Ir al contenido

Mastergids: Implementatie van Plane met SSL-beveiliging en Cloudflare

Implementatie en geavanceerde beveiliging van Plane Commercial via Nginx, Cloudflare Origin SSL-certificaten en strikte end-to-end encryptie.

0lecturas

De meest voorkomende fout bij het opstarten van Plane is het gebruik van verouderde versies van containerorkestratoren. We zullen deze opschonen en de officiële versie installeren die compatibel is met de administratieve CLI van 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. Installatie van Docker Engine en Compose Plugin

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

Fase 2: Installatie van Plane (Commercial Edition)

Sección titulada «Fase 2: Instalación de Plane (Commercial Edition)»

We zullen de standaardpoorten van de Plane-proxypcontainer aanpassen om conflicten met de lokale webserver Nginx te voorkomen.

2.1. Downloaden en Initialiseren van de Installer

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. Isolatie van poorten en variabelen in bestand .env

Sección titulada «2.2. Aislamiento de Puertos y Variables en Archivo .env»

We passen de lokale configuratie aan zodat de Plane-services luisteren op toegewezen interne poorten (8080), waardoor de bevoorrechte internetpoorten (80 en 443) op de hostmachine vrijkomen voor Nginx.

Open het configuratiebestand:

Ventana de terminal
nano .env

Lijn de volgende belangrijke variabelen uit:

# 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

Fase 3: Beveiligingscertificaten (Cloudflare Origin)

Sección titulada «Fase 3: Certificados de Seguridad (Cloudflare Origin)»

Om een strikt versleutelde tunnel te garanderen tussen de Cloudflare Edge en uw lokale virtualisatieserver:

  1. Ga naar je Cloudflare > SSL/TLS > Origin Server paneel.
  2. Maak een nieuw Origin Certificate aan door de hostnaamresolutie te specificeren.
  3. Kopieer de tekstreeksen van het openbare certificaat en de gegenereerde privésleutel.

Op de lokale hostserver:

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)

Fase 4: Configuratie van Reverse Proxy (Nginx)

Sección titulada «Fase 4: Configuración de Proxy Inverso (Nginx)»

Nginx zal de inkomende SSL-versleuteling ontsleutelen en het verkeer naar de Plane-containers leiden.

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

Voeg de gestandaardiseerde routeringsconfiguratie toe:

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. Activering en Implementatie op Nginx-server

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

Fase 5: Beveiliging in Cloudflare (Strict Mode)

Sección titulada «Fase 5: Blindaje en Cloudflare (Strict Mode)»
  1. Ga naar het tabblad SSL/TLS > Overview in Cloudflare en stel de versleuteling in op de modus Full (Strict).
  2. Ga naar SSL/TLS > Edge Certificates en activeer de optie Always Use HTTPS om beveiligde redirects af te dwingen.

  • ✓ End-to-end beveiliging: Volledige encryptie gegarandeerd via lokale Cloudflare Origin-certificaten.
  • ✓ Conflictvrij: Ontkoppeling van HTTP/HTTPS-poorten van de containers naar alternatieve poorten (8080 / 10443).
  • ✓ Actieve Sockets: Correcte WebSocket-headers voor directe projectsynchronisatie.