ServBay 문서: 프로젝트, 스크립트, 웹사이트에 특정 Node.js 버전 설정하기
ServBay는 강력한 로컬 웹 개발 환경으로, Node.js를 포함한 다양한 프로그래밍 언어와 기술 스택을 지원합니다. 실제 개발 현장에서는 프로젝트마다, 혹은 개별 스크립트 및 웹사이트마다 서로 다른 Node.js 버전이 필요할 수 있습니다. 예를 들어, 오래된 프로젝트는 Node.js 14에 의존할 수 있고, 최신 프로젝트는 Node.js 20의 새로운 기능을 활용해야 할 수도 있습니다. ServBay는 이런 요구에 맞춰 유연하게 대응할 수 있는 다양한 방법을 제공합니다.
이 문서에서는 ServBay에서 Node.js 스크립트나 웹사이트에 특정 Node.js 버전을 쉽게 지정하는 방법과 프로젝트 단위의 설정법을 상세히 설명합니다.
.servbay.config 파일로 프로젝트별 Node.js 버전 및 환경 설정하기
Node.js 버전과 관련 환경 변수의 엄격한 제어가 필요한 프로젝트는, 프로젝트 루트 디렉터리에 .servbay.config 파일을 생성하여 프로젝트 단위 설정을 할 수 있습니다. 이 파일을 통해 해당 프로젝트에서 사용할 Node.js 버전, 패키지 매니저 저장소, 캐시 디렉터리 등 세부 설정을 지정할 수 있어 환경의 격리성과 일관성이 보장됩니다.
특정 버전의 Node.js와 npm/yarn 저장소·캐시 경로를 지정한 .servbay.config 예시는 다음과 같습니다:
bash
NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # 예시: 특수 미러 사용
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # 예시: 특수 미러 사용
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # 예시: 캐시 경로 지정
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # 예시: 캐시 경로 지정1
2
3
4
5
2
3
4
5
설명:
NODE_VERSION: 프로젝트에서 사용할 Node.js 주 버전을 지정합니다. ServBay는 이 버전에 맞는 설치된 Node.js를 자동으로 사용합니다.YARN_CONFIG_REGISTRY,NPM_CONFIG_REGISTRY: 프로젝트에 사용할 npm 또는 yarn 패키지 매니저의 저장소 주소를 지정합니다.NPM_CONFIG_CACHE,YARN_CONFIG_CACHE: 패키지 매니저의 캐시 디렉터리 경로를 설정합니다. 예시에서는 ServBay의 기본 임시 디렉터리(/Applications/ServBay/tmp/) 하위 폴더를 활용합니다.
일반적으로 .servbay.config 파일은 프로젝트 최상위 폴더에 위치해야 합니다. 상세 설정 및 사용 방법은 ServBay 공식 문서의 .servbay.config 파일 섹션을 참고하세요.
커맨드라인에서 특정 Node.js 버전으로 스크립트 실행하기
프로젝트 전체가 아닌 단일 스크립트나 명령에 한해 일시적으로 특정 Node.js 버전을 사용하려면, ServBay가 제공하는 커맨드라인 별칭(alias)을 활용할 수 있습니다.
ServBay의 터미널 환경(ServBay 앱의 터미널 열기를 사용할 수 있음)에서는, node-<버전> 형태의 명령어로 원하는 Node.js 버전으로 간편하게 스크립트를 실행할 수 있습니다. ServBay는 설치된 각 Node.js 버전에 대해 이런 별칭을 자동 생성합니다.
예를 들어, Node.js 14로 script.js를 실행하려면 다음과 같이 입력하면 됩니다:
bash
$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # 예시 출력, 실제 버전은 다를 수 있습니다
$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # 예시 출력, 실제 버전은 다를 수 있습니다
$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # 예시 출력, 실제 버전은 다를 수 있습니다1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
예시 설명
$ node-14 script.js: ServBay에 설치된 Node.js 14.x.x로script.js를 실행합니다(구체적 마이너 버전은 설치 상황에 따라 다름).$ node-16 script.js: ServBay 내 Node.js 16 버전으로 스크립트를 실행.$ node-20 script.js: ServBay 내 Node.js 20 버전으로 스크립트를 실행.
이 방법을 사용하면 전역 Node.js 버전을 변경하지 않고도 여러 Node.js 버전의 호환성 테스트나, 특정 버전이 필요한 작업을 매우 편리하게 실행할 수 있습니다.
ServBay 관리 페이지에서 웹사이트의 기본 Node.js 버전 지정하기
ServBay는 웹 관리 인터페이스를 통해 호스팅 중인 각 웹사이트별로 Node.js 실행 버전을 손쉽게 지정할 수 있습니다. Node.js를 백엔드로 활용하는 웹사이트(예: Caddy, Nginx의 리버스 프록시로 Node.js 프레임워크 앱 사용 등)나, 특정 Node.js 환경이 필요한 사이트에 매우 유용합니다.
단계별 설정 방법
ServBay 관리 페이지 열기
ServBay 앱을 실행하고, 브라우저에서 관리 페이지(기본 주소는http://localhost:5200혹은 ServBay 메인 화면의 링크)를 엽니다.웹사이트 관리로 이동
메뉴바 좌측의웹사이트(Website) 항목을 클릭합니다.웹사이트 선택 및 편집
목록에서 설정하려는 웹사이트(예:/Applications/ServBay/www/servbay.demo에 생성된 사이트)를 찾아, 해당 행 우측의 편집(톱니바퀴 또는 연필모양) 아이콘을 클릭하거나, 사이트명을 클릭해 상세 페이지로 이동합니다.Node.js 버전 지정
설정 화면에서 Node.js 버전 관련 항목을 찾습니다. 일반적으로 드롭다운 메뉴 형식이며, 여기서 해당 사이트의 기본 Node.js 버전을 선택하면 됩니다.변경사항 저장
버전을 선택한 후에는 반드시 하단의저장또는적용버튼을 눌러야 변경사항이 반영됩니다.웹사이트 또는 ServBay 재시작(필요 시)
설정을 적용하려면 Caddy, Nginx 등 관련 웹서버 또는 전체 ServBay를 재시작해야 할 수 있습니다. ServBay는 필요한 경우 자동으로 재시작 안내 메시지를 표시합니다.
유의사항
- Node.js 버전 설치 및 구동 확인: 웹사이트 설정에서 선택 가능한 Node.js는 ServBay의
소프트웨어 패키지(Packages) 페이지에 설치 및 활성화되어 있어야 합니다. 미설치/미실행된 경우, 해당 페이지에서 별도로 설치/시작해주세요. - 웹사이트 유형: 이 설정은 Node.js를 백엔드 런타임으로 사용하는 사이트(Ex: Express.js, Next.js, NestJS 등)에서 의미가 있습니다. 순수 정적 사이트나, 완전히 PHP/Python/Go로 동작하는 사이트에는 적용 또는 영향이 제한적일 수 있습니다.
- 호환성 테스트: Node.js 버전을 변경한 후에는 사이트 기능을 충분히 테스트해, 의존 패키지 및 서비스가 새 버전에서도 정상 작동하는지 꼭 확인해야 합니다.
.servbay.config와의 관계: 웹사이트 설정 메뉴에서 지정한 Node.js 버전은 기본값입니다. 만약 사이트 디렉터리에.servbay.config파일과 그 안의NODE_VERSION항목이 있다면, 프로젝트별 세부 설정이 우선 적용됩니다(더 세밀한 제어를 위한 우선순위).
요약
ServBay는 통합적이고 유연한 로컬 개발 환경으로, 다양한 방식으로 Node.js의 버전 및 환경을 관리·지정할 수 있습니다. 프로젝트 루트의 .servbay.config 파일로 세밀한 설정과 환경 변수 통제를 할 수 있고, node-<버전> 커맨드로 빠르게 특정 Node.js 버전의 스크립트를 실행할 수 있습니다. 더불어 관리 인터페이스에서 웹사이트별 기본 Node.js 버전 지정도 지원합니다. 이 모든 기능들은 프로젝트별 요구에 맞는 Node.js 환경을 쉽게 구축하고, 구버전 호환성부터 신규 기능 테스트, 개발/운영 환경 일치까지 모두 효율적으로 관리할 수 있도록 도와줍니다. ServBay를 활용해 개발 생산성과 환경 관리 능력을 한층 높여보세요.
