jiradeveloper/n8n

n8n 与 PostgreSQL - Docker 部署指南

使用Docker运行n8n工作流自动化工具与PostgreSQL数据库的完整指南。

🚀 快速开始

1. 创建Docker网络

首先，为n8n和PostgreSQL创建专用网络以实现通信：

bash
docker network create n8n-network

该网络使n8n和PostgreSQL容器能够无缝通信。

🐘 PostgreSQL 设置

Linux/macOS

bash
docker run --name n8n-postgres \
  --network n8n-network \
  -e POSTGRES_PASSWORD=ENTER_PASS \
  -e POSTGRES_DB=n8n_db \
  -d postgres:latest

Windows (PowerShell)

powershell
docker run --name n8n-postgres `
  --network n8n-network `
  -e POSTGRES_PASSWORD=ENTER_PASS `
  -e POSTGRES_DB=n8n_db `
  -d postgres:latest

参数说明

⚙️ n8n 设置

Linux/macOS

bash
docker run -it \
  --name n8n \
  --network n8n-network \
  -p 5678:5678 \
  -e DB_TYPE=postgresdb \
  -e DB_POSTGRESDB_DATABASE=n8n_db \
  -e DB_POSTGRESDB_HOST=n8n-postgres \
  -e DB_POSTGRESDB_PORT=5432 \
  -e DB_POSTGRESDB_USER=postgres \
  -e DB_POSTGRESDB_SCHEMA=public \
  -e DB_POSTGRESDB_PASSWORD=ENTER_PASS \
  -v n8n_data:/home/node/.n8n \
  jiradeveloper/n8n:latest

Windows (PowerShell)

powershell
docker run -it `
  --name n8n `
  --network n8n-network `
  -p 5678:5678 `
  -e DB_TYPE=postgresdb `
  -e DB_POSTGRESDB_DATABASE=n8n_db `
  -e DB_POSTGRESDB_HOST=n8n-postgres `
  -e DB_POSTGRESDB_PORT=5432 `
  -e DB_POSTGRESDB_USER=postgres `
  -e DB_POSTGRESDB_SCHEMA=public `
  -e DB_POSTGRESDB_PASSWORD=ENTER_PASS `
  -v n8n_data:/home/node/.n8n `
  jiradeveloper/n8n:latest

参数说明

🌐 访问n8n

启动两个容器后，打开浏览器并导航至：

http://localhost:5678

n8n界面将准备就绪可供使用！

🐳 Docker Compose（推荐）

创建 docker-compose.yml 文件：

yaml
version: "3.8"

services:
  postgres:
    image: postgres:latest
    container_name: n8n-postgres
    restart: always
    environment:
      POSTGRES_PASSWORD: ENTER_PASS
      POSTGRES_DB: n8n_db
    networks:
      - n8n-network
    volumes:
      - postgres_data:/var/lib/postgresql/data

  n8n:
    image: jiradeveloper/n8n:latest
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      DB_TYPE: postgresdb
      DB_POSTGRESDB_DATABASE: n8n_db
      DB_POSTGRESDB_HOST: postgres
      DB_POSTGRESDB_PORT: 5432
      DB_POSTGRESDB_USER: postgres
      DB_POSTGRESDB_SCHEMA: public
      DB_POSTGRESDB_PASSWORD: ENTER_PASS
    networks:
      - n8n-network
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres

networks:
  n8n-network:
    driver: bridge

volumes:
  n8n_data:
  postgres_data:

使用Docker Compose启动

bash
docker compose up -d

停止并移除

bash
docker compose down

停止并移除（包含卷）

bash
docker compose down -v

🧹 清理命令

停止并移除容器

bash
docker stop n8n n8n-postgres
docker rm n8n n8n-postgres

移除网络和卷

bash
docker network rm n8n-network
docker volume rm n8n_data postgres_data

⚠️ 警告： 这些命令将永久删除所有数据！

📂 项目结构

n8n-docker-setup/
├── docker-compose.yml
├── README.md
└── (自动创建)
    ├── n8n_data/
    └── postgres_data/

💡 提示与最佳实践

更新容器

bash
docker compose pull
docker compose up -d

备份数据

工作流存储在 n8n_data 卷中。备份命令：

bash
docker run --rm -v n8n_data:/data -v $(pwd):/backup alpine tar czf /backup/n8n-backup.tar.gz -C /data .

恢复备份

bash
docker run --rm -v n8n_data:/data -v $(pwd):/backup alpine tar xzf /backup/n8n-backup.tar.gz -C /data

安全建议

• 修改默认密码 ENTER_PASS 为强密码后再部署
• 生产环境使用环境变量或密钥管理
• 生产环境启用SSL/TLS
• 定期备份PostgreSQL数据

🔧 故障排除

容器无法启动

检查日志：

bash
docker logs n8n
docker logs n8n-postgres

连接问题

验证两个容器是否在同一网络：

bash
docker network inspect n8n-network

重置所有配置

bash
docker compose down -v
docker compose up -d

📚 额外资源

• n8n 文档
• n8n 社区
• PostgreSQL 文档

📝 许可证

本部署指南按"原样"提供，用于教育和开发目的。

🤝 贡献

欢迎提交问题和拉取请求！随时为改进本部署指南贡献力量。

祝您使用n8n自动化愉快！🎉