systemdのユニットファイル — Afterは依存関係ではない

systemdのユニットファイル。サービスの設定カードと歯車、起動を管理するスイッチ。

※本記事はアフィリエイト広告(PR)を含みます。

sudo systemctl enable --now nginx は打てるようになりました。status の Active: と Loaded: も読めます。

これは【深掘り】の記事です。本線の順路ではありません。 読まなくても先へ進めます。 本線の startとenableは別物 — サーバーが「動いている」とは何か の続きとして、systemd のユニットファイルの中身だけを掘ります。

前回: プロセスとシグナル — kill -9を最初に打たない

この記事のコマンドは、すべてVMの中(Ubuntu Server)で打ちます。 Windows の PowerShell では打ちません。

前提: startとenableは別物 — サーバーが「動いている」とは何か、Linuxのパーミッション|Permission deniedの原因とrwx・755の読み方、シェルスクリプトの書き方|変数・引数・実行権限の基本 を一度触っていること。 タイマー(.timer)は cronとsystemd timerで定期実行する|動かないときの確認 で扱ったので、この記事では名前を出すだけにします。

でも、自分で .service を書いたときのことを思い出すと、正直なところこうでした。

どこかのページに載っていた .service を丸ごとコピーして、ExecStart= のパスだけ自分のものに書き換えた。 動いた。だから、それ以上は調べなかった。

そのファイルには Type=simple と書いてありました。なぜ simple なのか、simple 以外に何があるのか、何も分かっていません。 After=network.target も入っていました。これがあると何が保証されるのかも、分かっていません。

そして、分かっていないまま使うと、こういう形で返ってきます。

  • スクリプトを直したら、サービスが1秒ごとに再起動を繰り返して、そのうち諦めて止まった
  • データベースより先に自分のアプリが起動して、毎回1回目だけ接続に失敗する
  • enable しようとしたら The unit files have no installation config と言われた
  • VMを再起動したら、さっき読んでいたエラーログが丸ごと消えていた

どれも「使い方が分からない」ではなく、「書いてある1行の意味が分からない」から起きています。

この記事では、最小のユニットを自分で1本書いて、そこに1項目ずつ足したり壊したりして、何が起きるかを目で見ます。説明を読んで納得するのではなく、壊れるところを見るのが目的です。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • After= は順番の指定であって、相手を起動させる指定ではないこと。順番だけ書いても相手は上がってこない
  • Type= を間違えると「起動したのに落ちた扱い」や「90秒待たされて失敗」になること。simple は「正しい」から既定なのではなく、何も申告しないという意味であること
  • [Install] が無いユニットは enable できないこと。enable の正体がシンボリックリンクを1本張るだけであること
  • journalctl のログは、設定次第で再起動のたびに消えること。そして放っておくとディスクを食うこと
  • 配布物のユニットを直接編集してはいけない理由と、drop-in で上書きする作法

この記事でやること

  1. 最小の .service を1本書く(4行だけ)。そこから1項目ずつ足す
  2. After と Requires の違いを、2本のユニットを実際に走らせて確かめる
  3. Type と Restart を間違えた状態を、わざと作って壊す
  4. journalctl でログを systemd 側から読む。消える設定を直し、ディスク使用量を見る
  5. systemctl edit で drop-in を作り、systemctl cat で最終形を確かめる
  6. ユーザー単位のユニットを1本動かし、ログアウトで止まることを確認する
  7. 作ったユニットを、止めて・無効化して・消す

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
ユニット(unit)systemd が管理する対象1つ分の設定。サービスもタイマーもマウントも、全部「ユニット」という単位で扱われる
ユニットファイルそのユニットの中身を書いたテキストファイル。.service や .timer などの拡張子で種類が決まる
ディレクティブユニットファイルの中の Type=simple のような1行。「項目」と呼んでいるもの
セクション[Unit] [Service] [Install] のような角括弧の見出し。どのセクションに書くかで意味が変わる
ターゲット(target)複数のユニットをまとめた「状態」。「ここまで起動が進んだ」という区切りに使う
drop-in元のユニットファイルを書き換えずに、上から一部だけ差し替える追加ファイル
journalsystemd が集めたログの置き場。journalctl で読む
PID 1起動時に最初に動くプロセス。Ubuntu ではこれが systemd 本体で、他の全プロセスの親になる

ユニットには種類がある

.service は、ユニットの一種でしかありません。 拡張子が種類そのものです。

拡張子何をするものかどこで見るか
.serviceプログラムを動かす。 この記事で扱うのはこれnginx.service ssh.service
.socket先にポートだけ開けて待つ。 接続が来た瞬間に対応する .service を起こすssh.socket
.timer時刻や間隔で .service を起こす。 → 定期実行の回で扱ったので、この記事では触れませんapt-daily.timer
.target複数のユニットをまとめた「状態」。 起動の区切りに使う。単体では何も実行しないmulti-user.target network.target
.mountファイルシステムのマウント。 ほとんどは fstab から自動生成されるboot.mount
.pathファイルやディレクトリの変化を見張って、.service を起こすcups.path

他に .swap .device .slice .scope もありますが、自分で書くことはまずありません。 自動生成か、systemd が内部で使うものです。

種類ごとに一覧できます。

bash
$ systemctl list-units --type=target
UNIT                   LOAD   ACTIVE SUB    DESCRIPTION
basic.target           loaded active active Basic System
multi-user.target      loaded active active Multi-User System
network-online.target  loaded active active Network is Online
sockets.target         loaded active active Socket Units

.target は「何も実行しないユニット」です。 「ここまで来た」という旗にすぎません。だから systemctl status multi-user.target を見ても Main PID はありません。

ユニットファイルはどこにあるか

置き場所が3つあり、優先順位があります。ここを知らないと、後で「直したのに効かない」になります。

場所誰のもの優先度
/usr/lib/systemd/system/パッケージ(apt)が置いたもの。 apt upgrade で上書きされる低
/etc/systemd/system/管理者(自分)が置くもの。 ここが同名ならパッケージ側に勝つ高
/run/systemd/system/実行中に一時的に作られるもの。再起動で消える中(/etc/systemd/system/ より低く、/usr/lib/systemd/system/ より高い)

自分で書くユニットは /etc/systemd/system/ に置きます。 理由は下の「設定を上書きする作法」で書きます。

