Ir al contenido

Основное руководство: развертывание Plane с безопасностью SSL и Cloudflare

Запуск и продвинутая защита Plane Commercial с помощью Nginx, сертификатов SSL от Cloudflare Origin и строгого сквозного шифрования.

0просмотры

Фаза 1: Подготовка системы и Docker

Sección titulada «Fase 1: Preparación del Sistema y Docker»

Наиболее распространенная ошибка при запуске Plane - использование устаревших версий оркестраторов контейнеров. Мы очистим и установим официальную версию, совместимую с административной CLI Plane.

1.1. Отладка и официальный репозиторий

Sección titulada «1.1. Depuración y Repositorio Oficial»
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. Установка Docker Engine и плагина 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

Фаза 2: Установка Plane (Commercial Edition)

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

Мы настроим родные порты контейнера-прокси Plane, чтобы избежать конфликтов с локальным веб-сервером Nginx.

2.1. Загрузка и инициализация установщика

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. Изоляция портов и переменных в файле .env

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

Мы отредактируем локальную конфигурацию, чтобы сервисы Plane слушали на выделенных внутренних портах (8080), освобождая привилегированные порты интернета (80 и 443) на хост-машине для Nginx.

Откройте файл конфигурации:

Ventana de terminal
nano .env

Выровняйте следующие ключевые переменные:

# 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

2.3. Перезапуск контейнеров

Sección titulada «2.3. Reinicio de los Contenedores»
Ventana de terminal
sudo prime-cli restart

Фаза 3: Сертификаты безопасности (Cloudflare Origin)

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

Чтобы обеспечить строгий зашифрованный туннель между Edge Cloudflare и вашим локальным сервером виртуализации:

  1. Доступ к вашему панелю Cloudflare > SSL/TLS > Origin Server.
  2. Создайте новый Origin Certificate, указав разрешение имен хоста.
  3. Скопируйте строки текста открытого сертификата и сгенерированного приватного ключа.

На локальном хост-сервере:

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)

Фаза 4: Настройка обратного прокси (Nginx)

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

Nginx расшифрует входящее SSL-шифрование и направит трафик к контейнерам Plane.

Ventana de terminal
sudo apt update && sudo apt install nginx -y

4.2. Создание блока виртуального сервера

Sección titulada «4.2. Creación del Bloque de Servidor Virtual»
Ventana de terminal
sudo nano /etc/nginx/sites-available/plane

Добавьте стандартную конфигурацию маршрутизации:

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. Активация и развертывание на сервере 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

Фаза 5: Защита в Cloudflare (Strict Mode)

Sección titulada «Fase 5: Blindaje en Cloudflare (Strict Mode)»
  1. Перейдите в вкладку SSL/TLS > Обзор в Cloudflare и установите шифрование в режим Полное (строгий).
  2. Перейдите в SSL/TLS > Сертификаты Edge и активируйте опцию Всегда использовать HTTPS для принудительного безопасного перенаправления.

📊 Критерии качества руководства

Sección titulada «📊 Criterios de Calidad de la Guía»
  • ✓ Безопасность от конца до конца: Полное шифрование, гарантированное с помощью локальных сертификатов Cloudflare Origin.
  • ✓ Свободно от конфликтов: Отсоединение портов HTTP/HTTPS контейнеров от альтернативных портов (8080 / 10443).
  • ✓ Активные сокеты: Правильные заголовки WebSockets для поддержки мгновенной синхронизации проектов.