仲夏CMS | 仲夏晴空CMS 最全使用攻略

以下是基于 仲夏晴空CMS（ZXSORA CMS）最新版本的使用攻略

仲夏晴空CMS 最全使用攻略

写给站长朋友们的 ZXSORA CMS 系统使用完全指南

从内核原理到模块玩法，从安装部署到性能安全，一篇讲透

目录

• 第〇章 认识仲夏晴空CMS

• 第一篇 由内到外：先看懂系统的心脏（系统架构）

• 第二篇 安装部署：五分钟把站跑起来

• 第三篇 初始化配置：后台与站点设置

• 第四篇 站点搭建：内容组织与导航骨架

• 第五篇 内容发布：写作、定时、共创与审核

• 第六篇 十六大业务模块逐个玩透

• 第七篇 主题换装：晴空、墨卷与模块专属模板

• 第八篇 应用中心：模块、插件、主题的统一入口

• 第九篇 24 小时试用：源码实证与同类模式盘点

• 第十篇 多实例部署与组合建站

• 第十一篇 性能与安全

• 第十二篇 运营实战：四个真实站长案例

• 第十三篇 常见问题排查

• 第十四篇 进阶技巧

• 附录

第〇章 认识仲夏晴空CMS

0.1 它是什么？

仲夏晴空CMS（ZXSORA CMS）

 是一个用 Go 语言编写的轻量级建站工具。它的 slogan 是「把想法落成文字，把文字写给看得懂的人」，产品气质和它的名字一样：清新、直接、不折腾。

如果你受够了传统 CMS 的"装个环境要半天、配个插件要一堆、跑个站要几 G 内存"，那仲夏晴空CMS 会给你完全不同的体验——它主打一个 "装好就能用"（这句话是本攻略全文的钥匙，后面所有章节都在解释它）：

• 单文件运行

  整个程序就是一个二进制文件，Linux 版经压缩后约 5MB（当前源码版本为 0.1.20 / build 29，Go 1.25 编译）；

• 零外部依赖

  不需要 PHP、不需要 Node.js、不需要编译环境，连数据库驱动都内置（SQLite 用纯 Go 实现，连 CGO 都不用）；

• 四步安装向导

  浏览器里点四步就能完成安装；

• 开箱即带模块

  博客、论坛、文库、电商、招聘、圈子、动态、资讯、问答、服务、影集等十余个业务模块，加上「应用中心」随时在线扩充。

⚠️ 本攻略的诚实约定：

以下所有功能描述，都已对照源码逐项核实。凡是源码里没有的东西（比如曾经的宣传语里出现过、但代码里不存在的"多站点管理""多用户体系"），本攻略一概不写。已实现就是已实现，部分实现就标注限制，没有实现就直说没有。

0.2 适合谁用？

用户类型	适合场景	推荐模块组合
个人博主 / 内容创作者	写文章、沉淀作品、做个人品牌	博客 + 影集 + 动态 + 表单*
兴趣社群 / 站长	做社区、搞互动、沉淀 UGC	论坛 + 圈子 + 问答 + 动态
小团队 / 工作室	官网、作品集、客户服务	服务 + 影集 + 博客 + 表单*
电商小卖家	展示商品、收订单	电商 + 博客 + 资讯
知识型站长	文档库、教程站	文库 + 问答 + 博客 + 全站搜索
本地生活 / 同城站	活动、招聘、资讯	活动* + 招聘 + 资讯 + 服务
Windows 桌面用户	不想买服务器，先本地跑起来	任意组合，Win 本地版直接可用

\* 带星号的模块（音视、活动、表单）与影院选座插件是付费应用：未持授权时启用即进入 24 小时统一试用。具体机制见第九篇，试用期内功能完整可用，不用慌。

0.3 三个核心词汇（先记牢）

• 模块（Module）

  一个业务功能，比如博客、论坛、电商。模块可独立安装、启用、关闭。

• 插件（Plugin）

  增强能力的小应用，比如 RSS、站点地图、多人共创、影院选座。

• 主题（Theme）

  界面外观，比如默认的「晴空」、博客专属的「墨卷 · Paper」。

这三个东西，全部在应用中心统一管理——这是理解整个系统的一把钥匙。

0.4 和传统 CMS 比，差异在哪？

维度	传统 PHP CMS	仲夏晴空CMS
运行环境	需要 Web 服务器 + PHP + 数据库	单二进制，零依赖
体积	几十 MB 起步	约 5MB
安装	配环境 → 传文件 → 装程序 → 配库	四步向导
模块管理	插件市场，质量参差	应用中心统一管理三类应用
主题	全站一套模板	每个模块可独立选主题
SEO	靠插件堆 meta	内置完整收录底座（sitemap 分片 + 主动推送 + 后台自查）
移动端	看主题	默认移动端自适应
数据备份	导库导文件	Win 本地版整文件夹拷走即备份

第一篇 由内到外：先看懂系统的心脏（系统架构）

老话说"磨刀不误砍柴工"。建站前花十分钟看懂系统架构，后面所有配置都会变得顺理成章。

1.1 单文件哲学：为什么能做到 5MB？

仲夏晴空CMS 用 Go 1.25 编写，采用单二进制部署：所有代码编译成一个可执行文件，Linux 版经压缩后约 5.16MB。这意味着：

• 部署 = 拷贝一个文件 + 一个配置文件；

• 升级 = 替换一个文件（在线更新还会自动备份）；

• 迁移 = 拷走整个目录。

它的"重"活全部交给内置组件：数据库用 SQLite（纯 Go 实现，不需要 CGO），全文检索内置，Markdown 渲染内置，图片处理内置。你不需要在服务器上装任何额外软件。

1.2 技术底座一览

层	选型	说明
语言 / 运行时	Go 1.25	单二进制，编译型，启动快、占内存小
Web 框架	Go 标准库 net/http	无第三方框架，Go 1.22+ 增强路由（支持 GET /admin/{tab} 风格）
模板	html/template	服务端渲染，前端无构建链
Markdown	yuin/goldmark	支持 GFM：表格、任务列表、删除线、脚注
数据库	SQLite（默认） / MySQL	modernc.org/sqlite 纯 Go 驱动；MySQL 用 go-sql-driver；可一键切换
全文检索	FTS5 trigram（SQLite）/ FULLTEXT（MySQL）	含中文或短词（少于 3 字符）自动回退 LIKE
其他	goexif（EXIF）、golang.org/x/image、LRU 缓存等	图片处理、缓存加速

关键理解：

SQLite 是默认选择，适合绝大多数中小站点（零运维、单文件、备份简单）；流量上来了或需要多机部署时，改一行配置切 MySQL 即可，迁移是幂等的，不会丢数据。

1.3 core 引擎：一切的中枢

系统的心脏是 core 引擎（Engine）。你可以把它理解成一个"聚合总装车间"：数据库、模板、会话、设置、应用注册表、SEO 底座、用户召回底座……全部挂在 Engine 上，各业务模块通过"注册"的方式接入。

引擎里几个重要组件，站长需要知道的：

组件	作用	站长相关度
模板系统	全局模板按 (layout, content) 克隆缓存，支持热重载、主题覆盖层	★★★ 换肤原理
会话与 CSRF	登录状态 + 表单防伪造	★ 了解即可
站点设置 Settings	内存缓存 + 数据库持久化，后台可改	★★★ 后台设置入口
应用注册表 Apps	模块/插件/主题元数据的唯一来源	★★★ 应用中心
登录防爆破 LoginGuard	10 分钟窗口最多 5 次失败，超出锁 15 分钟	★ 安全机制
收录底座	sitemap 分片注册 + 缓存 + robots + 主动推送	★★★ SEO 核心
召回底座	用户主页 / 关注 / 收藏 / 消息聚合	★★★ 社区运营
试用底座 Trial	付费应用 24 小时统一试用计时	★★★ 付费模块入口（见第九篇）

