Debian 13 강좌 / systemd 서비스와 drop-in 설정 적용
Debian 13에서 systemd 서비스의 active는 현재 실행 상태를, enabled는 부팅 시 시작하도록 연결된 상태를 나타냅니다. 설정 파일이나 drop-in을 수정했다면 daemon-reload로 관리자의 설정을 다시 읽고, 변경된 실행 명령은 서비스를 재시작한 뒤 실제 응답까지 확인해야 합니다.
서비스 상태를 두 가지 축으로 읽기
systemd는 서비스·타이머·마운트 등의 작업을 유닛(unit)이라는 설정 단위로 관리합니다. 이 강좌는 Debian 13의 systemd 257 환경에서 루프백 전용 Python HTTP 서비스를 만들고, 상태 표시와 프로세스·포트·응답을 비교합니다. 일반 시스템 서비스의 조작을 익히는 실습이며, 모든 기존 서비스를 같은 방식으로 재시작하라는 의미는 아닙니다.
| 명령 | 바꾸는 대상 | 이 실습의 결과 |
|---|---|---|
| start / stop | 지금 실행 중인 서비스 | 자동 실행 연결을 그대로 둔 채 시작·중지 |
| enable / disable | 유닛의 자동 시작 연결 | 실행 중인 프로세스를 그대로 둔 채 연결 추가·제거 |
| enable --now | 연결과 현재 실행 | 자동 시작 연결 후 즉시 시작 요청 |
| daemon-reload | systemd가 읽는 유닛 설정 | 현재 HTTP 프로세스를 교체하지 않음 |
| restart | 서비스 프로세스 | 중지·시작하여 새 실행 명령 적용 |
enabled여도 서비스가 실패할 수 있고, disabled여도 수동 시작이나 다른 유닛의 요청으로 실행될 수 있습니다. 이 예제의 [Install]에 지정한 대상은 자동 시작 연결의 기준입니다. 설치 연결이 없는 static 유닛이나 소켓으로 시작하는 서비스도 있으므로 enabled 여부만으로 모든 서비스의 부팅 동작을 단정하지 마세요. 자세한 명령 의미는 Debian 13 systemctl 설명서에서 확인할 수 있습니다.
충돌 없는 전용 실습 환경 준비
sudo 가능한 lfstudent 계정과 Python 3·curl을 사용합니다. 다른 계정이라면 아래 서비스의 User와 문서 경로를 실제 계정에 맞추세요. Python HTTP 서버는 실습용이며, 호스트나 LAN에 공개할 필요가 없어 127.0.0.1에서만 수신합니다. NAT 전달이나 방화벽 변경도 필요하지 않습니다.
id lfstudent
python3 --version
curl --version
systemctl --version
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'
ls -ld /home/lfstudent/lf-http17 /etc/systemd/system/lf-http17.service.d
서비스는 LoadState=not-found, 두 포트는 수신 행 없음, 폴더는 존재하지 않음이 이번 시작 조건입니다. 마지막 ls의 파일 없음 오류는 해당 이름이 비어 있는지 확인하기 위한 것입니다. 이미 존재하면 이전 작업 내용을 확인하고 덮어쓰거나 다른 서비스를 중지하지 않습니다. Python·curl이 없다면 sudo apt install --no-install-recommends python3 curl의 변경 목록을 검토하여 설치합니다.
lfstudent로 로그인한 터미널에서 전용 파일을 만듭니다.
mkdir /home/lfstudent/lf-http17 &&
printf 'systemd-service-lab\n' > /home/lfstudent/lf-http17/probe.txt
폴더 생성이 실패하면 이어지는 서비스 작성도 중단합니다. 실습 문서 루트를 별도로 제한하여 홈 전체를 제공하지 않습니다. 시스템 서비스는 기본적으로 시스템 관리자가 다루지만, HTTP 프로세스 자체는 아래 User=lfstudent로 일반 사용자 권한에서 실행합니다.
완전한 서비스 파일 작성과 검사
sudo nano /etc/systemd/system/lf-http17.service로 새 파일을 열고 다음 전체 내용을 저장합니다. 다른 편집기를 사용해도 되지만 파일명·경로·줄 구성을 유지하세요. 이미 존재하는 파일을 새 예제로 덮어쓰지 않습니다.
[Unit]
Description=Local HTTP service for lesson 17
[Service]
Type=exec
User=lfstudent
ExecStart=/usr/bin/python3 -m http.server 8080 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17
Restart=on-failure
RestartSec=2s
[Install]
WantedBy=multi-user.target
Type=exec는 실행 파일을 시작하는 단계의 오류를 확인하는 데 도움이 됩니다. 다만 실행 파일 시작 성공이 HTTP 수신 준비 완료까지 보장하지는 않습니다. Restart=on-failure는 비정상 종료 때 재시작하도록 한 설정이며, 관리자가 정상적으로 stop한 서비스를 다시 살리기 위한 옵션은 아닙니다.
ExecStart에는 백그라운드 실행을 위한 &를 붙이지 않습니다. systemd가 직접 프로세스를 관리하도록 전경에서 실행합니다. 일반 셸 명령줄과 달리 파이프·리디렉션이 자동으로 셸 구문으로 처리되는 것도 아닙니다. 실행 방식은 systemd.service 설명서의 해당 옵션을 참고하세요.
sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
systemctl cat lf-http17.service
검사 오류나 경고가 있으면 원인을 확인합니다. 오류 없이 읽은 뒤에도 아직 시작하지 않았으므로 disabled·inactive가 예상됩니다. 이 두 조회는 상태에 따라 0이 아닌 종료 코드를 반환하므로, 자동화에서 단순히 모든 비정상 종료를 설치 실패로 처리하지 마세요.
active와 enabled를 따로 바꾸어 관찰
먼저 서비스를 수동으로 시작하고 실제 파일 응답을 확인합니다.
sudo systemctl start lf-http17.service
systemctl is-active lf-http17.service
systemctl is-enabled lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo ss -lntp 'sport = :8080'
active·disabled와 systemd-service-lab 응답을 확인합니다. curl의 제한된 재시도는 프로세스 실행 직후 포트가 준비되는 짧은 차이를 고려한 것입니다. 계속 실패하면 상태만 믿고 진행하지 말고 sudo journalctl -u lf-http17.service -b --no-pager -n 30으로 원인을 확인합니다.
이제 자동 시작을 연결한 뒤 현재 실행만 중지합니다.
sudo systemctl enable lf-http17.service
sudo systemctl stop lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
enabled·inactive가 예상됩니다. stop은 부팅 시 시작 연결을 없애지 않습니다. 다시 시작한 뒤 이번에는 disable만 실행합니다.
sudo systemctl start lf-http17.service
sudo systemctl disable lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
disabled·active와 같은 파일 응답이 예상됩니다. 이 예제에서는 disable이 실행 중인 HTTP 프로세스를 중지하지 않았습니다. 즉시 중지까지 원할 때는 disable --now를 사용합니다. 이 비교에서는 이어지는 포트 변경을 위해 active·disabled 상태로 둡니다.
drop-in으로 실행 포트 변경
drop-in은 원본 유닛 파일 옆의 유닛이름.d/ 폴더에 추가하는 보완 설정입니다. 패키지가 제공하는 /usr/lib/systemd/system/ 파일을 직접 수정하는 대신, 일반적으로 /etc/systemd/system/의 drop-in으로 관리자 변경을 관리합니다. 이 예제는 원본과 보완 파일을 구분해 보기 위해 직접 만든 유닛에도 같은 방식을 적용합니다.
systemctl show lf-http17.service -p MainPID -p ExecStart -p FragmentPath -p DropInPaths
sudo install -d /etc/systemd/system/lf-http17.service.d
현재 MainPID를 기록합니다. 이어 sudo nano /etc/systemd/system/lf-http17.service.d/20-port.conf로 새 파일을 만들고 저장합니다.
[Service]
ExecStart=
ExecStart=/usr/bin/python3 -m http.server 8082 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17
빈 ExecStart=는 앞서 설정된 실행 명령을 초기화하고 그 다음 줄에서 대체하기 위한 것입니다. 초기화 없이 두 번째 실행 명령을 추가하면 이 서비스 형식에서 의도한 교체가 되지 않습니다. drop-in은 옵션에 따라 병합·대체 방식이 다르므로 모든 설정을 같은 방식으로 다루지 않습니다. systemd.unit의 설정 검색 경로와 drop-in 설명이 기준입니다.
sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl cat lf-http17.service
systemctl show lf-http17.service -p MainPID -p ExecStart -p DropInPaths
curl --noproxy '*' --max-time 5 -fsS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8082/probe.txt
관리자가 읽은 ExecStart에는 8082가 나타나지만, 실행 중인 프로세스의 MainPID는 이전 값이고 8080 응답이 유지됩니다. 8082 요청은 아직 수신 서버가 없어 실패하는 것이 예상됩니다. 이것이 daemon-reload가 유닛 정의를 다시 읽는 작업이며 프로세스 재시작과 다르다는 비교입니다.
sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p MainPID -p ActiveState -p SubState -p UnitFileState
sudo ss -lntp 'sport = :8082'
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8082/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8080/probe.txt
재시작한 프로세스의 PID와 8082 수신·파일 응답을 확인하고, 이전 8080의 수신이 사라졌는지 비교합니다. PID 숫자는 환경마다 달라지며 숫자 자체보다 상태·리스너·응답을 함께 확인하는 것이 중요합니다. reload 명령도 별개의 동작입니다. 이 유닛은 ExecReload 등을 지정하지 않았으므로 지원되지 않는 reload를 설정 적용 수단으로 쓰지 않습니다.
이번 drop-in만 제거하고 기본 포트 복원
원본 서비스 파일은 유지하고 이번에 만든 20-port.conf만 삭제합니다. 다른 보완 설정까지 지울 수 있는 전체 revert를 이 작업에 사용하지 않습니다.
sudo rm -- /etc/systemd/system/lf-http17.service.d/20-port.conf
sudo rmdir -- /etc/systemd/system/lf-http17.service.d
sudo systemctl daemon-reload
sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p ExecStart -p DropInPaths
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo journalctl -u lf-http17.service -b --no-pager -n 20
DropInPaths가 비고 원본 명령의 8080에서 파일을 받으면 복원된 것입니다. rmdir가 비어 있지 않다는 이유로 실패하면 다른 파일이 있는지 먼저 확인하고 폴더 전체를 지우지 않습니다. 로그에는 시작·중지·요청 흔적이 남아 상태 전환을 확인할 수 있습니다.
오류를 읽고 전용 서비스 정리
파일 경로 오타나 접근 권한 문제는 HTTP 요청 실패나 서비스 시작 실패로 나타날 수 있습니다. 포트 충돌은 다른 서버가 수신 중인지 ss로 확인합니다. systemctl status lf-http17.service --no-pager의 결과와 journal의 구체적인 오류를 읽고 수정하세요. 실패 기록을 지우는 reset-failed만 실행한다고 원인이 해결되지는 않습니다.
실습을 마치면 전용 서비스만 중지·자동 실행 해제한 후 생성한 파일을 제거합니다.
sudo systemctl disable --now lf-http17.service
sudo rm -- /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
rm -- /home/lfstudent/lf-http17/probe.txt
rmdir -- /home/lfstudent/lf-http17
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'
유닛이 not-found이고 두 실습 포트에 수신 행이 없는지 확인합니다. 해당 서비스가 실패 상태로 남아 있다면 먼저 파일 제거·프로세스 종료를 확인한 뒤 sudo systemctl reset-failed lf-http17.service로 그 유닛의 실패 기록만 정리합니다. 다른 서비스와 시스템 로그는 유지합니다.




