Auto-sync: 2026-04-21 16:03

raw/Home Office/n8n Docker 配置 Telegram 代理 Troubleshooting.md

@@ -0,0 +1,122 @@
+
+#n8n #docker #http-proxy #https-proxy #telegram #xray #v2ray 
+## 问题描述
+
+n8n 运行在 Docker 容器内，宿主机已有代理（xray/v2ray 监听 `10808` 端口），但 n8n 的 Telegram 节点无法连接 `api.telegram.org`。
+
+---
+
+## 排查过程
+
+### 1. 宿主机可以访问，容器不行
+
+宿主机用 proxychains 可以正常访问 Telegram API：
+
+```bash
+proxychains4 curl https://api.telegram.org/bot<TOKEN>/getMe
+# ✅ 返回 bot 信息
+```
+
+容器内用 Node.js fetch 测试：
+
+```bash
+node -e "fetch('https://api.telegram.org/...').then(r=>r.text()).then(console.log).catch(console.error)"
+# ❌ ETIMEDOUT
+```
+
+### 2. 发现 docker-compose.yml 中代理地址错误
+
+```yaml
+# ❌ 错误：容器内的 127.0.0.1 是容器自身，不是宿主机
+HTTP_PROXY: http://127.0.0.1:10808
+HTTPS_PROXY: http://127.0.0.1:10808
+```
+
+### 3. 修正为 host.docker.internal
+
+```yaml
+# ✅ 正确：通过 host.docker.internal 访问宿主机
+HTTP_PROXY: http://host.docker.internal:10808
+HTTPS_PROXY: http://host.docker.internal:10808
+```
+`host.docker.internal` 能工作的前提是 `docker-compose.yml` 中已有： 
+```yaml
+extra_hosts:
+   - "host.docker.internal:host-gateway"
+```
+
+### 4. 确认代理端口可达
+
+在容器内验证连通性：
+
+```bash
+node -e "
+const net = require('net');
+const s = net.createConnection(10808, 'host.docker.internal', () => {
+  console.log('✅ 代理端口可达');
+  s.destroy();
+});
+s.on('error', e => console.log('❌ 失败:', e.message));
+"
+# ✅ 代理端口可达
+```
+
+宿主机确认代理监听地址：
+
+```bash
+ss -tlnp | grep 10808
+# LISTEN *:10808  ← 监听 0.0.0.0，容器可以访问 ✅
+```
+
+### 5. Node.js 原生 fetch 不读代理环境变量
+
+`node fetch` 不会自动使用 `HTTP_PROXY`/`HTTPS_PROXY`，所以容器内的测试命令显示 ETIMEDOUT 是**测试方法有误**，并非代理没生效。
+
+**n8n 使用 axios**，axios 会自动读取代理环境变量，所以 n8n 节点内是正常工作的。
+
+验证方法：直接在 n8n 里用 **HTTP Request 节点** 访问：
+
+```
+https://api.telegram.org/bot<TOKEN>/getMe
+```
+
+能返回 bot 信息即代理生效 ✅
+
+---
+
+## 最终解决方案
+
+### docker-compose.yml 关键配置
+
+```yaml
+services:
+  n8n:
+    environment:
+      HTTP_PROXY: http://host.docker.internal:10808   # 指向宿主机代理
+      HTTPS_PROXY: http://host.docker.internal:10808
+      NO_PROXY: localhost,127.0.0.1                   # 内网地址不走代理
+    extra_hosts:
+      - "host.docker.internal:host-gateway"           # 必须！映射宿主机 IP
+```
+
+### 前提条件
+
+|条件|检查命令|
+|---|---|
+|宿主机代理监听 `0.0.0.0`（非 `127.0.0.1`）|`ss -tlnp \| grep 10808`|
+|docker-compose 有 `extra_hosts` 配置|查看 yml 文件|
+
+### 重启生效
+
+```bash
+docker compose down && docker compose up -d
+```
+
+---
+
+## 总结
+
+|问题|原因|解决|
+|---|---|---|
+|代理不生效|`127.0.0.1` 在容器内指向容器本身|改为 `host.docker.internal`|
+|测试误报 ETIMEDOUT|Node.js 原生 `fetch` 不读代理环境变量|用 n8n HTTP Request 节点直接测试|