跳转到内容

首次设置

部署完成后,用本页设置登录密码、Passkey、语言、本位币和时区。

新部署的账本还没有密码。为了防止陌生人抢先占用,第一次设置密码时必须提供部署时配置的初始化令牌 SETUP_TOKEN。

  1. 打开 https://calends.example.com/admin。页面会提示「首次使用,请设置登录密码。」
  2. 在「初始化令牌(SETUP_TOKEN)」里填入令牌:
    • Cloudflare:你用 wrangler secret put SETUP_TOKEN 设置的那串字符;
    • Docker:容器第一次启动时打印在日志里(docker logs calends),同时保存在数据目录的 setup-token 文件里。也可以自己用环境变量 SETUP_TOKEN 指定。
  3. 填写新密码(至少 8 位)并再输一次,点「设置并进入」。

设置完成后,初始化令牌就用不到了。密码以 PBKDF2-SHA256 加盐哈希保存,服务端不保存明文。

进入「设置 → 安全」,点「添加 Passkey」。之后在登录页可以选「用 Passkey 登录」,用面容、指纹或设备密码登录,不用输入密码。每台设备、每个密码管理器可以各绑一个。

Passkey 需要 HTTPS。Cloudflare 的 workers.dev 地址和自定义域名天然是 HTTPS;Docker 部署请先配好反向代理,见自定义域名与 HTTPS。

更多登录相关的设置见登录与设备。

在「设置 → 通用」里:

设置 说明
语言 界面、提醒消息和 MCP 返回文字使用的语言,共 14 种。选「跟随系统」时界面跟随浏览器,提醒和 MCP 使用后台最近一次实际使用的语言。
名字 显示在年度回顾分享图和公开页上。
头像 侧边栏、公开页和合租里「我」的头像。可以填图片链接或上传图片(PNG、JPEG、WebP、GIF、SVG);不设置时用 Calends 图标。
打开后先看 打开 /admin 时进入的页面:概览、订阅、日历、报告或钱包。
本位币 所有金额折算成的币种,默认 USD。随时可以换,历史数据会按新本位币重新折算。
时区 决定「今天」是哪一天,以及提醒按哪个时区的整点发送。默认 UTC。
每周从 日历的每周起始日:周一(默认)或周日。