From de0b5d22a8af11e7a6ad6a7ba3f0d327438b4393 Mon Sep 17 00:00:00 2001 From: ShiZhui Date: Thu, 11 Jun 2026 18:43:17 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=9A=E8=AE=B0=E5=BD=95?= =?UTF-8?q?=20CMS=20=E9=85=8D=E7=BD=AE=E9=94=99=E8=AF=AF=E5=BE=85=E8=A7=A3?= =?UTF-8?q?=E5=86=B3=E9=97=AE=E9=A2=98=E5=8F=8A=E6=8E=92=E6=9F=A5=E6=80=9D?= =?UTF-8?q?=E8=B7=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/CMS.md | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/docs/CMS.md b/docs/CMS.md index d150669..3be387b 100644 --- a/docs/CMS.md +++ b/docs/CMS.md @@ -77,13 +77,28 @@ - 文件：`.gitea/workflows/deploy.yml` - 已实测：git push → Gitea → Runner → npm ci + build → 发布，全链路打通。 -### 阶段三：接入 CMS（进行中） +### 阶段三：接入 CMS（进行中 · 遇到待解决问题） - `public/admin/` 已就绪（Sveltia CMS + config.yml，backend 指向 Gitea IP） - Gitea 已注册 OAuth 应用（Sveltia CMS，公开客户端 + PKCE） - client_id 已写入 config.yml - redirect_uri: http://8.137.165.96:8080/admin/ -- **待验证**：浏览器登录 /admin 的 OAuth 流程能否纯前端跑通（Sveltia 对 - Gitea 的 token 交换是否需要额外中转服务）。需先放行安全组 3000 端口。 +- ✅ 安全组已放行 3000，浏览器可访问 Gitea +- ⚠️ **待解决问题**：访问 /admin 时报 + "There is an error in the CMS configuration. Please solve the issue and try again." + - 已排除：YAML 语法正确；已移除 local_backend 和无效的 locale 字段 + - 据 Sveltia 文档，该错误出现在登录屏，通常因 collection/field 的 name + 含非法字符（空格、`.`、`*`）或配置结构不被接受。本项目 name 均为合法英文， + 故疑点转向某个字段写法（datetime 的 format 组合 / value_type / summary 过滤器） + 或 backend 连接层。 + - 排查手段（下次继续）： + 1. 已在服务器临时部署最小化 config.yml 用于隔离（只含 title/pubDate/body）。 + 2. 需从浏览器 F12 控制台读取 Sveltia 打印的具体校验错误（最直接）。 + 3. 若最小配置可用，则逐项加回字段定位；若仍报错，排查 backend/CORS。 + - 相关：Sveltia 文档提到自托管 Gitea 需在 Gitea 配置启用 CORS + （[server].CORS / cors 段），本项目 Gitea 尚未配置 CORS，登录后调用 API + 可能受影响（此项与"配置错误"不同阶段，但一并待处理）。 +- 备注：CMS 在线编辑非阻塞项，静态站点 + CI 自动部署已可用； + 内容当前可用 Markdown 文件方式维护，CMS 调通后再切到在线编辑。 ### 测试访问地址（备案完成前） - 网站：http://8.137.165.96:8080