いま効いている実体は、これで見えます。

bash
$ systemctl cat ssh

先頭に # /usr/lib/systemd/system/ssh.service のようにパスがコメントで出ます。 どのファイルが読まれているかが、これで確定します。

最小のユニットを1本書く

題材を作ります。 5秒ごとに1行出すだけのスクリプトです。動き続けるプログラムの、いちばん単純な形です。

bash
$ mkdir -p ~/deep
$ cat > ~/deep/hello.sh <<'EOF'
  #!/bin/bash
  while true; do
    echo "hello / user=$(whoami) / cwd=$(pwd) / GREETING=${GREETING:-未設定}"
    sleep 5
  done
  EOF
$ chmod +x ~/deep/hello.sh

chmod +x を忘れると Permission denied で起動しません。 権限の回でやったところです。

手で動くことを先に確かめます。ユニットにする前に必ずこれをやってください。 手で動かないものは、ユニットにしても動きません。

bash
$ ~/deep/hello.sh

5秒おきに1行出れば成功です。Ctrl + C で止めます。

ユニットファイルを作る

bash
$ sudo nano /etc/systemd/system/hello.service

まず、これだけです。

[Unit]
Description=深掘り練習用のサービス

[Service]
ExecStart=/home/ubuntu/deep/hello.sh

4行(空行を除けば3項目)しかありません。 これで動きます。

ExecStart= に ~ は書けません。 ~/deep/hello.sh と書くと起動に失敗します。systemd はシェルではないので、~ も $HOME も * も展開しません。 必ず絶対パスで書きます。 ユーザー名が ubuntu でないなら、/home/自分の名前/deep/hello.sh に読み替えてください。 echo $HOME で確認できます。

読み込ませて、動かします。

bash
$ sudo systemctl daemon-reload
$ sudo systemctl start hello
$ systemctl status hello --no-pager
● hello.service - 深掘り練習用のサービス
     Loaded: loaded (/etc/systemd/system/hello.service; static)
     Active: active (running) since Thu 2026-09-17 10:12:03 JST; 4s ago
   Main PID: 3821 (hello.sh)
      Tasks: 2 (limit: 2273)
     CGroup: /system.slice/hello.service
             ├─3821 /bin/bash /home/ubuntu/deep/hello.sh
             └─3846 sleep 5

daemon-reload を忘れると、直したはずの内容が反映されません。 systemd はユニットファイルをメモリに読み込んで持っています。 ファイルを書き換えただけでは、systemd はまだ古い内容を見ています。 この記事では、ユニットファイルを触るたびに daemon-reload を打ちます。 忘れたときは Warning: The unit file ... changed on disk と親切に教えてくれますが、教えてくれないケースもあるので、習慣にしてください。

[スクリーンショット: 01_minimal_unit.png] systemctl status hello --no-pager の結果を撮ってください。Loaded: の行に static と出ているところが写るようにしてください。

Loaded: の括弧の中が static になっています。 本線の回では enabled と出ていたところです。この違いは後で回収します。

1項目ずつ壊して確かめる

ここからが本題です。足す・消す・間違える、を1項目ずつやります。

Description= — 消しても動く

まず、消しても動く項目から。

Description= を消して daemon-reload して restart すると、動きます。 ただし status の表示がこうなります。

● hello.service
     Loaded: loaded (/etc/systemd/system/hello.service; static)

サービス名しか出ません。 ログの行頭にもこの名前が出るので、10本20本と増えたときに、自分が何のために作ったのか分からなくなります。

動作に影響しない。だから消してよい、ではありません。 半年後の自分が読む1行です。戻しておいてください。

After= は順番であって、依存ではない

ここが、この記事でいちばん伝えたいところです。

コピーしてきたユニットには、だいたいこう書いてあります。

After=network.target mysql.service

これを見て、「mysql が起動してから自分が起動する、という指定」だと読みました。半分しか合っていません。

After= は「両方とも起動するなら、この順番で」という指定です。 相手を起動させる力はありません。 相手が起動しないなら、順番の約束は空振りして、自分だけ普通に起動します。

実際にやって確かめます。2本作ります。

bash
$ sudo nano /etc/systemd/system/dep-a.service
[Unit]
Description=依存の実験 A(3秒かかる)

[Service]
Type=oneshot
ExecStart=/bin/sh -c 'sleep 3; echo "A が終わりました"'
bash
$ sudo nano /etc/systemd/system/dep-b.service
[Unit]
Description=依存の実験 B
After=dep-a.service

[Service]
Type=oneshot
ExecStart=/bin/sh -c 'echo "B が動きました"'

B には After=dep-a.service だけを書きました。 素直に読めば「A のあとに B」です。

bash
$ sudo systemctl daemon-reload
$ sudo systemctl start dep-b
$ journalctl -u dep-a -u dep-b --since "1 min ago" --no-pager
Sep 17 10:31:20 ubuntu systemd[1]: Starting 依存の実験 B...
Sep 17 10:31:20 ubuntu sh[4102]: B が動きました
Sep 17 10:31:20 ubuntu systemd[1]: Finished 依存の実験 B.

A が1行も出ていません。 A は起動していません。After= は、相手を呼びません。

[スクリーンショット: 02_after_only.png] 上の journalctl -u dep-a -u dep-b --since "1 min ago" --no-pager の結果を撮ってください。A の行が1つも無いことが分かるようにしてください。

ここで Requires= を足します。

bash
$ sudo nano /etc/systemd/system/dep-b.service
[Unit]
Description=依存の実験 B
Requires=dep-a.service
After=dep-a.service

[Service]
Type=oneshot
ExecStart=/bin/sh -c 'echo "B が動きました"'
bash
$ sudo systemctl daemon-reload
$ sudo systemctl start dep-b
$ journalctl -u dep-a -u dep-b --since "1 min ago" --no-pager
Sep 17 10:34:02 ubuntu systemd[1]: Starting 依存の実験 A(3秒かかる)...
Sep 17 10:34:05 ubuntu sh[4180]: A が終わりました
Sep 17 10:34:05 ubuntu systemd[1]: Finished 依存の実験 A(3秒かかる).
Sep 17 10:34:05 ubuntu systemd[1]: Starting 依存の実験 B...
Sep 17 10:34:05 ubuntu sh[4192]: B が動きました

