[Bug]配置 socks5 系统代理，检查更新模块 (aiohttp) 报错 Server disconnected

[dongfangxiyu]

What happened / 发生了什么

在更新到最新版本4.23.1的 AstrBot 后，控制台不断报出 解析版本信息时发生异常: Server disconnected 的错误，导致无法正常获取项目更新。

经过排查发现，原因可能在于新版本的更新检查模块使用了 aiohttp，而 aiohttp 原生不支持读取系统环境变量中的 socks5:// 代理协议（需要额外配置 aiohttp-socks）。当它读取到系统的 socks5 代理配置时，会导致连接瞬间被代理服务器掐断。

由于 AstrBot 的 Telegram 适配器目前没有独立的代理配置项，为了维持 Telegram bot 的长连接稳定（长轮询），宿主机/容器必须配置全局的 socks5 代理（走 HTTP 代理会导致 TG 频繁断连）。这就导致了 Telegram 的网络需求与 aiohttp 的代理兼容性产生了不可调和的冲突。

顺带一提，在上一个版本的 AstrBot 中配置同样的 socks5 环境变量，并没有出现无法检测更新的报错，猜测是底层网络请求库发生了变更。

Reproduce / 如何复现？

1. 配置socks5系统代理
2. 重启AstrBot
3. 点击WebUI右上角的“更新AstrBot”
4. 观察AstrBot控制台输出

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

4.23.1，Docker Compose，此bug与提供商无关，Telegram

OS

Linux

Logs / 报错日志

[2026-04-15 22:18:24.103] [Core] [ERRO] [v4.23.1] [core.zip_updator:84]: 解析版本信息时发生异常: Server disconnected
[2026-04-15 22:18:24.103] [Core] [WARN] [v4.23.1] [routes.update:77]: 检查更新失败: 解析版本信息失败 (不影响除项目更新外的正常使用)
[2026-04-15 22:18:24.119] [Core] [ERRO] [v4.23.1] [core.zip_updator:84]: 解析版本信息时发生异常: Server disconnected
[2026-04-15 22:18:24.132] [Core] [ERRO] [v4.23.1] [routes.update:85]: /api/update/releases: Traceback (most recent call last):
File "/AstrBot/astrbot/core/zip_updator.py", line 56, in fetch_release_info
session.get(url) as response,
^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.12/site-packages/aiohttp/client.py", line 1521, in aenter
self._resp: _RetType = await self._coro
^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.12/site-packages/aiohttp/client.py", line 788, in _request
resp = await handler(req)
^^^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.12/site-packages/aiohttp/client.py", line 742, in _connect_and_send_request
conn = await self._connector.connect(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.12/site-packages/aiohttp/connector.py", line 672, in connect
proto = await self._create_connection(req, traces, timeout)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.12/site-packages/aiohttp/connector.py", line 1249, in _create_connection
_, proto = await self._create_proxy_connection(req, traces, timeout)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.12/site-packages/aiohttp/connector.py", line 1668, in _create_proxy_connection
resp = await proxy_resp.start(conn)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.12/site-packages/aiohttp/client_reqrep.py", line 539, in start
message, payload = await protocol.read() # type: ignore[union-attr]
^^^^^^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.12/site-packages/aiohttp/streams.py", line 707, in read
await self._waiter
aiohttp.client_exceptions.ServerDisconnectedError: Server disconnected

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
File "/AstrBot/astrbot/dashboard/routes/update.py", line 82, in get_releases
ret = await self.astrbot_updator.get_releases()
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/AstrBot/astrbot/core/updator.py", line 145, in get_releases
return await self.fetch_release_info(self.ASTRBOT_RELEASE_API)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/AstrBot/astrbot/core/zip_updator.py", line 85, in fetch_release_info
raise Exception("解析版本信息失败")
Exception: 解析版本信息失败

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]

你的分析是正确的。更新检查模块在 zip_updator.py 中创建 aiohttp.ClientSession 时使用了 trust_env=True [1]，这会让 aiohttp 自动读取系统环境变量中的代理配置。但 aiohttp 原生不支持 socks5 代理协议——当它读取到 socks5:// 的代理地址时，会尝试将其当作 HTTP 代理进行 CONNECT 隧道连接，导致代理服务器直接断开连接，出现 Server disconnected 错误。

项目已经通过 PR #7093 和 PR #7221 添加了 python-socks / pysocks 等 socks5 相关依赖 [2] [3]，但这些主要服务于 httpx 等其他 HTTP 客户端，aiohttp 的更新检查模块并未受益。

可能的解决方向：

1. 在 zip_updator.py 中使用 aiohttp-socks 库替换默认的 TCPConnector，让 aiohttp 原生支持 socks5 代理
2. 或者将更新检查的 HTTP 请求从 aiohttp 切换到已具备 socks5 支持的 httpx
3. 作为临时 workaround，可以设置 no_proxy 环境变量来排除 GitHub API 域名（如 api.github.com），或将 ALL_PROXY/HTTPS_PROXY 仅在需要时设置为 socks5

临时缓解方案：在环境变量中添加 no_proxy=api.github.com,github.com 可以让更新检查绕过 socks5 代理直接连接（前提是宿主机可以直连 GitHub）。如果不能直连，则需要等待代码层面的修复。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}
  

[dongfangxiyu]

@dosu 建议为Telegram适配器添加单独的代理选项以避免系统代理成为必须。

[dosubot]

这个需求已经有多位用户提出过了：#7444 [1] 和 #5983 [2] 都是类似的 Feature Request。

目前 Discord 适配器已经实现了独立代理配置，可以作为参考模式。具体来说，Discord 通过 discord_proxy 配置字段将代理地址显式传递给底层库 [3]，而 Telegram 适配器当前完全依赖全局环境变量 http_proxy/https_proxy [4]，ApplicationBuilder 构建时没有传入任何代理参数 [5]。

参照 Discord 的模式，为 Telegram 添加独立代理大致需要：

1. 在配置模板中添加 telegram_proxy 字段 [6]
2. 在 TelegramPlatformAdapter 中读取该配置
3. 在 ApplicationBuilder 链中通过 .proxy() 或 .proxy_url() 传入代理地址
4. 空值时回退到全局代理或不使用代理

这样就能解决当前 socks5 全局代理与 aiohttp 不兼容的冲突——Telegram 使用独立的 socks5 代理配置，其他模块不受影响。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}