四步装好，当天就能交付
不需要懂 Node 也不需要懂 PHP 框架。解压源码、打开安装向导、填数据库、建管理员——剩下的交给模板。
拿安装包
直接在本页下方「最新安装包」下载，无需注册；也可在控制台「安装包发布」获取历史版本。
上传解压
丢到站点根目录，给 config / data / uploads 写权限。
跑安装向导
浏览器打开 /install，环境检测 → 数据库 → 站点信息 → 完成。
套模板建站
后台选模板、换品牌色、改文案，发布上线。
Node 版（SiteCore）
# 解压后进入目录 cd site-core # 安装依赖（只需一次） npm install --omit=dev # 启动，浏览器打开 http://服务器IP:9100/install npm start
生产建议用 systemd / pm2 守护；Nginx 静态优先 + 反代 /admin。
PHP 版（SitePHP）
# 解压到站点根目录，给三个目录写权限 chown -R www:www config data uploads # 配伪静态（Nginx） location / { try_files $uri $uri/ /index.php?$query_string; } # 浏览器打开 http://域名/install/
Apache 目录里已带 .htaccess，开启 AllowOverride 即可。
装完记得删掉 install/ 目录（PHP 版）或确认向导已锁定；数据库账号不要用 root，只授权本库。
十份文档，覆盖日常全部操作
安装与部署
环境检测项、伪静态配置、目录权限、HTTPS 与常见报错对照表。
模板与组件
172 套模板在线预览怎么用、36 个组件各自适合什么场景、主题 token 怎么改。
后台操作全景
页面编辑器、文章、表单线索、媒体库、市场、安全设置——每个后台入口都在这里。
微信小程序
在线排版设计器 → 保存 → 下载模板包 → 导入开发者工具，5 步完成多端交付。
版本与升级
后台一键在线升级，检查更新、备份、回滚的完整流程。
授权与续费
License 绑定域名、改绑、停用、到期预警与降级行为说明。
免费版规则
免费版能干什么、哪些能力需要授权、页脚署名的约定。
技术栈互迁
Node 与 PHP 之间导数据、拷上传目录、切域名的完整步骤。
备份与安全
数据库与上传目录备份策略、敏感目录保护、登录限流与 CSRF。
故障排查
白屏 500、内页 404、上传失败、验证码、小程序白屏等高频问题。
最新安装包，公开直链下载
SiteCore（Node.js）与 SitePHP（PHP + MySQL）两套源码功能一致，按客户服务器环境任选。包内含 172 套模板、36 个组件、安装向导与伪静态配置。
安装包随版本更新自动替换为最新构建。
授权只管三件事：域名、到期、模块
License 不做代码级加密，也不打电话回家。它只标定「这个站授权给谁、到什么时候、开了哪些模块」，B 端安装时激活一次即可。
到期不会让网站打不开：静态页与已发布内容照常访问，只停掉模板市场、模块市场等需要对接授权中心的能力，页脚署名恢复显示。续费后立即恢复，不需要重新安装。
常用操作
免费版不是阉割版，规则只有一条
免费版无需域名授权即可全功能运行：全部组件、全部模板、文章、表单、媒体库、SEO、静态化发布、小程序模板包，一个不少。
免费版全功能
安装后即免费版：可视化编辑、文章系统、留资表单（含图形验证码）、一键静态化（Node 版）、小程序在线设计排版与模板包下载，全部可用。
唯一的约定
页面底部保留「技术支持：逍遥建站」署名——免费版与授权过期状态均强制显示，后台不可关闭。这是免费使用的全部代价。
何时需要授权
去掉页脚署名（白标交付）、付费模板市场与模块市场（对接 A 端）需要授权版。授权只标定域名与到期，不做代码级加密。
授权版可在后台「站点信息 → 页脚版权标注」关闭署名；到期后署名自动恢复显示，但网站照常访问，续费即恢复关闭能力。
后台操作全景，每个入口都讲清楚
登录后台（默认 /admin），顶栏从左到右就是日常工作流：编辑器搭页面 → 文章发内容 → 线索跟客户 → 市场装扩展 → 设置管安全。
可视化编辑器
左侧组件库拖进画布 → 右侧属性面板改文案/图/链接，改完自动保存。画布与前台共用渲染内核，所见即所得；点「预览」看真实效果，点「发布」落盘静态文件（Node 版）。窗口不够宽时点「⛶ 专注」隐藏导航全屏编辑（Esc 退出）；双栏宽度可拖拽分隔条调整，双击复位，窄屏自动收起侧栏。
文章与栏目
文章 → 新建：标题、Markdown 正文、封面、分类、标签、摘要；保存草稿或直接发布。栏目路径可自定义（如 /news、/blog），改路径旧链接自动跟随。列表页与详情页模板自动适配小程序，文章发布后多端同步。
表单与线索
编辑器里拖「留资表单」组件即可收询盘：字段自定义、提交写入本地线索库。前台所有提交均需图形验证码（4 位字符，点击可刷新，一次性消费防重放），挡住机器人灌水。后台「线索」里查看、导出跟进。
媒体库
媒体 → 上传：jpg/png/webp/gif/svg/ico，双校验真实 MIME；编辑器里所有图片字段都能直接从媒体库选。上传后自动生成缩略引用路径，迁移站点时整个 uploads/ 目录拷走即可。
市场与主题
市场：模块市场（扩展能力热插拔）与付费模板市场，授权版自动对接 A 端；免费版可看说明与升级引导。主题：主题 token 一键换色（主色/深浅底），模板在线预览后一键套用（会覆盖当前页面内容，套用前建议备份）。
安全设置
设置：站点信息（名称/Logo/联系方式/页脚版权）、管理员改密。登录安全：管理员登录带图形验证码，错码自动换图。后台目录：设置里可把 /admin 改成自定义路径（如 /console-xxx），改完旧地址立即 404、全后台链接自动跟随——忘记新地址可在配置文件里找回（见 FAQ）。
小程序多端交付，五步走完闭环
后台「小程序」页不是另一套后台：小程序直接读本站内容。想自定义排版，用在线设计器排好再打包。
在线设计排版
后台 → 小程序 → 在线设计排版：按页面调整区块显隐与顺序、覆盖标题，全局设主题色、导航栏标题、底部页签文案与顺序，手机预览实时所见。
保存设计稿
设计稿只存排版决策，不复制内容——以后在编辑器改内容、发文章，小程序实时同步，排版保持你设计的样子。
下载模板包
点「下载模板包（zip）」：自动结合当前网站参数——站点名/Logo/联系方式/导航/主题色写进包内，app.json 与设计稿一起生成，导入即离线可看完整效果。
导入开发者工具
微信开发者工具 → 导入项目 → 选解压目录 → 填自己的 AppID（没有可选测试号先跑通）。
配域名白名单
小程序后台 → 开发管理 → 服务器域名 → request 合法域名，加上站点域名（必须 HTTPS）；然后上传体验版 → 真机预览 → 提交审核。
内容实时同步
烤入数据保证离线秒开；联网后自动从站点接口刷新，下拉即取最新。网站改了文案、发了文章，小程序不用重新打包。
六个页面开箱即用
首页、产品、资讯、文章详情、关于、联系留资（表单直写线索库），14 类区块组件自动适配移动端渲染。
不想要小程序？
模板包按需下载，不下载就没有任何小程序痕迹；公开接口只读已发布内容，也可在 Nginx 禁掉 /api/miniapp/ 彻底关闭。
版本升级，后台一键完成
官网发布新版本后，B 端后台「技术与源码」页会看到更新提醒：检查更新 → 一键升级，程序自动下载发布包、备份、解包覆盖（不影响 data/ 数据与 .env 配置），重启即完成。
升级前自动备份到 data/upgrade-backup/，升级失败可在该目录找回旧版本文件。Node 版与 PHP 版升级互相独立，按各自页面操作。
操作路径
从 Node 换到 PHP，内容不用重做
两套源码用同一批 s_ 表结构与同一份 Schema JSON，渲染结果逐字符一致（48 组一致性用例守着），所以迁移只是搬数据。
导数据库
mysqldump 导出原站全部 s_ 开头的表，导入新库。
拷上传目录
把 uploads/ 整个拷过去，图片路径是相对地址，无需改数据。
跑安装向导
新环境解压后走一遍向导，跳过演示内容，接上刚导入的库。
# 1. 导出（在原 Node 站或数据库服务器上） mysqldump -u root -p --single-transaction 原库名 \ $(mysql -N -u root -p -e "SELECT GROUP_CONCAT(table_name) FROM information_schema.tables \ WHERE table_schema='原库名' AND table_name LIKE 's\_%'") > site.sql # 2. 拷图片 rsync -av 原站/uploads/ 新站/uploads/ # 3. 导入 mysql -u root -p 新库名 < site.sql # 4. 浏览器打开新站 /install/ 或 /install，按向导接上该库即可
如果站点的 canonical / sitemap 域名变了，切换后记得重新发布一次静态化（Node 版），或在后台「设置」里确认站点域名（PHP 版）。
能恢复的备份，才算备份
每天一次数据库 + 上传目录，保留 14 天，异地放一份。宝塔用计划任务，命令行用 cron，都可以。
安全默认值：输出全转义、URL scheme 白名单、代码组件净化、写操作 CSRF、登录限流、上传双校验、敏感目录 Web 层 404。
# 每天 03:20 备份并保留 14 天
20 3 * * * mysqldump -u backup -pXXX 站点库 \
| gzip > /backup/db-$(date +\%F).sql.gz
30 3 * * * tar czf /backup/up-$(date +\%F).tar.gz \
/www/wwwroot/站点/uploads
40 3 * * * find /backup -name '*.gz' -mtime +14 -delete高频问题，先看这里
说明安装锁不存在（Node 版 data/installed.lock，PHP 版 data/installed.lock）。装完自动写入；手工恢复过目录时可能丢失，重新跑一次向导即可，不会覆盖已有内容。
伪静态没生效。Nginx 加 try_files $uri $uri/ /index.php?$query_string;（PHP 版）或反代规则（Node 版）；Apache 要确认 AllowOverride All 且 .htaccess 未被忽略。
九成是目录不可写。Node 版检查 data/，PHP 版检查 config/ 与 data/。用 ls -ld 看属主是否为 Web 运行用户。
允许 jpg/png/webp/gif/svg/ico，且会校验真实 MIME。若文件稍大，调高 upload_max_filesize 与 client_max_body_size（建议 12M）。
Node 版点「发布」才会重新生成静态文件；如果 Nginx 静态优先，未发布时访问的是旧文件。PHP 版实时渲染，刷新即生效（浏览器缓存按 Ctrl+F5 强刷）。
PHP 版看 data/php-error.log；Node 版看 journalctl -u 服务名 -n 100。多数是数据库连接串错、扩展未装（pdo_mysql）或目录权限。
可以。PHP 版 base_path() 会自动识别子目录；Node 版需要在反代时保留路径前缀，并在 SITE_BASE_URL 里写上完整地址。
验证码 5 分钟有效、一次性消费（错一次就作废），点图片刷新后再输入。若图片一直不显示，检查浏览器是否禁用了本站请求或存在拦截插件；仍不行可清 Cookie 后重试。
能找回。Node 版：站点根目录 .env 里的 ADMIN_PATH 字段就是当前后台目录（改回 /admin 或改成新值后重启进程）。PHP 版：data/ 目录下的设置存储里有 admin 键，或直接用数据库工具查 settings 表。改目录是安全加固，建议顺手把新目录告知同管理员并收藏。
按顺序查：① utils/config.js 的 baseUrl 是否 https 且可访问；② 小程序后台「request 合法域名」是否已加该域名（本地预览项目已关 urlCheck 不受影响）；③ 站点是否正常（浏览器打开 /api/miniapp/site 应返回 JSON）；④ 打包时文章区块需要站点已发布内容。烤入的离线数据不依赖网络，若离线也白屏，重新下载一次模板包。
不能。这是免费版的唯一约定：免费版与授权过期状态均强制显示，后台不可关闭；购买授权后可在「站点信息 → 页脚版权标注」里关闭，到期自动恢复。其余功能免费版全部可用，不做阉割。