Guide maître : Déploiement de Plane avec sécurité SSL et Cloudflare
Mise en service et sécurisation avancée de Plane Commercial via Nginx, certificats SSL d'origine Cloudflare et chiffrement strict de bout en bout.
Phase 1 : Préparation du système et de Docker
Sección titulada «Fase 1: Preparación del Sistema y Docker»L'erreur la plus courante lors de la mise en route de Plane est d'avoir des versions obsolètes d'orchestrateurs de conteneurs. Nous allons nettoyer et installer la version officielle compatible avec la CLI d'administration de Plane.
1.1. Débogage et dépôt officiel
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. Installation de Docker Engine et du plugin 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 versionPhase 2 : Installation de Plane (Commercial Edition)
Sección titulada «Fase 2: Instalación de Plane (Commercial Edition)»Nous ajusterons les ports natifs du conteneur proxy de Plane pour éviter les collisions avec le serveur Web local Nginx.
2.1. Téléchargement et initialisation de l'installateur
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. Isolation des ports et des variables dans le fichier .env
Sección titulada «2.2. Aislamiento de Puertos y Variables en Archivo .env»Nous modifierons la configuration locale pour que les services de Plane écoutent sur des ports internes dédiés (8080), libérant ainsi les ports privilégiés d'Internet (80 et 443) sur la machine hôte pour Nginx.
Ouvrez le fichier de configuration :
nano .envAlignez les variables clés suivantes :
# 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. Redémarrage des conteneurs
Sección titulada «2.3. Reinicio de los Contenedores»sudo prime-cli restartPhase 3 : Certificats de sécurité (Cloudflare Origin)
Sección titulada «Fase 3: Certificados de Seguridad (Cloudflare Origin)»Pour garantir un tunnel chiffré strict entre l'Edge de Cloudflare et votre serveur de virtualisation local :
- Accédez à votre panneau Cloudflare > SSL/TLS > Origin Server.
- Créez un nouveau Origin Certificate en spécifiant la résolution de nom d'hôte.
- Copiez les chaînes de texte du certificat public et de la clé privée générée.
Sur le serveur hôte local :
# 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)Phase 4 : Configuration du proxy inverse (Nginx)
Sección titulada «Fase 4: Configuración de Proxy Inverso (Nginx)»Nginx déchiffrera le chiffrement SSL entrant et canalisera le trafic vers les conteneurs de Plane.
4.1. Installation de Nginx
Sección titulada «4.1. Instalación de Nginx»sudo apt update && sudo apt install nginx -y4.2. Création du Bloc de Serveur Virtuel
Sección titulada «4.2. Creación del Bloque de Servidor Virtual»sudo nano /etc/nginx/sites-available/planeAjoutez la configuration de routage standardisée :
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. Activation et Déploiement sur Serveur 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 nginxPhase 5 : Blindage dans Cloudflare (Strict Mode)
Sección titulada «Fase 5: Blindaje en Cloudflare (Strict Mode)»- Accédez à l'onglet SSL/TLS > Overview dans Cloudflare et réglez le chiffrement sur le mode Full (Strict).
- Accédez à SSL/TLS > Edge Certificates et activez l'option Always Use HTTPS pour forcer les redirections sécurisées.
📊 Critères de Qualité du Guide
Sección titulada «📊 Criterios de Calidad de la Guía»- ✓ Sécurité de bout en bout : Chiffrement complet garanti par des certificats Origin Cloudflare locaux.
- ✓ Sans conflit : Découplage des ports HTTP/HTTPS des conteneurs vers des ports alternatifs (
8080/10443). - ✓ Sockets actifs : En-têtes WebSockets corrects pour prendre en charge la synchronisation instantanée des projets.

