애플리케이션 배포

Compose, 컨테이너 패널 및 업데이트 관리

요약: Linux VPS에서 다중 컨테이너 애플리케이션을 관리할 때 여기저기 흩어진 docker run 명령을 사용하면 매개변수를 잊어버리거나 네트워크 토폴로지가 혼동되고 치명적인 업그레이드 실패로 이어지기 쉽습니다. 최신 컨테이너 배포는 이미지 태그, 환경 변수, 영구 볼륨, 네트워킹 및 리소스 제한을 코드형 인프라(Infrastructure as Code)인 Docker Compose로 표준화합니다.

VPSMap 편집팀 · 업데이트 2026-09-26 · 20분 분량 · 텍스트 버전

Linux VPS에서 다중 컨테이너 애플리케이션을 관리할 때 여기저기 흩어진 docker run 명령을 직접 사용하면 매개변수를 잊어버리거나 네트워크 토폴로지가 혼동되고 치명적인 업그레이드 실패가 발생하기 쉽습니다. 최신 컨테이너 배포는 Docker Compose를 사용하여 이미지 태그, 환경 변수, 영구 볼륨, 네트워킹 및 리소스 제한을 코드형 인프라(Infrastructure as Code)로 정의합니다.

프로덕션 환경 운영에서의 고가용성과 데이터 보안에 중점을 둔 본 문서에서는 표준화된 Compose 디렉터리 구성, 내부 네트워크 격리, 그래픽 관리 패널에 대한 더 엄격한 권한 설정, 데이터베이스 마이그레이션을 고려한 원활한 업데이트 및 긴급 롤백 절차를 설명합니다. 또한 BandwagonHost 및 DMIT와 같은 주요 클라우드 공급업체의 콘솔 기능을 활용하여 하위 수준의 문제 해결과 운영상의 재해 복구에 대한 지침을 제공합니다.


1. 아키텍처 표준: 단일 애플리케이션 디렉터리 및 격리된 상태#

이식성과 몇 초 만의 콜드 마이그레이션을 보장하기 위해 호스트 수준의 컨테이너 오케스트레이션은 애플리케이션 스택당 하나의 디렉터리라는 원칙을 따라야 합니다. 격리를 위한 루트 경로로 /srv/stacks/<应用名> 또는 /opt/stacks/<应用名>를 표준으로 사용하는 것을 권장합니다.

텍스트
/opt/stacks/web-app/
├── compose.yaml          # 核心编排文件(Compose V2 规范)
├── .env                  # 敏感环境变量(权限 600,禁止提交至公开仓库)
├── config/               # 挂载至容器的应用专属静态配置文件
│   └── nginx.conf
└── data/                 # 宿主机绑定挂载的数据目录(非必要时优先使用命名卷)
    └── app-uploads/

디렉터리 및 자격 증명 관리 지침#

  1. 업데이트된 명명 규칙: 최신 Compose 플러그인은 기본 구성 파일로 일관되게 compose.yaml(또는 compose.yml)를 사용합니다. 오래된 최상위 version: '3.8' 선언 라인. 명령은 구식 독립 실행형 바이너리인 docker-compose 대신 일관되게 docker compose(단어 사이에 공백 포함)입니다.
  2. 환경 자격 증명 격리: 데이터베이스 비밀번호 및 API 토큰과 같은 동적 구성 값은 동일한 디렉터리의 .env 파일로 추출해야 하며, Compose는 자동으로 변수 보간(${VARIABLE_NAME}). 호스트를 보호하려면 이 파일의 권한을 엄격하게 제한해야 합니다:
    bash
    chmod 600 /opt/stacks/web-app/.env
    chown -R root:root /opt/stacks/web-app
  3. 버전 관리 경계: Git을 사용하여 운영 구성을 추적하는 경우, 리포지토리에 .env.example 템플릿을 포함하고 .gitignore에서 .env 및 실제 비즈니스 상태를 포함하는 모든 data/ 디렉터리를 엄격히 제외하세요.

2. 프로덕션급 오케스트레이션 표준 및 네트워크 격리#