1.4 数据库：SQLite 与 MySQL 双轨

系统启动时会对数据库做幂等迁移，三步走：

1. 建表

   SQLite / MySQL 各有一套 DDL；

2. 补列

   老库缺的字段自动补上（比如文章的作者 ID、定时发布时间、论坛帖子类型、商品划线价等）；

3. 补索引

   自动补性能索引与全文索引。

核心表包括：

设置表、用户表、角色表、会话表、分类表、文章表、标签表、文章标签关联表、多人共创表、页面表、评论表、顶栏导航表、应用安装状态表，以及各模块的业务表（公告表、论坛版块/帖子表、文库文档表、电商商品/订单/支付表、招聘表、圈子部落/留言表、动态表、资讯表、问答表、服务表、影集相册表、音视频表、活动/报名表、表单/答卷表、选座厅图/座位流水表……）。

给站长的启示：

• 你不需要手动建表、不用管迁移，版本升级时系统自己搞定；

• 换数据库（SQLite ↔ MySQL）随时可以，但切换前一定先备份；

• 数据文件在 data/ 目录下（默认 data/zxcms.db）。

1.5 模块化：每个模块都是"四件套"

每个业务模块都遵循统一的开发结构：模型（models）→ 数据访问（repo）→ 处理器（handler + admin）→ 种子数据（seed）。

种子数据的设计很贴心：每个模块首次启用时会自动播种演示内容，但只有表为空时才会播——也就是说你装上模块就能立刻看到界面效果，而你一旦开始写真实内容，演示内容不会干扰你。

第二篇 安装部署：五分钟把站跑起来

本系统有两种形态：

服务器版（部署到云服务器对外提供服务）和 Win 本地版（在你自己的 Windows 电脑上跑，带系统托盘和独立窗口）。两套内核相同、数据格式相同，本地玩熟了再搬到服务器，数据直接搬。

2.1 两种形态，怎么选？

形态	默认监听	适合谁	特点
服务器版	8080（可配）	正式上线	对外发布，可切 MySQL，支持在线更新
Win 本地版	127.0.0.1:18080	本地体验 / 编辑台	托盘 + 独立窗口，整文件夹即备份，随开随用

注意：

Win 本地版走独立版本线（当前为 "Bate 1.0"，Build 1），不随站点版版本号跳号——它俩版本号各数各的，别拿本地版的版本号去跟服务器版对比，这不是版本落后，是两条线。

2.2 安装：四步向导

1. 把二进制（Linux zxcms / Windows ZXSORA.exe）放到你的目录，首次访问自动进入安装向导；

3. 第一步：环境检测——系统会真实探测"目录可写、SQLite 可用"等条件，不满足会直接告诉你；

4. 第二步：填站点信息（站点名称、管理员账号密码等）；

5. 第三步：选数据库——SQLite（默认，零配置）或 MySQL（填连接信息）；

6. 第四步：完成安装，自动生成 config.json 与安装锁 .zxcms_installed。

装完就可以进后台 /admin 了。

💡 小知识：

安装锁 .zxcms_installed 的作用是防止误删配置后重新触发安装。如果连配置带锁一起删掉再访问，会进入重装流程——这会重建数据，操作前务必先备份 data/。

2.3 对外发布包的默认模块策略（重要）

源码里有个部署开关（Deployment.Modules），决定了"装好后默认开哪些模块"：

• 对外发布包默认只开博客

  其余模块需要你在应用中心在线安装（一条龙：点安装 → 启用 → 前台立即可用）；

• 开启全量模块的部署形态

  一次性强制开启全部业务模块（资讯、问答、服务、影集也一并开启），适合演示站、开箱即用的体验站。

给站长的启示：

默认只开博客不是"功能缺失"，而是刻意克制——先跑起来，再按需装模块，避免一上来就被十几个入口淹没。

2.4 升级：替换一个文件（有自动备份）

• 后台「站点设置 → 程序更新」配置好更新源后，可在线检测更新；

• 系统自动备份旧程序到 backups/（保留最近三份）→ 下载新包 → 替换 → 重启；

• 更新失败可回滚；

• 手动升级兜底：主站部署包覆盖即可。

第三篇 初始化配置：后台与站点设置

安装完成后第一件事：进后台把站点信息填齐。后台入口 /admin，默认管理员账号是安装时设置的那个。

3.1 后台长什么样？

后台各页签（源码核验，均有对应实现）：

页签	管什么
仪表盘	站点概况、关键数字
基本信息	站点名称、Logo、站点 URL、站长信息（含 Pro 授权码填写处）
站点设置	SEO 关键词、统计代码、评论审核开关等
用户管理	用户列表、角色分配、新用户默认角色
导航管理	顶栏导航的增删改、排序
账户设置	管理员密码等
收录自查	SEO 收录情况自查（复用 sitemap 同一份数据）
程序更新	在线更新、备份管理

3.2 Logo：三种模式

• 文本模式

  直接用站点名渲染；

• 图片模式

  上传 Logo 图片；

• 组合模式

  图片 + 文字。

上传 Logo 时系统会拦截 SVG 文件（防 XSS 的安全设计），用 PNG / JPG 即可。

3.3 Pro 授权码：在哪里填？有什么用？

• 位置：

• 后台「站点设置 → 基本信息 / 站长信息」填写授权码；

• 授权码格式：ZXSORA-PRO-<载荷>-<签名>，用 Ed25519 验签，程序只有验的能力、没有签的能力，伪造不了；

• 唯一作用（源码注释原文）

  「可以去掉署名」——填了有效授权码，页脚署名消失；

• 它不解锁任何业务功能

  免费版与 Pro 的功能完全一致，不存在"Pro 才有的模块"。

⚠️ 付费模块的 24 小时试用在持有效授权后不再倒计时（详见第九篇），这是授权在试用底座上的真实作用。

3.4 新用户默认角色

• 前台注册的新用户默认是 author（作者）角色；

• 内置角色：admin（管理员，含全部业务模块管理权限）、author（作者）；

• 可以自定义角色：每个角色就是一组权限点的集合，按需勾选。

第四篇 站点搭建：内容组织与导航骨架

4.1 导航：表驱动的顶栏

顶栏导航存在数据库里，后台「导航管理」直接增删改排序。装了模块，模块的入口会自动出现在导航里；卸载/关闭模块，入口自动消失——你不需要手工维护导航。

4.2 分类与栏目：每个模块自己的骨架

• 博客有分类、标签；

• 文库有书架分类；

• 电商有商品分类；

• 资讯有四档栏目（快讯 / 深度 / 专栏 / 生活）；

• 论坛有版块；

• 圈子有部落（部落本身是分类单元）；

• 招聘有岗位类型……

• 共同规律

  先想清楚站点内容分几块，再在对应模块后台建分类，内容发布时对号入座。

4.3 页面：独立页面怎么做？

系统支持页面管理（页面表），适合做"关于我们""联系我"这类固定页面。导航里可以挂页面入口。

4.4 用户与角色：谁可以发什么

• admin

  管理一切（含所有模块后台、用户、角色）；

• author

  发内容（文章、帖子、商品等前台发布入口）；

• 自定义角色

  给"版主""小编"等场景按权限点裁剪。

第五篇 内容发布：写作、定时、共创与审核