今度は A が先に走り、3秒待ってから B が動きました。

次に、After= の行だけを消してみてください(Requires= は残します)。

Sep 17 10:36:11 ubuntu systemd[1]: Starting 依存の実験 A(3秒かかる)...
Sep 17 10:36:11 ubuntu systemd[1]: Starting 依存の実験 B...
Sep 17 10:36:11 ubuntu sh[4231]: B が動きました
Sep 17 10:36:14 ubuntu sh[4229]: A が終わりました

A も起動しました。でも同時に走り、B のほうが先に終わりました。

Requires= は「一緒に起動する」であって、「先に終わらせる」ではありません。 順番が要るなら After= を別に書きます。 2つは役割が違うので、ほぼ必ずセットで書きます。

まとめるとこうです。

書き方相手を起動するか順番を守るか相手が失敗したら
After= だけしない相手も起動するなら守る関係なく自分は動く
Requires= だけする守らない(同時に走る)自分も起動しない
Requires= + After=する守る自分も起動しない
Wants= + After=する守る相手が失敗しても自分は動く
BindsTo= + After=する守る相手が後で止まったら、自分も止まる

Wants= と Requires= の差も、実際に見られます。 A を失敗させます。

bash
$ sudo nano /etc/systemd/system/dep-a.service

ExecStart の行を、失敗する形に変えます。

ExecStart=/bin/sh -c 'sleep 1; echo "A は失敗します"; exit 1'
bash
$ sudo systemctl daemon-reload
$ sudo systemctl start dep-b
A dependency job for dep-b.service failed. See 'journalctl -xe' for details.

Requires= なので、A が失敗した時点で B は起動しませんでした。

ここで B の Requires= を Wants= に書き換えて、もう一度 daemon-reload して start dep-b してください。

Sep 17 10:41:55 ubuntu sh[4310]: A は失敗します
Sep 17 10:41:55 ubuntu systemd[1]: dep-a.service: Failed with result 'exit-code'.
Sep 17 10:41:55 ubuntu sh[4318]: B が動きました

A は失敗したまま、B は動きました。 これが Wants= です。

どちらを使うかの判断はこうです。

  • 相手が居ないと自分が意味を成さない → Requires=(例: データベースが無いと動かないアプリ)
  • 相手が居ると嬉しいが、無くても仕事はできる → Wants=(例: ログ転送、メトリクス送信)

迷ったら Wants= です。 Requires= は連鎖して止まるので、1つの障害が広く波及します。

network.target と network-online.target は別物です。 network.target は「ネットワーク設定の処理が始まった」程度の意味で、IPアドレスが付いていることを保証しません。 「起動直後だけ接続に失敗する」の典型的な原因がこれです。 本当にネットワークが使える状態を待ちたいなら Wants=network-online.target と After=network-online.target を両方書きます。 ただし起動が遅くなるので、必要なときだけにしてください。

Type= — 「起動できた」の判定方法を申告する

Type= は、systemd に「起動完了をどう判定してほしいか」を伝える項目です。 ここを間違えると、動いているのに落ちた扱いになったり、起動完了を待ち続けてタイムアウトしたりします。

Type=「起動できた」とみなす瞬間使う相手
simple(既定)ExecStart のプロセスを起こした瞬間。中身が成功したかは見ない前面で動き続ける普通のプログラム
exec実行ファイルの起動に成功した瞬間。simple より少しだけ厳しいsimple と同じ相手。こちらのほうが安全
forking親プロセスが終了した瞬間(子が本体として残る)自分で背後に回る昔ながらのデーモン
oneshotプロセスが終了した瞬間。終わるまで次のユニットへ進まない走って終わる処理(初期化、バックアップ)
notifyプログラム自身が「準備できた」と systemd に伝えた瞬間対応しているソフトのみ

間違えると、こうなります。

実際の作り書いた Type=何が起きるか
背後に回るデーモンsimple親がすぐ終わるので「サービスが終了した」と判定される。 Restart= 次第で無限再起動
前面で動き続けるforking親が終わらないので起動完了を待ち続け、既定90秒でタイムアウトして failed
走って終わる処理simple終わった瞬間に「落ちた」扱い。 status が inactive (dead) になり、成功したのか失敗したのか区別できない
走って終わる処理oneshot正しい。ただし終わると inactive になる。「終わったけど成功状態で残したい」なら RemainAfterExit=yes

simple と exec の違いだけ、実際に見られます。

hello.service の ExecStart を、存在しないパスに書き換えてください。

[Service]
Type=simple
ExecStart=/home/ubuntu/deep/typo.sh
bash
$ sudo systemctl daemon-reload
$ sudo systemctl start hello

start は、何も言わずに成功します。 失敗は status を見て初めて分かります。

Active: failed (Result: exit-code)

Type=simple は「プロセスを起こした」までしか見ていないので、その直後に失敗しても start コマンド自体は成功として返るわけです。

Type=exec に書き換えて、同じことをします。

bash
$ sudo systemctl daemon-reload
$ sudo systemctl start hello
Job for hello.service failed because the control process exited with error code.
See "systemctl status hello.service" and "journalctl -xeu hello.service" for details.

今度は start がその場で失敗を返しました。

迷ったら Type=exec です。 simple が既定なのは、「何も申告しない」がいちばん互換性が高いからであって、いちばん良いからではありません。自分で書くユニットなら、失敗がその場で分かる exec のほうが扱いやすいです。 (Type=exec は systemd 240 以降です。Ubuntu 20.04 以降なら使えます。systemctl --version で確認できます)

ExecStart= は元に戻してください。

[Service]
Type=exec
ExecStart=/home/ubuntu/deep/hello.sh

Restart= — 実際に落として確かめる

落ちたら勝手に立ち上がってほしい。 これを書く項目です。値によって「落ちた」の定義が変わります。

起動してすぐに失敗するスクリプトを用意します。

bash
$ cat > ~/deep/crash.sh <<'EOF'
  #!/bin/bash
  echo "起動しました"
  echo "失敗して終わります"
  exit 1
  EOF
$ chmod +x ~/deep/crash.sh
bash
$ sudo nano /etc/systemd/system/crash.service
[Unit]
Description=落ちる実験

