systemd入門 - サービス管理とsystemctlの使い方

1

systemctl status nginx

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

● nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/usr/lib/systemd/system/nginx.service; enabled; preset: disabled)
     Active: active (running) since Wed 2026-01-08 10:00:00 JST; 2h ago
       Docs: man:nginx(8)
    Process: 1234 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 1235 (nginx)
      Tasks: 3 (limit: 4647)
     Memory: 5.2M
        CPU: 32ms
     CGroup: /system.slice/nginx.service
             ├─1235 "nginx: master process /usr/sbin/nginx -g daemon on; master_process on;"
             ├─1236 "nginx: worker process"
             └─1237 "nginx: worker process"

Jan 08 10:00:00 server systemd[1]: Starting nginx.service - A high performance web server...
Jan 08 10:00:00 server systemd[1]: Started nginx.service - A high performance web server...

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# サービスの起動
sudo systemctl start nginx

# サービスの停止
sudo systemctl stop nginx

# サービスの再起動（stop + start）
sudo systemctl restart nginx

# 設定ファイルの再読み込み（プロセス再起動なし）
sudo systemctl reload nginx

# reload可能ならreload、不可ならrestart
sudo systemctl reload-or-restart nginx

1
2
3
4
5
6
7
8

# 自動起動を有効化
sudo systemctl enable nginx

# 自動起動を無効化
sudo systemctl disable nginx

# 自動起動設定の確認
systemctl is-enabled nginx

1
2

# enableの実行結果例
Created symlink /etc/systemd/system/multi-user.target.wants/nginx.service → /usr/lib/systemd/system/nginx.service.

1
2
3
4
5

# 自動起動有効化と即時起動を同時実行
sudo systemctl enable --now nginx

# 自動起動無効化と即時停止を同時実行
sudo systemctl disable --now nginx

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 現在ロードされているUnitの一覧（serviceのみ）
systemctl list-units --type=service

# すべてのUnitファイルの一覧
systemctl list-unit-files --type=service

# 実行中のサービスのみ表示
systemctl list-units --type=service --state=running

# 失敗したサービスを表示
systemctl list-units --type=service --state=failed

1
2
3
4
5

UNIT FILE                              STATE           PRESET
nginx.service                          enabled         disabled
postgresql.service                     enabled         disabled
ssh.service                            enabled         enabled
cron.service                           enabled         enabled

1
2
3
4
5

# 完全に無効化
sudo systemctl mask nginx

# 無効化を解除
sudo systemctl unmask nginx

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

[Unit]
# Unitの説明とメタデータ
Description=サービスの説明
Documentation=man:nginx(8)
After=network.target

[Service]
# サービス固有の設定
Type=forking
ExecStart=/usr/sbin/nginx
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID

[Install]
# インストール（enable時）の設定
WantedBy=multi-user.target

1
2
3
4
5
6
7

[Unit]
Description=My Application
# networkが起動してから起動する
After=network.target
# postgresqlが必要（失敗時は自分も起動しない）
Requires=postgresql.service
After=postgresql.service

1
2
3
4
5
6
7
8
9

[Service]
Type=simple
ExecStart=/usr/bin/myapp
# 異常終了時は5秒後に再起動
Restart=on-failure
RestartSec=5
# 再起動試行の制限（10秒間に3回まで）
StartLimitBurst=3
StartLimitIntervalSec=10

1
2
3

[Install]
# マルチユーザーモード（通常起動）で有効化
WantedBy=multi-user.target

1

systemctl cat nginx

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# /usr/lib/systemd/system/nginx.service
[Unit]
Description=A high performance web server and a reverse proxy server
Documentation=man:nginx(8)
After=network.target remote-fs.target nss-lookup.target
StartLimitIntervalSec=0

[Service]
Type=forking
PIDFile=/run/nginx.pid
ExecStartPre=/usr/sbin/nginx -t -q -g 'daemon on; master_process on;'
ExecStart=/usr/sbin/nginx -g 'daemon on; master_process on;'
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# すべてのログを表示
journalctl

# 末尾から表示（最新ログ）
journalctl -e

# 直近のn行を表示
journalctl -n 50