内容发布是全系统的核心动作。本篇以博客为主讲透通用机制，各模块的发布入口大同小异。

5.1 文章三态：发布 / 草稿 / 定时

• 发布

  保存即前台可见；

• 草稿

  存着不公开，改好了再发；

• 定时发布

  设定未来时间，到点自动上线（数据库补列里有"定时发布时间"字段，源码实锤）。

💡 运营建议：

定时发布是内容节奏神器——一次性写好一周的稿子，每天定点自动发，比想起来才写稳定得多。

5.2 Markdown 写作

• 全站 Markdown 渲染（goldmark），支持 GFM：表格、任务列表、删除线、脚注；

• 前台有写文章入口（/publish），不需要进后台也能发；

• 编辑器支持传图，图片存 uploads/（按年月组织）。

5.3 评论：验证码 + 蜜罐 + 审核开关

• 默认开启图形验证码：自绘四位数字，答案不落前端，10 分钟过期、一次一用，断网也能出图；

• 另有蜜罐字段（隐藏输入框，机器人填了就当垃圾处理）；

• 后台可开关评论审核：开启后评论先进审核队列，你放行才显示。

5.4 多人共创：一篇文章，多人署名（插件）

由「多人共创」插件提供，源码实证的流程是：

1. 作者写文章时点名合作者；

2. 被点名的人自己确认同意，署名才算数——点名的名字不算数，待确认与谢绝都不对外显示；

3. 接受邀请的人可以接着一起写，各自的改动都记进编辑历史（两张表：post_edit_permissions 权限 + post_edit_versions 版本）；

4. 不想用这个插件，在应用中心卸掉即可，已有署名记录保持原样。

💡 运营建议：

多人共创是"联合投稿"的干净解法——邀请朋友合写、多人连载，署名透明不撕逼。

5.5 防垃圾与社区治理（全站通用）

• 新用户默认 author，先发内容再谈权限；

• 搜索页、薄标签页自动 noindex、外链标 ugc（防 SEO 垃圾）；

• 新用户 7 天观察期（源码里的 UntrustedAuthor 机制）：发布内容暂时不参与收录（noindex），过了观察期自动放开——这是防止新号灌垃圾进搜索结果的防线。

第六篇 十六大业务模块逐个玩透

这是全攻略最长的一篇。老规矩先给一张总表，每个模块的付费状态和默认安装状态都在里面——这是对照源码核实过的，不看这张表，后面容易踩试用坑。

#	模块	一句话定位	默认装	是否付费
1	博客	晴空的编辑部：文章、分类、标签、评论、搜索	✅ 内置不可卸	免费
2	论坛	共鸣板：认真说话的人回声最响	✅	免费
3	文库	晴空书架：开放、无广告、无付费墙	✅	免费
4	电商	晴空小铺：透明小铺三件实事	✅	免费
5	招聘	晴空职栈：真实优先的职位板	✅	免费
6	圈子	晴空部落：一座部落一面旗	✅	免费
7	动态	晴空瞬语：没有算法的心情日记	✅	免费
8	资讯	晴空快报：栏目化资讯流	否（在线装）	免费
9	问答	晴空问路：只问正路，不问八卦	否（在线装）	免费
10	服务	晴空帮手：反幽灵订单、反维修刺客	否（在线装）	免费
11	影集	晴空影集：一组作品一个故事	否（在线装）	免费
12	音视	剧场：音频 / 视频 / 混合内容	否（在线装）	付费（24h 试用）
13	活动	日程：线上 / 线下 / 同场直播	否（在线装）	付费（24h 试用）
14	表单	问卷：13 种字段的收集器	否（在线装）	付费（24h 试用）
15	公告	布告：全站置顶的正式消息	✅	免费
16	全站检索	透镜：跨模块聚合搜索	✅ 内置不可卸	免费
附	影院选座（插件）	挂进活动模块的付费选座	否	付费（24h 试用）

🔑 付费状态是源码级事实：

media、events、forms 三个模块和 seats 插件的元数据里都有 Paid: true 标记。未持有效授权时启用它们，会进入 24 小时统一试用（机制细节见第九篇）。试用期内功能完整可用，不锁功能，放心试。

6.1 博客（免费，内置）

源码里的主站描述："晴空的编辑部：写文章、分栏目、挂标签，配上评论与搜索，把想法落成白纸黑字。"

• 作为"默认模块"，博客随程序一起出生：只能启用/关闭，不能卸载；关闭后前台入口隐藏、数据原样保留，随时能重新点亮；

• 文章三态：发布 / 草稿 / 定时（见 5.1）；

• 分类 + 标签双维度组织内容；

• 评论带验证码 + 蜜罐 + 审核开关（见 5.3）；

• Markdown 写作，支持表格、任务列表、删除线、脚注；

• 前台 /publish 直接发文，无需进后台；

• 全站检索会自动收录博客内容；

• 专属主题：墨卷 · Paper（第七篇细说）。

💡 运营小贴士：

博客是全系统的"根据地"。就算你是电商站、社区站，也建议留着博客——写点产品故事、站长手记，搜索引擎最喜欢新鲜的结构化文字内容。

6.2 论坛（免费，默认装）

源码里的主站描述："这里的名字叫「共鸣板」：不信时间流水账、不信刷票、不信复杂迷宫，只信认真说话的人回声最响。"

• 版块制：先建版块，再发帖；

• 六种帖子类型

  （源码实锤）：投票、晒图、辩论、推荐、连载、视频——一个论坛能吃下多种玩法；

• 专属主题：夜谈 · Ember。

💡 运营小贴士：

论坛冷启动最怕"没人回"。建议开"晒图"和"投票"两种类型做暖场——晒图门槛低、投票人人能参与，都是最容易把沉默用户钓出来的钩子。

6.3 文库（免费，默认装）

源码里的主站描述："晴空书架：一座开源、无广告、无付费墙的开放书架——文档分类如书架、卡片如藏本、阅读量即热读度，全文即点即读，读完还能留下温书人批注。"

• 文档分类如书架，卡片如藏本；

• 全文即点即读

  不用下载、不用等；

• 温书人批注

  读者可以在文档上留批注；

• 热读榜：阅读量即热度。

💡 运营小贴士：

文库适合放"长尾知识资产"——教程、FAQ、白皮书。批注功能是社区感放大器：读者在文档里留的批注，就是最好的"这站有人在认真读"的证据。

6.4 电商（免费，默认装）

源码里的主站描述："「晴空小铺」——信任优先的透明小铺。不做千篇一律的货架，只做三件实事：库存条看得见、售后承诺置顶、到货时效写明白。"

完整电商链路（源码路由实锤）：

• 上架

  标题、分类、价格、库存、摘要、正文，可传商品图（/shop/publish）；

• 商品展示

  前台商品列表 + 商品详情（/shop、/shop/{slug}）；

• 优惠码

  后台「优惠券」管理创建/删除，下单时可凭码减价；

• 下单

  访客把商品加入订单（/shop/orders 我的订单、收银台）；

• 订单状态机pending

  （待支付）→ paid（已支付）→ redeemed（已核销）；后台可标记支付、核销，也可凭核销码核销（/admin/shop/orders/redeem-code）；买家可取消订单；

• 安心购徽标

  库存看得见——库存≤5 红色提醒、现货绿色、缺货直说。

⚠️ 如实说明（部分实现）：

目前内置的是模拟支付流程（MockPaymentProvider），目的是把"下单 → 支付 → 核销"这条链路完整跑通给你看，不接真实收款。真实收款需要站长自行对接支付渠道，或等主站后续版本。买家用它下单不会真扣钱——正式上线收钱前，请务必搞清楚这一点。

