Ir al contenido

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.

0vues

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.

Ventana de terminal
# Eliminar versiones conflictivas previas
sudo apt-get remove docker docker-engine docker.io containerd runc
# Instalar dependencias base
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg -y
# Instalar llaves seguras GPG
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
# Configurar el repositorio oficial
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

1.2. Installation de Docker Engine et du plugin Compose

Sección titulada «1.2. Instalación de Docker Engine y Plugin Compose»
Ventana de terminal
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
# Validación de funcionamiento
docker compose version

Phase 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»
Ventana de terminal
mkdir plane-selfhost && cd plane-selfhost
curl -fsSL https://raw.githubusercontent.com/makeplane/plane/master/deploy/selfhost/install.sh -o setup.sh
chmod +x setup.sh
# Ejecutar setup indicando la delegación de SSL a un proxy reverso
sudo ./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 :

Ventana de terminal
nano .env

Alignez les variables clés suivantes :

# Asignación de puertos de contenedor internos
LISTEN_HTTP_PORT=8080
LISTEN_HTTPS_PORT=10443
# Enrutamiento SSL corporativo
WEB_URL=https://plane.portelcore.com
API_URL=https://plane.portelcore.com/api
# Enrutamiento del puerto local
SITE_ADDRESS=:80
Ventana de terminal
sudo prime-cli restart

Phase 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 :

  1. Accédez à votre panneau Cloudflare > SSL/TLS > Origin Server.
  2. Créez un nouveau Origin Certificate en spécifiant la résolution de nom d'hôte.
  3. 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 :

Ventana de terminal
# Registrar el certificado público de origen
sudo nano /etc/ssl/certs/plane-origin.pem
# (Pegar el contenido del bloque de Cloudflare Origin Certificate)
# Registrar la clave privada de cifrado
sudo 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.

Ventana de terminal
sudo apt update && sudo apt install nginx -y
Ventana de terminal
sudo nano /etc/nginx/sites-available/plane

Ajoutez 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»
Ventana de terminal
# Enlace simbólico en sitios activos
sudo ln -s /etc/nginx/sites-available/plane /etc/nginx/sites-enabled/
sudo rm /etc/nginx/sites-enabled/default
# Probar la sintaxis del archivo
sudo nginx -t
# Reiniciar servidor web
sudo systemctl restart nginx

Phase 5 : Blindage dans Cloudflare (Strict Mode)

Sección titulada «Fase 5: Blindaje en Cloudflare (Strict Mode)»
  1. Accédez à l'onglet SSL/TLS > Overview dans Cloudflare et réglez le chiffrement sur le mode Full (Strict).
  2. Accédez à SSL/TLS > Edge Certificates et activez l'option Always Use HTTPS pour forcer les redirections sécurisées.

  • ✓ 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.