Ghost Docker Node.js 버전 확인: 실행 컨테이너와 호환성 점검
Ghost를 Docker로 운영할 때 Node.js 버전을 확인하려면, 먼저 실제 Ghost 컨테이너 안에서 node --version을 실행해야 한다. 호스트 터미널의 node -v나 Compose에 적힌 이미지 태그만으로는 컨테이너의 실행 환경을 확인할 수 없다.
2026년 11월 13일 OCI A1에서 Ghost 6.77.0 후보 이미지를 점검할 때도 이미지 이름, 실제 Node 버전, Ghost가 요구하는 버전 범위를 따로 확인했다. 이 글은 그날의 점검 기록과 공식 문서를 바탕으로, 무엇을 조회하고 어디까지 정상이라고 판단할 수 있는지 정리한다.
문서 확인일은 2026-11-16이다. 아래 운영 기록은 11월 13일의 관찰값이며, 글 작성 시점에 운영 서버에서 다시 실행한 결과는 아니다. 이후 버전은 해당 이미지와 공식 지원 문서를 다시 확인해야 한다.
1. 호스트 Node와 컨테이너 Node를 구분한다
같은 서버에서 확인하더라도 다음 값들은 서로 다른 대상을 가리킬 수 있다.
| 확인한 곳 | 무엇을 보여 주는가 |
|---|---|
호스트 셸의 node -v |
호스트의 PATH에서 선택된 Node |
docker exec <컨테이너> node --version |
해당 컨테이너에서 새로 실행한 Node |
Ghost의 package.json |
설치된 Ghost 버전과 선언된 Node 요구 범위 |
Compose의 image: |
배포에 사용할 이미지 참조 |
실행 컨테이너의 .Image |
그 컨테이너를 생성한 로컬 이미지 ID |
컨테이너 이미지에 포함된 Node를 사용하는 일반적인 배포에서는 호스트 Node를 업데이트해도 컨테이너의 Node가 함께 바뀌지 않는다. 호스트에 Node가 없어도 컨테이너의 Ghost는 실행될 수 있다. 버전 조회를 위해 호스트에 Node를 새로 설치할 필요도 없다.
Ghost 공식 Docker 이미지 안내는 Node 버전을 확인할 때 docker exec <container-id> node --version을 사용하도록 설명한다. Ghost-CLI의 여러 명령은 Docker 이미지 운영 방식에 맞지 않는다는 주의사항도 있다. 호스트·CLI 설치용 업데이트 절차를 컨테이너 내부에 그대로 적용하기 전에 배포 방식을 먼저 구분하자.
2. 먼저 조회할 컨테이너를 고정한다
서버에 Ghost가 여러 개 있거나 테스트 프로젝트가 따로 있다면, 올바른 Node 버전을 읽고도 다른 서비스의 결과를 보고 있을 수 있다.
현재 Docker context와 Compose 버전을 확인한다.
docker context show
docker compose version
기존 배포에 사용한 Compose 파일·프로젝트·서비스를 기준으로 컨테이너를 찾는다. 다음 경로와 이름은 예시다. 여러 -f 파일이나 --env-file을 사용했다면 기존과 같은 인자를 지정한다.
docker compose -f /path/to/compose.yaml -p your-project ps -a
대상을 확인했다면 운영자 로컬에서 변수에 지정한다. 이후 예시도 이 변수를 이어서 사용한다.
ghost_container='<실제 Ghost 컨테이너 이름 또는 ID>'
docker inspect --type container \
--format 'image_ref={{.Config.Image}} image_id={{.Image}} state={{.State.Status}}' \
"$ghost_container"
.Config.Image는 생성할 때 지정한 이미지 참조이고, .Image는 그 컨테이너의 실제 로컬 이미지 ID다. 태그는 같은 이름으로 갱신될 수 있으므로 두 항목을 함께 기록한다.
ghost_image_id=$(
docker inspect --type container --format '{{.Image}}' "$ghost_container"
)
docker image inspect \
--format 'id={{.Id}} arch={{.Architecture}} digests={{json .RepoDigests}}' \
"$ghost_image_id"
Docker inspect와 image inspect의 형식 지정 기능으로 필요한 필드만 읽는 예시다. 전체 docker inspect 출력에는 환경변수와 내부 구성이 포함될 수 있으므로 게시용 로그로 그대로 복사하지 않는다.
로컬 이미지 ID와 레지스트리의 digest는 역할이 다르다. 둘의 문자열이 같아야 정상인 것은 아니다. 로컬에서 빌드하거나 가져온 방식에 따라 RepoDigests가 비어 있을 수도 있으므로, 비어 있다는 이유만으로 실행 실패라고 판단하지 않는다.
Compose 파일의 태그를 바꿨거나 이미지를 pull했다는 사실만으로 실행 컨테이너까지 바뀌었다고 보지 않는다. 반영 방식은 Docker Compose 환경변수 변경이 적용되지 않을 때: restart와 재생성 구분에서 다룬 설정·실행 대상 구분과 함께 확인할 수 있다.
3. Node 버전과 Ghost 요구 범위를 같은 위치에서 읽는다
먼저 가장 짧은 조회부터 실행한다.
docker exec "$ghost_container" node --version
컨테이너가 중지돼 있으면 이 명령은 실행되지 않는다. Docker exec 문서에서 설명하듯 실행 중인 컨테이너에 새 명령을 시작하는 기능이기 때문이다. 진단을 위해 운영 컨테이너를 무작정 재시작하지 말고 먼저 상태와 기존 오류를 확인한다.
이어서 Ghost 버전과 Node 요구 범위를 읽는다. 아래 경로는 11월 13일 점검한 기본 bookworm 이미지 구조를 전제로 한다.
ghost_package='/var/lib/ghost/current/package.json'
docker exec \
--env PROBE_PACKAGE="$ghost_package" \
"$ghost_container" node -e '
const p = require(process.env.PROBE_PACKAGE);
console.log(JSON.stringify({
ghost: p.version,
requiredNode: p.engines.node,
node: process.versions.node,
openssl: process.versions.openssl,
moduleABI: process.versions.modules,
arch: process.arch,
executable: process.execPath
}, null, 2));
'
next 이미지나 사용자 정의 이미지에서는 설치 구조가 다를 수 있다. 현재 공식 이미지 문서는 next의 설치 위치를 /home/ghost로 설명한다. 파일을 찾지 못하는 오류가 나오면 Node 비호환으로 결론내리기 전에 이미지 종류와 실제 패키지 경로를 확인한다.
출력은 다음처럼 해석한다.
| 필드 | 의미 |
|---|---|
ghost |
해당 패키지 파일에 기록된 Ghost 버전 |
requiredNode |
그 Ghost 릴리스가 선언한 Node 버전 범위 |
node |
조회 명령을 실행한 Node 버전 |
openssl |
그 Node가 보고한 OpenSSL 구성요소 버전 |
moduleABI |
Node 네이티브 모듈 ABI 버전 |
arch |
해당 Node 바이너리의 아키텍처 |
executable |
조회 명령을 실행한 Node 실행 파일 경로 |
Node.js process 문서에 따르면 process.versions.modules는 ABI 버전이다. 127이라는 값이 나와도 패키지 127개가 설치됐다는 뜻은 아니다. OpenSSL 값 역시 호스트의 openssl version과 같은 대상을 조회한 것이 아니며, 그 숫자 하나로 모든 보안 점검이 끝나는 것도 아니다.
또 하나의 경계가 있다. docker exec ... node는 이미 실행 중인 Ghost 프로세스 자체에 질문하는 명령이 아니라, 컨테이너에서 새 Node 프로세스를 실행한다. 여러 Node 바이너리나 별도 시작 스크립트를 사용하는 배포, 컨테이너 안에서 바이너리를 교체한 이력이 있는 환경이라면 기존 Ghost 프로세스와 동일한 실행 파일인지도 대조해야 한다.
4. “Node 22”라는 큰 번호만 비교하지 않는다
2026-11-16에 확인한 Ghost의 지원 Node 버전 문서는 Node 22·24 LTS를 지원 대상으로 안내하며, Ghost 6.77.0부터 다음 범위를 표시한다.
^22.23.5 || ^24.22.3
이 범위에서는 같은 Node 22라도 22.23.4와 22.23.5의 판정이 다르다. 더 큰 주 버전이라는 이유만으로 Node 25나 26이 자동으로 지원되는 것도 아니다.
다음 표는 위 범위에 대한 semver 판정 예시다. 실제 Ghost 부팅 실험 결과가 아니다.
| 입력 버전 | 위 범위에 포함되는가 |
|---|---|
| 22.23.4 | 아니오 |
| 22.23.5 | 예 |
| 24.22.2 | 아니오 |
| 24.22.3 | 예 |
| 25.0.0 | 아니오 |
문자열의 크기를 단순 비교하지 않고 node-semver의 범위 규칙을 사용한다. Ghost 설치에 semver가 포함된 환경에서는 다음처럼 실제 패키지를 기준으로 판정할 수 있다.
docker exec \
--env PROBE_PACKAGE="$ghost_package" \
"$ghost_container" node -e '
const {createRequire} = require("node:module");
const r = createRequire(process.env.PROBE_PACKAGE);
const p = r("./package.json");
const semver = r("semver");
const supported = semver.satisfies(process.versions.node, p.engines.node);
console.log(JSON.stringify({
ghost: p.version,
node: process.versions.node,
requiredNode: p.engines.node,
supported
}));
process.exitCode = supported ? 0 : 2;
'
이 예시에서 종료 코드 2는 검사 코드가 정한 “범위 불일치” 표시다. Ghost 자체의 공통 오류 코드라는 뜻은 아니다. semver 또는 패키지 파일을 찾지 못하면 검사 준비가 실패한 것이므로, 그 결과를 Node 지원 범위 불일치와 구분한다. 조회를 위해 운영 컨테이너에 패키지를 즉석 설치하지 않는다.
새 Ghost 버전을 사용할 때는 위 범위를 영구 기준으로 고정하지 말고, 해당 이미지의 engines.node와 그 릴리스의 공식 지원 안내를 다시 비교한다.
5. OCI A1에서 확인한 것은 어디까지였나
2026-11-13 후보 이미지 점검 기록에서는 다음 값을 확인했다. 공개용으로 항목을 추렸으며, 전체 실행 로그를 그대로 옮긴 표는 아니다.
| 항목 | 당시 후보에서 확인한 값 |
|---|---|
| 이미지 | docker.io/library/ghost:6.77.0-bookworm |
| 아키텍처 | arm64 |
| Ghost | 6.77.0 |
| Node.js | 22.23.5 |
| OpenSSL | 3.5.9 |
| Ghost의 Node 요구 범위 | Node 22: ^22.23.5, Node 24: ^24.22.3 |
| 엔진 호환 판정 | true |
| 후보 검사 종료 코드 | 0 |
후보 검사에서는 운영 컨테이너가 변경되지 않았다는 표시를 확인했다. 이어진 준비 단계에서도 같은 후보 이미지 ID와 Ghost·Node 버전을 확인했고, 준비 완료 기록에는 production_deployed=false, production_changed=false가 남았다.
이는 그 단계에서 후보를 검사했다는 기록이다. 이후 운영 배포까지 하지 않았다는 뜻으로 확대해서 읽으면 안 된다. 후보 이미지, 준비 환경, 운영 컨테이너의 결과는 각각의 시점과 실행 대상을 붙여 보관해야 한다.
당시 검사 도구에는 node_security_minimum_met 같은 항목도 있었다. 이 값은 도구에 정한 버전 조건을 통과했는지 보여 준다. 모든 취약점이 없다는 보증이나 최신 보안 검토의 대체물로 사용하지 않았다.
전체 업그레이드·보안 점검의 흐름은 서버 보안 점검 8편: Ghost·MySQL 일반 보안 점검 재시작과 업그레이드 실전기와 연결해서 읽을 수 있다. 이번 글의 초점은 그 과정 중 Node 런타임을 식별하는 부분이다.
6. 버전 호환과 모듈 동작은 따로 확인한다
버전 범위가 맞아도 의존 모듈이 정상적으로 로딩되는지는 별도 질문이다. Ghost 공식 문서도 Node 변경 시 바이너리 의존성의 재설치가 필요할 수 있음을 설명한다. 그렇다고 Docker 운영 컨테이너 안에서 Node와 의존성을 바로 교체하라는 뜻은 아니다.
11월 13일 준비 도구는 다음 항목을 검사하도록 작성됐다.
| 검사 | 확인할 수 있는 범위 | 확인하지 못하는 것 |
|---|---|---|
better-sqlite3로 :memory: DB를 열고 SELECT 1 실행 |
해당 모듈 로딩과 최소 메모리 쿼리 | 운영 MySQL 연결·데이터 정합성 |
@tryghost/image-transform.canTransformFiles() |
이미지 모듈이 보고하는 변환 지원 여부 | 특정 파일의 변환·목록 이미지 HTTP 응답 |
mysql2/promise의 연결 함수 로딩 |
드라이버 코드 사용 가능 여부 | 실제 인증·TLS·DB 접속 성공 |
이 표는 저장된 검사 코드의 구성이다. 코드에 조건이 있다는 사실만으로 모든 항목의 실행 성공을 새로 주장하지 않는다.
추가 재현은 운영 볼륨·DB 자격증명을 넣지 않은 별도 테스트 환경에서 진행할 수 있다. 정확한 후보 이미지 ID와 플랫폼을 고정하고, 검사별 결과와 종료 코드를 남긴다. SQLite는 메모리 DB를 사용하며, 이미지 변환은 작은 테스트 파일을 실제로 변환한 뒤 결과의 형식·치수를 확인한다. 운영 DB에 연결하거나 Ghost를 부팅하는 검사는 별도 단계로 둔다.
특히 변환 가능 플래그가 true인 것과 실제 목록 이미지가 보이는 것은 다르다. mLog의 상세 이미지는 보이는데 목록 썸네일이 안 나왔던 사례처럼 최종 웹 요청은 크기별 URL과 응답, 브라우저 표시까지 따로 확인해야 한다.
7. 결과에 따라 다음 확인 대상을 정한다
| 관찰 | 다음 확인 |
|---|---|
| 호스트와 컨테이너의 Node 버전이 다름 | 서로 다른 실행 환경인지 확인. 차이 자체를 장애로 보지 않기 |
| Node가 Ghost 요구 범위를 벗어남 | 정확한 Ghost 릴리스·이미지 variant·배포 설정 대조 |
| 태그는 예상대로인데 실행 이미지 ID가 다름 | 조회한 프로젝트·서비스와 이미지 반영 이력 확인 |
| 패키지 파일을 찾지 못함 | 기본·next·사용자 정의 이미지의 설치 경로 확인 |
| 버전은 맞지만 모듈 로딩 실패 | 전체 오류 종류, 플랫폼, 실행 파일, 후보 이미지의 의존성 구성 확인 |
| 런타임 검사는 통과했지만 웹 기능 실패 | DB·메일·프록시·실제 이미지 요청으로 점검 범위 이동 |
운영 변경 전에 Ghost·MySQL 백업 무결성과 복구 수단을 확인한다. 호환성 결과가 true라는 이유만으로 DB 마이그레이션을 되돌릴 수 있거나 업데이트가 무중단이라고 결론내리지 않는다.
문제를 공유할 때는 실행 날짜, Ghost·Node 버전, 이미지 종류, 플랫폼, 지원 범위와 최소 오류 메시지를 남기면 된다. 서버 IP·실제 컨테이너명·비밀값·전체 환경변수 출력은 제외한다.
이 글의 semver 예시 5건은 작성 환경에서 판정값을 확인했다. 운영 Docker 명령과 의존 모듈 실험은 이번 작성 환경에서 실행하지 않았다. 따라서 현재 서버의 성공 결과로 제시한 부분은 없으며, 실제 경험 표는 2026-11-13 기록에 한정한다.
참고 문서
공식 문서 확인일: 2026-11-16.