💡 运营小贴士：

就算不打算真在线收款，电商模块也可以当"透明报价单"用——价格、库存、售后承诺写明白，客户线上看货、线下交易，核销流程当"提货登记"用。

6.5 招聘（免费，默认装）

源码里的主站描述："「晴空职栈」：真实优先的职位板。岗位状态灯（招聘中 / 暂停 / 已满）拒绝挂而不招，薪资透明、福利写清、新鲜度可见，让每份简历都投向真实的岗位。"

• 状态灯

  招聘中（绿）/ 暂停（黄）/ 已满（红）——挂着的岗位状态一眼看清，拒绝"挂了不招"；

• 薪资福利透明、岗位新鲜度可见；

• 岗位分类筛选。

💡 运营小贴士：

同城站 / 行业站的招聘频道是最容易被搜到的内容类型之一。求职者搜"城市 + 岗位"进来，停留时间长，广告位价值高。

6.6 圈子（免费，默认装）

源码里的主站描述："晴空部落：一座部落一面旗——有旗帜（封面）、有公约（公开规则）、有新人谷。不搞组长一言堂，不让新人沉默期，不让冷启动冷场。"

• 部落

  是圈子里的组织单元：有封面旗帜、有公约、有新人谷（新人报到区）；

• 六种留言类型

  （源码实锤）；

• 部落旗帜可换图裁剪；单条留言可收藏；@ 提醒会进通知中心。

💡 运营小贴士：

圈子的"公约"是社区治理的好抓手——建部落时就把版规写成公约置顶，比事后吵架管用得多。新人谷专门用来接住新人，别让新人发第一帖就石沉大海。

6.7 动态（免费，默认装）

源码里的主站描述："「晴空瞬语」：一页没有算法的心情日记。不刷热点、不喂茧房、不比焦虑——每条动态开头都写着「此刻」，你刷到的，都是最新与真实。喜欢不叫点赞，叫共鸣。"

• 此刻标记

  每条动态自带时间戳，永远按最新排；

• 共鸣

  喜欢不叫点赞，叫共鸣；

• 静静模式

  不想被刷屏打扰的免打扰模式。

💡 运营小贴士：

动态是站内"广播喇叭"——新文章、新活动、新商品发布后，同步发一条动态，老用户回访时第一眼就看到。零成本回流。

6.8 资讯（免费，在线装）

源码里的主站描述："「晴空快报」：栏目化资讯流，不灌水、不标题党。快讯、深度、专栏、生活四档栏目各归其位；每条资讯带着时效温度，新不新、热不热一眼看清。"

• 四档栏目

  快讯 / 深度 / 专栏 / 生活——不同类型的内容有各自的栏目位；

• 时效温度

  24 小时内标"新"，读得多标"热"；

• 每篇资讯写明出处（来源标注）。

💡 运营小贴士：

资讯适合做"日更型"站点。四档栏目就是四个内容节奏：快讯追热点（日更）、深度做长文（周更）、专栏养作者（约稿）、生活接地气（UGC）。

6.9 问答（免费，在线装）

源码里的主站描述："「晴空问路」：只问正路，不问八卦——这里没有编出来的故事，也没有能刷的赞。求助按方向分好（经验 / 方法 / 数据 / 推荐），各归其位；谁的回答被采纳，谁就赢下这一局。"

• 四类方向

  经验 / 方法 / 数据 / 推荐；

• 采纳机制

  提问者采纳谁的回答，谁就赢下这一局；

• 不登录也能答题（降低参与门槛）。

💡 运营小贴士：

问答是"长尾关键词收割机"——用户问的问题就是搜索词。把高频问题沉淀成问答，再引导到文库的教程长文，形成"问答引流 → 文库留人"的漏斗。

6.10 服务（免费，在线装）

源码里的主站描述："「晴空帮手」：反幽灵订单、反维修刺客。服务一口价明码标价，公示价即成交价；响应时效写清楚；服务商资质与地址透明；服务完成后真实评价沉淀口碑分。"

• 一口价

  明码标价，公示价即成交价；

• 响应时效写清楚；服务商资质与地址透明；

• 服务完成后真实评价沉淀口碑分。

💡 运营小贴士：

服务模块适合工作室 / 个体户做"技能名片"——修电脑、拍照片、做设计、跑腿代办，一口价 + 口碑分就是最好的信任背书。

6.11 影集（免费，在线装）

源码里的主站描述："「晴空影集」：反算法吞噬，反版权裸奔。一组作品一个故事——相册按时间线安静排开，没有猜你喜欢、没有点赞排行；每一张照片都带着版权声明。"

• 相册按时间线排开；

• 每张照片带版权声明：作者、拍摄信息、授权说明写得明明白白；

• EXIF 自动归档

  拍摄时间等信息自动整理，隐私信息自动抹除后再展示；

• 自动压图，省空间省流量。

💡 运营小贴士：

摄影师 / 设计师做作品集，影集就是主场。版权声明写清楚"可商用 / 禁转载 / 需署名"，比事后追责省心一百倍。

6.12 音视（付费模块，24 小时试用）

源码里的主站描述：剧场：音频、视频、混合内容。 这是一个 Paid: true 的付费模块，未持授权启用即进入 24 小时试用（见第九篇）。

• 支持音频 / 视频 / 混合三种内容类型；

• 多播放轨

  同一内容可挂多个播放源（清晰度 / 音质切换）；

• 发布即推送：新内容自动进入内容流。

💡 运营小贴士：

播客、教学视频、音乐 demo——音视模块把"媒体资产"收纳成一个独立频道。试用期内先验证播放体验和带宽成本，再决定是否购买授权。

6.13 活动（付费模块，24 小时试用）

源码里的主站描述：日程：线上 / 线下 / 同场直播三种形态的活动管理。 这是一个 Paid: true 付费模块。

• 三种活动形态

  线上（纯线上参与）/ 线下（实体场地）/ 同场直播（线下+直播联动）；

• 报名管理

  报名码 + 二维码核验签到；

• 报名截止时间、候补队列（满员后排队等坑）；

• 一键导出

  报名名单；

• 报名表单联动表单模块字段；

• 验证码防刷；活动五种状态流转。

💡 运营小贴士：

同城站的命脉就是活动——读书会、市集、线下课，活动办起来，站就活了。报名 + 核验 + 导出一条龙，主办方最烦的"签到统计"直接省掉。

6.14 表单（付费模块，24 小时试用）

源码里的主站描述：问卷：13 种字段的收集器。 这是一个 Paid: true 付费模块。

• 13 种字段

  单行文本、多行文本、数字、邮箱、手机号、网址、日期、时间、单选、多选、下拉、评分、说明文字；

• 收集人数上限、截止时间；

• 选项自动统计、单条答卷可删、一键导出；

• 4 位图形验证码防刷。

💡 运营小贴士：

表单是"万能收集器"——约稿登记、报名接龙、满意度调查、客户留资，全都能干。13 种字段覆盖 90% 收集场景，不用再挂第三方问卷。

6.15 公告（免费，默认装）

源码里的主站描述：布告：全站置顶的正式消息。 免费模块，默认安装。

• 独立栏目，可置顶；

• 24 小时标新

  新公告 24 小时内带"新"标记；

• 适合发：维护通知、活动预告、规则变更。

💡 运营小贴士：

公告是"主站发声位"。版本更新、临时维护、重要规则，一律走公告——别让站长的正经事和用户水帖挤在一个信息流里。

6.16 全站检索（免费，内置）

