Ir al contenido

マニュアル:Portelcoreでのn8nのセキュアな展開

Docker Composeを介したn8nの導入に関する技術ガイド、永続的な関係データベースPostgreSQL、およびCloudflare Tunnelsによるゼロトラストルーティング。

0閲覧数

このガイドでは、本番向けのn8n(高度なワークフローオートメーションプラットフォーム)インスタンスの実装について説明します。アーキテクチャは、隔離、耐障害性、境界セキュリティの原則を最優先に設計されています。

graph TD
Client([Cliente en Internet]) -->|HTTPS / Cifrado Estricto| CFEdge[Edge de Cloudflare]
subgraph Servidor Ubuntu (Proxmox VE - Red Privada)
direction LR
CFEdge -->|Canal Seguro / Sin Puertos Abiertos| CFTunnel[Contenedor: cloudflared]
CFTunnel -->|Red Virtual Docker| n8nServer[Contenedor: n8n_server]
n8nServer -->|Persistencia Local| pgData[(Volumen: n8n_db_data)]
n8nServer -->|Conexión Segura| pgServer[Contenedor: n8n_postgres]
pgServer --> pgData
end
  • 実行環境: Proxmox VEハイパーバイザーで隔離された仮想化Ubuntuサーバーで実行。
  • コンテナオーケストレーション: 不変で移動可能な環境を確保するためのDockerとDocker Compose。
  • 関係型データベース: デフォルトのストレージ(SQLite)からPostgreSQL 16への移行。この決定により、高並列処理時の書き込みロックを防止し、将来的な水平スケーラビリティ(キューモードによる追加ワーカー経由)の基盤を構築します。
  • 境界セキュリティ (Zero Trust): Cloudflare Tunnels (cloudflared) の実装。
    • 主なメリット: Ubuntu ホストは、いかなる入力ポート(80、443、5678 のいずれも)もインターネットに公開しません。トンネルコンテナは、Cloudflare のエッジとの間に直接的な安全で暗号化されたアウトバウンド接続を確立し、ローカルネットワークを悪意のあるスキャンから保護し、SSL 証明書 (HTTPS) の処理をエッジに委譲します。
  • Infrastructure as Code (IaC): インフラストラクチャは、docker-compose.yml ファイルと機密でない環境変数 .env を使用して宣言的に定義され、スタックのバックアップとレプリケーションを容易にします。

2. オペレーティングシステムの準備(Ubuntu)

Sección titulada «2. Preparación del Sistema Operativo (Ubuntu)»

2.1 ネットワーク設定(Netplan)

Sección titulada «2.1 Configuración de Red (Netplan)»

サービスの透過的な解決を保証し、ローカルネットワークの DHCP サーバーによって発生する衝突を避けるために、Ubuntu ホストに静的 IP を設定します。この高エントロピーなラボでは、ノードは 172.22.40.231 アドレスで応答します。

システムのネットワークファイルを編集します:

Ventana de terminal
sudo nano /etc/netplan/50-cloud-init.yaml

内部企業ネットワークに設定を一致させます:

network:
ethernets:
ens18:
dhcp4: no
addresses:
- 172.22.40.231/24
routes:
- to: default
via: 172.22.40.1
nameservers:
addresses:
- 1.1.1.1
- 8.8.8.8
version: 2

変更を適用します:

Ventana de terminal
sudo netplan apply

2.2 Dockerエンジンの依存関係のインストール

Sección titulada «2.2 Instalación de Dependencias del Motor Docker»

更新されたエンジンとその公式オーケストレーションライブラリのインストールを確認してください:

Ventana de terminal
# 1. Actualización y parche de repositorios del sistema
sudo apt update && sudo apt upgrade -y
# 2. Instalación de utilidades de red y certificados seguros
sudo apt install -y ca-certificates curl gnupg lsb-release
# 3. Importación de las llaves GPG oficiales del registro de Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
# 4. Registro del repositorio estable
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 5. Instalación del motor oficial y del plugin Compose V2
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# 6. Permisos de grupo al usuario del sistema (portel_user)
sudo usermod -aG docker $USER

[!IMPORTANT] 重要な操作ステップ: Docker のローカルソケットにおけるユーザー・トークンの権限を更新するために、アクティブなコンソールセッション (exit) を終了し、SSH 経由で再度ログインすることを忘れないでください。


3. Cloudflareゼロトラスト構成(トンネル)

Sección titulada «3. Configuración de Cloudflare Zero Trust (El Túnel)»

ホストでコンテナを初期化する前に、Cloudflareコンソールでセキュアトンネルを準備します:

  1. Cloudflareゼロトラストポータルにアクセス > Networks > Tunnels。
  2. Cloudflared タイプの新しいトンネルを作成します(名前の例: portel-n8n-tunnel)。
  3. TUNNEL_TOKEN をコピーします(Cloudflare が提供する長い英数字テキストブロックで、コンテナを認証するために使用します)。
  4. パブリックルート(Public Hostname)を設定します:
    • パブリックドメイン: n8n.portelcore.com
    • サービスタイプ: HTTP
    • 内部 URL(宛先): n8n:5678 (注: Docker Compose の仮想ネットワークが提供する内部 DNS 解決を使用します)。

4. スタック構造とコンポジション(IaC)

Sección titulada «4. Estructura y Composición del Stack (IaC)»

すべてのインフラストラクチャは ~/n8n-docker ディレクトリに整理されています。

Ventana de terminal
mkdir -p ~/n8n-docker && cd ~/n8n-docker

