# systemd 빠른 참조

*서비스 관리, 유닛, 타이머, journalctl*

> Source: systemd Documentation (systemd.io) · MIT

## 서비스 관리

### 기본 서비스 명령어

```
systemctl start nginx
systemctl stop nginx
systemctl restart nginx
systemctl reload nginx    # reload config
systemctl status nginx
```

### 활성화 / 비활성화

```
systemctl enable nginx    # start at boot
systemctl disable nginx   # remove from boot
systemctl enable --now nginx  # enable + start
systemctl is-enabled nginx
```

### 서비스 상태

| Command | Description |
|---------|-------------|
| `active (running)` | 서비스가 정상 실행 중 |
| `active (exited)` | 한 번 실행 후 정상 종료 |
| `inactive (dead)` | 서비스가 중지됨 |
| `failed` | 서비스가 충돌하거나 오류 종료 |
| `activating` | 서비스가 시작 중 |

## 유닛 파일

### 유닛 파일 위치

| Command | Description |
|---------|-------------|
| `/etc/systemd/system/` | 관리자 생성 유닛 (최고 우선순위) |
| `/run/systemd/system/` | 런타임 생성 유닛 |
| `/usr/lib/systemd/system/` | 패키지 설치 유닛 |
| `~/.config/systemd/user/` | 사용자 수준 유닛 |

### 기본 서비스 유닛

```
[Unit]
Description=My Application
After=network.target
[Service]
ExecStart=/usr/bin/myapp --config /etc/myapp.conf
Restart=on-failure
User=appuser
[Install]
WantedBy=multi-user.target
```

### 변경 사항 적용

```
systemctl daemon-reload   # reload unit files
systemctl restart myapp   # apply changes
```

## 타이머

### 타이머 유닛

```
[Unit]
Description=Run backup daily
[Timer]
OnCalendar=*-*-* 02:00:00
Persistent=true
[Install]
WantedBy=timers.target
```

### OnCalendar 구문

| Command | Description |
|---------|-------------|
| `*-*-* 02:00:00` | 매일 오전 2시 |
| `Mon *-*-* 09:00:00` | 매주 월요일 오전 9시 |
| `*-*-01 00:00:00` | 매월 1일 |
| `hourly / daily / weekly` | 약식 스케줄 |

### 타이머 관리

```
systemctl list-timers --all
systemctl start backup.timer
systemctl enable backup.timer
systemd-analyze calendar "daily"
```

## 타겟

### 주요 타겟

| Command | Description |
|---------|-------------|
| `multi-user.target` | 일반 부팅, 멀티유저, GUI 없음 |
| `graphical.target` | 풀 GUI 데스크톱 |
| `rescue.target` | 단일 사용자 복구 모드 |
| `emergency.target` | 최소 셸, root만 가능 |
| `network-online.target` | 네트워크가 완전히 구성됨 |
| `timers.target` | 모든 타이머 유닛 준비 완료 |

### 타겟 명령어

```
systemctl get-default
systemctl set-default multi-user.target
systemctl isolate rescue.target
systemctl list-dependencies graphical.target
```

## Journalctl

### 로그 보기

```
journalctl -u nginx        # logs for unit
journalctl -u nginx -f     # follow (tail)
journalctl -u nginx --no-pager
journalctl -b              # current boot only
```

### 로그 필터링

```
journalctl --since "2026-03-01"
journalctl --since "1 hour ago"
journalctl -p err          # errors and above
journalctl _PID=1234
```

### 우선순위 레벨

| Command | Description |
|---------|-------------|
| `emerg (0)` | 시스템 사용 불가 |
| `alert (1)` | 즉각 조치 필요 |
| `crit (2)` | 심각한 상태 |
| `err (3)` | 오류 상태 |
| `warning (4)` | 경고 상태 |
| `info (6)` | 정보 메시지 |
| `debug (7)` | 디버그 수준 메시지 |

### 로그 유지 관리

```
journalctl --disk-usage
journalctl --vacuum-size=500M
journalctl --vacuum-time=30d
```

## 네트워킹

### networkctl

```
networkctl list
networkctl status eth0
networkctl up eth0
networkctl down eth0
```

### systemd-resolve

```
resolvectl status
resolvectl query example.com
resolvectl flush-caches
resolvectl statistics
```

### 네트워크 대기

```
# In unit file [Unit] section:
After=network-online.target
Wants=network-online.target
```

## 마운트

### 마운트 유닛

```
[Unit]
Description=Mount data volume
[Mount]
What=/dev/sdb1
Where=/mnt/data
Type=ext4
Options=defaults,noatime
[Install]
WantedBy=multi-user.target
```

### 자동 마운트 유닛

```
[Unit]
Description=Automount data on access
[Automount]
Where=/mnt/data
TimeoutIdleSec=300
[Install]
WantedBy=multi-user.target
```

### 명명 규칙

| Command | Description |
|---------|-------------|
| `/mnt/data` | 유닛 파일: `mnt-data.mount` |
| `/var/lib/app` | 유닛 파일: `var-lib-app.mount` |

*마운트 경로의 `/`를 `-`로 대체, 선행 대시 제거*

## 환경 변수

### 환경 변수 설정

```
[Service]
Environment=APP_ENV=production
Environment=PORT=8080
EnvironmentFile=/etc/myapp/env
```

### 환경 파일 형식

```
# /etc/myapp/env
APP_ENV=production
DATABASE_URL=postgres://localhost/db
SECRET_KEY=changeme
```

### 서비스 보안 강화

| Command | Description |
|---------|-------------|
| `ProtectSystem=strict` | 허용된 경로 외에는 읽기 전용 파일시스템 |
| `ProtectHome=true` | /home, /root, /run/user 숨김 |
| `NoNewPrivileges=true` | 권한 상승 방지 |
| `PrivateTmp=true` | 서비스 전용 격리된 /tmp |
| `ReadWritePaths=/var/lib/myapp` | 특정 경로에 쓰기 허용 |

## 의존성

### 순서 및 요구사항 지시어

| Command | Description |
|---------|-------------|
| `After=b.service` | b 다음에 시작 (순서만) |
| `Before=b.service` | b 이전에 시작 (순서만) |
| `Requires=b.service` | 강한 의존성; b가 실패하면 같이 실패 |
| `Wants=b.service` | 약한 의존성; b가 실패해도 실패하지 않음 |
| `BindsTo=b.service` | b가 중지되면 같이 중지 |
| `Conflicts=b.service` | b와 동시에 실행 불가 |

### 의존성 검사

```
systemctl list-dependencies nginx
systemctl list-dependencies --reverse nginx
systemd-analyze dot nginx.service | dot -Tsvg > deps.svg
```

## 자주 쓰는 패턴

### 재시작 정책

| Command | Description |
|---------|-------------|
| `Restart=no` | 재시작 안 함 (기본값) |
| `Restart=on-failure` | 비정상 종료 시 재시작 |
| `Restart=always` | 항상 재시작 (데몬용) |
| `RestartSec=5` | 재시작 전 5초 대기 |
| `StartLimitBurst=3` | 인터벌 내 최대 재시작 횟수 |
| `StartLimitIntervalSec=60` | 버스트 계산 인터벌 |

### 원본 파일 수정 없이 오버라이드

```
systemctl edit nginx  # creates drop-in
# /etc/systemd/system/nginx.service.d/override.conf
systemctl cat nginx   # show effective config
systemctl revert nginx  # remove overrides
```

### 시스템 분석

```
systemd-analyze                  # boot time
systemd-analyze blame            # per-unit time
systemd-analyze critical-chain
systemctl list-units --failed
```