部署到 Cloudflare Workers
1. Fork Sink 并创建资源
Fork Sink 仓库。在 Cloudflare 仪表盘 中创建：
| 绑定名称 | 产品 | 是否必需 | 是什么 |
|---|---|---|---|
DB | D1 数据库 | 必需 | 保存链接 |
KV | KV 命名空间 | 必需 | 加速跳转 |
ANALYTICS | Analytics Engine 数据集 | 推荐 | 访问统计 |
R2 | R2 存储桶 | 可选 | 备份与社交图片 |
AI | Workers AI | 可选 | AI 建议 |
在 D1、KV 各自的详情页复制 数据库 ID 和 命名空间 ID。
访问分析是可选的——不配也能用短链。启用步骤见访问分析与近实时视图。
2. 连接 Git（Workers Builds）
在 Cloudflare 仪表盘中创建带 Git 集成 的 Worker，并连接你的 Fork：
- 生产分支：
master - 构建命令：
pnpm build - 部署命令：
pnpm deploy:worker
添加这些构建变量（不要把生产环境 ID 写进仓库里的 wrangler.jsonc — 请用 DEPLOY_*）：
| 变量 | 填什么 |
|---|---|
DEPLOY_D1_DATABASE_ID | D1 数据库 ID（在 D1 详情页） |
DEPLOY_KV_NAMESPACE_ID | KV 命名空间 ID（在 KV 详情页）→ kv_namespaces[].id |
DEPLOY_KV_PREVIEW_NAMESPACE_ID | 可选 Wrangler 预览 KV → preview_id（默认等于 DEPLOY_KV_NAMESPACE_ID） |
DEPLOY_R2_BUCKET_NAME | R2 存储桶名称（仅在使用 R2 时；不填则生成配置里不含 R2）→ bucket_name |
DEPLOY_R2_PREVIEW_BUCKET_NAME | 可选 Wrangler 预览 R2 → preview_bucket_name（默认等于 DEPLOY_R2_BUCKET_NAME） |
DEPLOY_D1_DATABASE_NAME | 可选；默认 sink |
DEPLOY_ANALYTICS_DATASET | 可选；默认 sink（若改了，请与 NUXT_DATASET 保持一致） |
pnpm deploy:worker 会根据这些值生成被 gitignore 的 wrangler.deploy.jsonc，更新 D1 结构后部署。连接仓库时 Cloudflare 会生成部署令牌 — 不用再单独粘贴部署密钥。
3. 应用设置（登录密码等）
在 Settings → Variables and Secrets 中添加：
| 变量 | 类型 | 用途 |
|---|---|---|
NUXT_SITE_TOKEN | 加密密钥 | 仪表盘登录密码和 API 密码（至少 8 个字符，保持稳定） |
NUXT_CF_ACCOUNT_ID | 变量 | 访问分析推荐 |
NUXT_CF_API_TOKEN | 加密密钥 | 访问分析推荐 |
访问分析细节见访问分析与近实时视图。完整列表见配置参考。
确认绑定名称正好是 DB、KV、ANALYTICS、R2、AI。
4. 部署并首次使用
从 master 启动构建，等待完成。
- 打开
/dashboard，用NUXT_SITE_TOKEN登录 - 打开一次 Dashboard → Links（一次性存储初始化）
- 创建链接
必须先打开一次 Links
存储初始化完成前，创建链接可能失败，并提示「存储未就绪」（HTTP 423）。
后续升级见升级 Sink。