사용 방법
- 서비스 이름, 실행 명령(ExecStart), 작업 디렉터리, 실행 사용자·그룹을 입력합니다. 실행 명령은
/usr/bin/node처럼 절대 경로여야 합니다. - 재시작 정책, 환경 변수, 환경 파일, 보안 강화, 메모리·파일 수 제한을 필요한 만큼 설정합니다.
- 주기 실행이 필요하면 타이머를 켭니다. 서비스는
oneshot으로 바뀌고.timer파일이 함께 만들어집니다. 크론 표현식을 넣으면OnCalendar값으로 바꿔 줍니다. - 생성된 파일을
/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 을 씁니다.
입력한 내용이 서버로 전송되나요?
아니요. 파일은 브라우저 안에서만 만들어집니다.
입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.