从零到一：使用 Docker 在服务器上部署生产级 n8n 自动化平台
在这个数据驱动的时代，自动化是提升效率的关键。n8n 作为一个开源、可自托管的"Zapier"替代品，赋予了开发者和技术爱好者完全掌控自己工作流的能力。相比于昂贵的商业服务，自托管 n8n 意味着无限的流程、无限制的步骤，以及最重要的数据隐私。
本教程将带您从零开始，在一台标准的云服务器（2核4G）上，使用 Docker Compose 和 PostgreSQL 数据库，一步步部署一个稳定、安全且可扩展的 n8n 实例。
**您将学到：**
* 准备服务器环境并安装 Docker。
* 使用 Docker Compose 编排 n8n 和 PostgreSQL 数据库服务。
* 通过 `.env` 文件安全地管理您的密码和凭证。
* 启动、验证并访问您的 n8n 实例。
* 配置生产环境所需的关键后续步骤，如 HTTPS 和备份。
### 准备工作：您的部署清单
在开始之前，请确保您已具备以下条件：
1. **一台云服务器**：至少 `2核 CPU` 和 `4GB 内存`。本文以 **Ubuntu 22.04** 为例，但其他主流 Linux 发行版同样适用。
2. **SSH 访问权限**：您需要能够以 root 或拥有 sudo 权限的用户身份登录服务器。
3. **一个域名（强烈推荐）**：虽然可以使用 IP 地址访问，但为 n8n 配置一个域名是实现 HTTPS 加密和专业部署的前提。
-----
### 第一步：环境准备 - 安装 Docker 和 Docker Compose
首先，我们需要在服务器上安装容器化环境。Docker 是当前最流行的容器技术，而 Docker Compose 则能让我们轻松定义和管理多容器应用。
1. **登录服务器并更新系统**
通过 SSH 连接到您的服务器，然后运行以下命令更新软件包列表和已安装的软件：
```bash
sudo apt update && sudo apt upgrade -y
```
2. **一键安装 Docker**
Docker 官方提供了一个便捷的安装脚本，可以自动完成安装过程。
```bash
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
```
3. **安装 Docker Compose**
Docker Compose 是一个独立的二进制文件，我们需要从 GitHub 下载它。
```bash
# 从 GitHub Release 下载并赋予执行权限
sudo curl -L "https://github.com/docker/compose/releases/download/v2.27.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
```
*注意：您可以访问 Docker Compose 的 [GitHub Release 页面](https://github.com/docker/compose/releases) 查看并替换为最新的版本号。*
4. **验证安装**
执行以下命令检查 Docker 和 Docker Compose 是否安装成功：
```bash
docker --version
docker-compose --version
```
如果您能看到各自的版本号输出，那么恭喜您，服务器环境已准备就绪！
-----
### 第二步：核心配置 - 编写 Docker Compose 文件
现在，我们将定义 n8n 应用及其数据库。我们将创建一个项目目录，并在其中放置两个核心文件：`docker-compose.yml` 用于定义服务，`.env` 用于存放敏感数据。
1. **创建项目目录**
```bash
mkdir ~/n8n
cd ~/n8n
```
2. **创建 `docker-compose.yml` 文件**
这是整个部署的蓝图。使用 `nano` 或您喜欢的编辑器创建该文件：
```bash
nano docker-compose.yml
```
将以下内容完整地复制粘贴到文件中。其中的注释解释了每个配置项的作用。
```yaml
# Docker Compose 文件版本
version: '3.8'
# 定义所有服务
services:
# n8n 主服务
n8n:
image: n8nio/n8n # 使用官方的 n8n 镜像
restart: unless-stopped # 容器退出时自动重启，除非手动停止
ports:
- "5678:5678" # 将主机的 5678 端口映射到容器的 5678 端口
environment:
# --- 数据库配置 ---
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=db # 指向下面的 'db' 服务
- DB_POSTGRESDB_DATABASE=${POSTGRES_DB} # 从 .env 文件读取数据库名
- DB_POSTGRESDB_USER=${POSTGRES_USER} # 从 .env 文件读取用户名
- DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD} # 从 .env 文件读取密码
# --- n8n 基础配置 ---
- N8N_BASIC_AUTH_ACTIVE=true # 启用基础登录认证 (安全第一道防线)
- N8N_BASIC_AUTH_USER=${N8N_USER} # 从 .env 文件读取登录用户名
- N8N_BASIC_AUTH_PASSWORD=${N8N_PASSWORD} # 从 .env 文件读取登录密码
- GENERIC_TIMEZONE=Asia/Shanghai # 设置时区，确保定时任务准确
- WEBHOOK_URL=http://your-server-ip:5678/ # **重要!** 务必修改为你的公网IP或域名
volumes:
- n8n_data:/home/node/.n8n # 数据持久化，防止容器重启后数据丢失
# PostgreSQL 数据库服务
db:
image: postgres:14 # 使用稳定可靠的 PostgreSQL 14 镜像
restart: unless-stopped
environment:
- POSTGRES_DB=${POSTGRES_DB}
- POSTGRES_USER=${POSTGRES_USER}
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
volumes:
- postgres_data:/var/lib/postgresql/data # 数据库数据持久化
# 定义数据卷，由 Docker 管理
volumes:
n8n_data:
postgres_data:
```
3. **创建 `.env` 文件以保护凭证**
将密码等敏感信息放在 `.env` 文件中是最佳实践。在 `docker-compose.yml` 旁边创建它：
```bash
nano .env
```
将以下内容粘贴进去，并**务必修改为您自己的强密码和用户名**：
```env
# PostgreSQL 数据库的凭证
POSTGRES_DB=n8n
POSTGRES_USER=n8nuser
POSTGRES_PASSWORD=YourSuperStrongDbPassword123!
# n8n 初始登录的用户名和密码
N8N_USER=admin
N8N_PASSWORD=YourSuperStrongN8nLoginPassword456!
```
-----
### 第三步：启动与验证
一切就绪，是时候启动我们的自动化平台了！
1. **启动服务**
在 `~/n8n` 目录下，执行以下命令：
```bash
docker-compose up -d
```
Docker Compose 会在后台拉取镜像、创建并启动容器。首次启动需要一些时间。
2. **检查运行状态**
```bash
docker-compose ps
```
您应该能看到 `n8n` 和 `db` 两个服务的状态（STATUS）都显示为 `running` 或 `Up`。
3. **访问 n8n**
打开浏览器，输入 `http://<你的服务器公网IP>:5678`。您会看到一个登录弹窗，请输入您在 `.env` 文件中设置的 `N8N_USER` 和 `N8N_PASSWORD`。
验证通过后，您将进入 n8n 的初始化界面，根据提示设置一个管理员（Owner）账户。这个账户是您未来登录 n8n 工作台的唯一凭证。
-----
### 第四步：迈向生产 - 安全与维护
成功运行只是第一步，要让 n8n 成为可靠的生产力工具，以下几点至关重要：
1. **安全第一：配置反向代理与 HTTPS**
直接通过 IP 和端口访问是**不安全**的。您应该使用 **Nginx Proxy Manager** 或 **Caddy** 等工具，将您的域名反向代理到 `http://localhost:5678`，并自动配置 Let's Encrypt 的免费 SSL 证书。这不仅能让您通过 `https://n8n.yourdomain.com` 访问，还能加密所有传输数据。
*配置完成后，切记将 `docker-compose.yml` 或 `.env` 文件中的 `WEBHOOK_URL` 更新为您的 HTTPS 域名。*
2. **高枕无忧：数据备份策略**
我们的数据虽然已经通过 Docker Volume 持久化，但服务器硬件故障或误操作仍可能导致数据丢失。您需要定期备份 `n8n_data` 和 `postgres_data` 这两个 Docker 卷。可以编写一个简单的脚本，利用 `cron` 定时任务将数据打包并传输到其他存储位置（如对象存储 OSS）。
3. **保持最新：如何轻松升级**
得益于 Docker，升级 n8n 非常简单。只需在 `~/n8n` 目录下执行几条命令：
```bash
# 1. 拉取最新的 n8n 和 postgres 镜像
docker-compose pull
# 2. 重新启动服务，Docker Compose 会自动使用新镜像
docker-compose up -d
# 3. (可选) 清理不再使用的旧镜像，释放磁盘空间
docker image prune -f
```
### 总结
恭喜您！您已经成功地搭建了一个属于自己的、功能强大的自动化平台。现在，您可以尽情探索 n8n 的无限可能，将重复性的工作流自动化，连接您最喜爱的各种应用，真正地让技术为您的效率服务。这个私有化的 n8n 实例将是您数据安全、降本增效的得力助手。
