본문 바로가기
기타

nssm으로 Windows 서비스 등록하기

by 알래스카비버 2025. 6. 23.

Node.js 애플리케이션을 Windows 서비스로 실행해야 할 일이 있어

nssm으로 서비스 등록하는 방법에 대해 적어봅니다.

 

1. nssm (Non-Sucking Service Manager)

Windows에서 일반 실행 파일, 스크립트(Node.js, Python 등)를 윈도우 서비스로 등록할 수 있도록 해주는 유틸리티라고 합니다

sc로 서비스를 등록하려 했지만 실행 파일(exe 파일)이나 스크립트로만 가능하다고 해서 nssm을 선택했습니다.

 

2. 등록 방법

    1. nssm 다운로드

        nssm 페이지에 접속해 파일을 다운로드

        https://nssm.cc/download

    2. 압축 풀기

        다운로드 받은 파일을 원하는 위치에 압축 풀기

        예시) D:\nssm-2.24

    3. cmd 실행 > nssm 설치 폴더 하위에 nssm.exe 가 있는 폴더로 이동

        cd D:\nssm-2.24\win64

    4. nssm 실행

        nssm install 서비스명

    5. 등록 화면이 뜨게 되는데 항목 입력 > Install service

        Path : 실행할 프로그램의 경로 (ex: C:\Program Files\nodejs\node.exe)

        Startup directory : 프로그램이 실행될 때의 현재 작업 디렉터리 (ex: D:\test)

        Arguments : Path로 지정한 실행파일에 넘길 인자 (ex: D:\test\src\index.mjs)

    6. 서비스 시작

        nssm start 서비스명

        서비스가 시작됩니다. (아래 서비스에서도 등록된 서비스 확인 가능)

    7. 기타

        명령어

             1. 서비스 시작 : nssm start 서비스명

             2. 서비스 중지 : nssm stop 서비스명

             3. 서비스 상태 확인 : nssm status 서비스명

             4. 서비스 수정 : nssm edit 서비스명

             5. 서비스 삭제 : nssm remove 서비스명

        각 탭에서 옵션 지정 가능 (ex: I/O 탭에서 위치 지정 시 로그도 남기기)

 

댓글