マニュアル:Portelcoreでのn8nのセキュアな展開
Docker Composeを介したn8nの導入に関する技術ガイド、永続的な関係データベースPostgreSQL、およびCloudflare Tunnelsによるゼロトラストルーティング。
このガイドでは、本番向けの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 end1.1 キーアーキテクチャ決定
Sección titulada «1.1 Decisiones Arquitectónicas Clave»- 実行環境: Proxmox VEハイパーバイザーで隔離された仮想化Ubuntuサーバーで実行。
- コンテナオーケストレーション: 不変で移動可能な環境を確保するためのDockerとDocker Compose。
- 関係型データベース: デフォルトのストレージ(SQLite)からPostgreSQL 16への移行。この決定により、高並列処理時の書き込みロックを防止し、将来的な水平スケーラビリティ(キューモードによる追加ワーカー経由)の基盤を構築します。
- 境界セキュリティ (Zero Trust): Cloudflare Tunnels (
cloudflared) の実装。- 主なメリット: Ubuntu ホストは、いかなる入力ポート(
80、443、5678のいずれも)もインターネットに公開しません。トンネルコンテナは、Cloudflare のエッジとの間に直接的な安全で暗号化されたアウトバウンド接続を確立し、ローカルネットワークを悪意のあるスキャンから保護し、SSL 証明書 (HTTPS) の処理をエッジに委譲します。
- 主なメリット: Ubuntu ホストは、いかなる入力ポート(
- 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 アドレスで応答します。
システムのネットワークファイルを編集します:
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変更を適用します:
sudo netplan apply2.2 Dockerエンジンの依存関係のインストール
Sección titulada «2.2 Instalación de Dependencias del Motor Docker»更新されたエンジンとその公式オーケストレーションライブラリのインストールを確認してください:
# 1. Actualización y parche de repositorios del sistemasudo apt update && sudo apt upgrade -y
# 2. Instalación de utilidades de red y certificados segurossudo apt install -y ca-certificates curl gnupg lsb-release
# 3. Importación de las llaves GPG oficiales del registro de Dockersudo install -m 0755 -d /etc/apt/keyringscurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpgsudo chmod a+r /etc/apt/keyrings/docker.gpg
# 4. Registro del repositorio estableecho \ "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 V2sudo apt updatesudo 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コンソールでセキュアトンネルを準備します:
- Cloudflareゼロトラストポータルにアクセス > Networks > Tunnels。
- Cloudflared タイプの新しいトンネルを作成します(名前の例:
portel-n8n-tunnel)。 TUNNEL_TOKENをコピーします(Cloudflare が提供する長い英数字テキストブロックで、コンテナを認証するために使用します)。- パブリックルート(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 ディレクトリに整理されています。
mkdir -p ~/n8n-docker && cd ~/n8n-docker4.1 環境変数ファイル(.env)
Sección titulada «4.1 Archivo de Variables de Entorno (.env)»このファイルは、ダミーのリスニングポート、データベースのパスワード、認証トークンを中央で保存します。このファイルは、本物のシークレットを公開されたバージョン管理リポジトリにアップロードすることが厳しく禁止されています。
ファイル: ~/n8n-docker/.env
# ==========================================# Configuración del Entorno y Dominio# ==========================================N8N_HOST=n8n.portelcore.comN8N_PROTOCOL=httpsTIMEZONE=Europe/Madrid
# ==========================================# Credenciales de Base de Datos (PostgreSQL)# ==========================================POSTGRES_USER=portel_n8n_sec_usrPOSTGRES_PASSWORD=pg_pass_secure_demo_987654321_! # Ejemplo demostrativo y de laboratorioPOSTGRES_DB=n8n_production_db
# ==========================================# Credenciales de Seguridad (Cloudflare)# ==========================================# Sustituye este marcador por tu token obtenido en la consola de CloudflareCLOUDFLARE_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 hostvolumes: n8n_data: name: n8n_app_data pg_data: name: n8n_db_data
# Red virtual privada aisladanetworks: n8n_network: name: n8n_internal_net driver: bridge5.1 初回デプロイとスタック起動
Sección titulada «5.1 Despliegue Inicial y Arranque del Stack»宣言されたインフラストラクチャ全体を初めてバックグラウンドで起動する場合(または .env ファイルを変更した後):
cd ~/n8n-dockerdocker compose up -d5.2 実時間ログの読み取り
Sección titulada «5.2 Lectura de Logs en Tiempo Real»データフローを分析的に監視するか、起動エラーを診断するには:
# Ver logs de todo el stack de serviciosdocker compose logs -f
# Diagnóstico específico del túnel de Cloudflaredocker logs -f n8n_tunnel5.3 ファクトリリセット(緊急メンテナンス)
Sección titulada «5.3 Restablecimiento de Fábrica (Mantenimiento de Emergencia)»[!CAUTION] 破壊的な操作: 次のコマンドは、ホスト上のすべてのコンテナとローカルボリュームを完全に削除します(n8n の資格情報、ユーザー、ワークフローの履歴も含まれます)。ラボ環境や重大な緊急時にのみ使用してください。
cd ~/n8n-docker# Detiene el stack eliminando los volúmenes asociadosdocker compose down -v
# Reconstruye el entorno desde cerodocker compose up -d📊 運用成功チェックリスト
Sección titulada «📊 Checklist de Éxito Operativo»- ✓ 厳格な HTTPS 暗号化: Cloudflare のエッジによってネイティブにルーティングされた、
n8n.portelcore.comへのエンドツーエンドで暗号化されたトラフィック。 - ✓ 関係性の永続性: 自動化された健全性チェックを通じてPostgreSQL 16データベースエンジンが検証されました。
- ✓ 隔離されたネットワークセキュリティ: パブリックネットワークに公開されているホストポートはゼロで、内部ルーティングは閉じたDocker仮想ブリッジを介して行われます。
- ✓ 宣言的な標準: 固定されたシークレットを排除し、制御された停止指令と統合された IaC ファイル(
docker-compose.ymlおよび.env)。

