n8n Docker 部署（六）：常见问题与排查

📌 本文是「n8n Docker 部署」系列第 六 篇 · 系列目录

服务无法启动

• 检查端口 5678 是否被占用或被安全组/防火墙拦截
• 查看容器日志定位错误：

  docker-compose logs -f n8n

• 确认 Docker 与 Compose 正常：

  docker --version && docker-compose version

端口映射冲突

• 修改外部端口映射，例如：

  ports:
    - "8080:5678"

• 调整后访问 http://<host>:8080

忘记登录密码

• 修改 docker-compose.yml 中的 N8N_BASIC_AUTH_PASSWORD
• 使配置生效：

  docker-compose up -d

代理不生效

• 宿主机先验证：

  curl -I -x http://127.0.0.1:7890 https://example.com

• 容器内再验证：

  docker exec -it n8n bash
  curl -I https://example.com
  exit

• 检查 HTTP_PROXY/HTTPS_PROXY/NO_PROXY/N8N_USE_PROXY 是否正确

Compose 缓存与容器清理

• 配置有变更后建议执行：

  docker-compose down
  docker-compose up -d