源码里的主站描述：透镜：跨模块聚合搜索。 与博客一样是"内置模块"：只能启用/关闭，不能卸载。

• 一条搜索框，跨 博客、论坛、文库、问答 聚合检索（/search，按模块分组展示结果）；

• 底层是 SQLite FTS5 trigram 全文索引，MySQL 下走 FULLTEXT；

• 中文或短词（少于 3 字符）自动回退 LIKE

  ——这是设计不是 bug，搜"的""了"这种没意义；

• 有专属模板 透镜 · Lens。

💡 运营小贴士：

搜索框是内容站的"内部导购"。文库、问答这类长内容站点务必开它——用户搜得到，内容才有第二次生命。

6.17 影院选座（付费插件，24 小时试用）

这是一个 Paid: true 的插件（源码类型为插件，注册在活动模块上），源码实锤的能力：

• 厅图画图器

  在后台画出放映厅座位图；

• 五种座位类型

  普通 / VIP / 情侣 / 无障碍 / 停售；

• 锁座 15 分钟防超卖

  选座后 15 分钟内未支付自动释放；

• 出票

  出票时把座位号写进报名记录和凭证，扫码对座；

• 改图不伤已售：改厅图时已售座位自动保护（快照机制）。

💡 运营小贴士：

影院、剧场、线下课、讲座——只要"有座位的活动"都能用。它挂在活动模块上：活动负责报名，选座负责座位，天然配套。

6.18 关于 Pro 授权（本版重要修正）

旧版攻略把这一节叫"Pro 高级扩展"，这个叫法有误导，本版更正。

源码事实（internal/core/license.go）：

• Pro 授权码的唯一作用：去除页脚署名；

• 它不解锁任何业务功能

  免费版与 Pro 的功能完全一致，不存在"Pro 专属模块 / Pro 专属主题"；

• 它在试用底座上的真实作用：持有效授权后，付费模块不再受 24 小时试用倒计时限制（见第九篇 9.2）。

结论：

想支持开发者就买 Pro（去署名），想要功能就用试用 + 按需购买付费模块授权——两件事别混为一谈。

第七篇 主题换装：晴空、墨卷与模块专属模板

7.1 主题机制（源码实证）

• 系统自带 「晴空」默认主题（themes/default/），是全局兜底皮肤；

• 每个模块可以独立选主题

  （源码的 Templates 选项机制）：博客用墨卷、论坛用夜谈、电商用市集……互不影响；

• 主题应用（AppTheme 类型）安装后，在模块后台选用；卸载自动回退默认「晴空」；

• 模板覆盖层

  全局模板按 (layout, content) 克隆缓存，支持主题覆盖层 + 热重载——改模板不用重启，即时生效；

• 主题目录缺失自动跳过回退，不会全站白屏。

7.2 现成主题一览（源码实锤共 17 款）

主题	归属	气质
晴空（default）	全站默认	清新、直接、不折腾
墨卷 · Paper	博客	纸质书卷感，长文阅读
夜谈 · Ember	论坛	深色对话氛围
典藏 · Archive	文库	藏书架
市集 · Bazaar	电商	逛摊感
职榜 · Career	招聘	职位板
营地 · Camp	圈子	部落聚集地
时光 · Timeline	动态	时间线
号外 · Extra	资讯	快报感
答疑 · Solve	问答	问路台
服务台 · Desk	服务	办事窗口
展厅 · Frame	影集	画廊
剧场 · Theater	音视	放映厅
日程 · Calendar	活动	日历板
问卷 · Survey	表单	答题纸
布告 · Bulletin	公告	通知栏
透镜 · Lens	全站检索	放大镜

💡 运营小贴士：

模块换主题是"气质分层"的利器——主站用晴空保持统一，博客频道切墨卷拉长文阅读氛围，电商频道切市集增强"逛"的感觉。主题是给访客的第一印象，别懒。

第八篇 应用中心：模块、插件、主题的统一入口

8.1 三类应用，一个入口

后台「应用中心」统一管理三类东西：

• 模块

  博客、论坛、电商……业务功能本体；

• 插件

  RSS、站点地图、多人共创、影院选座……能力增强；

• 主题

  晴空、墨卷及各模块专属模板……界面外观。

设计要点：

每个应用的元数据（名称、版本号、更新日志）以系统代码为唯一来源，安装状态持久化在数据库中。所以应用中心展示的信息永远和程序本体一致，不会出现"装了但实际没有"的假象。

8.2 在线安装：零命令行、无需重启

对外发布包默认仅开启博客，其余模块都可以从应用中心在线安装：

1. 后台进入「应用中心」；

2. 浏览可选模块（默认源 https://zxsora.cn/apps）；

3. 点击安装 → 状态变为已安装 → 立即启用；

4. 前台立刻出现对应模块入口，全程不需要重启程序、不需要碰命令行。

💡 小贴士：

装上模块后系统会幂等播种演示内容（表空才播），立刻能看到模块长什么样。

8.3 内置应用规则（重要）

• 内置应用不可卸载

  博客和全站检索是"仅可关闭"（DisableOnly），只能启用/关闭，数据保留；

• 至少保留一个开启的模块

  别把模块全关了，系统会提示你；

• 未安装模块的 guard

  未安装的模块路由由 guard 返回 404，前台导航不显示入口——这是设计，不是故障。

8.4 插件：RSS、站点地图、多人共创（免费）

插件是"轻量增强"，目前内置的（源码实证均为免费、默认安装）：

• RSS 插件

  提供站点/内容订阅输出；

• 站点地图插件

  与收录底座配合，输出搜索引擎需要的 sitemap 分片；

• 多人共创插件

  博客多人共创开关以插件形式提供（老库升级时自动开启）。

给站长的建议：

RSS + sitemap 建议保持开启，一个是内容订阅出口，一个是收录必需。

8.5 老库升级：一次性迁移自动开新模块

如果你是从旧版本升级上来的老库，系统会在升级时执行一次性迁移逻辑：在开启全量模块的部署形态下，自动开启新模块（资讯、问答、服务、影集）与对应插件（多人共创）。不用手动逐个开，升级后检查一遍即可。

第九篇 24 小时试用：源码实证与同类模式盘点

这一篇是本版攻略新增的重点章节。外面宣传的"24 小时试用"到底是怎么个机制？源码里写得明明白白，我们一条条拆给你看；再把国内外用"24 小时/短时试用"玩法的同类产品盘一遍，方便你对照理解。

9.1 先看源码：试用底座到底怎么工作

源码位置：internal/core/trial.go。核心事实如下（每一条都能在代码里找到对应）：

① 试用只针对"付费应用" 带 Paid: true 标记的只有四个：音视（media）、活动（events）、表单（forms）三个模块 + 影院选座（seats）插件。其余所有模块都是免费的，没有试用这一说。

② 触发方式：启用即开表 不是"下载后限时 24 小时"，而是启用付费应用的那一刻开始计时。不装、不启用，就不走表。

③ 24 小时是"实际使用时间" 试用额度默认 86400 秒（正好 24 小时），按实际用掉的时间累计：中途把付费应用关闭（或暂停试用），计时就停；再启用，接着上次的剩余时间继续走。暂停没有次数和时长限制——你可以停半年再回来接着用。

④ 用满之后：不可用，但数据保留 24 小时额度用满且未持有效授权 → 该应用不可用（前台入口隐藏、路由 guard 拦截）。但数据与开关状态原样保留，开通授权后即恢复。不会删你的活动、表单、音视频。

⑤ 何时开始正式计时：2026-10-01 源码里写死了正式计时起点：2026 年 10 月 1 日 00:00（北京时间）。在此之前启用付费应用，一律不走表、不算时间、也不可暂停；到点之后，已启用的自动开表开始累计。也就是说——2026-10-01 之前，付费模块相当于随便用。