[Service]
Type=exec
ExecStart=/home/ubuntu/deep/crash.sh
Restart=no
bash
$ sudo systemctl daemon-reload
$ sudo systemctl start crash

数秒待ってから見ます。

bash
$ systemctl status crash --no-pager
Active: failed (Result: exit-code) since Thu 2026-09-17 11:02:41 JST; 6s ago

Restart=no(既定)なので、落ちたまま放置されます。

Restart=on-failure に変えます。

Restart=on-failure
RestartSec=2
bash
$ sudo systemctl daemon-reload
$ sudo systemctl restart crash
$ journalctl -u crash -f

2秒ごとに起動と失敗を繰り返すのが、流れていくのが見えます。Ctrl + C で抜けてください。

そのまま放っておくと、ある時点で止まります。

crash.service: Start request repeated too quickly.
crash.service: Failed with result 'exit-code'.
Failed to start 落ちる実験.

無限に再起動し続けるわけではありません。 既定では StartLimitIntervalSec=10s の間に StartLimitBurst=5 回を超えると、systemd は諦めます。 以降は start しても弾かれます。 解除は sudo systemctl reset-failed crash です。 これを知らないと「直したのに起動しない」で数十分溶かします。実際に溶かしました。

Restart= の値の違いは、ここです。

値正常終了(exit 0)で異常終了(exit 1 やシグナル)で手動 stop で
no(既定)再起動しない再起動しないしない
on-failure再起動しない再起動するしない
always再起動する再起動するしない
on-abnormalしないシグナル・タイムアウトのみ再起動(exit 1 はしない)しない

always と on-failure の差を見ます。 crash.sh の最後を exit 0 に書き換えて、Restart=on-failure のまま restart してください。

Active: inactive (dead)

正常終了なので、再起動されません。 ここで Restart=always に変えると、exit 0 でも立ち上がり直します。

どちらを使うか。

  • 落ちるのは異常だ、というプログラム → on-failure。正常に終わったなら、それは終わってよいということ
  • とにかく動いていてほしい常駐プロセス → always
  • 走って終わるのが正しい処理(Type=oneshot) → Restart= を書かない

Restart= は、原因を隠します。 落ちるたびに立ち上がるので、「動いているように見える」状態が続きます。 systemctl show crash -p NRestarts で再起動した回数が見られるので、「動いてはいるが、実は毎分落ちている」を見つけるのはここです。

bash
$ systemctl show crash -p NRestarts
NRestarts=17

[スクリーンショット: 03_restart_loop.png] journalctl -u crash -n 30 --no-pager で、起動と失敗が繰り返されたあと Start request repeated too quickly. が出ているところを撮ってください。

User= / WorkingDirectory= / Environment=

ここを書かないと、何が既定になっているか。

項目書かなかったときの既定何が困るか
User=rootサービスが全部 root で動く。 乗っ取られたときの被害が最大になる
WorkingDirectory=/(ルート)スクリプト内の ./data/x.txt のような相対パスが全部ずれる
Environment=ほぼ空PATH すら最小限。シェルで動いたのにサービスだと動かないの主因

hello.sh が、まさにこの3つを出力するように書いてあります。 いまのログを見てください。

bash
$ journalctl -u hello -n 3 --no-pager
Sep 17 11:20:05 ubuntu hello.sh[5012]: hello / user=root / cwd=/ / GREETING=未設定

root で、ルートディレクトリで動いていました。 何も書いていないので当然です。書いていないものは、既定値が黙って選ばれているわけです。

3つとも指定します。

bash
$ sudo nano /etc/systemd/system/hello.service
[Unit]
Description=深掘り練習用のサービス

[Service]
Type=exec
ExecStart=/home/ubuntu/deep/hello.sh
User=ubuntu
Group=ubuntu
WorkingDirectory=/home/ubuntu/deep
Environment=GREETING=こんにちは
bash
$ sudo systemctl daemon-reload
$ sudo systemctl restart hello
$ journalctl -u hello -n 3 --no-pager
Sep 17 11:23:41 ubuntu hello.sh[5140]: hello / user=ubuntu / cwd=/home/ubuntu/deep / GREETING=こんにちは

3つとも変わりました。

User= を書いたら、そのユーザーがファイルを読めるか確認してください。 root で動いていたときは何でも読めていたので、User= を足した瞬間に Permission denied が出ることがあります。これは「壊れた」のではなく、「今まで強すぎた」だけです。

環境変数が増えてきたら、ファイルに出します。

bash
$ cat > ~/deep/hello.env <<'EOF'
  GREETING=ファイルから来ました
  EOF
$ chmod 600 ~/deep/hello.env
EnvironmentFile=/home/ubuntu/deep/hello.env

Environment= の行と置き換えて、daemon-reload して restart してください。

使いどころ
Environment=1〜2個。ユニットファイルに直接書くので、中身が見える
EnvironmentFile=パスワードやトークン。 ファイルの権限を 600 にすれば、ユニットファイルを読める人からは隠せる

EnvironmentFile= の中身はシェルではありません。 GREETING=$OTHER と書いても展開されません。export も要りません。KEY=VALUE を1行ずつ、それだけです。 ファイルが存在しないと起動に失敗します。 「無くてもいい」なら EnvironmentFile=-/path のように先頭に - を付けます。

[Install] が無いと enable できない

思い出してください。最初に status を見たとき、Loaded: の括弧の中が static でした。

bash
$ sudo systemctl enable hello
The unit files have no installation config (WantedBy=, RequiredBy=, Also=,
Alias= settings in the [Install] section, and DefaultInstance= for template
units). This means they are not meant to be enabled using systemctl.

「有効化するようには作られていません」と言われます。 本線の回で「start と enable は別物」とやりましたが、そもそも enable できないユニットがあるわけです。

[Install] を足します。

[Install]
WantedBy=multi-user.target
bash
$ sudo systemctl daemon-reload
$ sudo systemctl enable hello
Created symlink /etc/systemd/system/multi-user.target.wants/hello.service → /etc/systemd/system/hello.service.

メッセージをそのまま読んでください。enable がやったのは、シンボリックリンクを1本張ることだけです。

bash
$ ls -l /etc/systemd/system/multi-user.target.wants/ | grep hello

enable の正体は、これです。

