Coolify v4.5 업데이트: 도커 배포와 셀프 호스팅 PaaS의 변화

클라우드 서비스의 비용 부담을 줄이고 단일 서버에서 컨테이너 기반 서비스를 직접 제어하려는 개발자 사이에서 쿨리파이(Coolify)는 대표적인 오픈소스 플랫폼형 서비스(PaaS)로 자리 잡았습니다. 최근 공개된 Coolify v4.5 릴리스는 도커 배포 파이프라인의 안정성을 높이고, 컨테이너 관리와 자체 호스팅 개발 환경을 보완하는 여러 실질적인 변경점을 담고 있습니다.

이번 업데이트에서 가장 눈에 띄는 정책 변화는 도커 컴포즈(Docker Compose)의 복제본 설정 제한입니다. 또한 독립적인 저장소 환경을 선호하는 개발자를 위해 기티(Gitea) 공식 연동이 추가되었으며, 컨테이너 빌드 시스템과 API 토큰 보안 체계도 한층 엄격해졌습니다.

도커 컴포즈 다중 복제본 차단과 컨테이너 롤백

Coolify v4.5부터는 도커 컴포즈 파일에 scale 또는 replicas 설정이 1을 초과하는 경우 배포가 거부됩니다. 단일 호스트 인프라에서 프록시 라우팅과 포트 충돌 문제를 유발하던 다중 컨테이너 구성을 원천 차단하고 단일 컨테이너 인스턴스 중심의 안정성을 확보하기 위한 조치입니다.

이와 함께 레지스트리에 저장된 최근 배포 도커 이미지로 즉시 되돌리는 롤백 기능이 정식 도입되었습니다. 배포 직후 런타임 오류가 발생했을 때 이전 빌드를 다시 수행하지 않고도 직전 이미지 태그를 참조해 빠르게 서비스를 복원할 수 있습니다. 컨테이너 터미널에는 대화형 콘솔 모드인 docker attach 기능이 추가되어 실행 중인 컨테이너 내부 상태를 실시간으로 점검하기 쉬워졌습니다.

기티 연동과 빌드팩 기본값의 전환

프라이빗 저장소 지원 범위도 넓어졌습니다. 기존 깃허브와 깃랩 중심의 웹훅 연동에 더해 공식 기티 앱 소스를 등록해 개인 서버에 설치된 기티 저장소에서도 소스코드를 자동으로 가져와 배포할 수 있습니다. 클라우드 외부의 폐쇄망이나 독립된 자체 서버 인프라를 온전히 구성하려는 팀에게 유용한 변경점입니다.

컨테이너 이미지 빌드 도구 생태계에도 변화가 적용되었습니다. 오랫동안 사용되던 닉스팩(Nixpacks) 빌드팩은 지원 중단 절차에 들어갔으며 공식 추천 도구로 레일팩(Railpack)이 지정되었습니다. 프로젝트를 처음 등록할 때 도커파일과 환경 변수를 자동으로 탐색해 분석하는 스마트 스캔 기능도 함께 추가되어 프로젝트 생성 과정이 간결해졌습니다.

엄격해진 API 권한과 서버 보안

자동화 스크립트나 CI 파이프라인에서 Coolify를 제어할 때 사용하는 API 토큰 권한 체계가 세분화되었습니다. 기존에는 기본 토큰으로도 광범위한 제어가 가능했으나, 이제는 배포 권한이 명시적으로 부여된 토큰만 예약 작업 실행, 프록시 변경, 리소스 삭제와 같은 서버 부수 효과를 일으킬 수 있습니다. 백업 실행 메시지와 민감 정보도 기본 조회 권한만으로는 확인할 수 없도록 분리되었습니다.

서버 운영 측면에서는 운영체제 보안 패치를 자동으로 적용하고 위험 패키지나 재부팅 필요 여부를 서버 목록에서 경고해 주는 서버 패칭 기능이 베타로 탑재되었습니다. 쿨리파이 자체 업데이트를 수행하기 전 내부 데이터베이스를 자동으로 백업하는 로직도 기본 적용되어 업데이트 실패로 인한 데이터 손실 위험을 낮췄습니다.

어떤 환경에 적합하고 언제 피해야 하는가

Coolify v4.5는 개인 VPS나 단일 물리 서버에서 웹 애플리케이션, 데이터베이스, 백업을 손쉽게 통합 관리하려는 풀스택 개발자에게 적합합니다. 도커파일 작성에 익숙하지 않더라도 레일팩 기반의 자동 빌드와 SSL 인증서 자동 발급, 직관적인 컨테이너 롤백의 이점을 즉시 누릴 수 있습니다.

여러 대의 서버에 걸쳐 컨테이너를 분산 배치해야 하거나 도커 스웜(Docker Swarm)과 쿠버네티스 수준의 정교한 오케스트레이션이 필요한 대규모 프로덕션 환경이라면 적합하지 않을 수 있습니다. 도커 컴포즈 파일에 scale 설정을 적용해 로드밸런싱을 시도하던 기존 프로젝트를 이전할 때 배포 거부 오류가 발생할 수 있으므로 컴포즈 구조를 사전에 점검해야 합니다.