1. 홈
  2. 개발자
  3. systemd 서비스 생성기

systemd 서비스 생성기

실행 명령과 옵션을 넣으면 systemd 서비스와 타이머 파일이 만들어집니다.

다른 형식·기능까지 한 번에 하려면 서버 설정 파일 생성기 →

내 브라우저에서 처리 · 업로드 없음
비밀번호·토큰은 여기에 쓰지 말고 아래 환경 파일에 넣으세요.
서비스 파일
[Unit] Description=My application After=network-online.target Wants=network-online.target [Service] Type=simple User=myapp Group=myapp WorkingDirectory=/opt/myapp ExecStart=/usr/bin/node /opt/myapp/server.js Restart=on-failure RestartSec=5 EnvironmentFile=/etc/myapp/myapp.env Environment="NODE_ENV=production" NoNewPrivileges=true PrivateTmp=true ProtectHome=true ProtectSystem=strict ReadWritePaths=/var/lib/myapp [Install] WantedBy=multi-user.target
설치·실행 방법
# create the service user if it does not exist sudo useradd --system --no-create-home --shell /usr/sbin/nologin myapp # create the environment file for secrets (systemd reads it as root, so 600 is enough) sudo mkdir -p /etc/myapp sudo touch /etc/myapp/myapp.env sudo chmod 600 /etc/myapp/myapp.env # save as /etc/systemd/system/myapp.service sudo systemd-analyze verify /etc/systemd/system/myapp.service sudo systemctl daemon-reload sudo systemctl enable --now myapp.service systemctl status myapp.service journalctl -u myapp.service -f
운영 서버에 반영하기 전에 검토하세요. ProtectHome 과 ProtectSystem 은 앱이 /home 이나 시스템 경로에 쓰면 실패하게 만듭니다. systemd-analyze verify 로 먼저 확인하세요.

입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

사용 방법

  1. 서비스 이름, 실행 명령(ExecStart), 작업 디렉터리, 실행 사용자·그룹을 입력합니다. 실행 명령은 /usr/bin/node 처럼 절대 경로여야 합니다.
  2. 재시작 정책, 환경 변수, 환경 파일, 보안 강화, 메모리·파일 수 제한을 필요한 만큼 설정합니다.
  3. 주기 실행이 필요하면 타이머를 켭니다. 서비스는 oneshot 으로 바뀌고 .timer 파일이 함께 만들어집니다. 크론 표현식을 넣으면 OnCalendar 값으로 바꿔 줍니다.
  4. 생성된 파일을 /etc/systemd/system/ 에 저장하고, 하단에 나오는 systemd-analyze verify, daemon-reload, enable --now 명령을 순서대로 실행합니다.

주요 항목

항목 지시어 설명
서비스 종류 Type= simple 은 ExecStart 프로세스를 그대로 서비스로 취급합니다. 한 번 실행하고 끝나는 작업은 oneshot, 스스로 백그라운드로 가는 프로그램은 forking
재시작 Restart=, RestartSec= on-failure 는 비정상 종료일 때만, always 는 정상 종료여도 다시 시작
네트워크 대기 After=, Wants=network-online.target 네트워크가 연결된 뒤 시작
환경 파일 EnvironmentFile= 비밀값을 유닛 파일 밖으로 분리. 앞에 - 를 붙이면 파일이 없어도 시작
보안 강화 NoNewPrivileges, PrivateTmp, ProtectSystem, ProtectHome 권한 상승 차단, 전용 /tmp, 시스템·홈 디렉터리 읽기 전용 또는 접근 차단
쓰기 허용 경로 ReadWritePaths= ProtectSystem=strict 일 때 앱이 쓸 수 있는 경로
리소스 MemoryMax=, LimitNOFILE= 메모리 상한과 열 수 있는 파일 수

크론 표현식을 OnCalendar 로

타이머를 켜면 크론 표현식을 OnCalendar 로 바꾸는 칸이 나옵니다. 이 도구의 변환 결과는 다음과 같습니다.

크론 OnCalendar
0 3 * * * *-*-* 03:00:00
0 9 * * 1-5 Mon..Fri *-*-* 09:00:00
30 2 * * 0 Sun *-*-* 02:30:00
*/15 * * * * *-*-* *:00/15:00
0 0 1 * * *-*-01 00:00:00
0,30 9-17 * * * *-*-* 09..17:00,30:00

일과 요일을 모두 지정한 크론(0 0 13 * 5)은 둘 중 하나만 맞아도 실행되지만, systemd 는 두 조건이 모두 맞아야 실행됩니다. 이 경우 경고를 보여 줍니다. @reboot 는 OnCalendar 대신 타이머의 OnBootSec 을 쓰세요. 크론 표현식 자체를 만들거나 확인하려면 크론 표현식 생성기와 크론 표현식 해석기를 이용하세요.

주의할 점

  • ProtectHome=true 는 /home 아래를 앱에서 보이지 않게 합니다. 작업 디렉터리가 /home 아래라면 보안 강화 옵션을 끄거나 경로를 옮기세요. ProtectSystem=strict 는 ReadWritePaths 에 적은 곳 외에는 쓰기를 막습니다.
  • 비밀번호·토큰은 Environment= 에 직접 적지 말고 EnvironmentFile= 로 분리하고 파일 권한을 600 으로 하세요. 유닛 파일과 systemctl show 출력은 다른 사용자도 볼 수 있습니다. 권한 숫자는 chmod 계산기로 확인하세요.
  • Environment 값의 % 는 systemd 지정자 표시라서 이 도구가 %% 로 바꿔 줍니다. 따옴표와 역슬래시도 이스케이프합니다.
  • 입력값에 줄바꿈이 있으면 공백으로 바꿔서 다른 지시어를 끼워 넣는 일을 막습니다.
  • 생성된 유닛 파일은 운영 서버에 반영하기 전에 검토하세요. 앱에 따라 TimeoutStopSec, ExecReload, 로그 설정이 더 필요할 수 있습니다.
  • 환경 변수 파일 형식은 환경 변수 변환기에서 JSON·YAML 등으로 바꿔 볼 수 있고, 컨테이너로 운영한다면 Dockerfile 생성기와 Nginx 설정 생성기가 이어집니다.

자주 묻는 질문

서비스 파일은 어디에 저장하나요?

직접 만든 유닛은 /etc/systemd/system/이름.service 에 둡니다. 저장한 뒤 sudo systemctl daemon-reload 로 systemd 가 새 파일을 읽게 해야 합니다.

서비스가 시작되지 않을 때 어디를 보나요?

systemctl status 이름.service 로 상태와 마지막 로그를, journalctl -u 이름.service -n 100 으로 더 많은 로그를 봅니다. status=203/EXEC 는 ExecStart 경로나 실행 권한 문제인 경우가 많습니다.

크론 대신 타이머를 쓰면 무엇이 좋은가요?

실행 로그가 journal 에 모이고, Persistent=true 로 서버가 꺼져 있던 동안 놓친 실행을 켜질 때 수행하며, 실행 환경을 서비스 유닛으로 일관되게 관리할 수 있습니다.

Type=simple 과 forking 중 무엇을 쓰나요?

프로그램이 포그라운드에서 계속 실행되면(대부분의 Node, Python, Go 앱) simple 입니다. 스스로 fork 해서 부모가 종료되는 전통적인 데몬이면 forking 을 씁니다.

입력한 내용이 서버로 전송되나요?

아니요. 파일은 브라우저 안에서만 만들어집니다.

입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

필요한 도구가 없나요?

어떤 작업을 하고 싶은지 적어 주세요. 요청이 많은 도구부터 만듭니다.