AutoGPT 后端因 JWT_JWKS_URL 为明文 HTTP 拒绝启动怎么解决？

AutoGPT 后端因 JWT_JWKS_URL 为明文 HTTP 拒绝启动怎么解决？

【免费下载链接】AutoGPTAutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.项目地址: https://gitcode.com/GitHub_Trending/au/AutoGPT

自托管 AutoGPT Platform 时，后端（backend）启动阶段会校验一个名为JWT_JWKS_URL的环境变量：它指向前端内嵌 Better Auth 服务发布的 JWKS 密钥端点（.../api/auth/jwks）。后端的登录令牌校验完全信任这个 URL 返回的签名密钥，因此当JWT_JWKS_URL是明文http://且指向非本地主机时，后端会直接抛出AuthConfigError拒绝启动。典型报错是：

JWT_JWKS_URL fetches keys over cleartext http:// from a non-local host ('...'). The backend trusts whatever keys that URL returns, so an attacker in the path could substitute them and forge tokens for any user. Use https://, or set JWKS_ALLOW_INSECURE_TRANSPORT=true if the network path is trusted.

这篇文章解决的就是这个启动失败：先判断你的部署拓扑属于哪种情况，再按对应路径修改配置，最后用日志确认后端已正常起来。校验逻辑在 auth 配置模块 中，安全说明在 getting-started.md 的 "Auth transport security" 一节。

先确认你的部署属于哪种情况

报错并不是"任何 http 都不行"。按 config.py 的判定规则，以下情况不会被拒绝：

• localhost、127.0.0.1、::1开头的http://URL；
• 单标签容器服务名（如http://frontend:3000），这是 Docker 内部私有网络的服务发现主机名，被视为与 loopback 同等可信；
• 任何https://URL。

会被拒绝的只有一种：http://+ 非本地主机名（带.或:的完整域名，例如http://auth.example.com/api/auth/jwks）。对应的测试用例见 config_test.py。

据此对照你的环境：

1. 单机 Docker Compose 安装（后端和前端在同一台机器的同一 compose 网络里）：默认值就是http://frontend:3000/api/auth/jwks（见 docker-compose.platform.yml 第 34 行），属于单标签主机名，不需要改任何东西。如果你遇到了这个报错，说明你的JWT_JWKS_URL被手动改成了完整域名的http://地址，按下面的方案一或方案二处理。
2. 后端与前端分部署在不同机器（LAN 拆分或对外暴露）：走方案一（改https）；网络路径完全可信时才走方案二（放行开关）。

方案一：把 JWT_JWKS_URL 指到 https 地址（不信任网络上的首选）

当后端和前端分处不同机器、或对外公开访问时，文档明确建议走https：明文获取 JWKS 会被网络路径上的攻击者截获，而替换密钥等于能给任意用户伪造令牌。

操作路径（见 getting-started.md）：

1. 给前端套上 TLS 反向代理，或者用本地受信证书（文档给出的示例工具是 mkcert）；
2. 把JWT_JWKS_URL指向https://地址。修改位置取决于你的启动方式：
   • Docker 部署：改 backend/.env 中的JWT_JWKS_URL（该文件由 backend/.env.default 提供默认值与说明注释，make init-env只在.env不存在时创建它，不会覆盖你已有的文件）；
   • 本地直接跑后端（poetry run app/make run-backend）：改autogpt_platform/backend/.env后重启即可。
3. 重启后端（docker compose up -d或重新poetry run app）。

方案二：网络路径可信时，用 JWKS_ALLOW_INSECURE_TRANSPORT 放行

如果你确认后端到前端的链路是可信的（文档举例：隔离的私有 LAN），可以不升级 TLS，改在autogpt_platform/backend/.env中加一行：

JWKS_ALLOW_INSECURE_TRANSPORT=true

该开关接受1、true、yes（不区分大小写，见 config.py 与 config_test.py 的参数化用例）。设置后后端可以正常启动，但每次启动都会向日志写入一条警告，大意是 JWKS 密钥正在从非本地主机经明文 http 获取、链路上任何人可替换密钥伪造令牌——这是故意留痕，让取舍在日志中可见。

两点边界，直接来自项目文档：

• SECURITY.md 说明这项明文检查是"尽力而为的操作者提示，不是安全边界"，它只是警告、永不阻止启动（指警告路径本身），保障后端到 JWKS 端点之间网络安全的责任在运维方；
• getting-started.md 指出这是无状态 JWT/JWKS 校验的通用属性，标准单机 Docker 安装不需要做任何改动。

验证是否解决

1. 重启后端后查日志：
   • 配置校验通过：不再出现上面那段cleartext http://报错，容器/进程不再退出循环；
   • 若走了方案二，日志中应出现文档描述的JWKS_ALLOW_INSECURE_TRANSPORT is enabled启动警告（含你配置的主机名），这属于预期行为而非故障；
2. 按 getting-started.md 的端口说明确认服务在监听：前端 UI 3000、后端 WebSocket 8001、执行 API REST 8006，浏览器访问http://localhost:3000能打开界面。

顺带核对：URL 本身的合法性

如果报错信息不是"cleartext"而是Invalid JWT_JWKS_URL，那是另一类配置错误，同样在启动时抛出：

• 必须以http://或https://开头，localhost:3000/jwks、ftp://...这类写法会被拒；
• 主机部分必须是可解析的（例如不闭合的 IPv6 括号http://[::1/...会在启动时报Invalid JWT_JWKS_URL而不是留到首次请求时报晦涩错误）；
• JWT_JWKS_URL是必填项，未设置时报错会提示它指向平台认证服务的 JWKS 端点（示例形如https://<frontend-host>/api/auth/jwks），且不能用JWT_VERIFY_KEY替代——后者只覆盖 Supabase HS256 旧令牌的过渡期。

修完配置后，若仍反复重启，用docker compose logs backend（Docker 部署）观察AuthConfigError的具体消息，它会指明当前拒绝的确切原因（URL 缺失、URL 非法、还是明文传输），对照本文对应小节处理即可。

【免费下载链接】AutoGPTAutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.项目地址: https://gitcode.com/GitHub_Trending/au/AutoGPT