• 简体中文
  • 环境变量

    必填

    变量说明
    GITHUB_TOKENFine-grained PAT,单仓库,Contents: Read and write
    COMMENTS_REPOowner/repo,评论数据仓库
    COMMENTS_SECRET至少 32 字节,HKDF 主密钥
    SELF_ORIGIN评论系统自身 URL,无尾斜杠
    ALLOWED_ORIGINS逗号分隔的博客 Origin
    TURNSTILE_SITE_KEYCloudflare Turnstile site key
    TURNSTILE_SECRETCloudflare Turnstile secret key

    Turnstile 始终必填,与是否开启人工审核无关。

    审核与发件

    变量默认何时必填说明
    MODERATION_REQUIREDtrue否true 走邮件审核;false 直接写入
    MODERATOR_EMAIL—仅审核开启审核邮件收件人
    MAIL_PROVIDER自动否resend 或 mailport
    RESEND_API_KEY—审核开启且用 Resend
    RESEND_FROM—随 RESEND_API_KEYName <addr@domain>
    MAILPORT_BASE_URL—审核开启且用 MailPort无尾斜杠
    MAILPORT_PID—随 MailPort5–10 位路由 id
    MAILPORT_API_KEY—随 MailPort32 位密钥

    发件选择:

    1. MAIL_PROVIDER 显式指定 → 用指定的;对应组不完整则 health 为 degraded
    2. 未指定 → 只配 Resend 用 Resend;只配 MailPort 用 MailPort;都配默认 Resend
    3. 都缺 → submit 返回 503 mail_not_configured

    可选

    变量默认说明
    COMMENTS_BRANCHmain写入分支
    COMMENTS_PATHcomments仓库内目录,无首尾斜杠
    SELF_REPO空仅用于 /api/health 同仓告警比对

    没有 SAME_REPO 开关。同仓/异仓由 COMMENTS_REPO 的值决定。

    启动校验

    配置不完整时服务不会崩溃,而是:

    • /api/health 返回 503 与 degraded
    • 缺失配置涉及的接口返回 503
    • 未涉及的接口正常工作