このファイルは、ダミーのリスニングポート、データベースのパスワード、認証トークンを中央で保存します。このファイルは、本物のシークレットを公開されたバージョン管理リポジトリにアップロードすることが厳しく禁止されています。

ファイル: ~/n8n-docker/.env

# ==========================================
# Configuración del Entorno y Dominio
# ==========================================
N8N_HOST=n8n.portelcore.com
N8N_PROTOCOL=https
TIMEZONE=Europe/Madrid
# ==========================================
# Credenciales de Base de Datos (PostgreSQL)
# ==========================================
POSTGRES_USER=portel_n8n_sec_usr
POSTGRES_PASSWORD=pg_pass_secure_demo_987654321_! # Ejemplo demostrativo y de laboratorio
POSTGRES_DB=n8n_production_db
# ==========================================
# Credenciales de Seguridad (Cloudflare)
# ==========================================
# Sustituye este marcador por tu token obtenido en la consola de Cloudflare
CLOUDFLARE_TUNNEL_TOKEN=eyJh...[TU_TOKEN_DE_TÚNEL_SEGURO_AQUÍ]...

4.2 マルチレイヤーオーケストレーション(docker-compose.yml)

Sección titulada «4.2 Orquestación Multicapa (docker-compose.yml)»

このファイルは、リレーショナルデータベースエンジン(Postgres 16)、n8nワークフローサーバー、Cloudflareトンネルエージェントを宣言します。サービスのダウンタイムを軽減し、クリーンな論理的な依存関係を確保するために、高度な健全性チェック(healthchecks)が含まれています。

ファイル: ~/n8n-docker/docker-compose.yml

version: '3.8'
services:
# 1. Capa de Persistencia y Base de Datos Relacional
postgres:
image: postgres:16-alpine
container_name: n8n_postgres
restart: unless-stopped
environment:
- POSTGRES_USER=${POSTGRES_USER}
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=${POSTGRES_DB}
volumes:
- pg_data:/var/lib/postgresql/data
networks:
- n8n_network
healthcheck:
test: ["CMD-SHELL", "pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
interval: 10s
timeout: 5s
retries: 5
# 2. Servidor de Automatización (Lógica de Negocio)
n8n:
image: docker.n8n.io/n8nio/n8n:latest
container_name: n8n_server
restart: unless-stopped
# Nota de Seguridad: No mapeamos puertos físicos del host a internet.
# Todo tráfico es recibido localmente a través de la red de Docker por el túnel.
environment:
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
- DB_POSTGRESDB_USER=${POSTGRES_USER}
- DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
- N8N_HOST=${N8N_HOST}
- N8N_PORT=5678
- N8N_PROTOCOL=${N8N_PROTOCOL}
- NODE_ENV=production
- WEBHOOK_URL=${N8N_PROTOCOL}://${N8N_HOST}/
- GENERIC_TIMEZONE=${TIMEZONE}
volumes:
- n8n_data:/home/node/.n8n
networks:
- n8n_network
depends_on:
postgres:
condition: service_healthy
# 3. Capa de Enlace Zero Trust (Cloudflare Tunnel)
cloudflared:
image: cloudflare/cloudflared:latest
container_name: n8n_tunnel
restart: unless-stopped
# Desactivar autoupdate evita que actualizaciones autónomas rompan la infraestructura local
command: tunnel --no-autoupdate run
environment:
- TUNNEL_TOKEN=${CLOUDFLARE_TUNNEL_TOKEN}
networks:
- n8n_network
# Definición de volúmenes persistentes locales del host
volumes:
n8n_data:
name: n8n_app_data
pg_data:
name: n8n_db_data
# Red virtual privada aislada
networks:
n8n_network:
name: n8n_internal_net
driver: bridge

宣言されたインフラストラクチャ全体を初めてバックグラウンドで起動する場合(または .env ファイルを変更した後):

Ventana de terminal
cd ~/n8n-docker
docker compose up -d

データフローを分析的に監視するか、起動エラーを診断するには:

Ventana de terminal
# Ver logs de todo el stack de servicios
docker compose logs -f
# Diagnóstico específico del túnel de Cloudflare
docker logs -f n8n_tunnel

5.3 ファクトリリセット(緊急メンテナンス)

Sección titulada «5.3 Restablecimiento de Fábrica (Mantenimiento de Emergencia)»

[!CAUTION] 破壊的な操作: 次のコマンドは、ホスト上のすべてのコンテナとローカルボリュームを完全に削除します(n8n の資格情報、ユーザー、ワークフローの履歴も含まれます)。ラボ環境や重大な緊急時にのみ使用してください。

Ventana de terminal
cd ~/n8n-docker
# Detiene el stack eliminando los volúmenes asociados
docker compose down -v
# Reconstruye el entorno desde cero
docker compose up -d

📊 運用成功チェックリスト

Sección titulada «📊 Checklist de Éxito Operativo»
  • ✓ 厳格な HTTPS 暗号化: Cloudflare のエッジによってネイティブにルーティングされた、n8n.portelcore.com へのエンドツーエンドで暗号化されたトラフィック。
  • ✓ 関係性の永続性: 自動化された健全性チェックを通じてPostgreSQL 16データベースエンジンが検証されました。
  • ✓ 隔離されたネットワークセキュリティ: パブリックネットワークに公開されているホストポートはゼロで、内部ルーティングは閉じたDocker仮想ブリッジを介して行われます。
  • ✓ 宣言的な標準: 固定されたシークレットを排除し、制御された停止指令と統合された IaC ファイル(docker-compose.yml および .env)。