設定ファイルを安全に変更する手順|バックアップ・構文チェック・切り戻し
設定ファイルの変更は、「バックアップ → 変更 → 差分の確認 → 構文チェック → 反映 → 動作確認」の順に進めます。なかでも、反映の前に行う構文チェックと、すぐに元へ戻せるバックアップの2つが、サービス停止を防ぐ要になります。この順番を毎回守ることが、もっとも確実な事故防止です。
全体の流れ
| 順番 | やること | 目的 |
|---|---|---|
| 1 | バックアップを取る | いつでも元の状態に戻せるようにする |
| 2 | 設定を変更する | 手順書どおりの内容に書き換える |
| 3 | 差分を確認する | 意図した箇所だけが変わっているかを確かめる |
| 4 | 構文チェックを行う | 反映の前に、書き間違いを見つける |
| 5 | 設定を反映する | サービスに新しい設定を読み込ませる |
| 6 | 動作を確認する | サービスが正常に動いているかを確かめる |
以下では、nginxの設定ファイルを変更する場合を例に、各ステップを見ていきます。ほかのサービスでも、流れは同じです。
ステップ1:バックアップを取る
$ sudo cp -p /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak_$(date +%Y%m%d_%H%M%S)
$ ls -l /etc/nginx/nginx.conf*
-rw-r--r-- 1 root root 2412 Oct 30 09:12 /etc/nginx/nginx.conf
-rw-r--r-- 1 root root 2412 Oct 30 09:12 /etc/nginx/nginx.conf.bak_20261114_101500
-pを付けると、所有者・権限・更新日時が、元のファイルのまま保たれます。ファイル名に日時を入れておくと、いつの時点の状態かが分かり、同じ日に複数回変更しても、上書きされません。コピーのあとは、ls -lで、バックアップが作成されたことと、サイズが同じであることを確認します。
conf.d/のように、ディレクトリ内の.confファイルをすべて読み込む設定になっている場合、同じディレクトリに.confで終わる名前のバックアップを置くと、設定として読み込まれてしまいます。拡張子の後ろに
.bak_日付を付けるか、別のディレクトリに保存します。ステップ2〜3:変更して、差分を確認する
$ sudo vi /etc/nginx/nginx.conf
$ diff -u /etc/nginx/nginx.conf.bak_20261114_101500 /etc/nginx/nginx.conf
--- /etc/nginx/nginx.conf.bak_20261114_101500
+++ /etc/nginx/nginx.conf
@@ -12,7 +12,7 @@
sendfile on;
- keepalive_timeout 65;
+ keepalive_timeout 30;
server_tokens off;
diff -u 変更前 変更後で、変更した箇所だけが表示されます。-の行が変更前、+の行が変更後です。手順書で指示された箇所だけが変わっているか、余計な文字が混入していないかを、ここで確認します。この差分は、作業の証跡として、そのまま報告に使えます。
ステップ4:構文チェックを行う
$ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
多くのサービスには、設定ファイルの書き方に誤りがないかを、反映の前に検査するコマンドが用意されています。構文に誤りがある状態でサービスを再起動すると、サービスが起動できず、停止したままになります。構文チェックでエラーが出たら、反映には進まず、設定を直します。
| サービス・設定 | 構文チェックのコマンド |
|---|---|
| nginx | sudo nginx -t |
| Apache | sudo apachectl configtest |
| SSH(sshd) | sudo sshd -t |
| BIND | sudo named-checkconf・sudo named-checkzone ゾーン名 ファイル |
| Postfix | sudo postfix check |
| sudoers | sudo visudo -c |
| /etc/fstab | sudo findmnt --verify・sudo mount -a |
| systemdのユニットファイル | sudo systemd-analyze verify ファイル |
ステップ5:設定を反映する
$ sudo systemctl reload nginx # 接続を切らずに、設定だけを読み込み直す
$ sudo systemctl restart nginx # プロセスを停止して、起動し直す
reloadは、サービスを止めずに、設定を読み込み直します。restartは、いったん停止してから起動するため、短い時間ですが、サービスが途切れます。reloadに対応しているサービスで、reloadで反映できる変更であれば、reloadを優先します。どちらを使うかは、手順書の指示に従います。
systemdのユニットファイル自体を変更した場合は、先にsudo systemctl daemon-reloadを実行しないと、変更が読み込まれません。
ステップ6:動作を確認する
$ systemctl status nginx # active (running) になっているか
$ sudo journalctl -u nginx -n 20 --no-pager # 反映後に、エラーが出ていないか
$ sudo ss -tlnp | grep nginx # 想定したポートで待ち受けているか
$ curl -I http://localhost/ # 実際に応答が返るか
「サービスが起動している」ことと、「正しく動いている」ことは、別です。プロセスの状態、ログ、待ち受けポート、実際の応答の4つを確認して、初めて「反映できた」と判断します。変更した設定値そのものが有効になっているかも、可能な範囲で確かめます。
問題が起きたら:切り戻しの手順
$ sudo cp -p /etc/nginx/nginx.conf.bak_20261114_101500 /etc/nginx/nginx.conf
$ sudo nginx -t
$ sudo systemctl reload nginx
$ systemctl status nginx
反映後に異常が見つかったら、原因をその場で調べ続けるよりも、まず元の設定に戻して、サービスを復旧させることを優先します。戻したあとも、構文チェックと動作確認は、変更のときと同じように行います。原因の調査は、復旧してから、落ち着いて進めます。
切り戻すかどうかの判断基準(どんな状態になったら戻すか、誰が判断するか)は、作業を始める前に決めておきます。
SSHやネットワークの設定を変更するときの注意
sshd_configやファイアウォールの設定を誤ると、サーバーに接続できなくなり、自分では直せなくなることがあります。リモートから変更する場合は、次の2点を守ります。
- 作業中のセッションを切らない:
反映したあと、現在の接続は切らずに、別のターミナルから新しく接続できることを確認します。
新しい接続に失敗しても、残しておいたセッションから、設定を戻せます。 - 別の接続手段を確認しておく:
クラウドのコンソール接続など、SSH以外でサーバーに入る方法があるかを、作業の前に確認しておきます。
よくある質問
バックアップは、いつ削除すればよいですか?
現場のルールに従います。一般的には、変更後の動作が安定していることを一定期間確認してから、整理します。バックアップが増え続けると、どれが必要なものか分からなくなるため、保管の期間を決めておくとよいでしょう。
構文チェックが通れば、安全だと考えてよいですか?
構文チェックで分かるのは、書き方の誤りだけです。設定値が意図どおりかどうか、ほかの設定と矛盾していないかは、検査されません。反映後の動作確認は、必ず行います。
reloadとrestartは、どちらを使えばよいですか?
手順書に指定があれば、それに従います。指定がない場合は、サービスを止めずに済むreloadを優先しますが、変更の内容によっては、restartでなければ反映されないものもあります。
sedで設定を書き換えてもよいですか?
同じ変更を、多数のサーバーへ行う場合などに使われます。その場合も、sed -i.bakでバックアップを残し、diffで差分を確認し、構文チェックを行う、という流れは変わりません。