| title | 配置参考 |
|---|---|
| description | Sink 支持的全部环境变量——做什么、填在哪、什么时候需要。 |
所有值都是字符串。布尔开关除非另有说明，使用 true。
大多数人需要的
- 必配：
NUXT_SITE_TOKEN、D1（DB）、KV（KV）以及它们的 ID - 访问分析：
ANALYTICS绑定 +NUXT_CF_ACCOUNT_ID+NUXT_CF_API_TOKEN— 见访问分析 - 其余都是可选
可以想成两个时机：
| 时机 | 含义 | Workers | Pages |
|---|---|---|---|
| 构建时 | Cloudflare 构建/发布应用时用到 | Workers Builds → Variables | Settings → Variables and Secrets |
| 运行时 | 线上应用运行时用到 | Worker Settings → Variables and Secrets | 同一套 Variables and Secrets（共用） |
| 两者都要 | 构建出的页面和运行时都要用（例如公开 UI 设置） | 在 Builds 和 Worker 设置里填相同值 | 只填一次 |
::: tip 改了公开/构建变量后 请重新部署一次，让应用重新构建。Workers 上「两者都要」的变量必须在两处一致。 :::
以 DEPLOY_* 开头的名字只在部署时连接资源用。它们会把仓库里 wrangler.jsonc 的占位值写进被 gitignore 的 wrangler.deploy.jsonc — 请在 .env 或 Cloudflare 构建变量里设置 DEPLOY_*，不要把生产环境 ID 写进 wrangler.jsonc。以 NUXT_* 开头的名字配置正在运行的应用。
绑定 = 把 Cloudflare 产品用固定名称接到 Sink。
| 绑定 | 是否必需 | 白话说明 |
|---|---|---|
DB |
必需 | D1 数据库 — 保存链接 |
KV |
必需 | 加速跳转的缓存（+ 存储就绪标记） |
ANALYTICS |
推荐 | 访问事件，供分析使用 |
R2 |
可选 | 文件存储，用于备份和社交图片。Workers 可用 DEPLOY_R2_BUCKET_NAME；Pages 在仪表盘 Bindings 里添加 |
AI |
可选 | Workers AI 建议 |
ASSETS |
自动 | 静态文件 — 系统自动提供 |
访问分析是可选的。不配也能用短链和仪表盘；图表会是空的。启用步骤见访问分析。
::: warning NUXT_SITE_TOKEN
请自己设置。这是仪表盘登录密码，也是 API 密码。至少 8 个字符，越长越好。保持稳定。
如果留空，Sink 可能在构建时随机生成密码，下次部署可能变化。 :::
| 变量 | 时机 | 放哪里 | 用途 |
|---|---|---|---|
NUXT_SITE_TOKEN |
运行时（密钥） | Workers 或 Pages 的加密密钥 | 单用户登录 + API 密码 |
NUXT_OIDC_ISSUER |
运行时 | Worker 或 Pages 变量 | 可选的 OpenID Connect 签发者 URL |
NUXT_OIDC_CLIENT_ID |
运行时 | Worker 或 Pages 变量 | 机密 Web 客户端 ID |
NUXT_OIDC_CLIENT_SECRET |
运行时（密钥） | Workers 或 Pages 的加密密钥 | 机密 Web 客户端密钥 |
NUXT_OIDC_REDIRECT_URI |
运行时 | Worker 或 Pages 变量 | 以 /api/auth/callback 结尾的精确回调 URL |
NUXT_OIDC_SESSION_SECRET |
运行时（密钥） | Workers 或 Pages 的加密密钥 | 至少 32 字符的随机 Session 签名密钥 |
NUXT_OIDC_SESSION_TTL_SECONDS |
运行时 | Worker 或 Pages 变量 | 本地 Session 上限，默认 28800 |
DEPLOY_D1_DATABASE_ID |
构建时 | Workers Builds 或 Pages 变量 | D1 数据库 ID（在 D1 详情页） |
DEPLOY_KV_NAMESPACE_ID |
构建时 | Workers Builds 或 Pages 变量 | KV 命名空间 ID（在 KV 详情页） |
Sink 同一时间只使用一种认证模式：
- 未配置 OIDC 时，Sink 保持单用户模式。站点令牌和 Cloudflare Access 共用
rootowner。 - 配置 OIDC 后启用多用户模式。浏览器和 API 都必须使用 OIDC Session；站点令牌和 Cloudflare Access 不再能认证受保护的 API。
- 只配置部分 OIDC 必填项时会以失败关闭。签发者、客户端 ID、客户端密钥和 Session 密钥必须一起配置完整。
在 OIDC 多用户模式下，每个通过验证的身份都有相互隔离的链接、标签和访问分析数据，Sink 使用身份提供方稳定的 subject 标识作为 owner ID。在单用户模式下，通过站点令牌或 Cloudflare Access 创建的链接，以及从旧版本升级的现有链接，都属于共享的 root owner。
由于同一主机名下的公开跳转共用短码命名空间，短码仍然全局唯一。如果其他用户已经占用了指定短码，当前用户只会收到冲突响应，无法访问对方的链接。
| 变量 | 时机 | 放哪里 | 用途 |
|---|---|---|---|
NUXT_CF_ACCOUNT_ID |
运行时 | Worker 或 Pages 变量 | 你的 Cloudflare 账户 ID |
NUXT_CF_API_TOKEN |
运行时（密钥） | 加密密钥 | 仅含 Account → Account Analytics → Read 的 Custom Token |
同时绑定 ANALYTICS。备份加 R2，AI 加 AI。令牌步骤见访问分析。
Workers 要在 Builds 和运行时填相同值。Pages 只填一次，然后重新部署。
| 变量 | 默认 | 用途 |
|---|---|---|
NUXT_PUBLIC_PREVIEW_MODE |
空 | true = 演示模式（链接只活 5 分钟） |
NUXT_PUBLIC_SLUG_DEFAULT_LENGTH |
6 |
自动生成短链码的长度 |
NUXT_PUBLIC_KV_BATCH_LIMIT |
50 |
导出每页条数；导入每次最多一半 |
| 变量 | 放哪里 | 何时生效 |
|---|---|---|
NUXT_API_CORS |
Builds 或 Pages | 严格等于 true 时，允许其他网站的浏览器调用 /api/**（CORS）。仍需要登录 |
DEPLOY_R2_BUCKET_NAME |
仅 Workers Builds | 填已有 R2 桶名以挂上 R2（bucket_name）。Pages：在 Bindings 里添加 |
DEPLOY_KV_PREVIEW_NAMESPACE_ID |
Workers Builds 或 Pages | 可选 Wrangler preview_id；默认等于 DEPLOY_KV_NAMESPACE_ID |
DEPLOY_R2_PREVIEW_BUCKET_NAME |
仅 Workers Builds | 可选 Wrangler preview_bucket_name；启用 R2 时默认等于 DEPLOY_R2_BUCKET_NAME |
| 变量 | 用途 |
|---|---|
NUXT_HOME_URL |
非空则把 / 重定向到该 URL；空则显示 Sink 首页 |
NUXT_NOT_FOUND_REDIRECT |
未知短链码跳到哪里（始终 HTTP 302） |
NUXT_CF_ACCESS_TEAM_DOMAIN + NUXT_CF_ACCESS_AUD |
两个都设 → 启用 Cloudflare Access |
NUXT_SAFE_BROWSING_DOH |
用于检查不安全域名的 DNS-over-HTTPS 地址（未设置 unsafe 时） |
NUXT_WEBHOOK_URL |
点击 Webhook 的 HTTP(S) 地址 |
NUXT_WEBHOOK_SECRET |
可选签名密钥，以 whsec_ 开头 |
安全浏览示例：Cloudflare Family DNS https://family.cloudflare-dns.com/dns-query。另见链接功能。
| 变量 | 默认 | 用途 |
|---|---|---|
NUXT_REDIRECT_STATUS_CODE |
301 |
普通跳转状态码（也可用 302/307/308）。未知短链仍用 302 |
NUXT_LINK_CACHE_TTL |
60 |
KV 缓存链接的秒数 |
NUXT_REDIRECT_WITH_QUERY |
false |
true 时把访客查询参数接到目标 URL |
NUXT_REDIRECT_NO_STORE |
false |
true 时要求浏览器不要缓存这次跳转 |
NUXT_CASE_SENSITIVE |
false |
true 时自定义短链码区分大小写（Docs ≠ docs） |
NUXT_DATASET |
sink |
访问分析数据集名；必须与 ANALYTICS 绑定一致 |
NUXT_LIST_QUERY_LIMIT |
500 |
分析列表最大行数 |
NUXT_DISABLE_BOT_ACCESS_LOG |
false |
true 时从分析和 Webhook 排除机器人 |
NUXT_DISABLE_AUTO_BACKUP |
false |
true 时关闭计划 R2 备份 |
NUXT_AI_MODEL |
@cf/qwen/qwen3-30b-a3b-fp8 |
Workers AI 模型 |
NUXT_AI_PROMPT |
内置 | 自定义短链提示词必须保留 {slugRegex} |
NUXT_AI_OG_PROMPT |
内置 | 自定义社交预览提示词 |
DEPLOY_D1_DATABASE_NAME |
sink |
覆盖生成部署配置中的 d1_databases[].database_name |
DEPLOY_ANALYTICS_DATASET |
sink |
覆盖生成部署配置中的 analytics_engine_datasets[].dataset；请与 NUXT_DATASET 保持一致 |