모든 컨테이너 포트를 호스트의 0.0.0.0에 직접 매핑하는 것은 심각한 네트워크 보안 위험입니다. Docker 데몬은 시스템의 iptables 규칙을 직접 수정하고 DOCKER 체인을 삽입하여 시스템의 UFW 또는 firewalld 설정을 우회합니다. 데이터베이스나 캐시 서비스가 외부에 매핑되면 해당 포트가 공용 인터넷에 직접 노출됩니다.

다음은 분리된 애플리케이션 네트워크, 로그 순환 제한, 리소스 제약 조건 및 리버스 프록시를 위한 구성을 통합한 표준 compose.yaml 템플릿입니다:

yaml
services:
  web:
    image: ghost:5-alpine
    container_name: production_blog_web
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    environment:
      database__client: mysql
      database__connection__host: db
      database__connection__user: ghost
      database__connection__password: ${MYSQL_PASSWORD}
      database__connection__database: ghost_prod
      url: https://example.com
    volumes:
      - blog_content:/var/lib/ghost/content
    ports:
      # 严格限制仅监听宿主机本地环回接口,交由外部 Nginx 或 Caddy 处理 TLS 与反代
      - "127.0.0.1:2368:2368"
    networks:
      - frontend_net
      - backend_net
    deploy:
      resources:
        limits:
          cpus: '1.50'
          memory: 1024M
    logging:
      driver: json-file
      options:
        max-size: "20m"
        max-file: "3"

  db:
    image: mariadb:10.11
    container_name: production_blog_db
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ghost_prod
      MYSQL_USER: ghost
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
    # 绝不发布 ports,仅在内部网络被同栈应用发现
    networks:
      - backend_net
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "2"

volumes:
  blog_content:
    name: blog_app_content
  db_data:
    name: blog_app_db_data

networks:
  frontend_net:
    driver: bridge
  backend_net:
    driver: bridge

핵심 아키텍처 고려 사항#

  • 두 계층 네트워크 격리: db 컨테이너는 backend_net에만 참여하여 공용 인터넷과의 통신 가능성을 완전히 차단합니다. web 컨테이너는 Compose의 내장 DNS 및 서비스 이름 db을(를) 사용하여 확인하고 연결을 설정합니다.
  • 디스크 고갈 방지 설계: Docker의 기본 로깅 드라이버는 컨테이너 stdout/stderr 로그가 무제한으로 증가하도록 허용합니다. 구성에서 max-size 및 max-file을(를) 명시적으로 선언하면 로그 순환을 강제하여 디스크 가득 참으로 인해 저사양 VPS 인스턴스가 중단되는 것을 방지할 수 있습니다.
  • 이미지 버전 고정: 프로덕션 환경에서 :latest을(를) 직접 사용하지 마세요. 예기치 않은 재시작 중에 호환성을 깨뜨리는 변경 사항이 포함된 빌드를 가져오지 않도록, 명시적인 메이저 버전 또는 고정된 빌드 해시가 있는 안정적인 이미지(예: mariadb:10.11, alpine 브랜치)를 사용하세요.

3. 배포 검증 및 일반적인 명령 워크플로#

디렉터리 구조를 설정한 후에는 “구문 검사 $\\to$ 이미지 가져오기 $\\to$ 백그라운드 빌드 $\\to$ 상태 감사”의 표준 순서를 따릅니다:

bash
# 1. 验证配置文件合法性与变量解析状态(不显示敏感数据)
docker compose config --quiet

# 2. 预先抓取所有编排中的镜像,降低上线中断时长
docker compose pull

# 3. 后台守护模式创建并启动容器
docker compose up -d

# 4. 检查服务健康状态与端口监听
docker compose ps

# 5. 持续观测业务输出以排查初始化异常
docker compose logs -f --tail=100 web

문제 해결 시 주의 사항: docker compose config은(는) .env 모든 내부 변수가 완전히 확장됩니다. 팀이나 지원 티켓 시스템과 디버깅 정보를 공유할 때 온전히 정리되지 않은 전체 구성을 그대로 붙여넣지 마세요.


4. 시각적 패널(Portainer / 1Panel) 선택 및 공격 표면 축소#

일부 팀은 협업이나 모니터링을 간소화하기 위해 가벼운 컨테이너 관리 패널을 추가합니다. 하지만 다음 사항을 반드시 인식해야 합니다: Docker에 연결된 모든 관리 패널은 본질적으로 권한이 부여된 프로세스입니다.

