---
title: "n8n Docker 安装与 SOCKS5 代理配置"
type: source
tags: [n8n, docker, socks5, self-hosted, proxy]
date: 2025-12-30
---

## Source File
- [[raw/Agent/n8n docker install & update.md]]

## Summary
- 核心主题：n8n Docker 部署并配置 SOCKS5 代理访问外网
- 问题域：n8n 容器内网络隔离，需要通过宿主机代理访问 AI API（OpenAI/Claude 等）
- 方法/机制：Docker 自定义 Dockerfile 安装 curl/wget + docker-compose ALL_PROXY 环境变量指向宿主机 Docker 网桥 SOCKS5 端口
- 结论/价值：容器内 AI 工作流节点可正常访问被墙或海外服务

## Key Claims
- n8n 容器默认网络隔离，HTTP/HTTPS 请求无法直接访问外网 AI 服务
- `ALL_PROXY=socks5://172.21.0.1:10808` 将容器流量路由到宿主机 SOCKS5 代理
- Docker 网桥网关地址（`docker network inspect n8n_default` 中的 Gateway）决定宿主机代理监听地址
- 更新 n8n：进入 docker-compose 目录 → `docker compose pull` → `docker compose down` → `docker compose up -d`

## Key Quotes
> "注意：`172.21.0.1` 需替换为以下命令输出的网桥 IP（Gateway）" — 网桥 IP 因环境而异，必须动态获取

## Key Concepts
- [[Docker 网桥网络]]: Docker 默认 bridge 网络模式，容器通过 `172.17.0.1`（Linux）或 `172.18.0.1`/`172.21.0.1`（macOS Docker Desktop）访问宿主机
- [[SOCKS5 代理]]: 一种代理协议，支持 TCP/UDP 流量转发；`socks5h://` 模式由代理服务器解析 DNS，防止 DNS 污染
- [[ALL_PROXY]]: 环境变量，HTTP/HTTPS/SOCKS 协议通用代理设置
- [[Docker 自定义 Dockerfile]]: 基于官方镜像安装额外工具（curl/wget）的标准方式

## Key Entities
- [[n8n]]: 开源工作流自动化平台，支持 543+ 节点，本项目 AI 自动化核心
- [[V2Ray]]: SOCKS5 代理服务端，监听宿主机 `0.0.0.0:10808`

## Connections
- [[n8n-Telegram-Trigger-HTTPS配置修复]] ← relates_to ← [[n8n-Docker安装与SOCKS5代理配置]]（同属 n8n 自托管部署实战）

## Contradictions
- 与"n8n 官方推荐直接暴露 5678 端口"不同：本方案通过 Caddy 反向代理隐藏端口，仅暴露 HTTPS 端点

## Docker Compose 关键配置
```yaml
environment:
  - N8N_PROTOCOL=https
  - N8N_HOST=n8n.ishenwei.online
  - WEBHOOK_URL=https://n8n.ishenwei.online/
  - N8N_TRUST_PROXY=true
  - N8N_SECURE_COOKIE=true
  - ALL_PROXY=socks5://172.21.0.1:10808
networks:
  n8n_default:
    external: true
```

## 容器内测试代理
```bash
docker exec -it n8n /bin/sh
curl --socks5 172.18.0.1:10808 https://ifconfig.me
# 返回国外 IP 即表示代理生效
```

## Tags
- #n8n #docker #proxy #self-hosted