湛箴网页版（CF Pages 静态前端）

纯静态单页应用，连你自己的湛箴 API 服务器。部署到 Cloudflare Pages 零配置。

Cloudflare Pages 部署（1 分钟）

1. CF Dashboard → Workers & Pages → Create → Pages → Connect to Git
2. 选这个仓库 zhanzhen-web
3. 构建设置全部留空（纯静态，无需构建命令）→ Save and Deploy
4. 得到 https://<项目名>.pages.dev —— 打开即用

连接后端

打开页面后在顶部横幅填两项（存浏览器 localStorage）：

项	填什么
服务器地址	你 VPS 上湛箴 API 的地址，如 https://api.你的域名.com 或 http://1.2.3.4:8710
API Key	管理台 /admin 发放的 zzk_...

也可以写死默认后端：把 index.html 第一行脚本里的 ZZ_API_BASE 设为你的地址再部署。

CORS 注意

VPS 上的湛箴 API 必须允许本 Pages 域名跨域。最快方式：在 VPS 的反代（nginx/1panel）加：

add_header Access-Control-Allow-Origin "https://<你的pages域名>" always;
add_header Access-Control-Allow-Headers "X-API-Key, Content-Type" always;
add_header Access-Control-Allow-Methods "GET, POST, OPTIONS" always;

或直接用 Cloudflare 的同域方案：给 Pages 项目绑自定义域 app.你的域名， API 走 api.你的域名 同一主域——多数情况无需额外 CORS 头。

与仓库关系

• 后端/桌面版/安卓：见 Ya-MiC/zhanzhen
• 本仓库只放「用户打开就能用的网页壳」，与 zhanzhen/web/index.html 功能同步