마스터 가이드: SSL 및 Cloudflare 보안과 함께 Plane 배포
Nginx, Cloudflare 원본 인증서 및 엄격한 엔드투엔드 암호화를 통한 Plane Commercial의 시작 및 고급 보안 설정.
0조회
단계 1: 시스템 및 Docker 준비
Sección titulada «Fase 1: Preparación del Sistema y Docker»Plane 시작 시 가장 흔한 오류는 오래된 컨테이너 오케스트레이터 버전을 사용하는 것입니다. Plane 관리 CLI와 호환되는 공식 버전을 정리하고 설치할 것입니다.
1.1. 디버깅 및 공식 저장소
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. Docker 엔진 및 플러그인 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 version단계 2: Plane (상업 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»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. 포트 및 변수 격리 파일 .env
Sección titulada «2.2. Aislamiento de Puertos y Variables en Archivo .env»Plane 서비스가 전용 내부 포트 (8080)에서 작동하도록 로컬 설정을 수정하고, 인터넷 특권 포트 (80 및 443)를 호스트 머신에서 Nginx에 할당합니다.
설정 파일을 엽니다:
nano .env다음 키 변수를 정렬하세요:
# 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. 컨테이너 재시작
Sección titulada «2.3. Reinicio de los Contenedores»sudo prime-cli restart단계 3: 보안 인증서 (Cloudflare Origin)
Sección titulada «Fase 3: Certificados de Seguridad (Cloudflare Origin)»Cloudflare Edge와 로컬 가상화 서버 간에 엄격한 암호화 터널을 보장하기 위해:
- Cloudflare 패널 > SSL/TLS > Origin Server로 이동하세요.
- 호스트 이름 해석을 지정하여 새 Origin Certificate를 생성하세요.
- 생성된 공개 인증서 및 개인 키 문자열을 복사하세요.
로컬 호스트 서버:
# 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)단계 4: 역 프록시 구성 (Nginx)
Sección titulada «Fase 4: Configuración de Proxy Inverso (Nginx)»Nginx는 들어오는 SSL 암호를 해독하고 Plane 컨테이너로 트래픽을 전달합니다.
4.1. Nginx 설치
Sección titulada «4.1. Instalación de Nginx»sudo apt update && sudo apt install nginx -y4.2. 가상 서버 블록 생성
Sección titulada «4.2. Creación del Bloque de Servidor Virtual»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»# 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 nginx단계 5: Cloudflare 보안 (강한 모드)
Sección titulada «Fase 5: Blindaje en Cloudflare (Strict Mode)»- Cloudflare에서 SSL/TLS > 개요 탭으로 이동하여 암호화를 완전 (강한) 모드로 설정하세요.
- SSL/TLS > Edge Certificates로 이동하여 항상 HTTPS를 사용하는 옵션을 활성화하여 안전한 리디렉션을 강제하세요.
- ✓ 엔드 투 엔드 보안: Cloudflare 로컬 오리진 인증서를 통해 완전한 암호화가 보장됩니다.
- ✓ 충돌 없는: 컨테이너의 HTTP/HTTPS 포트를 대체 포트 (
8080/10443)로 분리합니다. - ✓ 활성 소켓: 프로젝트 실시간 동기화를 지원하는 올바른 웹소켓 헤더가 있습니다.