⑥ 存量站点放行（grandfather） 已经用着的付费应用，升级到带试用机制的新版本后一次性放行，不会让你突然被锁。

⑦ 界面提示

• 后台有试用悬浮提醒条（只显示"正在试用 / 已暂停"状态，不打扰已过期的）；

• 应用中心卡片上有红色徽章标出试用状态；

• 已持有有效授权（授权检查 LicenseCheck().Granted 为真）的应用显示 licensed，不受试用限制。

⑧ 测试留的口子TRIAL_SEC、TRIAL_EFFECT_AT 环境变量可以调短时长、改起点，是给开发者测试用的，站长不用管。

🧪 一句话总结源码实证：

ZXCMS2027 的 24 小时试用 = "付费模块启用后，累计 24 小时实际使用时间；用满未授权则停用、数据保留；2026-10-01 起正式走表；此前随便用；老存量放行。"

9.2 授权与试用的关系（重要，别再被绕晕）

场景	付费模块（音视/活动/表单/选座）	页脚署名
免费版（未填授权码）	24 小时试用，用满停用	保留署名
填写有效 Pro 授权码	不再受试用限制	署名消失

授权码格式 ZXSORA-PRO-<载荷>-<签名>，Ed25519 验签，程序只有验的能力没有签的能力。详见 3.3。

9.3 国内外同类：还有谁用"24 小时 / 短时试用"这套打法？

以下盘点基于已检索到的公开资料整理，厂商与时长均有来源，没有虚构。

共同点：短时试用普遍用于"低门槛体验核心能力 + 快速逼单"；

不同点：有的免卡（零风险），有的靠退款窗口（先付后退）。

产品 / 平台	试用模式	来源要点
CyberGhost VPN	24 小时免卡试用 （Windows / macOS）；Android 3 天、iOS 7 天；另有 45 天退款窗口	VPN 行业最贴近"24h 无卡"的例子：装、测、过期，不填支付信息
Steam	2 小时游玩 / 14 天退款窗口 （非严格试用，是"先买后退"）	游戏行业的标准做法：购买 14 天内、游玩不足 2 小时可退款，任何理由
Shopify	14 天免费试用（注册即可，无需信用卡即可体验基础流程）	SaaS 电商建站最常被引用的试用长度
BigCommerce	15 天免卡试用	与 Shopify 同赛道的竞品参数
米拓 CMS	7 天免费试用 ：注册即用、无需付费；试用期可试用所有插件（含收费插件）、可启用商城；试用内容可迁移至正式站；可付费延期（首次 9 元/月，之后 99 元/月）	国内建站系统里把"试用→迁移→延期"链路讲得最透的
竹子建站	无时间限制的基础功能免费试用 + VIP 体验券限时解锁高级功能	"永久免费基础版 + 限时解锁高级"的混合打法
凡科建站	支持免费试用，常推 30 天高级模板免费体验活动	国内 SaaS 建站常用 30 天周期
Host & Tech 等海外拖拽建站	免费搭建到满意为止，上线才收费（pay nothing until go live）	"试用即建站"模式：建站过程免费，发布才谈钱

对照 ZXCMS2027 的 24 小时试用，差异与亮点：

1. 免卡、零风险

   ——和 CyberGhost 的 24h 无卡一致，不需要先付钱再退款，省心；

2. 按实际用时累计

   ——比"自然日 24 小时"更宽松：你只打开 2 小时就关了，这 24 小时能拆成好几天慢慢用；暂停无限制，更是碾压"一刀切到期"的常见做法；

3. 数据保留

   ——用满不可用但数据都在，开通授权即恢复，不像某些平台到期直接清数据逼你续费；

4. 与 Steam 的对照

   ——Steam 的"2 小时"是退款窗口（先付后退），ZXCMS 是真正的免卡试用，心理门槛更低；但 Steam 模式有 14 天自然日 + 全功能，ZXCMS 试用期内功能也是全开放的，这点一致。

💡 站长视角：

要不要开付费模块？建议先趁试用把"流程跑通 + 内容装满"，验证它真的能帮你解决运营问题，再决定购买授权。试用期就是干这个用的。

第十篇 多实例部署与组合建站

10.1 "多站"到底是什么意思？（本版更正）

"多站与组合建站"，容易让人以为系统内置"一个程序管理多个网站"（多站点管理）。源码里没有这样的实现——不存在多站点、多租户功能，也没有"站点间切换管理"的后台。

ZXCMS2027 实际支持的是 多实例部署：

• 你想开两个站（比如"博客站"和"客户案例站"），就拷贝两份程序（或两个部署目录），各自独立安装、独立配置、独立数据；

• 数据都在各自目录的 data/ 下，互不干扰；

• Win 本地版开第二个实例时，系统会自动检测并激活已打开的窗口（多开保护），建议本地只跑一个实例，多站场景放到服务器上各开各的。

结论：

要"多站"，就多部署几份实例——一份程序对应一个站，简单粗暴，零耦合。

10.2 组合建站：一个站，多模块拼

虽然不支持"一套程序多站"，但一个站内可以自由组合模块，这就是组合建站：

你想做的站	模块组合
个人品牌站	博客 + 影集 + 表单 + 动态
兴趣社区	论坛 + 圈子 + 问答 + 动态
电商站	电商 + 博客 + 资讯
知识站	文库 + 问答 + 博客 + 全站检索
同城站	资讯 + 活动 + 招聘 + 服务
工作室官网	服务 + 影集 + 博客 + 表单

组合的规则很简单：

每个模块都是独立的开关，装上就用、不装就看不见，入口由导航自动管理。

第十一篇 性能与安全

11.1 性能设计（源码实证）

• SQLite 默认零运维

  单文件数据库，无需独立数据库服务；流量大了再切 MySQL；

• FTS5 trigram 全文索引

  搜索不走全表扫描；中文 / 短词自动回退 LIKE（平衡索引体积）；

• LRU 缓存

  模板、sitemap、设置均有内存缓存；

• 模板热重载

  改模板无需重启，开发期和换肤期都很省事；

• 图片自动压图

  影集模块自动压缩，省空间省流量；

• 收录分片缓存

  sitemap 分片按需生成 + 缓存，不拖累页面响应。

11.2 安全设计（源码实证）

项目	实现
密码存储	PBKDF2-HMAC-SHA256（v2 格式 310000 轮；v1 老格式兼容并自动升级）
登录防爆破	10 分钟窗口最多 5 次失败，超出锁定 15 分钟
CSRF 防护	所有表单带 CSRF 令牌校验
会话	Cookie 会话；本地版 localhost 长会话；安全属性按需
安全响应头	nosniff、X-Frame-Options、SameOrigin 等中间件统一注入
图形验证码	自绘四位数字，10 分钟过期、一次一用，断网可用
邮箱注册 OTP	6 位验证码、10 分钟有效、60 秒限频、5 次作废；邮件未配置时记日志兜底
Logo 上传	禁止 SVG（防 XSS）
路径校验	重定向 / 路径遍历统一校验（httpx 辅助）
前台登录	安全跳转校验（safeNext 防钓鱼跳转）
反垃圾	蜜罐字段、新用户 7 天观察期（未过观察期内容 noindex）
外链治理	搜索页、薄标签页 noindex，外链标 ugc

11.3 备份与恢复

• Win 本地版

  整个数据文件夹拷走即备份（单文件理念的极致体现）；

