nginxの設定ファイルの場所と書き方|nginx.conf・conf.d・sites-availableの違い

  • nginx の設定ファイルがどこにあるのか分からない
  • nginx.conf・conf.d・sites-available のどこに書けばいいのか迷う
  • location の書き方と、変更を安全に反映する手順を知りたい

nginx の設定ファイルは、入れ方によって置き場所が変わります。

この記事では、apt で入れた場合と Docker の公式イメージの場合に分けて、設定ファイルの場所を整理します。

後半では、server と location の基本の書き方と、nginx -t で確かめてから反映する手順を紹介します。

VPS を借りてサイトを公開するまでの全体の流れは、こちらにまとめています。

設定ファイルの場所は nginx -t で確かめられる

どこに設定ファイルがあるか迷ったら、まず nginx -t を実行します。今の nginx が読んでいる nginx.conf のパスが表示されます。

ShellScript
sudo nginx -t

うまくいくと、次のように表示されます。

Plaintext
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

ここに出ている /etc/nginx/nginx.conf が、すべての設定の出発点になるファイルです。

読み込まれている設定をすべて表示する(nginx -T)

大文字の -T を付けると、文法のチェックに加えて、読み込まれている設定をすべて表示します。

ShellScript
sudo nginx -T | less

ファイルごとに「# configuration file /etc/nginx/conf.d/default.conf:」のような行が付きます。

どのファイルが実際に読まれているかを、ここで確かめられます。

Docker の場合はコンテナの中で実行する

nginx を Docker で動かしている場合は、コンテナの中で同じコマンドを実行します。

ShellScript
# compose.yaml のサービス名が nginx の場合
docker compose exec nginx nginx -t

# コンテナ名で指定する場合
docker exec <コンテナ名> nginx -t

apt 版と Docker 公式イメージでの場所の違い

nginx.conf の場所は同じですが、サイトごとの設定を置く場所と、公開するファイル・ログの場所が違います。

項目apt(Ubuntu)Docker 公式イメージ
全体の設定/etc/nginx/nginx.conf/etc/nginx/nginx.conf
サイトの設定/etc/nginx/sites-available/
/etc/nginx/sites-enabled/
/etc/nginx/conf.d/
最初からある設定sites-available/defaultconf.d/default.conf
公開するファイル/var/www/html/usr/share/nginx/html
ログ/var/log/nginx/標準出力・標準エラー
(docker logs で見る)
nginx の主なファイルの場所

apt 版の列は、Ubuntu の標準パッケージ(apt install nginx)で入れた場合です。

Ubuntu の nginx.conf は、conf.d と sites-enabled の両方を読み込みます。

nginx の公式リポジトリから入れた場合は、Docker と同じく conf.d を使う形になります。

Docker 公式イメージのログは、ファイルではなく標準出力・標準エラーに出す作りです。そのため docker logs で見ます。

ShellScript
docker compose logs nginx

僕の環境:nginx.conf を1つだけマウントしている

僕は nginx を Docker の公式イメージ(alpine 版)で動かしています。サーバーに apt では入れていません。

設定は conf.d を使わず、nginx.conf を1つだけ用意しています。それをコンテナの /etc/nginx/nginx.conf に重ねる形です。

YAML
services:
  nginx:
    image: nginx:1.30-alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      # 手元の nginx.conf でイメージの nginx.conf を置き換える
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./site:/var/www/site:ro

この形で気をつけたい点が2つあります。

nginx.conf を丸ごと置き換えるときの注意
  1. イメージの nginx.conf にある include mime.types; を、自分でも書く
  2. ファイル1つのマウントでは、reload ではなくコンテナの再起動で反映する

1つ目は mime.types です。僕は最初これを書いていなかったため、CSS が text/plain で返り、ブラウザに適用されませんでした。

2つ目は、ファイル1つだけをマウントしたときの癖です。git pull などでファイルが置き換わると、コンテナは古い中身を見たままになることがあります。

そのため僕は、設定を変えたら docker compose restart nginx で反映しています。再起動の数秒だけ、つながらない時間があります。

nginx.conf・conf.d・sites-available の違い

nginx.conf が親で、conf.d と sites-enabled はそこから読み込まれる子です。

どこに書いても、最後は1つの設定としてまとめて読まれます。

Ubuntu の nginx.conf の http ブロックには、次の行があります。

