PanWatch HTTP 代理配置详解：海外数据源访问的三种配置方式
【免费下载链接】PanWatchPanWatch — AI stock monitoring for A-shares, HK & US markets, powered by TradingAgents. Portfolio insights, real-time alerts & automated reports.｜盯盘侠：覆盖 A股/港股/美股的 AI 盯盘、持仓分析、实时提醒与自动报告。项目地址: https://gitcode.com/GitHub_Trending/pa/PanWatch
PanWatch 是一款覆盖 A股、港股、美股的 AI 盯盘工具，提供持仓分析、实时提醒与自动报告。当你在无法直连海外网络的环境自托管时，HTTP 代理配置是打通美股、港股等海外数据源与 AI 服务的第一步。本文带你快速掌握 PanWatch 的三种 HTTP 代理配置方式、生效优先级与常见故障排查，零基础也能一次配好。
为什么需要为海外数据源配置代理
PanWatch 会从多个数据源拉取报价、K 线、新闻与 AI 分析结果。如果服务器所在网络无法直连海外服务，你会遇到这些问题：
- 🌐 美股 / 港股行情请求超时、连接被重置
- 🤖 AI 模型接口连不上
- ⚠️ 自检项出现「timeout / proxy / ssl」一类连接失败提示
好消息是，PanWatch 把所有对外请求收敛到了统一的一层（见 market_http.py），代理一旦生效，行情、新闻、AI、通知等全部出站流量统一走代理，不需要逐个模块配置。
三种代理配置方式一览
PanWatch 支持三种配置方式，任选其一即可：
| 方式 | 配置位置 | 生效时机 | 适合人群 |
|---|---|---|---|
| ① 系统环境变量 | 启动前export HTTP_PROXY=... | 启动时 | Docker、systemd 服务化部署 |
②.env文件 | http_proxy=http://host:port | 启动时 | 本地开发 |
| ③ UI 全局 HTTP 代理 | 设置页填入地址 | 保存即生效，免重启 | 普通用户（推荐） |
⚖️ 三者优先级：外部环境变量 > UI >.env（完整说明见 README.zh-CN.md 的环境变量表）。
方式一：系统环境变量（服务化部署首选）
在启动服务前设置标准的HTTP_PROXY/HTTPS_PROXY环境变量即可。PanWatch 的出站请求默认启用trust_env=True，会自动读取这两个变量走代理；不配置时就是直连，零副作用。这种方式最适合 Docker、systemd 等托管场景，配置一次随服务永久生效。
方式二：.env文件配置（本地开发推荐）
在项目根目录的.env文件中写入：
http_proxy=http://127.0.0.1:7890
配置模型 config.py 会自动从.env加载该字段；同时.env兼容HTTPS_PROXY等未声明的标准变量，不会报错。重启服务后生效。
方式三：UI「全局 HTTP 代理」（推荐，保存即生效）
打开网页控制台，进入设置 → 全局 HTTP 代理，填入http://host:port格式的代理地址并保存：
- ✅ 后端立即调用 server.py 中的
apply_proxy_env统一更新进程环境变量 - ✅ 之后的所有请求马上走新代理，无需重启服务
- ✅ 把值清空并保存，即可取消代理恢复直连
这一 UI 入口由 settings.py 实现，它对http_proxy的描述是：“配置后所有对外请求含行情/新闻/AI/通知统一走此代理”。
代理生效机制：一个细节决定体验
代理配置后，PanWatch 会同时设置HTTP_PROXY、HTTPS_PROXY与NO_PROXY：
NO_PROXY默认包含localhost,127.0.0.1,::1,0.0.0.0——本地访问不会绕代理一圈，本地接口保持高速- 所有 httpx 客户端（含 marketdata 包 内的采集器）共用同一套代理环境变量，行为一致
常见问题：代理配了仍连不上怎么办
打开内置自检功能，它会按错误类别给出可执行的中文修复提示，逻辑见 selfcheck.py。最常见的三个坑：
- 出口地域不匹配：国内接口需要 CN 出口，Yahoo / 海外数据源需要境外出口——检查代理能否代出目标域名
- 被 MITM 代理拦截：本机走了拦截型代理时，需换可信出口
- 慢代理 + 高并发：可能触发「SQLite 被锁」，降低并发或换更快的代理即可
总结
PanWatch 的 HTTP 代理配置可以总结为一句话：
- 服务化部署 → 用外部环境变量
- 本地开发 → 用
.env文件 - 普通用户 → 用UI 全局 HTTP 代理（免重启，保存即生效）
无论选择哪种方式，行情、新闻、AI 与通知请求都会自动统一走代理，让美股、港股等海外数据源在 PanWatch 中稳定可用。
【免费下载链接】PanWatchPanWatch — AI stock monitoring for A-shares, HK & US markets, powered by TradingAgents. Portfolio insights, real-time alerts & automated reports.｜盯盘侠：覆盖 A股/港股/美股的 AI 盯盘、持仓分析、实时提醒与自动报告。项目地址: https://gitcode.com/GitHub_Trending/pa/PanWatch
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
