すべてにsudoを使うのはやめよう:systemdユーザーユニットとLingeringガイド

Linux tutorial - IT technology blog
Linux tutorial - IT technology blog

なぜユーザーコンテキストでサービスを実行するのか?

システム管理者を始めたばかりの頃、私は危険な習慣を持っていました。すべてのバックグラウンドスクリプトをrootとして実行していたのです。パーミッションの壁をすべて回避できるため, それが最も簡単な道でした。しかし、インフラが成長するにつれ、そのリスクに気づきました。rootレベルのスクリプトにバグが一つあるだけで、OS全体が危険にさらされる可能性があります。そこで、systemdユーザーユニットの出番です。

多くのLinux管理者はシステム全体のサービス管理systemctlを使用しますが、ユーザーレベルのマネージャーを活用している人はほとんどいません。このツールを使えば、自分自身のユーザーアカウントの権限でサービスを実行できます。標準的なUbuntu 22.04のVPSで、DockerベースのPythonワーカーからsystemdユーザーユニットに切り替えたところ、アイドリング時のメモリ使用量が150MBからわずか12MBに減少しました。これは、システム全体へのアクセスを必要としないタスクにとって、軽量で安全な代替手段となります。

サービス管理手法の比較

プロセスをバックグラウンドで維持し続ける必要がある場合、いくつかの選択肢があります。本番環境における比較は以下の通りです。

手法 永続性 セキュリティ 制御
Screen/Tmux 再起動で消失 高 (ユーザー) 手動のみ
Crontab @reboot 永続的 高 (ユーザー) 自動再起動なし
システム全体のsystemd 永続的 低 (Root) 非常に優れている
systemdユーザーユニット 永続的 高 (ユーザー) 非常に優れている

ウェブスクレイパーやDiscordボット、プライベートAPIのような非クリティカルなタスクには、ユーザーユニットがセキュリティと使いやすさのバランスにおいて最適です。

トレードオフ

ユーザーユニットはあらゆる状況において完璧というわけではありません。環境を移行する前に、メリットとデメリットを把握しておく必要があります。

メリット

  • 影響範囲の限定: 攻撃者がサービスを悪用したとしても、ユーザー権限の範囲内に封じ込められます。システムバイナリや他のユーザーのデータに触れることはできません。
  • 開発者の自律性: 上位の管理者にsudo権限を要求することなく、サービスのデプロイや管理が可能です。
  • クリーンな環境: パスや環境変数はホームディレクトリ内に限定されるため、システムレベルでの「依存関係の地獄」を避けることができます。

デメリット

  • リソースの制限: ユーザーサービスは単一のリソーススライスを共有します。一つのサービスがメモリリークを起こすと、カーネルが他のユーザープロセスを停止させる可能性があります。
  • 特権ポート: 追加の設定なしでは、1024未満のポート(80や443など)にバインドすることはできません。
  • セッションへの依存: デフォルトでは、ログアウトするとサービスも停止します。これはよくある不満点ですが、「Lingering」によって解決できます。

実践的な実装方法

私は、ハードウェアレベルのアクセスを必要としないGoバイナリやNode.jsアプリには、ユーザーユニットを使用しています。サービスファイルは常に~/.config/systemd/user/に保存します。これはXDG規格に準拠しており、ホームディレクトリを整理された状態に保てます。

1. ユニットファイルの作成

まず、systemdがユーザーレベルの設定を探すディレクトリを作成します。

mkdir -p ~/.config/systemd/user/

Pythonワーカー用のサービスを作成してみましょう。クラッシュした場合に自動的に再起動し、出力を特定のフォルダにログ記録するように設定します。

nano ~/.config/systemd/user/my-worker.service

以下の設定を貼り付けます。パスは実際のプロジェクトの場所に置き換えてください:

[Unit]
Description=Pythonバックグラウンドワーカー
After=network.target

[Service]
ExecStart=/usr/bin/python3 -u /home/alex/scripts/worker.py
Restart=always
RestartSec=3
StandardOutput=append:/home/alex/logs/worker.log
StandardError=append:/home/alex/logs/worker.err

[Install]
WantedBy=default.target

注意: 常に絶対パスを使用してください。systemdはPATH変数や.bashrcのエイリアスを認識しません。

2. サービスの制御

これらのサービスを管理する際は、--userフラグが必須です。これがないと、systemdは/etc/systemd/system/を確認し、ファイルが見つからずエラーになります。

# マネージャーをリロード
systemctl --user daemon-reload

# 起動して自動起動を有効化
systemctl --user start my-worker.service
systemctl --user enable my-worker.service

# 実行状態を確認
systemctl --user status my-worker.service

3. Lingeringによる永続性の有効化

ほとんどのモダンなディストリビューションでは、最後のSSHセッションが終了した瞬間にすべてのユーザープロセスが終了します。サービスを24時間365日稼働させるには、Lingering(リンガリング)を有効にする必要があります。これにより、システム起動時にユーザーマネージャーを開始し、無期限に維持するようsystemdに指示します。

# 特定のユーザーに対してLingeringを有効化
sudo loginctl enable-linger alex

有効にすると、SSHでログインする前であっても、サーバーが起動した瞬間にサービスが開始されます。

よくあるエラーのトラブルシューティング

シンプルな構成でも問題が発生することがあります。私が頻繁に遭遇する2つの問題を紹介します。

「Failed to connect to bus」エラー

もしFailed to connect to bus: No such file or directoryと表示される場合、XDG_RUNTIME_DIRが設定されていない可能性があります。これは通常、su - usernameでユーザーを切り替えた場合に発生します。修正するには、以下のコマンドを実行するか、プロファイルに追加してください:

export XDG_RUNTIME_DIR=/run/user/$(id -u)

root権限なしでのログ確認

/var/log/syslogを確認する必要はありません。ユーザーフラグを付けてjournalctlを使用すれば、スクリプトの動作をリアルタイムで正確に把握できます。

journalctl --user -u my-worker.service -f

「rootのみ」という考え方から脱却することで、サーバーの回復力(レジリエンス)が高まります。ユーザーユニットとLingeringは、最小限のオーバーヘッドでバックグラウンドタスクを管理するための、コンテナを使わないプロフェッショナルな手法を提供します。

Share: