llms.txt · xianyan.cc
运维与部署 更新于 2026-08-15

Cloudflare 资源

职责：集中管理 Cloudflare 全栈资源——账户/Token 权限、Workers、D1、R2、KV、AI Gateway、Turnstile、自定义域名、wrangler CLI 速查。

Cloudflare 资源管理指南（Workers + D1 + R2 + KV + AI）

创建: 2026-08-15 | 更新: 2026-08-15
维护: Xianyan 团队

职责：集中管理 Cloudflare 全栈资源——账户/Token 权限、Workers、D1、R2、KV、AI Gateway、Turnstile、自定义域名、wrangler CLI 速查。

1. 资源清单

资源 ID 用途
Account ID 0f10da38d071cb4e689594b4bd0cff90 Freetimeuu@gmail.com
Zone xianyan.cc 1e258e5850617d5b0f3d5b78b6af4dfa 主站
Zone wyi.cc 75bf2ced3c47ef9b423a04145019d011 短链
D1 xianyan-gufeng 456401c1-8f6a-4981-afac-52164d3ec382 古风诗词
D1 xianyan-analytics 19601853-17f5-406e-bb1f-9807bbe81917 埋点
D1 xianyan-shield 9c795d8b-8727-4a5e-bc44-998c952bb065 OAuth
D1 wyi-shortener 13b1d999-3378-488c-97f8-831ad3f7e79f 短链
D1 doc-xianyan ab6fbbd5-faac-4d81-b8ce-83ec23d53e9b 文档中心
KV RATE_LIMIT 60ce91e00a4547a4b16c8a5517423345 全局限流
KV XY_CDN_FILES 2175c849644144cbabc1d0d8fbd1a263 静态资源
KV XY_CDN_INDEX 647ee2348bc6414786121accca82c342 索引
KV XY_CDN_SESSIONS d5dda97351b543c0b64e83c955358135 会话
KV XY_CDN_TOKENS 09fb38c62818432bb95362a883afdd76 临时文件 token
KV XY_FENXI_SESSIONS 1d2b81adb0114e0c9c08aa4f98dae685 看板会话
R2 xianyan-images — 闲言图片存储
AI Gateway default AI 缓存+限流
Turnstile s2ss-content-pages 人机验证

2. Workers 列表

Worker 域名 用途
xianyan-cdn cdn.xianyan.cc 静态资源 + 快传 + 海外中转
xianyan-fenxi fenxi.xianyan.cc 埋点 + 看板 + 古风后台
xianyan-today today.xianyan.cc 今日一吟（时段为主）
yan-wyi-cc yan.wyi.cc 每日一吟（水墨时段图）
xianyan-image-gen (cron) AI 生图（凌晨 1 次）
yan-wyi-cc-freetimeuu (旧占位) —
wyi-cc-site wyi.cc 短链服务
doc-xianyan doc.xianyan.cc 文档中心
fy-api fy.wyi.cc 翻译 + AI
fan-frontend fan.wyi.cc 翻译前端

3. Token 权限矩阵

Token Workers D1 R2 KV AI Gateway Turnstile WAF Custom Domain
OAuth (wrangler) ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌
API Token cfat_... ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌
API Token cfut_... ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌

结论： - DNS / Custom Domain 绑定 → 仅 Dashboard 手动操作 - Workers/D1/R2/KV/AI/Turnstile 管理 → cfut token

4. wrangler CLI 速查

# 登录
wrangler login

# Workers
wrangler deploy [path]              # 部署
wrangler tail <name>                # 实时日志
wrangler secret put <NAME>          # 设置 secret
wrangler secret list                # 列出所有 secret
wrangler triggers                   # 列出 cron 触发器

# D1
wrangler d1 list                    # 数据库列表
wrangler d1 create <name>           # 创建
wrangler d1 execute <db> --command "SQL"  # 执行 SQL
wrangler d1 execute <db> --file=foo.sql   # 执行 SQL 文件
wrangler d1 execute <db> --command "SQL" --remote  # 远程（生产）

# R2
wrangler r2 bucket list
wrangler r2 bucket create <name>
wrangler r2 object delete <bucket> <key>

# KV
wrangler kv namespace list
wrangler kv key get --namespace-id <id> <key>

5. 域名绑定流程（必经 Dashboard）

API/OAuth 都不能改 DNS 或绑定 Custom Domain。流程：

  1. Dashboard → Workers & Pages → 选 Worker
  2. Settings → Domains & Routes → Add Custom Domain
  3. 输入子域名（如 today.xianyan.cc）
  4. Cloudflare 自动创建 DNS 记录
  5. 1-3 分钟生效，SSL 自动签发

6. AI Gateway 管理

# 查 gateway 状态
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT/ai-gateway/gateways" \
  -H "Authorization: Bearer cfut_token"

# 配置缓存 + 限流
curl -X PUT "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT/ai-gateway/gateways/default" \
  -H "Authorization: Bearer cfut_token" \
  -d '{"cache_ttl": 3600, "collect_logs": true, "rate_limiting_limit": 10000, ...}'

# 查实时调用日志
curl ".../ai-gateway/gateways/default/logs?per_page=10"

当前 default 配置： - cache_ttl = 3600 秒 - rate_limiting_limit = 10000 次/天

7. 常见问题

Q: Custom Domain 绑定失败？

A: API/OAuth 都不能绑。必须 Dashboard 手动操作。

Q: workers.dev 域名访问不到？

A: 在中国大陆 networks 里被 DNS 污染。需本地代理（127.0.0.1:7890/7891）才能访问。

Q: AI 调用返回 401？

A: Token 没权限。检查 token 是否含 Workers AI Read 权限。

8. 关联文档