首次设置
部署完成后,用本页设置登录密码、Passkey、语言、本位币和时区。
新部署的账本还没有密码。为了防止陌生人抢先占用,第一次设置密码时必须提供部署时配置的初始化令牌 SETUP_TOKEN。
- 打开
https://calends.example.com/admin。页面会提示「首次使用,请设置登录密码。」 - 在「初始化令牌(SETUP_TOKEN)」里填入令牌:
- Cloudflare:你用
wrangler secret put SETUP_TOKEN设置的那串字符; - Docker:容器第一次启动时打印在日志里(
docker logs calends),同时保存在数据目录的setup-token文件里。也可以自己用环境变量SETUP_TOKEN指定。
- Cloudflare:你用
- 填写新密码(至少 8 位)并再输一次,点「设置并进入」。
设置完成后,初始化令牌就用不到了。密码以 PBKDF2-SHA256 加盐哈希保存,服务端不保存明文。
绑定 Passkey
Section titled “绑定 Passkey”进入「设置 → 安全」,点「添加 Passkey」。之后在登录页可以选「用 Passkey 登录」,用面容、指纹或设备密码登录,不用输入密码。每台设备、每个密码管理器可以各绑一个。
Passkey 需要 HTTPS。Cloudflare 的 workers.dev 地址和自定义域名天然是 HTTPS;Docker 部署请先配好反向代理,见自定义域名与 HTTPS。
更多登录相关的设置见登录与设备。
在「设置 → 通用」里:
| 设置 | 说明 |
|---|---|
| 语言 | 界面、提醒消息和 MCP 返回文字使用的语言,共 14 种。选「跟随系统」时界面跟随浏览器,提醒和 MCP 使用后台最近一次实际使用的语言。 |
| 名字 | 显示在年度回顾分享图和公开页上。 |
| 头像 | 侧边栏、公开页和合租里「我」的头像。可以填图片链接或上传图片(PNG、JPEG、WebP、GIF、SVG);不设置时用 Calends 图标。 |
| 打开后先看 | 打开 /admin 时进入的页面:概览、订阅、日历、报告或钱包。 |
| 本位币 | 所有金额折算成的币种,默认 USD。随时可以换,历史数据会按新本位币重新折算。 |
| 时区 | 决定「今天」是哪一天,以及提醒按哪个时区的整点发送。默认 UTC。 |
| 每周从 | 日历的每周起始日:周一(默认)或周日。 |