Docker 소켓 보안 경계#

Portainer와 같은 거의 모든 시각적 관리 패널은 호스트의 Docker 통신 소켓을 마운트해야 합니다: -v /var/run/docker.sock:/var/run/docker.sock

이 소켓을 컨테이너에 마운트하면 동일한 호스트 수준의 root에 상응하는 제어 권한이 부여됩니다. 패널의 프론트엔드 비밀번호가 유출되거나 원격 코드 실행 취약점이 있는 경우, 공격자는 이 소켓을 사용하여 호스트의 루트 디렉터리를 마운트하는 특권 컨테이너를 생성함으로써 시스템 전체를 장악할 수 있습니다.

패널 보안 강화 지침#

  1. 공용 인터넷에 노출하지 않기: Portainer의 9443 또는 1Panel 포트와 같은 관리 패널 포트를 공용 인터넷에 직접 노출하지 마세요. 프로덕션 환경에서는 로컬 전용 수신(127.0.0.1)을 필수로 지정하고, 안전한 SSH 키 기반 터널을 통한 로컬 포트 포워딩을 통해서만 접근하도록 설정해야 합니다:
    bash
    # 在本地工作电脑建立安全隧道,将远程端口转发至本地
    ssh -N -L 9443:127.0.0.1:9443 user@vps-ip -i ~/.ssh/id_ed25519
    그런 다음 로컬 브라우저에서 열어 https://127.0.0.1:9443 패널에 접속합니다.
  2. 양방향 관리로 인한 구성 드리프트 방지: 그래픽 패널과 로컬 YAML 파일 간에 상태 충돌이 쉽게 발생할 수 있습니다. 로컬 compose.yaml이(가) 동기화되지 않은 상태에서 패널의 WebUI에서 직접 컨테이너의 매핑된 포트나 환경 변수를 변경하면, 다음에 터미널을 통해 docker compose up -d을(를) 실행할 때 패널에서 적용한 모든 임시 변경 사항이 완전히 지워집니다. 모범 사례: 패널은 읽기 전용 모니터링 또는 로그 감사 도구로만 사용하세요. 모든 생성, 읽기, 업데이트 및 삭제 작업에 대해 버전 관리 리포지토리와 터미널 스크립트를 단일 진실 공급원(Single Source of Truth)으로 유지하세요.

5. 원활한 이미지 업데이트, 데이터 마이그레이션 및 롤백 제어#

많은 초보자는 컨테이너를 업데이트하는 것이 최신 이미지를 가져와서 다시 시작하는 것만을 의미한다고 생각합니다. 지속성이 필요한 비즈니스 애플리케이션의 경우, 이는 데이터베이스 스키마 마이그레이션을 쉽게 중단시키거나 데이터를 손상시킬 수 있습니다.

표준 네 단계 롤링 업데이트 방식#

텍스트
[1. 业务静态化与状态备份] ──> [2. 拉取新镜像] ──> [3. 差异化重建容器] ──> [4. 健康校验]

첫 번째 단계: 애플리케이션 및 데이터베이스 콜드 백업 수행#

새 이미지로 전환하기 전에 호스트 디스크 스냅샷에만 의존하지 말고 데이터의 논리적 덤프를 생성하세요.

bash
# 进入部署目录
cd /opt/stacks/web-app

# 逻辑导出当前数据库数据并压缩
docker compose exec db mariadb-dump -u ghost -p"${MYSQL_PASSWORD}" ghost_prod | gzip > backup_$(date +%F_%H%M).sql.gz

# 备份持久化配置与上传目录
tar -czvf app_data_$(date +%F).tar.gz config/ data/

두 번째 단계: 이미지 업데이트 및 컨테이너 교체#

compose.yaml에서 대상 서비스(예: web)의 버전 태그를 수정한 다음 차분 리빌드를 수행합니다:

bash
# 仅拉取更新的镜像层
docker compose pull web

# 触发依赖项计算,仅重新创建发生了配置或镜像变更的容器
docker compose up -d web

# 清理不再使用的孤儿容器与旧版本镜像
docker compose ps
docker image prune -f

