配置项

部署或排查配置问题时，在这里查询环境变量、密钥、绑定和应用设置的默认值。

Calends 的大部分设置都在应用界面里，保存在数据库中。部署层面只有下面这些配置。

环境变量与绑定

名称	类型	适用	说明
SETUP_TOKEN	密钥 / 环境变量	全部	新部署首次设置密码时必须提供。Cloudflare 用 wrangler secret put SETUP_TOKEN 设置；Docker 不设时自动生成。设好密码后就用不到了。
SITE_URL	变量 / 环境变量	全部	站点地址，比如 https://calends.example.com，用于提醒消息和日历订阅里的链接。不设时：处理请求时用当前访问的地址；定时任务里用你最近一次访问应用时记下的地址。
EMAIL	绑定	Cloudflare	Cloudflare Email Sending 的 send_email 绑定，邮件提醒需要。
MAIL_FROM	变量	Cloudflare	发件地址，必须是 EMAIL 绑定里允许的地址。和 EMAIL 一起配置后邮件渠道才可用。
MAIL_FROM_NAME	变量	Cloudflare	发件人名称，可选。
TRUST_PROXY	环境变量	自托管	在反向代理后面时设为 1，才信任 X-Forwarded-For 作为访客 IP，登录限速才准确。不在代理后面时不要设。
DATA_DIR	环境变量	Docker	数据目录，缺省 /data。
PORT	环境变量	Docker	监听端口，缺省 8787。
LOG_LEVEL	环境变量	Docker	Worker 日志级别，缺省 warn。
OWNER_PASSCODE	密钥	旧版	早期版本把口令直接放在密钥里。第一次用它登录成功后会转存为哈希，之后可以删除。新部署不需要。
DEV_BYPASS_AUTH	.dev.vars	本地开发	设为 1 时跳过登录。只用于本地，绝不要在线上配置。

在 Cloudflare 上，变量写在 wrangler.jsonc 的 vars 里，或者在控制台的 Worker 设置里添加；密钥用 wrangler secret put。在 Docker 里都用环境变量。

应用里的设置

这些不是环境变量，在界面里改：

设置	位置	缺省
本位币	设置 → 通用	USD
时区	设置 → 通用	UTC
语言	设置 → 通用	跟随系统
默认提前提醒	设置 → 提醒	3 天
发送时间	设置 → 提醒	09:05
每月 1 日账单预告	设置 → 提醒	开启
公开页	设置 → 开放	关闭
AI 连接（MCP）	设置 → 开放	开启
最多同时登录	设置 → 安全	10 台

路由

路径	内容
/	登录后跳转到设置中的启动页
/overview	概览
/list	订阅
/calendar	日历
/report	报告
/wallet	钱包
/family	合租与人员
/behalf	代付
/assistant	内置 AI 助手
/connect	AI 接入与 MCP 连接页
/settings	设置
/login	登录与首次设置密码
/public	只读公开页，仅在设置中开启后可访问
/api/*	应用与公开页用的接口
/mcp	MCP 服务端点；浏览器打开时跳转到 /connect
/cal/<令牌>.ics	日历订阅

未登录访问应用页面时，会跳转到 /login?next=...，登录后返回原页面。例如访问 /wallet 会先进入 /login?next=wallet，登录后回到 /wallet。

未登录访客打开 / 时，若已开启公开页则跳转到 /public，否则跳转到 /login。