Przewodnik główny: wdrożenie Plane z zabezpieczeniem SSL i Cloudflare
Uruchomienie i zaawansowane zabezpieczenie Plane Commercial za pomocą Nginx, certyfikatów SSL Origin Cloudflare i ścisłego szyfrowania end-to-end.
Faza 1: Przygotowanie systemu i Dockera
Sección titulada «Fase 1: Preparación del Sistema y Docker»Najczęstszy błąd podczas uruchamiania Plane polega na posiadaniu nieaktualnych wersji orkiestratorów kontenerów. Wyczyścimy i zainstalujemy oficjalną wersję zgodną z interfejsem CLI Plane.
1.1. Debugowanie i oficjalny repozytorium
Sección titulada «1.1. Depuración y Repositorio Oficial»# Eliminar versiones conflictivas previassudo apt-get remove docker docker-engine docker.io containerd runc
# Instalar dependencias basesudo apt-get updatesudo apt-get install ca-certificates curl gnupg -y
# Instalar llaves seguras GPGsudo 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
# Configurar el repositorio oficialecho \ "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/null1.2. Instalacja silnika Docker i wtyczki Compose
Sección titulada «1.2. Instalación de Docker Engine y Plugin Compose»sudo apt-get updatesudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
# Validación de funcionamientodocker compose versionFaza 2: Instalacja Plane (wersja komercyjna)
Sección titulada «Fase 2: Instalación de Plane (Commercial Edition)»Dostosujemy natywne porty kontenera proxy Plane, aby uniknąć kolizji z serwerem internetowym Nginx.
2.1. Pobieranie i inicjalizacja instalatora
Sección titulada «2.1. Descarga e Inicialización del Instalador»mkdir plane-selfhost && cd plane-selfhostcurl -fsSL https://raw.githubusercontent.com/makeplane/plane/master/deploy/selfhost/install.sh -o setup.shchmod +x setup.sh
# Ejecutar setup indicando la delegación de SSL a un proxy reversosudo ./setup.sh --behind-proxy --domain="plane.portelcore.com"2.2. Izolacja Portów i Zmiennych w Pliku .env
Sección titulada «2.2. Aislamiento de Puertos y Variables en Archivo .env»Edytujemy konfigurację lokalną, aby usługi Plane nasłuchiwały na dedykowanych portach wewnętrznych (8080), zwalniając porty uprzywilejowane internetu (80 i 443) na maszynie hosta dla Nginx.
Otwórz plik konfiguracyjny:
nano .envWyrównaj następujące zmienne kluczowe:
# Asignación de puertos de contenedor internosLISTEN_HTTP_PORT=8080LISTEN_HTTPS_PORT=10443
# Enrutamiento SSL corporativoWEB_URL=https://plane.portelcore.comAPI_URL=https://plane.portelcore.com/api
# Enrutamiento del puerto localSITE_ADDRESS=:802.3. Ponowny start kontenerów
Sección titulada «2.3. Reinicio de los Contenedores»sudo prime-cli restartFaza 3: Certyfikaty bezpieczeństwa (Cloudflare Origin)
Sección titulada «Fase 3: Certificados de Seguridad (Cloudflare Origin)»Aby zapewnić ścisły tunel szyfrowany między Edge Cloudflare a lokalnym serwerem wirtualizacji:
- Zaloguj się do panelu Cloudflare > SSL/TLS > Origin Server.
- Utwórz nowy Certyfikat Origin, określając rozdzielczość nazw hosta.
- Skopiuj ciągi tekstowe certyfikatu publicznego i wygenerowanego klucza prywatnego.
Na serwerze hosta lokalnym:
# Registrar el certificado público de origensudo nano /etc/ssl/certs/plane-origin.pem# (Pegar el contenido del bloque de Cloudflare Origin Certificate)
# Registrar la clave privada de cifradosudo nano /etc/ssl/private/plane-key.pem# (Pegar el contenido del bloque de Private Key)Faza 4: Konfiguracja proxy odwrotnego (Nginx)
Sección titulada «Fase 4: Configuración de Proxy Inverso (Nginx)»Nginx odszyfrowuje przychodzące szyfrowanie SSL i przekaże ruch do kontenerów Plane.
4.1. Instalacja Nginx
Sección titulada «4.1. Instalación de Nginx»sudo apt update && sudo apt install nginx -y4.2. Utworzenie bloku serwera wirtualnego
Sección titulada «4.2. Creación del Bloque de Servidor Virtual»sudo nano /etc/nginx/sites-available/planeDodaj konfigurację routingu standaryzowanego:
server { listen 443 ssl http2; server_name plane.portelcore.com;
# Rutas a certificados de Cloudflare Origin ssl_certificate /etc/ssl/certs/plane-origin.pem; ssl_certificate_key /etc/ssl/private/plane-key.pem;
# Configuración de Algoritmos de Cifrado Seguros ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers EECDH+AESGCM:EDH+AESGCM; ssl_prefer_server_ciphers on; ssl_session_cache shared:SSL:10m;
# Límite máximo de carga de adjuntos client_max_body_size 10M;
location / { # Redireccionar al puerto de contenedor interno proxy_pass http://127.0.0.1:8080/;
# Cabeceras estándar de enrutamiento inverso proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Real-IP $remote_addr; proxy_set_header Host $http_host;
# Soporte de conexiones WebSockets duraderas proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
# Tiempos de espera extendidos proxy_read_timeout 300; proxy_connect_timeout 300; }}4.3. Aktywacja i wdrożenie na serwerze Nginx
Sección titulada «4.3. Activación y Despliegue en Servidor Nginx»# Enlace simbólico en sitios activossudo ln -s /etc/nginx/sites-available/plane /etc/nginx/sites-enabled/sudo rm /etc/nginx/sites-enabled/default
# Probar la sintaxis del archivosudo nginx -t
# Reiniciar servidor websudo systemctl restart nginxFaza 5: Wzmocnienie w Cloudflare (tryb ścisły)
Sección titulada «Fase 5: Blindaje en Cloudflare (Strict Mode)»- Przejdź do zakładki SSL/TLS > Przegląd w Cloudflare i ustaw szyfrowanie w trybie Pełne (ścisłe).
- Przejdź do SSL/TLS > Certyfikaty krawędzi i aktywuj opcję Zawsze używaj HTTPS, aby wymusić bezpieczne przekierowania.
📊 Kryteria jakości przewodnika
Sección titulada «📊 Criterios de Calidad de la Guía»- ✓ Bezpieczeństwo od końca do końca: Pełne szyfrowanie gwarantowane za pomocą certyfikatów Origin Cloudflare.
- ✓ Wolne od konfliktów: Odłączenie portów HTTP/HTTPS kontenerów od alternatywnych portów (
8080/10443). - ✓ Gniazda aktywne: Prawidłowe nagłówki WebSockets w celu obsługi natychmiastowej synchronizacji projektów.