Nginx
http {
    include /etc/nginx/mime.types;
    # (中略)
    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-enabled/*;
}

4行目で conf.d の .conf ファイルを、5行目で sites-enabled のファイルを読み込んでいます。

Docker 公式イメージの nginx.conf には、5行目がありません。

nginx.conf:全体の設定を書く

ワーカーの数やログの形式など、nginx 全体に関わる設定を書くファイルです。

サイトごとの設定は、ここに直接書かずに conf.d や sites-available に分けるのが一般的です。ただ、僕のように1つにまとめても動きます。

conf.d:.conf で終わるファイルが読まれる

conf.d に置いたファイルのうち、名前が .conf で終わるものだけが読み込まれます。

一時的に無効にしたいときは、名前を example.conf.off のように変えます。これで読まれなくなります。

sites-available と sites-enabled:リンクで有効・無効を切り替える

Ubuntu や Debian の nginx で使う形です。

設定の本体は sites-available に置き、使うものだけ sites-enabled にリンクを張ります。

ShellScript
# 有効にする(sites-enabled にリンクを張る)
sudo ln -s /etc/nginx/sites-available/example /etc/nginx/sites-enabled/

# 無効にする(本体は sites-available に残る)
sudo rm /etc/nginx/sites-enabled/example

sites-enabled は、拡張子に関係なく中のファイルを全部読み込みます。

そのため、sites-enabled に example.bak のような控えを置くと、それも読まれます。控えは sites-enabled の外に置いてください。

conf.d と sites-available のどちらを使うか迷ったら、すでにある設定と同じ場所にそろえるとよいと思います。

server と location の基本の書き方

server ブロックは「どのドメイン・ポートへの通信か」、location は「どの URL のときに何をするか」を決めます。

静的なファイルを配信する、いちばん小さな例です。

Nginx
server {
    listen 80;
    server_name example.com;

    root /var/www/site;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

2行目の listen は待ち受けるポート、3行目の server_name はドメイン名です。

届いた通信のドメインと server_name が合う server ブロックが使われます。

5行目の root が、公開するファイルを置くフォルダです。9行目の try_files は、ファイル→フォルダの順に探し、なければ 404 を返します。

ここでは、example.com の通信を /var/www/site のファイルで返しているというわけです。

アプリへ転送する(リバースプロキシ)

Django などのアプリを動かす場合は、location の中に proxy_pass を書いて、アプリへ通信を渡します。

Nginx
location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

2行目が転送先です。3〜6行目は、元のドメインやアクセス元の IP をアプリへ伝えるための設定です。

nginx もアプリも Docker で動かしている場合は、127.0.0.1 の代わりにサービス名を書きます(http://app:8000 など)。

Gunicorn で Django を動かして nginx から転送する手順は、こちらです。

location の書き方と選ばれる順番

location は、URL の一致の仕方を記号で指定します。

書き方意味例
= /path完全に一致location = /favicon.ico
^~ /path/前方一致(一致したら正規表現を見ない)location ^~ /.well-known/acme-challenge/
~ 正規表現正規表現(大文字・小文字を区別)location ~ \.php$
~* 正規表現正規表現(区別しない)location ~* \.(png|jpg)$
/path/前方一致location /api/
location の主な書き方

1つの URL に複数の location が当てはまるときは、次の順で1つが選ばれます。

location が選ばれる順番
  1. = の完全一致があれば、それを使う
  2. 前方一致のうち、いちばん長く一致したものを覚えておく。それが ^~ なら、それを使う
  3. 正規表現を上から順に調べ、最初に一致したものを使う
  4. どの正規表現にも一致しなければ、2で覚えた前方一致を使う

書いた順番が効くのは、正規表現どうしだけです。前方一致は、書いた順番に関係なく長く一致した方が選ばれます。

僕の設定でも、証明書の発行に使う /.well-known/acme-challenge/ は ^~ で書いています。

^~ にしておくと、正規表現の location に横取りされません。

設定を変えたら nginx -t で確かめてから reload する

設定を変えたら、先に nginx -t で文法を確かめ、通ってから reload します。

reload は、新しい設定に誤りがあれば、古い設定のまま動き続けます。一方で restart は一度止めるので、誤りがあると起動できず、サイトが止まります。

apt で入れた nginx の場合です。

ShellScript
# 文法を確かめる
sudo nginx -t

# 問題がなければ設定を読み直す
sudo systemctl reload nginx

Docker の場合は、コンテナの中で同じことをします。

ShellScript
docker compose exec nginx nginx -t
docker compose exec nginx nginx -s reload

nginx.conf を1つだけマウントしている場合は、上で書いたとおり reload ではなく再起動で反映します。

nginx -t のエラーの読み方

誤りがあると、ファイル名と行番号が表示されます。たとえば、行末の ; を付け忘れると次のようになります。

Plaintext
nginx: [emerg] unexpected "}" in /etc/nginx/conf.d/default.conf:12
nginx: configuration file /etc/nginx/nginx.conf test failed

表示された行そのものではなく、その少し上の行に原因があることが多いです。; の付け忘れや、{ } の数が合っているかを見ます。

括弧のずれを見つけやすくするには、VSCode で nginx.conf を自動整形しておくと楽です。

よくある質問

nginx.conf がどこにあるか分からないときは?

nginx -t を実行すると、読み込んでいる nginx.conf のパスが表示されます。

nginx -V の出力にある –conf-path でも確かめられます。

conf.d と sites-enabled の両方に同じドメインを書くとどうなりますか?

同じポートと server_name の server ブロックが2つになり、「conflicting server name」と警告が出ます。

このとき使われるのは、先に読み込まれた方だけです。どちらか一方に寄せてください。

最初からある default の設定は消してもいいですか?

自分の server ブロックで置き換えるなら、消しても問題ありません。

残しておくと、ほかの server に当てはまらない通信に、nginx の初期ページを返すことがあります。

まとめ:場所を確かめてから書き、nginx -t を通して反映する

nginx の設定は、場所を確かめてから server と location を書き、nginx -t を通して反映すれば安全に変えられます。

nginx そのものの基本から知りたい場合は、こちらの入門記事をどうぞ。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

普段は主にPython開発をしています。
最近はAI駆動開発にも関わっています。