[Bug]系统 http_proxy 环境变量干扰 localhost API 请求

[MS33834]

What happened / 发生了什么

系统设置了 http_proxy / https_proxy 环境变量后（如 Clash 代理），
AstrBot 的 Dashboard 前端和所有 API 对 localhost 的请求也通过代理发送，
导致所有本地 API 调用失败（返回空响应或超时）。

必须显式绕过代理（如 curl --noproxy '*' 或在代码中设置 NO_PROXY=localhost）
才能正常访问。

类似 issue 在一些 Python Web 框架中是已知问题，建议在启动时自动设置
NO_PROXY 包含 localhost,127.0.0.1。

Reproduce / 如何复现？

1. 设置 https_proxy=http://127.0.0.1:7890
2. 启动 AstrBot
3. curl http://localhost:6185/api/auth/login → 无响应（连接超时）
4. 注意到 curl 尝试通过代理连接 localhost
5. 使用 curl --noproxy '*' http://localhost:6185/api/auth/login → 正常返回

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

AstrBot: v4.25.5
部署方式: Windows 本地 Python venv 直接运行
Python: 3.12.13
代理: Clash (FLClash, mixed-port 7890)

OS

Windows

Logs / 报错日志

curl -v http://localhost:6185/api/auth/login

• Uses proxy env variable https_proxy == 'http://127.0.0.1:7890'
• Trying 127.0.0.1:7890...
• connect to 127.0.0.1 port 7890 failed: Connection refused
• Failed to connect to localhost port 6185 after 0 ms

加上 --noproxy '*' 后正常:
HTTP/1.1 200 OK

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

这个问题的根因是：当你没有在 AstrBot 配置中设置 http_proxy 时，AstrBot 启动代码会主动清除环境变量中的 http_proxy/https_proxy/no_proxy [1]。但问题在于你的场景是系统级环境变量已设置代理，而 AstrBot 配置中没有填写代理——这导致 AstrBot 虽然清除了进程内的环境变量，但 Dashboard 前端（浏览器/curl）仍然受系统环境变量影响。

实际上，AstrBot 在配置中已有默认的 no_proxy 列表，包含 localhost, 127.0.0.1, ::1, 10.*, 192.168.* [2]，但这只在 AstrBot 配置了 http_proxy 时才会被写入环境变量。

临时解决方案：

在启动 AstrBot 前，手动设置环境变量：

set NO_PROXY=localhost,127.0.0.1,::1

或者在 AstrBot 配置中填入你的代理地址（http_proxy 字段），这样 AstrBot 会自动设置 no_proxy 环境变量来绕过本地地址。

建议的代码修复方向：

启动时无论是否配置了代理，都应确保 no_proxy 包含 localhost 相关地址。当前逻辑是"如果没配置代理就清除所有代理变量"，但更合理的做法是：即使不主动配置代理，也应设置 no_proxy=localhost,127.0.0.1 以防系统级代理干扰。相关代码在 AstrBotCoreLifecycle.__init__() 中 [1]。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[MS33834]

@dosu 经过重新复盘和抓包验证，此问题的根因已彻底查明。

结论：这不是 AstrBot 的代码 Bug，而是典型的“系统全局代理误杀本地回环”的环境配置痛点。因此无需修改核心网络逻辑。

外部客户端（浏览器/curl）访问 localhost:6185 超时，本质是因为 Windows 系统全局环境变量 https_proxy 拦截了本地流量，而系统或代理软件（如 Clash）未配置 Bypass 规则。AstrBot 作为服务端，无法越权干涉客户端的网络栈行为。

虽然不需要修 Bug，但这个“坑”对新手极不友好。为了提升用户体验，建议维护者从以下两个维度进行优化（Enhancement / Documentation）：

1. 文档层面 (Documentation)：
建议在官方文档的 FAQ 或 Troubleshooting 章节，补充关于代理环境的说明：提醒用户在系统环境变量中配置 no_proxy=localhost,127.0.0.1，或在 Clash 等代理软件中勾选“绕过局域网/本地地址”。

2. 代码层面 (Enhancement - 启动环境检测)：
建议在后端启动阶段（如 AstrBotCoreLifecycle 初始化时）增加一个轻量级的环境检测：

• 如果检测到系统存在 http_proxy/https_proxy，但 no_proxy 未包含 localhost；
• 则在控制台打印一行醒目的黄色 Warning 日志（例如：[Warning] 检测到系统全局代理，若 Dashboard 无法访问，请在代理软件中设置绕过 localhost 或配置 NO_PROXY 环境变量）。
  这样能将排错成本降到最低，直接“防患于未然”。

后续操作：
我将保留此 Issue 的 Open 状态，并建议维护者将标签从 bug 更改为 enhancement 或 documentation。期待后续能在文档或启动日志中看到相关优化，待优化落地后，再由维护者关闭此 Issue。感谢社区！

[dosubot]

感谢你的详细复盘和建设性建议！你的分析很到位。

补充一个发现：当前 AstrBot 在未配置代理时，启动代码会主动清除系统环境变量中的 http_proxy/https_proxy/no_proxy [1]。这意味着对于 AstrBot 进程内部的请求，系统代理实际上已被移除。但正如你所说，这无法影响外部客户端（浏览器/curl）的行为。

关于你提出的两个优化方向：

启动环境检测的实现位置确实可以放在 AstrBotCoreLifecycle.__init__() 的 proxy 处理逻辑附近 [2]。建议在清除代理变量之前先检测原始系统环境，如果发现 http_proxy/https_proxy 已设置且 no_proxy 未包含 localhost，输出一条 warning 级别日志。当前所有代理相关日志都是 debug 级别，普通用户看不到。

这两个建议（文档 + 启动 warning）都是低成本高收益的改进，很值得落地。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.