docker compose up -d을(를) 사용하면 정상 상태를 유지하는 별도의 데이터베이스 서비스를 중단하지 않고 스택을 제자리에서 업데이트할 수 있습니다.

치명적인 롤백 오해: 스키마 함정#

새 서비스 버전이 정상적으로 시작되지 않아 긴급 롤백이 필요한 경우, 많은 사람이 단순히 compose.yaml에서 이미지 버전을 이전 태그로 되돌리고 up -d을(를) 실행합니다.

치명적인 숨은 위험: Nextcloud, WordPress, Ghost와 같은 많은 웹 애플리케이션은 새 버전이 처음 시작될 때 열 삭제, 필드 이름 변경, 문자 집합 변환 등 되돌릴 수 없는 데이터베이스 스키마 마이그레이션을 자동으로 수행합니다. 이전 애플리케이션 코드는 새 버전에 의해 수정된 테이블을 해석할 수 없으므로, 이미지 롤백에 성공하더라도 오류와 충돌이 계속 발생합니다.

완전한 롤백 절차:

  1. 즉시 애플리케이션 컨테이너 중지: docker compose stop web
  2. 이전에 내보낸 백업을 사용하여 데이터베이스 복원:
    bash
    # 清空并恢复数据库
    gunzip < backup_YYYY-MM-DD.sql.gz | docker compose exec -T db mariadb -u ghost -p"${MYSQL_PASSWORD}" ghost_prod
  3. compose.yaml을(를) 수정하여 이전 이미지 태그와 해당 구성 파일을 복원합니다.
  4. 이전 컨테이너 버전 다시 빌드: docker compose up -d web

경고: docker compose down -v 사용 금지
docker compose down은(는) 컨테이너 및 브리지 네트워크만 중지하고 제거하지만, -v(또는 --volumes) 매개변수가 포함된 경우 Docker는 compose.yaml에 선언된 명명된 볼륨을 직접 삭제합니다. 환경을 완전히 파괴하려는 목적이 아니라면 프로덕션 서버에서 다음 옵션을 절대 사용하지 마세요: -v 명령.


6. 기본 클라우드 네트워킹 조율 및 긴급 운영#

컨테이너 오케스트레이션은 기반 클라우드 서버에서 실행됩니다. 네트워크 인터페이스 문제, 방화벽 차단 또는 자격 증명 유실은 컨테이너 라이프사이클을 직접 중단시킬 수 있습니다. 호스트의 인프라 기능을 효과적으로 활용하는 것이 운영 재해에 맞서는 최후의 방어선입니다.

방화벽 및 기본 연결 장애 문제 해결#

Docker는 NAT 테이블과 브리지 자체(docker0 / br-xxxx)를 직접 관리하므로, 컨테이너 재시작 후 라우팅 테이블 충돌이 종종 발생하여 호스트의 SSH 데몬에 연결할 수 없게 되기도 합니다.

  • DMIT 긴급 액세스: DMIT의 인스턴스 제어판은 전용 Web Console 진입점을 제공합니다. Docker 컨테이너가 포트를 점유하고 있거나 네트워크 정책에 의해 차단되어 SSH에 접속할 수 없는 경우, 패널의 Console을 사용하여 하드웨어 인터럽트를 전송하거나 직접 로그인하여 문제를 해결하십시오. 또한 무차별 대입 공격을 방지하기 위해 DMIT는 원격 root 비밀번호 로그인을 비활성화하고 SSH 키 기반 액세스를 적극 권장합니다. 패널의 Access 메뉴를 통해 공개 키를 일괄 교체하거나 주입해야 하는 경우, 작업 후 패널의 안내에 따라 인스턴스를 재부팅(Reboot)하면 기본 cloud-init 및 인증 메커니즘이 적용됩니다.
  • BandwagonHost KiwiVM 심층 문제 해결: BandwagonHost는 각 VPS에 독립된 KiwiVM 패널을 할당합니다. KiwiVM 패널 비밀번호, 고객 영역 계정 비밀번호, 시스템 내부 root 비밀번호는 완전히 별개라는 점에 유의하십시오. 호스트 네트워크에 장애가 발생하면 KiwiVM의 내장 Interactive Console을 사용하여 일반 네트워크 스택을 우회하고 TTY 터미널에 직접 접속한 뒤, root 비밀번호를 입력하여 서버의 제어권을 확보하십시오. 잘못된 컨테이너 네트워킹으로 인해 네트워크 전체가 비활성화된 경우, 패널을 통해 OS 재설치나 스냅샷 복원을 시작할 수도 있습니다.