# リアルタイムでログを追跡
journalctl -f

1
2
3
4
5
6
7
8

# nginxのログを表示
journalctl -u nginx

# nginxのログをリアルタイム追跡
journalctl -u nginx -f

# 複数サービスのログ
journalctl -u nginx -u postgresql

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 今日のログ
journalctl --since today

# 直近1時間のログ
journalctl --since "1 hour ago"

# 特定期間のログ
journalctl --since "2026-01-08 10:00:00" --until "2026-01-08 12:00:00"

# 前回起動時のログ
journalctl -b -1

# 今回起動以降のログ
journalctl -b

1
2
3
4
5

# エラー以上のログ
journalctl -p err

# 警告以上のログ
journalctl -p warning

1
2
3
4
5
6
7
8

# JSON形式で出力
journalctl -u nginx -o json-pretty

# 詳細形式で出力
journalctl -u nginx -o verbose

# 短い形式（デフォルト）
journalctl -u nginx -o short

1
2
3
4
5
6
7
8

# ディスク使用量の確認
journalctl --disk-usage

# 古いログの削除（サイズ指定）
sudo journalctl --vacuum-size=500M

# 古いログの削除（日数指定）
sudo journalctl --vacuum-time=7d

1

sudo vim /etc/systemd/system/myapp.service

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

[Unit]
Description=My Node.js Application
Documentation=https://example.com/docs
After=network.target

[Service]
Type=simple
User=www-data
Group=www-data
WorkingDirectory=/var/www/myapp
ExecStart=/usr/bin/node /var/www/myapp/server.js
Restart=on-failure
RestartSec=10

# 環境変数
Environment=NODE_ENV=production
Environment=PORT=3000

# セキュリティ設定
NoNewPrivileges=true
PrivateTmp=true

# ログ設定
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

1
2
3
4
5
6
7
8

# systemdに設定を再読み込み
sudo systemctl daemon-reload

# サービスの有効化と起動
sudo systemctl enable --now myapp

# 状態確認
systemctl status myapp

1

sudo vim /etc/myapp/env

1
2
3
4

NODE_ENV=production
PORT=3000
DATABASE_URL=postgresql://user:pass@localhost/mydb
SECRET_KEY=your-secret-key

1
2
3

[Service]
EnvironmentFile=/etc/myapp/env
ExecStart=/usr/bin/node /var/www/myapp/server.js

1

sudo vim /usr/local/bin/myapp-start.sh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

#!/bin/bash
set -e

cd /var/www/myapp

# 環境のセットアップ
export PATH="/usr/local/bin:$PATH"

# 依存関係の確認
if [ ! -d "node_modules" ]; then
    npm install --production
fi

# アプリケーション起動
exec node server.js

1

sudo chmod +x /usr/local/bin/myapp-start.sh

1
2
3

[Service]
Type=simple
ExecStart=/usr/local/bin/myapp-start.sh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

[Service]
# 特権昇格の禁止
NoNewPrivileges=true

# 専用のtmpディレクトリ
PrivateTmp=true

# ホームディレクトリへのアクセス制限
ProtectHome=true

# システムディレクトリを読み取り専用に
ProtectSystem=strict

# 書き込み可能なディレクトリを明示
ReadWritePaths=/var/www/myapp/data /var/log/myapp

# ネットワーク名前空間の制限
PrivateNetwork=false

# デバイスへのアクセス制限
PrivateDevices=true

# カーネルチューナブルの変更禁止
ProtectKernelTunables=true

# カーネルモジュールのロード禁止
ProtectKernelModules=true

1

systemctl status myapp

1

journalctl -u myapp -n 50 --no-pager

1

systemd-analyze verify /etc/systemd/system/myapp.service

1
2
3
4
5

# 依存関係ツリーを表示
systemctl list-dependencies nginx

# 逆依存関係（このUnitに依存しているUnit）
systemctl list-dependencies nginx --reverse

1
2
3
4
5
6
7
8

# 起動時間の概要
systemd-analyze

# サービスごとの起動時間
systemd-analyze blame

# 起動の時系列グラフを生成
systemd-analyze plot > boot-analysis.svg