• 整站备份

  后台 / 在线更新流程支持打 zip（含 data/、uploads/、config.json）——备份还原是"启动期换血"式恢复，兼容老格式；

• 切换数据库前

  一定先备份；

• 在线更新自动备份旧版本（保留最近三份），可回滚。

第十二篇 运营实战：四个真实站长案例

前面讲了太多"模块能干什么"，这一篇反过来——

站长想干什么，用哪些模块解决。四个案例覆盖四种典型站长，每个都按"建什么站 → 要什么 → 用什么模块 → 解决什么"展开，可以直接照着搭。

12.1 案例一：个人博主"阿晴"——用博客 + 影集 + 表单搭个人品牌站

• 建什么站

  个人品牌站。阿晴是个独立摄影师 + 写作者，想有一个地方：放文章、放作品集、让读者能联系她约拍。

• 需要什么功能

  长文写作与归档、作品展示、联系/预约入口、个人介绍页。

• 用系统哪个模块解决
• 博客

  （免费内置）：写摄影手记、器材测评，按分类归档；定时发布维持更新节奏；

• 影集

  （免费在线装）：按拍摄项目建相册，时间线排开，每张带版权声明（写清楚"约拍授权可商用"）；

• 表单

  （付费，24h 试用）：做"约拍登记表"——姓名、日期、拍摄需求，自动导出成名单；

• 动态

  （免费默认装）：随手发"今日出片"。

• 解决了什么问题

  作品和文章在一个站里互相引流——读者看文章被作品打动 → 填表约拍 → 表单导出直接排期。版权声明写清楚，再也不用担心图被白嫖。

12.2 案例二：电商小卖家"老王"——用电商 + 博客 + 资讯开店

• 建什么站

  独立小电商站。老王卖手工皮具，受够了平台抽成和"比价内卷"，想开个自己的店。

• 需要什么功能

  商品展示、库存可见、优惠促销、下单核销、产品故事。

• 用系统哪个模块解决
• 电商

  （免费默认装）：上架商品、分类、价格、库存条（低库存红色提醒）；建优惠码做促销；买家下单后走"待支付 → 已支付 → 已核销"流程，后台可凭核销码核销；

• 博客

  （免费内置）：写"皮具保养指南""制作过程"长文，为商品页引流；

• 资讯

  （免费在线装）：发上新公告、限时活动。

• 解决了什么问题透明三件套（库存条 / 售后承诺 / 到货时效）

  让买家敢下单；优惠码实现"私域促销"；订单核销流程让"线上看货、线下交付"也有凭据。

• ⚠️ 老王要记住的一条：

• 当前电商内置的是模拟支付（下单不会真扣钱）。正式收款前，要么等主站接入真实支付，要么自己在交付环节收钱——别把模拟支付当收款通道上线。

12.3 案例三：知识型站长"林老师"——用文库 + 问答 + 博客搭教程站

• 建什么站

  编程教程站。林老师写了几百篇技术笔记，想做成一个"能搜、能问、能沉淀"的知识站。

• 需要什么功能

  文档组织与全文检索、读者提问与解答、教程写作、内容沉淀。

• 用系统哪个模块解决
• 文库

  （免费默认装）：把笔记按主题归档成"书架"，全文即点即读，读者可留温书人批注；

• 全站检索

  （免费内置）：一条搜索框跨文库/博客/问答聚合命中——这是知识站的生命线；

• 问答

  （免费在线装）：读者卡住了来问，采纳机制沉淀"最佳答案"；

• 博客

  （免费内置）：写"每周一坑"之类的连载心得；

• 表单

  （付费，24h 试用）：做"内容需求投票"（读者想先看哪块）。

• 解决了什么问题搜得到 + 问得到 + 读得完

  文库承接长尾流量，问答承接即时问题，批注让读者感觉到"这本书有人在读"。

12.4 案例四：本地同城站长"老周"——用资讯 + 活动 + 招聘 + 服务搭同城站

• 建什么站

  县城同城信息站。老周想做一个"本地人每天都来看一眼"的站：本地新闻、周末活动、招工求职、便民服务。

• 需要什么功能

  资讯更新、活动报名、招聘发布、本地服务挂牌。

• 用系统哪个模块解决
• 资讯

  （免费在线装）：四档栏目——快讯追本地热点、深度写本地故事、专栏找本地作者、生活收 UGC 投稿；24h 标新让"新不新"一目了然；

• 活动

  （付费，24h 试用）：读书会、市集、广场活动——线上 / 线下 / 同场直播三种形态，报名 + 核验签到 + 导出名单，主办方零负担；

• 招聘

  （免费默认装）：本地岗位状态灯（招聘中/暂停/已满），拒绝"挂着不招"；

• 服务

  （免费在线装）：本地师傅挂牌——一口价 + 口碑分，修电脑、通下水道明码标价。

• （进阶）影院选座（付费插件，24h 试用）：本地小剧场 / 放映会可以卖座位——画厅图、五种座位、锁座 15 分钟防超卖、扫码对座。

• 解决了什么问题

  同城站的核心是"信息真实 + 更新勤"。状态灯和时效温度保证了信息不烂尾，活动报名 + 核销把线上流量变成线下人气——

站活了，广告位就值钱了。

12.5 案例总结表

站长	建什么站	核心模块	最值钱的功能
阿晴	个人品牌	博客 + 影集 + 表单	版权声明 + 约拍表单
老王	电商小铺	电商 + 博客 + 资讯	库存条 + 优惠码 + 核销
林老师	知识教程	文库 + 问答 + 全站检索	全文即点即读 + 批注
老周	同城信息	资讯 + 活动 + 招聘 + 服务	状态灯 + 活动核销

第十三篇 常见问题排查

13.1 安装 / 启动类

Q1：安装向导提示"目录不可写 / SQLite 不可用"？ 

A：安装向导第一步做的是真实环境探测，不是吓唬你。检查程序目录权限（Linux 下 chmod 或换属主），确认磁盘剩余空间正常，再重试。

Q2：删了 config.json 会怎样？ 

A：系统有安装锁 .zxcms_installed 保护，正常不会触发重装。如果连锁一起删了再访问，会进入重装向导——重装会重建数据，操作前先备份 data/。

Q3：Win 本地版双击没反应 / 点了又弹回已打开的窗口？ 

A：本地版有"多开保护"——已有一个实例在跑时，再开一次会激活原窗口而不是新开一个。找托盘图标，或看任务栏是否有窗口。托盘之外关窗即退（这是设计）。

13.2 模块 / 应用类

Q4：应用中心里看不到某些模块？ 

A：默认安装列表是按部署形态决定的（对外发布包默认只开博客）。其余模块去应用中心在线安装即可；安装后前台入口自动出现。

Q5：访问某模块地址返回 404？ 

A：大概率是模块未安装或已关闭——未安装模块的 guard 统一返回 404，导航里也没有入口。这不是故障，去应用中心启用即可。

Q6：付费模块（音视/活动/表单/选座）提示试用/停用？ 

A：见第九篇。未持授权时这些模块累计 24 小时实际使用时间，用满停用但数据保留；开通授权立即恢复。

Q7：改了主题，前台没变化？ 

A：确认是在模块后台选的对应主题（每个模块独立选主题，不是全站一个开关）。模板热重载即时生效，无需重启；改完强制刷新浏览器缓存。

13.3 内容 / 用户类

Q8：新用户发了内容，搜索引擎不收录？ 

A：新用户有 7 天观察期（UntrustedAuthor），观察期内内容 noindex，过了自动放开。这是防垃圾设计，不是 bug。

Q9：评论不见了？ 

