Repository navigation
Guide v1.2.0
新增 Cloudflare“检测受限”状态与独立分类管理，支持分类排序、空分类和前台同步。
新功能
- **检测受限（protected）：**明确遇到 Cloudflare 验证挑战时显示“检测受限”，不显示虚假响应时间。正常响应仍显示在线，普通 403、429、503 不会仅凭错误码判为受限。网站链接仍可访问，但受限状态不代表已确认网站可用。
- **分类管理：**后台支持新增、编辑、删除、上下移动排序、空分类及关联网站计数；服务编辑可选择已创建的分类。
- **前台同步：**分类栏按后台顺序显示，“全部”始终在首位并默认选中。有关联网站的分类必须先迁移网站才能删除，计数包含私有和停用网站。
优化与修复
- 改进分类更名后的数据同步，避免编辑网站时恢复旧分类；统一新写入分类名称的校验。
- 保持原在线检测周期、超时规则与安全防护。
升级与兼容性
- 已接入官方升级器的实例，先运行
sudo guide-update --check，再运行sudo guide-update；v1.0.0 首次接入须按安装文档核对旧部署。 - 数据库 schema 13 → 14 在新版首次启动时自动迁移，无需手工操作。保留原网站、分类、网站排序和检测数据，旧 Service API 继续兼容。
- 升级前保存可恢复的备份。官方升级器停服后备份数据库及 WAL/SHM 和旧二进制，启动失败时整体回滚；手工回退也必须恢复升级前完整快照，不能只替换旧二进制。恢复快照会覆盖备份后的修改，请先另存需要保留的数据。
- 已有管理分类时，会拒绝恢复缺少分类表的旧备份，以保护空分类和排序；不要删除分类或网站来绕过保护。
安装与下载
安装、升级与数据恢复指南 · 账号恢复 · 本版附件
下载时使用同一版本的归档、独立 .sha256 和 sha256sums.txt；安装器也须校验，校验失败立即停止。
已知限制
- 官方安装与升级支持 Linux x86_64、兼容 glibc 和 systemd；ARM、Windows、Alpine/musl、OpenRC 和容器内升级不受支持，暂无官方 Docker 镜像。断电、强制终止或磁盘故障不能保证自动回滚。
- 部分第三方依赖的许可证证据仍待补齐，见公开披露。