※本記事はアフィリエイト広告(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 で上書きする作法
この記事でやること
- 最小の
.serviceを1本書く(4行だけ)。そこから1項目ずつ足す AfterとRequiresの違いを、2本のユニットを実際に走らせて確かめるTypeとRestartを間違えた状態を、わざと作って壊すjournalctlでログを systemd 側から読む。消える設定を直し、ディスク使用量を見るsystemctl editで drop-in を作り、systemctl catで最終形を確かめる- ユーザー単位のユニットを1本動かし、ログアウトで止まることを確認する
- 作ったユニットを、止めて・無効化して・消す
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| ユニット(unit) | systemd が管理する対象1つ分の設定。サービスもタイマーもマウントも、全部「ユニット」という単位で扱われる |
| ユニットファイル | そのユニットの中身を書いたテキストファイル。.service や .timer などの拡張子で種類が決まる |
| ディレクティブ | ユニットファイルの中の Type=simple のような1行。「項目」と呼んでいるもの |
| セクション | [Unit] [Service] [Install] のような角括弧の見出し。どのセクションに書くかで意味が変わる |
| ターゲット(target) | 複数のユニットをまとめた「状態」。「ここまで起動が進んだ」という区切りに使う |
| drop-in | 元のユニットファイルを書き換えずに、上から一部だけ差し替える追加ファイル |
| journal | systemd が集めたログの置き場。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 が内部で使うものです。
種類ごとに一覧できます。
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/ に置きます。 理由は下の「設定を上書きする作法」で書きます。
いま効いている実体は、これで見えます。
先頭に # /usr/lib/systemd/system/ssh.service のようにパスがコメントで出ます。 どのファイルが読まれているかが、これで確定します。
最小のユニットを1本書く
題材を作ります。 5秒ごとに1行出すだけのスクリプトです。動き続けるプログラムの、いちばん単純な形です。
chmod +x を忘れると Permission denied で起動しません。 権限の回でやったところです。
手で動くことを先に確かめます。ユニットにする前に必ずこれをやってください。 手で動かないものは、ユニットにしても動きません。
5秒おきに1行出れば成功です。Ctrl + C で止めます。
ユニットファイルを作る
まず、これだけです。
[Unit]
Description=深掘り練習用のサービス
[Service]
ExecStart=/home/ubuntu/deep/hello.sh
4行(空行を除けば3項目)しかありません。 これで動きます。
ExecStart=に~は書けません。~/deep/hello.shと書くと起動に失敗します。systemd はシェルではないので、~も$HOMEも*も展開しません。 必ず絶対パスで書きます。 ユーザー名がubuntuでないなら、/home/自分の名前/deep/hello.shに読み替えてください。echo $HOMEで確認できます。
読み込ませて、動かします。
● 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本作ります。
[Unit]
Description=依存の実験 A(3秒かかる)
[Service]
Type=oneshot
ExecStart=/bin/sh -c 'sleep 3; echo "A が終わりました"'
[Unit]
Description=依存の実験 B
After=dep-a.service
[Service]
Type=oneshot
ExecStart=/bin/sh -c 'echo "B が動きました"'
B には After=dep-a.service だけを書きました。 素直に読めば「A のあとに B」です。
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= を足します。
[Unit]
Description=依存の実験 B
Requires=dep-a.service
After=dep-a.service
[Service]
Type=oneshot
ExecStart=/bin/sh -c 'echo "B が動きました"'
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 を失敗させます。
ExecStart の行を、失敗する形に変えます。
ExecStart=/bin/sh -c 'sleep 1; echo "A は失敗します"; exit 1'
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
start は、何も言わずに成功します。 失敗は status を見て初めて分かります。
Active: failed (Result: exit-code)
Type=simple は「プロセスを起こした」までしか見ていないので、その直後に失敗しても start コマンド自体は成功として返るわけです。
Type=exec に書き換えて、同じことをします。
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= — 実際に落として確かめる
落ちたら勝手に立ち上がってほしい。 これを書く項目です。値によって「落ちた」の定義が変わります。
起動してすぐに失敗するスクリプトを用意します。
[Unit]
Description=落ちる実験
[Service]
Type=exec
ExecStart=/home/ubuntu/deep/crash.sh
Restart=no
数秒待ってから見ます。
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
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で再起動した回数が見られるので、「動いてはいるが、実は毎分落ちている」を見つけるのはここです。
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つを出力するように書いてあります。 いまのログを見てください。
Sep 17 11:20:05 ubuntu hello.sh[5012]: hello / user=root / cwd=/ / GREETING=未設定
root で、ルートディレクトリで動いていました。 何も書いていないので当然です。書いていないものは、既定値が黙って選ばれているわけです。
3つとも指定します。
[Unit]
Description=深掘り練習用のサービス
[Service]
Type=exec
ExecStart=/home/ubuntu/deep/hello.sh
User=ubuntu
Group=ubuntu
WorkingDirectory=/home/ubuntu/deep
Environment=GREETING=こんにちは
Sep 17 11:23:41 ubuntu hello.sh[5140]: hello / user=ubuntu / cwd=/home/ubuntu/deep / GREETING=こんにちは
3つとも変わりました。
User=を書いたら、そのユーザーがファイルを読めるか確認してください。rootで動いていたときは何でも読めていたので、User=を足した瞬間にPermission deniedが出ることがあります。これは「壊れた」のではなく、「今まで強すぎた」だけです。
環境変数が増えてきたら、ファイルに出します。
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 でした。
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
Created symlink /etc/systemd/system/multi-user.target.wants/hello.service → /etc/systemd/system/hello.service.
メッセージをそのまま読んでください。enable がやったのは、シンボリックリンクを1本張ることだけです。
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秒ごとに書き続けているので、練習相手にちょうどいいです。
絞り込みの5つ
| オプション | 意味 | 使う場面 |
|---|---|---|
-u 名前 | そのユニットのログだけ。複数書ける | まずこれ |
-f | 流し見。 新しい行が出るたびに追記される | 直しながら見る |
--since / --until | 期間を切る | 「昨日の夜」に絞る |
-p | 深刻度で絞る | エラーだけ拾う |
-b | 今回の起動分だけ。-b -1 で前回 | 再起動をまたいで比べる |
期間の指定は、日本語的な書き方が通ります。
深刻度は0〜7の数字と名前で指定します。
| 数字 | 名前 | 意味 |
|---|---|---|
| 0 | emerg | システムが使えない |
| 1 | alert | すぐ対応が要る |
| 2 | crit | 致命的 |
| 3 | err | エラー。まずここを見る |
| 4 | warning | 警告 |
| 5 | notice | 普通だが目立つ |
| 6 | info | 普通の情報(既定でここまで出る) |
| 7 | debug | 開発用 |
「今回の起動でエラー以上だったもの、全部」です。 何かおかしいと思ったとき、まずこれを打つと当たりが早いです。
-p errは「err だけ」ではなく「err 以上(0〜3)」です。 範囲で指定したいなら-p warning..errのように書きます。
再起動をまたいで比べます。
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 が前回です。「再起動する前は動いていた」を確かめるときに使います。
表示形式も変えられます。
| 形式 | 何が出るか |
|---|---|
short(既定) | 時刻 + ホスト名 + プロセス名 + 本文 |
short-iso | 時刻が 2026-09-17T11:52:20+0900 形式。 他のログと突き合わせるときに揃う |
cat | 本文だけ。 アプリが出した内容だけを見たいとき |
json-pretty | journal が実際に持っている全フィールド。 何が記録されているかを知るのに一度見ておく |
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 の行が写るようにしてください。
ログが消える
再起動したら、さっき読んでいたログが丸ごと消えていた。 これが起きます。バグではなく設定です。
ここに今回(0)しか出てこないなら、ログは再起動で消えています。
理由は、journal の保存先がメモリになっているからです。
| 保存先 | 場所 | 再起動したら |
|---|---|---|
| 永続 | /var/log/journal/ | 残る |
| 揮発(volatile) | /run/log/journal/ | 消える(/run はメモリ上) |
設定を見ます。
#Storage=auto
# が付いているので既定値です。そして既定は auto。
Storage= | 動き |
|---|---|
auto(既定) | /var/log/journal/ というディレクトリが存在すれば永続、無ければ揮発 |
persistent | ディレクトリが無ければ作って、必ず永続 |
volatile | 必ずメモリ。再起動で消える |
none | 保存しない |
auto の怖いところは、「ディレクトリがあるかどうか」で黙って挙動が変わることです。 Ubuntu Server の通常インストールなら存在しますが、コンテナや、最小構成のイメージでは無いことがあります。
確かめます。
No such file or directory と出たら、ログは消えています。 永続化します。
確認は、VMを再起動して journalctl --list-boots に -1 が出ることです。
再ログインして、
-1 の行が出れば、前回の起動分が残っています。
戻し方: 永続化をやめたいなら
sudo rm -rf /var/log/journalで元に戻ります。この記事では戻さなくて構いません。 ログが残っているほうが、この先ずっと役に立ちます。
ディスクを食う
永続化したということは、ログが溜まり続けるということです。
Archived and active journals take up 528.0M in the file system.
放っておくと、ディスクの一部を静かに占め続けます。 systemd は既定でファイルシステムの10%まで(上限4GB)使います。学習用の20GBのVMなら2GBです。
いますぐ減らすなら、こうです。
Vacuuming done, freed 312.0M of archived journals from /var/log/journal/...
| 指定 | 意味 |
|---|---|
--vacuum-size=200M | 合計200MBに収まるまで、古いものから消す |
--vacuum-time=14d | 14日より古いものを消す |
--vacuum-files=5 | ファイル数で切る |
恒久的な上限は設定ファイルに書きます。
[Journal]
SystemMaxUse=500M
MaxRetentionSec=1month
vacuumは、消したログを取り戻せません。 障害の調査中に打たないでください。まず必要なところを別ファイルに保存してから消します。
ログを1画面にまとめる話は、ログを1画面にする回でやりました。 そちらは複数台・複数コンテナの話で、この記事は1台の中の journal そのものの話です。
依存関係を見る
書いた After= や Wants= が、実際にどう繋がっているかを見ます。
hello.service
● ├─system.slice
● └─sysinit.target
● ├─systemd-journald.service
● ├─systemd-tmpfiles-setup.service
● └─...
書いていないのに、たくさん繋がっています。 [Service] を持つユニットには、既定で Requires=sysinit.target と After=sysinit.target basic.target が暗黙に付くからです。「何も書いていない」は「依存が無い」ではありません。
逆向きも見られます。
「誰が自分を必要としているか」です。enable したあとなら multi-user.target が出ます。
順序だけを見たいなら、これです。
起動が遅い原因を探す
VMの起動が遅い。どこで時間を食っているのか。
Startup finished in 4.106s (kernel) + 21.735s (userspace) = 25.842s
graphical.target reached after 21.501s in userspace.
ユニットごとの所要時間を並べます。
19.442s systemd-networkd-wait-online.service
3.117s snapd.service
1.882s cloud-init.service
898ms dev-sda2.device
blameの上位が、そのまま原因とは限りません。 多くのユニットは並列に起動しています。 3秒かかったユニットが3本あっても、並列なら全体は3秒です。「長い」と「待たせている」は別です。
「待たせている」ほうを見るのが、これです。
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にも出せます。
VMに直接ブラウザが無いので、VS Code のリモート接続で開くのが楽です。
設定を上書きする作法
nginx の起動オプションを変えたい。 ユニットファイルは /usr/lib/systemd/system/nginx.service にあります。ここを直接編集してはいけません。
理由は2つです。 1.
apt upgradeで上書きされます。 パッケージが更新されると、自分の編集は予告なく消えます 2. 消えたことに気づけません。 動かなくなるのは更新の数週間後で、原因を編集に結び付けられません
正しいやり方は、drop-in です。
エディタが開き、上下がコメントで挟まれた空白部分が出ます。そこに、変えたい項目だけを書きます。
[Service]
Environment=GREETING=上書きされました
保存して閉じると、daemon-reload まで自動でやってくれます。
Sep 17 12:40:11 ubuntu hello.sh[6210]: hello / user=ubuntu / cwd=/home/ubuntu/deep / GREETING=上書きされました
何が起きたのか、ファイルで確認します。
-rw-r--r-- 1 root root 61 Sep 17 12:39 override.conf
元のファイルは1文字も変わっていません。 .d というディレクトリが増え、その中の .conf が上から重なっているだけです。
最終的に何が効いているかは、これで見ます。
# /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コマンドです。
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= を書いていないとき、実際は何になっているのか」を確かめるのに使います。
Type=exec
Restart=no
User=ubuntu
WorkingDirectory=/home/ubuntu/deep
ユーザー単位のユニット
ここまで全部 sudo を付けていました。 systemd には、自分のユーザーだけで動く systemd がもう1つあります。
sudo なしで動きます。 ユニットの置き場所も違います。
| システム単位 | ユーザー単位 | |
|---|---|---|
| コマンド | sudo systemctl | systemctl --user |
| ユニットの置き場 | /etc/systemd/system/ | ~/.config/systemd/user/ |
| 動く権限 | User= で指定(既定 root) | 自分のみ(User= は書けない) |
| ログ | journalctl -u | journalctl --user -u |
| いつ動くか | OS起動時 | ログインしたとき |
1本作ります。
WantedBy= が multi-user.target ではなく default.target です。 ユーザー単位の systemd には multi-user.target がありません。
sudo を一度も打っていません。 自分のアプリを動かすだけなら、root の権限は要らないわけです。
ログアウトすると止まる
ここが罠です。 SSH を切って、入り直してください。
再度 SSH で入って、
止まっています。 場合によっては、そもそも Failed to connect to bus と言われます。
ユーザー単位の systemd は、そのユーザーのセッションが1つも無くなると終了します。 「SSH で入って動かして、抜けたら消えていた」の正体がこれです。バグではありません。
居座らせるには、明示的に許可します。
Linger=yes
もう一度ログアウトして入り直すと、今度は動き続けています。
| ログアウト後 | OS再起動後 | |
|---|---|---|
| linger なし | 止まる | 上がらない |
| linger あり | 動き続ける | enable してあれば上がる |
どちらを使うか。
- サーバーとして常時動かすもの → システム単位(
/etc/systemd/system/)。root 権限が要るが、起動時に確実に上がる - 自分の作業用ツール、開発中のアプリ → ユーザー単位。
sudoが要らないので気軽に試せる - ユーザー単位で常時動かしたい →
enable-lingerを必ずセットで
sudo systemctl --user ...は動きません。--userは「自分のセッション」に繋ぎに行くので、sudoを付けると root のセッションを探しに行って失敗します。--userにsudoは付けない、と覚えてください。
落ちたときの調べ方の型
ここまでの道具を、順番に並べます。この順で打てば、だいたい原因に着きます。
① まず状態を見る
Active: の括弧の中を読みます。exit-code なのか signal なのか timeout なのかで、次に見る場所が変わります。
② ログを、説明つきで読む
-x を付けると、systemd 自身のメッセージに説明文が足されます。 エラーの読み方の回でやったとおり、下から読みます。
③ ユニットファイルの文法を検査する
/etc/systemd/system/hello.service:6: Unknown key name 'Enviroment' in section 'Service', ignoring.
これが一番効きます。 systemd は、知らない項目名を黙って無視します。
EnvironmentをEnviromentと打ち間違えても、起動は成功します。ただ、その設定だけが無かったことになります。 「書いたのに効かない」の大半はこれです。statusにもjournalctlにも出ません。verifyだけが教えてくれます。
④ 最終形を確認する
自分が書いたつもりの値と、systemd が解釈した値が一致しているかを見ます。drop-in を作ったことを忘れている、が意外とあります。
⑤ 同じ条件で、手で実行する
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 を打った直後に、「さっきのエラー、もう一度見たい」となりました。もうありません。 調査中に容量を減らすのは、順番が逆でした。
後片づけ
この記事で作ったものを、全部消します。
① システム単位のユニットを止めて、無効化して、消す
revert で drop-in が消えます。残っていないか確認します。
何も出なければ消えています。 ユニット本体を消します。
daemon-reloadを忘れると、消したはずのユニットがsystemctl list-unitsに残ります。not-foundという状態で出てきます。reset-failedは、失敗したまま記録に残っているものを消します。
② ユーザー単位のユニットを消す
disable-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.targetType=は「起動できた」の判定方法の申告。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ヶ月です。
参考リンク
- roadmap.sh — Linux
- systemd.unit — ユニットファイル共通の書式
- systemd.service —
Type=とRestart=の全値 - systemd.exec —
User=Environment=などの実行環境 - journald.conf —
Storage=とSystemMaxUse= - Ubuntu manpages — journalctl(1)
- Ubuntu manpages — systemd-analyze(1)
- Ubuntu manpages — loginctl(1)
次に読む
この記事は 【深掘り】Linux の 7 / 18 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- ユニットファイルを自分で書く
- journalctl でログを読む
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント