站点设置域

通用读取需要 system.settings.read。通常通过 PUT /api/v1/admin/settings/{domain} 保存并携带 If-Match 版本；版本冲突后刷新、比较再保存。含密钥设置需要再验证。下表页面均位于后台 /admin/settings/*，专用资源除外。

域	用途与关键参数	修改权限 / 边界	密钥
install	用途与关键参数初始化状态，完成前业务不可用	修改权限 / 边界仅初始化流程	密钥否
site	用途与关键参数名称、描述、条款、隐私、结算币种、业务时区、主题；官网落地页与站点内容页（草稿后发布）	修改权限 / 边界system.settings.manage；首单后币种固定	密钥否
i18n	用途与关键参数默认/启用语言、自动翻译、术语表、提供商顺序、预算和语言映射	修改权限 / 边界system.i18n.manage	密钥是
auth	用途与关键参数注册策略（邮箱后缀、仅限邀请）、OAuth/OIDC、短信与 Telegram 登录	修改权限 / 边界iam.auth_provider.manage	密钥是
auth_providers	用途与关键参数Google、GitHub、Microsoft、Discord、OIDC、手机号开关、Telegram 机器人引用、原生客户端白名单	修改权限 / 边界iam.auth_provider.manage	密钥是
auth_keys	用途与关键参数随机生成的认证签名密钥与密码 pepper	修改权限 / 边界内部域，不提供通用接口	密钥是
captcha	用途与关键参数各场景 Turnstile、Cap、图形验证码	修改权限 / 边界iam.auth_provider.manage	密钥是
commerce	用途与关键参数order_ttl_minutes（默认 30）、汇率、自动续费、余额支付与退款默认值	修改权限 / 边界commerce.channel.manage；渠道实例另存	密钥否
apple	用途与关键参数Apple App Store 集成（默认关闭，私钥加密保存）	修改权限 / 边界commerce.channel.manage	密钥是
plan_change	用途与关键参数套餐升降级：流量折算、超额处理、退订退款方式	修改权限 / 边界system.settings.manage	密钥否
paid_reset	用途与关键参数按规格配置的付费流量重置价格	修改权限 / 边界catalog.price.manage	密钥否
checkout_links	用途与关键参数签名结账链接允许的返回地址	修改权限 / 边界growth.coupon.manage	密钥否
network	用途与关键参数DNS、出站、路由、IP 策略、标签显示、时段倍率	修改权限 / 边界network.runtime.manage	密钥否
distribution	用途与关键参数客户端、域名、更新间隔、命名、过滤、线路、健康开关、用户参数、模板版本规则与灰度、泄露检测、用户自定义规则策略	修改权限 / 边界专用接口；distribution.client.manage / distribution.filter.manage / distribution.template.manage	密钥否
carriers	用途与关键参数自动生成的 ASN 运营商分组、名称、隐藏	修改权限 / 边界专用 carriers 接口；distribution.filter.manage	密钥否
growth	用途与关键参数佣金订单类型、冻结、等级周期、邀请奖励、风控、提现费用、默认关闭的 trial、commission_transfer_reauth	修改权限 / 边界growth.referral.manage；字段严格 snake_case	密钥否
marketing	用途与关键参数营销邮件七天频控与退订来源	修改权限 / 边界notify.provider.manage	密钥否
bulk_policy	用途与关键参数批量操作需要第二人审批的人数与金额阈值	修改权限 / 边界system.settings.manage	密钥否
notify	用途与关键参数发件人、按顺序回退的提供商、速率、HTTP 邮件；SMTP 仅自托管	修改权限 / 边界notify.provider.manage	密钥是
notify_channels	用途与关键参数短信、Telegram 提供商与每日摘要	修改权限 / 边界notify.provider.manage	密钥是
notify_keys	用途与关键参数收件地址哈希密钥	修改权限 / 边界内部域，不提供通用接口	密钥是
telegram_support	用途与关键参数Telegram 工单镜像（默认关闭）	修改权限 / 边界notify.provider.manage	密钥否
storage	用途与关键参数各桶驱动（R2 绑定、S3、本地目录）、公开基础地址、5–16 MiB 分片、类型/大小限制、上传配额；自托管桶凭证	修改权限 / 边界system.settings.manage；只能收窄内置限制	密钥是
support	用途与关键参数教程开关、页脚、工单分类与 SLA 时长	修改权限 / 边界system.settings.manage	密钥否
security	用途与关键参数限流、只能缩短的会话上限、admin_ip_allowlist	修改权限 / 边界system.settings.manage；空 IP 列表不限制	密钥否
retention	用途与关键参数日志、聚合、审计、文件等保留期；每类数据由所属模块清理并写审计	修改权限 / 边界专用接口；ops.privacy.manage，再验证	密钥否
privacy	用途与关键参数注销冷静期（默认 30 天，1–90）	修改权限 / 边界专用接口；ops.privacy.manage，再验证	密钥否
alerts	用途与关键参数告警路由（异常类型、级别、接收员工、通道、节流）	修改权限 / 边界专用接口；ops.exception.manage	密钥否
checkout_keys	用途与关键参数签名结账链接的签名密钥	修改权限 / 边界内部域，不提供通用接口	密钥是
maintenance	用途与关键参数维护开关与建议重试秒数	修改权限 / 边界专用接口；system.maintenance.manage（预置角色中只有 root），再验证；通用接口不能写	密钥否

出站 Webhook 端点不是设置域，在后台“通知 → Webhook”管理。

安全保存复制标题链接

未知字段拒绝，false、0、空字符串原样保存。读取密钥返回 { "set": true }；保存时省略字段或保留该标记表示不变，null 清除。不要用空白表单意外清掉凭据。可以先保存草稿、查看差异再发布；发布与回滚需要 system.settings.publish，含密钥的域还需要再验证。

翻译可能将运营内容发送给第三方，启用前审核数据范围和提供商。主密钥轮换与认证签名密钥轮换是不同操作；新增主密钥版本后，在运维工作台启动全域重新加密，用清点确认旧版本密文为 0 后才移除旧版本。请查备份恢复。