자동 갱신 및 데이터 보존 경계#

컨테이너 오케스트레이션을 사용하면 애플리케이션을 빠르게 재구축할 수 있지만, 영구 데이터에 대한 노드 간 재해 복구를 대체하지는 못합니다. 청구서 결제 기한이 지나거나 데이터 센터 정책이 변경되면 호스트의 모든 데이터 볼륨이 즉시 영구 삭제될 수 있습니다.

  • 청구 및 보존 기간:
    • BandwagonHost: 해당 공급업체는 이용자의 개입 없이 연동된 신용카드나 PayPal 계정으로 자동 청구하지 않습니다. 갱신이 활성화된 경우 만료 7일 전에 청구서가 생성됩니다. 선불 계정 잔액이 충분하면 시스템에서 이를 차감하여 서비스를 갱신하며, 그렇지 않은 경우 관리자가 수동으로 결제를 완료해야 합니다.
    • DMIT: 월간 갱신 청구서 역시 만료 7일 전에 생성됩니다. 미납으로 인해 서비스가 정지될 경우, 데이터 센터에서 제공하는 데이터 보존 유예 기간은 일반적으로 3일에 불과합니다. 유예 기간이 만료되면 자동화 프로세스가 인스턴스와 마운트된 Docker 데이터를 영구적으로 파괴하며 복구할 수 없습니다.
  • 데이터 센터 간 이전 제한: BandwagonHost는 편리한 리전 간 데이터 센터 이전을 제공하지만, 금지된 아웃바운드 활동이나 남용으로 인해 인스턴스의 IP가 블랙리스트에 등록되면 시스템은 기본 패널에서의 이전을 엄격히 제한합니다. 잘못 구성된 컨테이너가 침해당해 외부 네트워크 스캔에 악용될 경우, IP 차단 및 서비스 중단부터 이전 및 복구 권한 상실에 이르는 불이익을 받을 수 있습니다.
  • 원격 재해 복구 최소 요구사항: 기본 공급업체와 관계없이, 영구 디렉터리(Volumes) 및 데이터베이스 Dump 백업은 매일 정기적으로 암호화하여 AWS S3, R2 또는 Backblaze B2와 같은 객체 스토리지 클라이언트를 사용해 호스트 외부에 업로드해야 합니다. 모든 계란을 단일 인스턴스의 가상 디스크라는 한 바구니에 담아두지 마십시오.

7. 프로덕션 인수인계 체크리스트#

모든 Docker Compose 배포 또는 메이저 버전 업데이트 후에는 다음 단계를 수행하여 인수인계 감사를 완료하십시오.

검증 범주주요 점검 항목검증 방법 / 예상 동작
네트워크 격리데이터베이스/미들웨어 포트가 공용 인터넷에 노출되지 않음호스트에서 실행 ss -tulpn | grep -E '3306|5432|6379' 외부 리스너 없음
권한 검토애플리케이션 컨테이너는 특권 모드를 사용하지 않아야 함compose.yaml 포함되어 있지 않음: privileged: true, 불필요한 호스트 마운트가 없음
리소스 제한메모리 및 CPU 하드 리밋이 구성되어 유효함시작 후 다음을 사용: docker stats --no-stream 컨테이너 메모리 제한이 적용되었는지 확인
로그 로테이션로그로 인해 호스트 디스크가 가득 차지 않음모든 서비스가 다음을 선언하고 있는지 확인: max-size 및 max-file 제한 사항
정전 후 자동 시작호스트 재부팅 후 자동 복구서비스 구성 restart: unless-stopped, 재시작 후 docker ps 표시됨
오프라인 백업원격 백업 전략 및 백업 검증자동화된 SQL 백업 파일이 비어 있지 않고 테스트 환경으로 정상 임포트되는지 확인
긴급 접속 채널항상 사용 가능한 운영 콘솔네트워크 장애 발생 시에도 저수준 문제 해결 접속이 가능하도록 공급업체의 콘솔 로그인 자격 증명을 사전에 확인