安全与上生产

两把密钥§

GPT-Load 有两把用途完全不同的密钥，别混淆：

两把都可以在 .env 里显式指定；不指定时， 首次启动会自动生成并存放在数据目录下的 auth.key 与 encryption.key。

备份§

数据库和加密密钥必须成套备份。自动生成的 auth.key 与 encryption.key 在数据目录中； 显式设置的 AUTH_KEY 与 ENCRYPTION_KEY 则要从原来的 环境变量或密钥管理服务单独备份。

备份文件本身包含可解密的凭据， 要按敏感数据对待——加密存放，不要丢进公开的网盘或仓库。

换数据库驱动、迁移服务器时的注意事项见 数据库与备份。

网络边界§

服务默认只监听 127.0.0.1，也就是只有本机能访问。 这是有意的默认值——管理台一旦暴露到公网， 拿到 AUTH_KEY 就等于拿到了你所有的上游凭据。

需要远程访问时，按风险从低到高：

1. SSH 端口转发——最安全，不需要改任何服务配置：

ssh -L 3001:127.0.0.1:3001 user@your-server
# 然后在本机浏览器打开 http://127.0.0.1:3001

2. 内网 / VPN——只在受控网络内暴露
3. 反向代理 + TLS + 访问控制——确实需要公网访问时，见下一节

反向代理§

用 Nginx、Caddy 一类在前面挡一层，至少要做到三件事：启用 HTTPS、限制来源、不要把管理台和数据面一起裸奔。

server {
    listen 443 ssl;
    server_name gateway.example.com;

    # 证书配置略

    # 管理面：只允许可信来源
    location /api/ {
        allow 203.0.113.0/24;
        deny all;
        proxy_pass http://127.0.0.1:3001;
    }

    # 数据面：按需开放，注意流式响应要关缓冲
    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_buffering off;
        proxy_read_timeout 600s;
    }
}

proxy_buffering off 和较长的读超时是必要的—— 流式响应如果被代理缓冲住，客户端会一直等不到输出。

文件权限§

受管的数据目录会被收紧到仅属主可访问， 程序启动时自动处理，通常不需要你干预：

• 数据目录：0700（仅属主可读写执行）
• 数据库文件与两把密钥：0600（仅属主可读写）
• Windows 上使用当前用户专属的 ACL

如果无法确认目录归属或链接类型，程序会拒绝启动而不是降级运行——这是有意的，避免在权限不明的位置写入凭据。

不要泄漏的东西§

• 两把密钥——不要提交到仓库、贴进 issue、发在群里
• 备份文件——它包含可解密的凭据
• 截图——管理台截图里常带账号邮箱和密钥后缀， 发出去之前先打码
• 访问密钥——虽然可以吊销，但泄漏期间的用量是真金白银

发现安全问题请按仓库 SECURITY.md 里的流程私下反馈，不要开公开 issue。

上生产清单§

逐条确认，再让真实流量进来：

• 密钥——AUTH_KEY 与 ENCRYPTION_KEY 已显式设置或已确认自动生成的值被备份
• 备份——数据库和 encryption.key 一起备过，并且验证过能恢复
• 网络——没有把服务直接绑到 0.0.0.0 暴露公网； 远程访问走 SSH 转发、内网或带 TLS 的反向代理
• 管理面——/api 有来源限制，没有对公网开放
• 访问密钥——按应用分别发放，设置了合理的限流与成本上限
• 监控——知道去哪看健康状态与请求日志，见 监控与排障
• 边界认知——理解成本是估算、2.0 面向单实例部署