---
title: "n8n Docker 安装与更新指南"
type: source
tags: [docker, n8n, workflow]
date: 2025-03-30
---

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

## Summary
- 核心主题：n8n 自托管工作流引擎的 Docker 部署、代理配置与更新流程
- 问题域：n8n 容器内无法访问外网（需配置宿主机代理）、镜像更新维护
- 方法/机制：Dockerfile 扩展官方镜像 + docker-compose 编排 + SOCKS5 宿主机代理
- 结论/价值：n8n 生产环境推荐 Docker 部署，通过 Caddy 反向代理 + SOCKS5 代理实现安全访问外网

## Key Claims
- n8n 官方镜像默认不包含 curl/wget，需通过自定义 Dockerfile 安装
- ALL_PROXY=socks5://172.21.0.1:10808 使容器内 HTTP/HTTPS 流量走宿主机 SOCKS5 代理
- 宿主机防火墙必须允许 Docker 网桥访问代理端口：sudo ufw allow from 172.18.0.0/16 to any port 10808
- docker compose pull && docker compose down && docker compose up -d 为标准更新流程
- 容器内测试代理是否生效：curl --socks5 172.18.0.1:10808 https://ifconfig.me（返回国外 IP 则生效）

## Key Concepts
- [[n8n]]：开源工作流自动化平台，支持 543 个节点，AI 能力节点 271 个
- [[Docker容器网络]]：Docker 默认网桥（172.18.0.0/16 或 172.21.0.0.1），容器通过宿主机网桥 IP 访问外网
- [[SOCKS5代理]]：SOCKS5 协议允许客户端通过代理服务器转发请求，ALL_PROXY 环境变量在容器内全局生效

## Key Entities
- [[n8n]]：工作流自动化引擎
- [[shenwei]]：部署者，在 Ubuntu2（192.168.3.45）部署 n8n

## Connections
- [[n8n-Docker安装与更新]] ← 更新流程参考 → [[n8n configure telegram trigger]]
- [[n8n-Docker安装与更新]] ← 使用场景 → [[n8n-mcp]]（Claude 通过 n8n-mcp 调用 n8n 节点）

## Contradictions

## Related Wiki Pages
- [[n8n-mcp]]：Claude 与 n8n 的 MCP 协议桥接
- [[n8n configure telegram trigger]]：n8n Telegram 触发器配置