設定ファイルを安全に変更する手順|バックアップ・構文チェック・切り戻し

設定ファイルの変更は、「バックアップ → 変更 → 差分の確認 → 構文チェック → 反映 → 動作確認」の順に進めます。なかでも、反映の前に行う構文チェックと、すぐに元へ戻せるバックアップの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

多くのサービスには、設定ファイルの書き方に誤りがないかを、反映の前に検査するコマンドが用意されています。構文に誤りがある状態でサービスを再起動すると、サービスが起動できず、停止したままになります。構文チェックでエラーが出たら、反映には進まず、設定を直します。

サービス・設定構文チェックのコマンド
nginxsudo nginx -t
Apachesudo apachectl configtest
SSH(sshd)sudo sshd -t
BINDsudo named-checkconf・sudo named-checkzone ゾーン名 ファイル
Postfixsudo postfix check
sudoerssudo visudo -c
/etc/fstabsudo 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で差分を確認し、構文チェックを行う、という流れは変わりません。

この記事を書いた人:
こすけ(コマンド学習道場 運営者)。
AWSの運用保守に携わるエンジニアで、保有資格はCCNA・AWS-SAA・LPIC-3(305)。
詳しくは運営者情報をご覧ください。

← 現場ガイドの一覧へ戻る