WantedBy=multi-user.target は、「multi-user.target に到達するとき、私も起動してほしい」という申告です。 multi-user.target は「通常の起動が完了した状態」なので、実質「起動時に立ち上げてほしい」という意味になります。 disable はこのリンクを消すだけです。だから disable してもサービスは動いたままです。止めるのは stop。 本線でやった start と enable の分離は、ファイルの実体レベルではこうなっていた、ということです。

書き方意味
WantedBy=multi-user.target通常起動のときに立ち上げてほしい(ほぼこれ)
WantedBy=graphical.targetデスクトップ環境まで起動したときに立ち上げてほしい
RequiredBy=相手が「自分が居ないと駄目」として扱う。 強すぎるので普通は使わない
Alias=別名を付ける。enable 時に別名のリンクも張られる

static / enabled / disabled の意味も、ここで揃います。

Loaded: の表示意味
enabled[Install] があり、リンクが張られている。起動時に上がる
disabled[Install] はあるが、リンクが無い。手で start すれば動く
static[Install] が無い。 enable できない。他のユニットから呼ばれるためのもの
masked/dev/null へのリンクで封印されている。 start すら拒否される

ログを systemd 側から読む

journalctl は本線の回で -u と -n だけ使いました。 ここを掘ります。

hello が5秒ごとに書き続けているので、練習相手にちょうどいいです。

bash
$ sudo systemctl start hello

絞り込みの5つ

オプション意味使う場面
-u 名前そのユニットのログだけ。複数書けるまずこれ
-f流し見。 新しい行が出るたびに追記される直しながら見る
--since / --until期間を切る「昨日の夜」に絞る
-p深刻度で絞るエラーだけ拾う
-b今回の起動分だけ。-b -1 で前回再起動をまたいで比べる

期間の指定は、日本語的な書き方が通ります。

bash
$ journalctl -u hello --since "10 min ago" --no-pager
$ journalctl -u hello --since "2026-09-17 09:00" --until "2026-09-17 10:00" --no-pager
$ journalctl -u hello --since yesterday --no-pager

深刻度は0〜7の数字と名前で指定します。

数字名前意味
0emergシステムが使えない
1alertすぐ対応が要る
2crit致命的
3errエラー。まずここを見る
4warning警告
5notice普通だが目立つ
6info普通の情報(既定でここまで出る)
7debug開発用
bash
$ journalctl -p err -b --no-pager

「今回の起動でエラー以上だったもの、全部」です。 何かおかしいと思ったとき、まずこれを打つと当たりが早いです。

-p err は「err だけ」ではなく「err 以上(0〜3)」です。 範囲で指定したいなら -p warning..err のように書きます。

再起動をまたいで比べます。

bash
$ journalctl --list-boots
IDX BOOT ID                          FIRST ENTRY                 LAST ENTRY
 -1 3f2a...                          Wed 2026-09-16 21:03:11 JST Thu 2026-09-17 08:41:02 JST
  0 9b7c...                          Thu 2026-09-17 08:41:30 JST Thu 2026-09-17 11:52:20 JST

0 が今回、-1 が前回です。「再起動する前は動いていた」を確かめるときに使います。

bash
$ journalctl -u hello -b -1 --no-pager

表示形式も変えられます。

bash
$ journalctl -u hello -n 5 -o short-iso --no-pager
$ journalctl -u hello -n 5 -o cat --no-pager
$ journalctl -u hello -n 1 -o json-pretty --no-pager
形式何が出るか
short(既定)時刻 + ホスト名 + プロセス名 + 本文
short-iso時刻が 2026-09-17T11:52:20+0900 形式。 他のログと突き合わせるときに揃う
cat本文だけ。 アプリが出した内容だけを見たいとき
json-prettyjournal が実際に持っている全フィールド。 何が記録されているかを知るのに一度見ておく

json-pretty を1回見ておくと、journal がただのテキストではなく、フィールドの集合を持っていることが分かります。_PID _UID _SYSTEMD_UNIT PRIORITY などが並んでいます。-u で絞れるのは、_SYSTEMD_UNIT というフィールドを持っているからです。

[スクリーンショット: 04_journal_json.png] journalctl -u hello -n 1 -o json-pretty --no-pager の結果を撮ってください。_SYSTEMD_UNIT と PRIORITY の行が写るようにしてください。

ログが消える

再起動したら、さっき読んでいたログが丸ごと消えていた。 これが起きます。バグではなく設定です。

bash
$ journalctl --list-boots

ここに今回(0)しか出てこないなら、ログは再起動で消えています。

理由は、journal の保存先がメモリになっているからです。

保存先場所再起動したら
永続/var/log/journal/残る
揮発(volatile)/run/log/journal/消える(/run はメモリ上)

設定を見ます。

bash
$ grep -n "Storage" /etc/systemd/journald.conf
#Storage=auto

# が付いているので既定値です。そして既定は auto。

Storage=動き
auto(既定)/var/log/journal/ というディレクトリが存在すれば永続、無ければ揮発
persistentディレクトリが無ければ作って、必ず永続
volatile必ずメモリ。再起動で消える
none保存しない

auto の怖いところは、「ディレクトリがあるかどうか」で黙って挙動が変わることです。 Ubuntu Server の通常インストールなら存在しますが、コンテナや、最小構成のイメージでは無いことがあります。

確かめます。

bash
$ ls -ld /var/log/journal

No such file or directory と出たら、ログは消えています。 永続化します。

bash
$ sudo mkdir -p /var/log/journal
$ sudo systemd-tmpfiles --create --prefix /var/log/journal
$ sudo systemctl restart systemd-journald

確認は、VMを再起動して journalctl --list-boots に -1 が出ることです。

bash
$ sudo reboot

再ログインして、

bash
$ journalctl --list-boots

-1 の行が出れば、前回の起動分が残っています。

戻し方: 永続化をやめたいなら sudo rm -rf /var/log/journal で元に戻ります。この記事では戻さなくて構いません。 ログが残っているほうが、この先ずっと役に立ちます。

ディスクを食う

永続化したということは、ログが溜まり続けるということです。

bash
$ journalctl --disk-usage
Archived and active journals take up 528.0M in the file system.

放っておくと、ディスクの一部を静かに占め続けます。 systemd は既定でファイルシステムの10%まで(上限4GB)使います。学習用の20GBのVMなら2GBです。