A：先看后台是否开了"评论审核"开关——开了的话评论先进审核队列，放行后才显示。另外评论带验证码 + 蜜罐，被误判的垃圾过滤也可能拦截。

Q10：多人共创邀请别人，署名没出现？ 

A：署名必须被邀请的人自己确认同意才算数。点名、待确认、谢绝都不对外显示——这是共创插件的规则，防止"被署名"。

Q11：邮箱注册收不到验证码？ 

A：OTP 邮件发送依赖站点邮件配置。如果邮件未配置，系统会把验证码记到日志兜底（见 11.2）。先去后台配置好 SMTP，再重试。

13.4 升级 / 备份类

Q12：在线更新失败 / 想回滚？ 

A：更新流程自带备份（保留最近三份）与失败回滚。也可以手动用备份目录恢复旧版本，再检查 data/ 数据完整性。

Q13：换数据库（SQLite→MySQL）会不会丢数据？ 

A：迁移是幂等的，不会丢数据。但切换前一定先备份，切换后核对关键数据（用户、文章数）。

第十四篇 进阶技巧

14.1 用定时发布做内容节奏

一次性写好一周内容，定时到每天上午 9 点发布。内容节奏稳定，搜索引擎更喜欢"有规律的更新"。

14.2 组合拳：问答引流 → 文库留人

把用户高频问题沉淀成问答（容易被搜到），问答回答里挂文库长文链接（读得完、留得住）。问答收割搜索流量，文库承接深度阅读。

14.3 动态当广播喇叭

新文章 / 新商品 / 新活动发布后，同步发一条动态。老用户回访首页就看到，零成本回流。

14.4 同城站的活动飞轮

活动（免费试用到满意再买授权）→ 报名 + 核验签到 → 导出名单 → 办完发资讯复盘 → 下一篇资讯预告下场活动。一场活动养三波内容。

14.5 模板热重载调试

改主题模板不用重启，保存即生效。调样式时开两个窗口：一个编辑器、一个前台预览，反复改反复看，效率拉满。

14.6 安全基线清单

• 后台密码用强密码（PBKDF2 310000 轮也扛不住弱密码）；

• 登录连续失败会被锁 15 分钟，别自己把自己锁了；

• Logo 别传 SVG（会被拒），用 PNG / JPG；

• 评论审核建议常开，验证码别关；

• 新用户默认 author，别给前台用户发 admin。

附录

附录 A 通俗化术语表（大白话版）

旧版术语表偏书面，本版全部换成大白话，一句括号简释。

术语	大白话解释
模块（Module）	一个业务功能块，如博客、电商。相当于店里的一排货架，想摆哪个就装哪个。
插件（Plugin）	给模块加能力的小零件，如 RSS、多人共创。相当于给货架加挂钩。
主题（Theme）	网站皮肤/外观。每个模块可以穿自己的衣服。
单二进制（Single Binary）	整个程序就是一个文件，拷走就是部署。不用装运行环境。
零依赖	不需要 PHP、Node、数据库服务等任何外部软件。
幂等迁移	升级时自动补表补列，跑多少次结果都一样，不会把数据搞乱。
SQLite / MySQL	两种数据库：前者单文件零运维（默认），后者适合大流量/多机部署。
FTS5 trigram	SQLite 的全文索引技术，搜中文又快又省；搜短词自动降级 LIKE（模糊匹配）。
收录底座	系统内置的一套"让搜索引擎收你"的设施：sitemap 分片 + robots + 主动推送。
sitemap 分片	把网站地图拆成多个小文件，内容多了也好管理，搜索引擎按清单来抓。
主动推送	内容发布后主动通知搜索引擎来收录（IndexNow / 百度推送），不用等它慢慢爬。
召回底座	系统内置的"把老用户叫回来"的设施：关注、收藏、站内消息通知。
noindex	告诉搜索引擎"这页别收"。新用户观察期、薄内容页会自动标上。
canonical	告诉搜索引擎"这页的正式地址是哪个"，防止重复内容被降权。
JSON-LD 结构化数据	网页里嵌的一小段"机器可读"标签，让搜索结果能显示评分、价格等富样式。
PBKDF2-HMAC-SHA256	密码加密算法，把密码"搅"很多轮再存，数据库泄露也难还原。
CSRF	防止"你在别的网页上被偷偷提交了这个网站的表单"的防护机制。
OTP	一次性验证码（邮箱收 6 位数字那种），注册/敏感操作时用。
蜜罐	页面里藏一个正常人不该填的输入框，机器人填了就被识破，拉黑处理。
登录防爆破	密码连续错 5 次就锁 15 分钟，防止有人暴力猜密码。
状态机	订单从"待支付→已支付→已核销"的流转规则，防止状态乱跳。
模拟支付	内置的"假支付通道"，用于跑通下单流程演示，不真收钱。
试用额度	付费应用可累计使用的时间（24 小时），按实际用时扣，暂停不扣。
多实例部署	一个程序管一个站；要开多个站就多部署几份，互不干扰。
热重载	改模板/代码不用重启程序，保存即生效。
Ed25519 验签	一种数字签名算法，用来验证 Pro 授权码真假，伪造不了。
Grandfather（存量放行）	老用户不受新限制影响：升级前就在用的付费模块，升级后一次性放行。
蜜罐 / 白名单（删除场景）	文件整理等场景的"只动不删 + 重名重命名"保护机制，防止误删。

附录 B 路径速查

内容	位置
程序	部署目录二进制（Linux zxcms / Windows ZXSORA.exe）
配置	config.json
数据	data/ （默认 data/zxcms.db）
上传文件	uploads/ （按年月组织）
主题	themes/ （default / paper / ember / archive / bazaar / career / camp / timeline / extra / solve / desk / frame / theater / calendar / survey / bulletin / lens）
备份	backups/ （在线更新自动保留最近三份）
安装锁	.zxcms_installed
更新源	后台「站点设置 → 程序更新」配置

附录 C 版本规则（源码注释原样转述）

• 主版本号首位为 0（当前），第二位每年 6 月 16 日进位（项目生日），构建号每次发布 +1；

• 站点版当前：0.1.20 / Build 29；

• Win 本地版独立版本线：Bate 1.0 / Build 1，不随站点版跳号；

• 发布打包前需核对 internal/core/version.go 与 update/version.json 一致（两处都是版本权威来源）。

附录 D 模块与主题速查表

模块	默认装	付费	专属主题	一句话
博客	内置不可卸	免费	墨卷 Paper	编辑部
论坛	✅	免费	夜谈 Ember	共鸣板
文库	✅	免费	典藏 Archive	开放书架
电商	✅	免费	市集 Bazaar	透明小铺
招聘	✅	免费	职榜 Career	真实职位板
圈子	✅	免费	营地 Camp	部落
动态	✅	免费	时光 Timeline	心情日记
资讯	在线装	免费	号外 Extra	快报
问答	在线装	免费	答疑 Solve	问路
服务	在线装	免费	服务台 Desk	帮手
影集	在线装	免费	展厅 Frame	作品集
音视	在线装	付费试用	剧场 Theater	音视频
活动	在线装	付费试用	日程 Calendar	活动管理
表单	在线装	付费试用	问卷 Survey	收集器
公告	✅	免费	布告 Bulletin	置顶消息
全站检索	内置不可卸	免费	透镜 Lens	跨模块搜索
影院选座	插件	付费试用	—	活动选座

附录 E 结语

这本攻略严格对照源码重写，核心就一句话：只写有的，不写没有的。

祝你建站顺利，把想法落成文字，把文字写给看得懂的人。

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/sinat_24301081/article/details/166790088