安全与限制配置

• 安全与限制配置位于 /system-settings/security，仅 Root 可访问。
• 该工作区包含「速率限制」「SSRF 保护」和「令牌限制」三个分区，用于控制模型请求频率、出站访问安全与密钥数量。

安全与限制配置简介

安全与限制域下有三个独立分区：

配置分区

速率限制

• 安全与限制-速率限制

• 全局限制

• 基于分组的速率限制

除全局限制外，可以为特定分组（用户分组或 API 密钥分组）覆盖设置每周期最大请求数（含失败）和最大成功请求数。
分组规则 JSON 结构为 {"分组名":[最大请求数（含失败）,成功请求数]}：
规则可通过表格可视化编辑器维护，支持搜索、添加、编辑与删除；也可切换到 JSON 模式直接编辑原始 JSON。

操作流程：

1. 点击「添加分组」。
2. 在弹窗中输入分组名称（须与用户分组或 API 密钥分组的名称完全一致），填写最大请求数（含失败）与最大成功请求数。
3. 点击「添加」，再点击页头「保存速率限制」写入（编辑、删除规则后同样需要保存）；需要精确控制时可切换到 JSON 模式。

• 安全与限制-添加分组

• 安全与限制-编辑分组

• 相关环境变量

除页面上的四项速率限制配置外，安全与限制还涉及以下启动时环境变量（主要是全局限流）。

（下载与上传另有 DownloadRateLimitNum / UploadRateLimitNum，默认 10。）

各变量的作用范围：

• Global API：作用于所有 /api/* 路由，按客户端 IP 计数。
• Global Web：作用于 web 页面/路由，按 IP 计数。
• Critical：作用于注册、登录、密码重置、OAuth state/回调、Passkey、Access Token、2FA 验证、验证码等关键/匿名接口，按 IP计数。
• Search：作用于搜索端点，按用户计数。

SSRF 保护

• 安全与限制-SSRF 保护

SSRF 防护用于限制服务端出站 HTTP 请求允许访问的域名与 IP，避免请求被用于访问内网或回环地址。共 8 个字段：

执行边界：

• 生效于受保护出站 HTTP 客户端、下载请求、Midjourney 图片拉取、视频代理、Webhook 与 Bark/Gotify 通知等出站请求；转发到上游渠道的请求本身不做 SSRF 检查。
• 仅允许 http:// / https:// 地址；域名解析失败会报错。
• 对域名同时校验「请求时」与「拨号时」（dial-time），避免解析后回环 IP 绕过；拨号时的校验仅在开启「对已解析的域应用 IP 筛选器」且请求不经代理时生效。

令牌限制

• 安全与限制-令牌限制

「令牌限制」只有「每个用户的最大令牌数」一个字段（默认 1000），控制每个用户可创建的最大令牌数量（设置过大可能会影响性能）；在创建 API 密钥（POST /api/token）时校验：当前用户密钥数达到上限后，新密钥会被拒绝。

保存与生效

保存方式见系统设置概览，生效与多实例同步规则见生效范围与多实例同步。未特别说明时，保存后处理该请求的节点立即使用新值，其他节点随系统设置同步（默认 60 秒）；各配置项读取新值的时机如下：

补充说明

• 没有改动：SSRF 保护没有改动时提示「没有需要保存的更改」。
• 逐项提交：各分区按字段逐项保存：先计算变更字段，再对每个变更字段单独提交 PUT /api/option/。
• SSRF 列表的存储：SSRF 的列表字段以 JSON 字符串保存：域名列表、IP 列表按每行一个，允许端口按逗号分隔，转换为数组后提交。

注意事项

限流与令牌

• 速率限制：只作用于模型请求路由、按登录用户计数；全局 Global/API/Web/Critical 限流由环境变量控制、按 IP 计数，二者相互独立。
• 分组规则共享窗口：分组仅覆盖次数，窗口与全局一致。
• 令牌限制：是每用户密钥数量上限，达到上限后创建被拒；密钥数超过上限（如调低上限后）时，带 % 通配符的模糊搜索会被拒绝，只能精确搜索。

SSRF 与失败方式

• SSRF 私网范围：关闭「允许私有 IP」会拦截比界面列出网段更广的 IANA 私有/保留段。
• SSRF 黑白名单语义：白名单为空=全部阻断，黑名单为空=全部放行；域名通配只在域名层生效，IP 过滤在解析后对每个 IP 生效。
• SSRF 默认端口：后端默认 80/443/8080/8443；为空表示全部端口允许。
• 失败方式：机制为「阻止并返回错误」，不是静默重试：限流、SSRF 命中时对应请求都会失败，客户端按错误处理即可。

常见问题

相关文档

• 系统设置概览：系统设置的生效机制、多实例同步、敏感配置与变更验证要求。
• 请求策略配置：请求检查（原「敏感词」）、重试、会话保持与渠道健康。
• API 密钥：API 密钥的创建、分组与模型限制。
• 使用日志：查看请求详情；被速率限制拒绝的模型请求不会写入使用日志。