いますぐ減らすなら、こうです。

bash
$ sudo journalctl --vacuum-size=200M
Vacuuming done, freed 312.0M of archived journals from /var/log/journal/...
bash
$ sudo journalctl --vacuum-time=14d
指定意味
--vacuum-size=200M合計200MBに収まるまで、古いものから消す
--vacuum-time=14d14日より古いものを消す
--vacuum-files=5ファイル数で切る

恒久的な上限は設定ファイルに書きます。

bash
$ sudo nano /etc/systemd/journald.conf
[Journal]
SystemMaxUse=500M
MaxRetentionSec=1month
bash
$ sudo systemctl restart systemd-journald
$ journalctl --disk-usage

vacuum は、消したログを取り戻せません。 障害の調査中に打たないでください。まず必要なところを別ファイルに保存してから消します。

bash
$ journalctl -u hello --since "1 hour ago" --no-pager > ~/deep/hello-log.txt

ログを1画面にまとめる話は、ログを1画面にする回でやりました。 そちらは複数台・複数コンテナの話で、この記事は1台の中の journal そのものの話です。

依存関係を見る

書いた After= や Wants= が、実際にどう繋がっているかを見ます。

bash
$ systemctl list-dependencies hello
hello.service
● ├─system.slice
● └─sysinit.target
●   ├─systemd-journald.service
●   ├─systemd-tmpfiles-setup.service
●   └─...

書いていないのに、たくさん繋がっています。 [Service] を持つユニットには、既定で Requires=sysinit.target と After=sysinit.target basic.target が暗黙に付くからです。「何も書いていない」は「依存が無い」ではありません。

逆向きも見られます。

bash
$ systemctl list-dependencies --reverse hello

「誰が自分を必要としているか」です。enable したあとなら multi-user.target が出ます。

順序だけを見たいなら、これです。

bash
$ systemctl list-dependencies --after hello
$ systemctl list-dependencies --before hello

起動が遅い原因を探す

VMの起動が遅い。どこで時間を食っているのか。

bash
$ systemd-analyze
Startup finished in 4.106s (kernel) + 21.735s (userspace) = 25.842s
graphical.target reached after 21.501s in userspace.

ユニットごとの所要時間を並べます。

bash
$ systemd-analyze blame | head -15
19.442s systemd-networkd-wait-online.service
 3.117s snapd.service
 1.882s cloud-init.service
  898ms dev-sda2.device

blame の上位が、そのまま原因とは限りません。 多くのユニットは並列に起動しています。 3秒かかったユニットが3本あっても、並列なら全体は3秒です。「長い」と「待たせている」は別です。

「待たせている」ほうを見るのが、これです。

bash
$ systemd-analyze critical-chain
graphical.target @21.501s
└─multi-user.target @21.500s
  └─ssh.service @21.498s
    └─network-online.target @21.495s
      └─systemd-networkd-wait-online.service @2.051s +19.442s

@ が「その時刻に到達した」、+ が「そのユニット自体にかかった時間」です。 上から下に辿ると、全体を21秒にしている犯人が一直線に見えます。

この例では systemd-networkd-wait-online.service が19秒待っています。設定したのに存在しないネットワークインターフェースを待っているのが典型で、さっき出てきた network-online.target の実体がこれです。

[スクリーンショット: 05_critical_chain.png] systemd-analyze critical-chain の結果を撮ってください。@ と + の数字が読める状態にしてください。

図で欲しいなら、SVGにも出せます。

bash
$ systemd-analyze plot > ~/deep/boot.svg

VMに直接ブラウザが無いので、VS Code のリモート接続で開くのが楽です。

設定を上書きする作法

nginx の起動オプションを変えたい。 ユニットファイルは /usr/lib/systemd/system/nginx.service にあります。ここを直接編集してはいけません。

理由は2つです。 1. apt upgrade で上書きされます。 パッケージが更新されると、自分の編集は予告なく消えます 2. 消えたことに気づけません。 動かなくなるのは更新の数週間後で、原因を編集に結び付けられません

正しいやり方は、drop-in です。

bash
$ sudo systemctl edit hello

エディタが開き、上下がコメントで挟まれた空白部分が出ます。そこに、変えたい項目だけを書きます。

[Service]
Environment=GREETING=上書きされました

保存して閉じると、daemon-reload まで自動でやってくれます。

bash
$ sudo systemctl restart hello
$ journalctl -u hello -n 2 --no-pager
Sep 17 12:40:11 ubuntu hello.sh[6210]: hello / user=ubuntu / cwd=/home/ubuntu/deep / GREETING=上書きされました

何が起きたのか、ファイルで確認します。

bash
$ ls -l /etc/systemd/system/hello.service.d/
-rw-r--r-- 1 root root 61 Sep 17 12:39 override.conf

元のファイルは1文字も変わっていません。 .d というディレクトリが増え、その中の .conf が上から重なっているだけです。

最終的に何が効いているかは、これで見ます。

bash
$ systemctl cat hello
# /etc/systemd/system/hello.service
[Unit]
Description=深掘り練習用のサービス
...

# /etc/systemd/system/hello.service.d/override.conf
[Service]
Environment=GREETING=上書きされました

元ファイルと drop-in が、順番に全部出ます。 「効いているはずの設定が効かない」と思ったら、まずこれを打ちます。

ExecStart= を drop-in で変えるときだけ、罠があります。 ExecStart= は複数書ける項目なので、drop-in で足すと追加になり、2回実行されます。一度空にしてから書きます。

[Service]
ExecStart=
ExecStart=/home/ubuntu/deep/other.sh

空の ExecStart= が「リセット」の意味です。Environment= や After= など、リストになる項目は全部これが要ります。

元に戻すのも1コマンドです。

bash
$ sudo systemctl revert hello
Removed "/etc/systemd/system/hello.service.d/override.conf".
コマンド何をするか
systemctl edit 名前drop-in を作る(推奨)
systemctl edit --full 名前元ファイル全体をコピーして編集。 上書きされない代わりに、パッケージの改善も取り込まれなくなる
systemctl cat 名前最終的に効いている全文を見る
systemctl revert 名前自分の変更を全部捨てて、配布時の状態に戻す
systemctl show 名前systemd が解釈したあとの、全項目の値を見る

