inotifywaitコマンドでファイル変更をリアルタイム監視する方法｜スクリプト自動化と実務活用も

この記事のポイント

・inotifywait でファイル変更・作成・削除をリアルタイムで検知できる
・-e オプションでイベント種別を絞り込み、誤検知を防ぐ
・while ループと組み合わせて自動処理スクリプトを書ける
・inotify-tools パッケージのインストールで即使える（RHEL9/Ubuntu24.04対応）

# EPEL リポジトリを有効化
$ sudo dnf install -y epel-release

# inotify-tools をインストール
$ sudo dnf install -y inotify-tools

# バージョン確認
$ inotifywait --version
inotifywait 3.22.6.0

$ sudo apt install -y inotify-tools

# バージョン確認
$ inotifywait --version
inotifywait 3.22.6.0

# 基本書式
inotifywait [オプション] 監視対象ファイル/ディレクトリ

# 単発監視: /etc/nginx/nginx.conf が変更されるまで待機する
$ inotifywait /etc/nginx/nginx.conf
Setting up watches.
Watches established.
/etc/nginx/nginx.conf MODIFY

# 書き込み完了（CLOSE_WRITE）のみ検知する
$ inotifywait -e close_write /tmp/test.txt
Setting up watches.
Watches established.
/tmp/test.txt CLOSE_WRITE,CLOSE

# /var/www/html 配下を再帰的に監視
$ inotifywait -r -e close_write,create,delete /var/www/html
Setting up watches.  Finished establishing watches, now continuing.
/var/www/html/css/ CLOSE_WRITE,CLOSE style.css
/var/www/html/ CREATE newfile.html

# /etc/nginx 配下を継続監視
$ inotifywait -m -r -e close_write,create,delete /etc/nginx
Setting up watches.  Finished establishing watches, now continuing.
/etc/nginx/conf.d/ CLOSE_WRITE,CLOSE api.conf
/etc/nginx/nginx.conf CLOSE_WRITE,CLOSE
^C  # Ctrl+C で終了

#!/bin/bash
# /usr/local/bin/watch-nginx-conf.sh

WATCH_DIR="/etc/nginx"

echo "Watching: ${WATCH_DIR}"

while inotifywait -r -e close_write,create,delete --quiet "${WATCH_DIR}"; do
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] 設定ファイル変更を検知"
    if nginx -t 2>&1; then
        echo "設定テスト OK - nginx をリロードします"
        systemctl reload nginx
    else
        echo "設定テスト NG - リロードをスキップします" >&2
    fi
done

#!/bin/bash
# /usr/local/bin/watch-upload.sh

WATCH_DIR="/var/upload/incoming"
PROCESSED_DIR="/var/upload/processed"

while IFS= read -r -d '' event_dir event_name; do
    FILE="${event_dir}${event_name}"
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] 新規ファイル検知: ${FILE}"
    # ここに処理を追加（例: 変換・移動）
    mv "${FILE}" "${PROCESSED_DIR}/"
done < <(inotifywait -m -r -e close_write \
    --format '%w%0%f%0' \
    --quiet "${WATCH_DIR}")

# /etc/systemd/system/watch-nginx-conf.service

[Unit]
Description=Watch Nginx config and reload on change
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/watch-nginx-conf.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

# サービスを有効化・起動する
$ sudo systemctl daemon-reload
$ sudo systemctl enable watch-nginx-conf.service
$ sudo systemctl start watch-nginx-conf.service

# 状態確認
$ sudo systemctl status watch-nginx-conf.service
* watch-nginx-conf.service - Watch Nginx config and reload on change
     Loaded: loaded (/etc/systemd/system/watch-nginx-conf.service; enabled)
     Active: active (running) since Mon 2026-04-27 10:00:00 JST; 1min ago
   Main PID: 12345 (watch-nginx-conf)

# 現在の上限を確認する
$ cat /proc/sys/fs/inotify/max_user_watches
8192

# 上限を一時的に増やす（再起動で元に戻る）
$ sudo sysctl fs.inotify.max_user_watches=524288

# 永続化する場合は /etc/sysctl.conf に追記
$ echo "fs.inotify.max_user_watches=524288" | sudo tee -a /etc/sysctl.conf
$ sudo sysctl -p