show は、書いていない項目の既定値も全部出ます。 「Restart= を書いていないとき、実際は何になっているのか」を確かめるのに使います。

bash
$ systemctl show hello -p Type -p Restart -p User -p WorkingDirectory
Type=exec
Restart=no
User=ubuntu
WorkingDirectory=/home/ubuntu/deep

ユーザー単位のユニット

ここまで全部 sudo を付けていました。 systemd には、自分のユーザーだけで動く systemd がもう1つあります。

bash
$ systemctl --user status --no-pager | head -5

sudo なしで動きます。 ユニットの置き場所も違います。

システム単位ユーザー単位
コマンドsudo systemctlsystemctl --user
ユニットの置き場/etc/systemd/system/~/.config/systemd/user/
動く権限User= で指定(既定 root)自分のみ(User= は書けない)
ログjournalctl -ujournalctl --user -u
いつ動くかOS起動時ログインしたとき

1本作ります。

bash
$ mkdir -p ~/.config/systemd/user
$ cat > ~/.config/systemd/user/myhello.service <<'EOF'
  [Unit]
  Description=ユーザー単位の練習
  
  [Service]
  Type=exec
  ExecStart=/home/ubuntu/deep/hello.sh
  
  [Install]
  WantedBy=default.target
  EOF

WantedBy= が multi-user.target ではなく default.target です。 ユーザー単位の systemd には multi-user.target がありません。

bash
$ systemctl --user daemon-reload
$ systemctl --user enable --now myhello
$ systemctl --user status myhello --no-pager
$ journalctl --user -u myhello -n 3 --no-pager

sudo を一度も打っていません。 自分のアプリを動かすだけなら、root の権限は要らないわけです。

ログアウトすると止まる

ここが罠です。 SSH を切って、入り直してください。

bash
$ exit

再度 SSH で入って、

bash
$ systemctl --user status myhello --no-pager

止まっています。 場合によっては、そもそも Failed to connect to bus と言われます。

ユーザー単位の systemd は、そのユーザーのセッションが1つも無くなると終了します。 「SSH で入って動かして、抜けたら消えていた」の正体がこれです。バグではありません。

居座らせるには、明示的に許可します。

bash
$ sudo loginctl enable-linger $USER
$ loginctl show-user $USER | grep Linger
Linger=yes

もう一度ログアウトして入り直すと、今度は動き続けています。

ログアウト後OS再起動後
linger なし止まる上がらない
linger あり動き続けるenable してあれば上がる

どちらを使うか。

  • サーバーとして常時動かすもの → システム単位(/etc/systemd/system/)。root 権限が要るが、起動時に確実に上がる
  • 自分の作業用ツール、開発中のアプリ → ユーザー単位。sudo が要らないので気軽に試せる
  • ユーザー単位で常時動かしたい → enable-linger を必ずセットで

sudo systemctl --user ... は動きません。 --user は「自分のセッション」に繋ぎに行くので、sudo を付けると root のセッションを探しに行って失敗します。--user に sudo は付けない、と覚えてください。

落ちたときの調べ方の型

ここまでの道具を、順番に並べます。この順で打てば、だいたい原因に着きます。

① まず状態を見る

bash
$ systemctl status hello -l --no-pager

Active: の括弧の中を読みます。exit-code なのか signal なのか timeout なのかで、次に見る場所が変わります。

② ログを、説明つきで読む

bash
$ journalctl -u hello -n 50 --no-pager -x

-x を付けると、systemd 自身のメッセージに説明文が足されます。 エラーの読み方の回でやったとおり、下から読みます。

③ ユニットファイルの文法を検査する

bash
$ systemd-analyze verify /etc/systemd/system/hello.service
/etc/systemd/system/hello.service:6: Unknown key name 'Enviroment' in section 'Service', ignoring.

これが一番効きます。 systemd は、知らない項目名を黙って無視します。 Environment を Enviroment と打ち間違えても、起動は成功します。ただ、その設定だけが無かったことになります。 「書いたのに効かない」の大半はこれです。status にも journalctl にも出ません。verify だけが教えてくれます。

④ 最終形を確認する

bash
$ systemctl cat hello
$ systemctl show hello -p ExecStart -p User -p Type

自分が書いたつもりの値と、systemd が解釈した値が一致しているかを見ます。drop-in を作ったことを忘れている、が意外とあります。

⑤ 同じ条件で、手で実行する

bash
$ sudo -u ubuntu env -i GREETING=こんにちは /home/ubuntu/deep/hello.sh

env -i は「環境変数を空にして実行」です。サービスと同じ、何も無い環境を再現します。「シェルでは動くのにサービスだと動かない」の切り分けが、これで一発です。

この5つを表にまとめておきます。

症状まず打つもの
failed になったjournalctl -u 名前 -n 50 --no-pager -x
start は通るのに何も起きないsystemctl show 名前 -p ExecStart
書いた設定が効かないsystemd-analyze verify と systemctl cat
再起動を繰り返すsystemctl show 名前 -p NRestarts と Restart= の値
「もう起動しない」と言われるsudo systemctl reset-failed 名前
手では動くのにサービスだと動かないUser= WorkingDirectory= Environment= の3つ
再起動したらログが消えたjournalctl --list-boots と Storage=

わざと壊して直す練習は、障害対応の回でもやりました。 順番を決めておくと、焦らずに済みます。

つまずいたところ

daemon-reload を忘れて30分溶かしました。 ユニットファイルを直して restart する。変わらない。もう一度直す。変わらない。ファイルを見ると、ちゃんと直っています。 systemd が読み直していないだけでした。「ファイルを触ったら daemon-reload」を体で覚えるまで、3回はやりました。

Start request repeated too quickly で完全に詰まりました。 Restart=always にしたまま、失敗するスクリプトを何度も直しては restart していたら、そのうち start すら受け付けなくなりました。 ユニットファイルを削除して作り直しても駄目です。reset-failed を知るまで、原因がまったく分かりませんでした。 「systemd が壊れた」と本気で思いました。

Enviroment= と打ち間違えて、1時間気づきませんでした。 n が抜けています。起動は成功します。ログにも何も出ません。 ただ環境変数だけが入っていません。systemd-analyze verify を打って初めて Unknown key name と出ました。「systemd は知らない項目を無視する」を知らないと、永遠に見つかりません。

After=mysql.service を書いて安心していました。 「順番の指定だから、mysql のあとに起動する」と読んでいました。mysql を enable していなかった環境では、mysql が起動しないまま自分だけ起動していました。 そして接続に失敗していました。After= は相手を呼ばない、をこの記事で確かめて、ようやく腑に落ちました。

ユーザー単位のユニットを作って、SSH を抜けたら消えていました。 enable もしたし --now も付けた。なのに入り直すと止まっている。「enable が効いていない」と思って何度もやり直しました。 enable-linger という別の概念があるとは想像もしていませんでした。

ログを vacuum してから、そのログを見たくなりました。 ディスクが心配で --vacuum-size=100M を打った直後に、「さっきのエラー、もう一度見たい」となりました。もうありません。 調査中に容量を減らすのは、順番が逆でした。

後片づけ

この記事で作ったものを、全部消します。

① システム単位のユニットを止めて、無効化して、消す

bash
$ sudo systemctl disable --now hello.service
$ sudo systemctl stop crash.service dep-a.service dep-b.service
$ sudo systemctl revert hello.service

revert で drop-in が消えます。残っていないか確認します。

bash
$ ls /etc/systemd/system/hello.service.d 2>/dev/null

何も出なければ消えています。 ユニット本体を消します。

bash
$ sudo rm /etc/systemd/system/hello.service
$ sudo rm /etc/systemd/system/crash.service
$ sudo rm /etc/systemd/system/dep-a.service
$ sudo rm /etc/systemd/system/dep-b.service
$ sudo systemctl daemon-reload
$ sudo systemctl reset-failed

daemon-reload を忘れると、消したはずのユニットが systemctl list-units に残ります。 not-found という状態で出てきます。reset-failed は、失敗したまま記録に残っているものを消します。

② ユーザー単位のユニットを消す

bash
$ systemctl --user disable --now myhello.service
$ rm ~/.config/systemd/user/myhello.service
$ systemctl --user daemon-reload
$ sudo loginctl disable-linger $USER

disable-linger を忘れないでください。 付けたままだと、ログアウト後もそのユーザーのプロセスが居座り続けます。

③ 練習用のファイルを消す

bash
$ rm -rf ~/deep

④ 残っていないか確認する

bash
$ systemctl list-units --all | grep -E "hello|crash|dep-"
$ systemctl --user list-units --all | grep myhello
$ loginctl show-user $USER | grep Linger

1行も出ず、Linger=no なら片づいています。

/var/log/journal の永続化と SystemMaxUse= は、戻さなくて構いません。 ログが残るほうが、この先ずっと役に立ちます。

まとめ

  • .service は、ユニットの一種でしかない。 .target は何も実行しない「状態の旗」で、.timer は定期実行の回で扱ったもの
  • ユニットの置き場は3つあり、/etc/systemd/system/ がパッケージ側に勝つ。 どれが読まれているかは systemctl cat
  • ファイルを触ったら必ず daemon-reload。 これを忘れると「直したのに反映されない」で確実に溶かす
  • After= は順番であって依存ではない。 相手を起動させない。相手も起動させたいなら Requires= か Wants= を別に書く
  • Requires= は「一緒に起動」であって「先に終わらせる」ではない。 順番が要るなら After= とセット
  • 迷ったら Wants=。 Requires= は連鎖して止まるので、1つの障害が広く波及する
  • network.target は IP が付いたことを保証しない。 本当に待つなら network-online.target
  • Type= は「起動できた」の判定方法の申告。 simple が既定なのは「何も申告しない」から。自分で書くなら exec のほうが、失敗がその場で分かる
  • Type を間違えると、動いているのに落ちた扱いか、90秒待たされて failed になる
  • Restart=on-failure は正常終了では再起動しない。always はする。 どちらも手動 stop では再起動しない
  • 無限には再起動しない。 10秒に5回を超えると諦める。解除は sudo systemctl reset-failed
  • Restart= は原因を隠す。 落ちている回数は systemctl show 名前 -p NRestarts
  • 何も書かなければ User=root / WorkingDirectory=/ / 環境変数ほぼ空。 「シェルでは動くのにサービスだと動かない」はここ
  • [Install] が無いと enable できない。 enable の正体はシンボリックリンクを1本張るだけ。だから disable してもサービスは動いたまま
  • journalctl は -u -f --since -p -b の5つで絞る。 「今回の起動のエラー以上」は journalctl -p err -b
  • ログは設定次第で再起動のたびに消える。 Storage=auto は /var/log/journal/ があるかどうかで黙って挙動が変わる
  • 永続化したら溜まり続ける。 journalctl --disk-usage で測り、SystemMaxUse= で上限を決める。--vacuum は調査が終わってから
  • 起動が遅い原因は blame ではなく critical-chain で探す。 並列に走っているので「長い」と「待たせている」は別
  • 配布物のユニットを直接編集しない。 apt upgrade で予告なく消える。systemctl edit で drop-in を作る
  • drop-in で ExecStart= を変えるときは、一度空の ExecStart= を書いてリセットする。 書かないと2回実行される
  • ユーザー単位のユニットは sudo が要らない代わりに、ログアウトで止まる。 居座らせるのは loginctl enable-linger
  • systemd は知らない項目名を黙って無視する。 Enviroment= の打ち間違いは起動に成功する。見つけられるのは systemd-analyze verify だけ
  • 落ちたときの型: status → journalctl -u -x → systemd-analyze verify → systemctl cat と show → env -i で手で実行

ユニットファイルを書いて壊して直す練習は手元の VM で十分ですが、借りたサーバーでも同じ手順がそのまま使えます。さくらのVPSはクレジットカード払いなら全プランを 2 週間無料で試せる(2026-11 時点)ので、自作ユニットを公開サーバーに置いて journalctl で追う練習先にできます。ただし解約しないと自動で本登録になり、最低利用期間は 3ヶ月です。

参考リンク


次に読む

この記事は 【深掘り】Linux の 7 / 18 本目です。

記事
← 前の記事プロセスとシグナル — kill -9を最初に打たない
→ 次の記事ディスクとファイルシステム fstab・LVM — 消しても空き容量が戻らない

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps›Linux — Service Management
  • ユニットファイルを自分で書く
  • journalctl でログを読む

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次