できない.dev

Django「Invalid HTTP_HOST header」の原因と直し方

Invalid HTTP_HOST header は、Host ヘッダが ALLOWED_HOSTS に無いと返る 400 エラーだ。
エラー文の「You may need to add」に出るホスト名を足せば直る。

公開: 更新:

症状できない · exit 1
python manage.py runserver 0.0.0.0:8000
CommandError: You must set settings.ALLOWED_HOSTS if DEBUG is False.
解決後できた · exit 0
DJANGO_ALLOWED_HOSTS=example.com,www.example.com python manage.py check
System check identified no issues (0 silenced).

2026-10-23 に python:3.12(Django 5.2.18) で実際に打って取った出力。検証環境の詳細

要約

Django はリクエストの Host ヘッダを ALLOWED_HOSTS と照合し、一致しなければ DisallowedHost を送出して 400 Bad Request を返す。
ログには次のような行が出る。

django.core.exceptions.DisallowedHost: Invalid HTTP_HOST header: '192.168.1.10:8000'. You may need to add '192.168.1.10' to ALLOWED_HOSTS.

エラー文の後半「You may need to add」に書かれた名前が、そのまま ALLOWED_HOSTS に足すべき値だ。
照合はポートを含まないので、:8000 は書かなくてよい。

実行例

python:3.12 のコンテナに Django 5.2.18 を入れて、新規プロジェクトの ALLOWED_HOSTS を変えながら試した。
DEBUG = False で空のままだと、runserver が CommandError で終了コード 1 になった。
DEBUG = True で空のまま Host: 192.168.1.10:8000 を付けて開くと、400 と DisallowedHost のログが出た。
エラー文のホスト名を足すと、同じリクエストが 200 になった。
環境変数を文字列のまま代入した設定は、split(",") でリストにすると通った。
トレースバックは最終行だけを載せている。

$ grep -n -e DEBUG -e ALLOWED_HOSTS mysite/settings.py
26:DEBUG = False
28:ALLOWED_HOSTS = []
$ python manage.py runserver 0.0.0.0:8000
CommandError: You must set settings.ALLOWED_HOSTS if DEBUG is False.
$ echo $?
1
$ curl -s -o /dev/null -w '%{http_code}\n' -H "Host: 192.168.1.10:8000" http://127.0.0.1:8000/
400
$ grep -a -E "Invalid HTTP_HOST|Bad Request" server.log
Invalid HTTP_HOST header: '192.168.1.10:8000'. You may need to add '192.168.1.10' to ALLOWED_HOSTS.
django.core.exceptions.DisallowedHost: Invalid HTTP_HOST header: '192.168.1.10:8000'. You may need to add '192.168.1.10' to ALLOWED_HOSTS.
$ grep -n ALLOWED_HOSTS mysite/settings.py
28:ALLOWED_HOSTS = ["localhost", "127.0.0.1", "192.168.1.10"]
$ curl -s -o /dev/null -w '%{http_code}\n' -H "Host: 192.168.1.10:8000" http://127.0.0.1:8000/
200
$ grep -n ALLOWED_HOSTS mysite/settings.py
29:ALLOWED_HOSTS = os.environ.get("DJANGO_ALLOWED_HOSTS")
$ DJANGO_ALLOWED_HOSTS=example.com,www.example.com python manage.py check
django.core.exceptions.ImproperlyConfigured: The ALLOWED_HOSTS setting must be a list or a tuple.
$ echo $?
1
$ grep -n ALLOWED_HOSTS mysite/settings.py
29:ALLOWED_HOSTS = os.environ.get("DJANGO_ALLOWED_HOSTS", "localhost").split(",")
$ DJANGO_ALLOWED_HOSTS=example.com,www.example.com python manage.py check
System check identified no issues (0 silenced).
$ echo $?
0

— 2026-10-23 時点の出力

検証環境Python 3.12.15 / Git 2.47.3 / Django 5.2.18 / 2026-10-23 検証
検証日
実行環境
python:3.12 Debian GNU/Linux 13 (trixie)
バージョン
  • Python 3.12.15
  • Git 2.47.3
  • Django 5.2.18

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. エラー文のホスト名を追加する

settings.py の ALLOWED_HOSTS にリストで書く。

# settings.py
ALLOWED_HOSTS = ["localhost", "127.0.0.1", "192.168.1.10"]

サブドメインをまとめて許可したいときは、先頭にドットを付けた ".example.com" と書く。
これで example.com と www.example.com の両方に一致する。
"*" はすべてを許可するが、その場合は Host ヘッダの検証を自前で行う責任があると公式ドキュメントが明記しているので、回避策として使わない。

LAN の別端末から開発サーバに接続するなら、待ち受けアドレスも変える。
runserver の既定は 127.0.0.1:8000 で、他の端末からは届かない。

python manage.py runserver 0.0.0.0:8000

2. 本番用の設定では公開ドメインを列挙する

DEBUG = False にした環境では、公開するドメインを漏れなく書く。

DEBUG = False
ALLOWED_HOSTS = ["example.com", "www.example.com"]

3. プロキシで元の Host を渡す

nginx では proxy_set_header で、ブラウザが送った Host をそのまま転送する。

location / {
    proxy_pass http://web:8000;
    proxy_set_header Host $host;
}

これで Django に届く Host が公開ドメインになり、ALLOWED_HOSTS にコンテナ名を足す必要がなくなる。

4. 環境変数はリストに変換してから代入する

環境ごとに値を変えるなら、カンマ区切りの文字列を受けて分割する。

import os
 
ALLOWED_HOSTS = os.environ.get("DJANGO_ALLOWED_HOSTS", "localhost").split(",")

DJANGO_ALLOWED_HOSTS=example.com,www.example.com を渡せばリストになる。
example.com, www.example.com のように空白を入れると " www.example.com" が一致しなくなるので、カンマの前後に空白を置かない。

よくある原因

  1. ALLOWED_HOSTS が空のまま、別の名前でアクセスしている。
    DEBUG = True かつ ALLOWED_HOSTS が空のとき、Django は ['.localhost', '127.0.0.1', '[::1]'] だけを許可する。
    LAN の IP アドレスや独自ドメインで開くと、この 3 つに一致せず 400 になる。
  2. DEBUG = False で ALLOWED_HOSTS が空になっている。
    この組み合わせでは既定の許可リストも無くなる。
    runserver は起動時点で CommandError: You must set settings.ALLOWED_HOSTS if DEBUG is False. を出して止まる。
  3. プロキシが Host ヘッダを書き換えている。
    nginx は既定で proxy_set_header Host $proxy_host; を使い、proxy_pass に書いた転送先の名前を Host として送る。
    Docker Compose で proxy_pass http://web:8000; としていると、Django には web:8000 が届く。
  4. 環境変数を文字列のまま代入している。
    ALLOWED_HOSTS = os.environ.get("DJANGO_ALLOWED_HOSTS") のように文字列を入れると、現行の Django は The ALLOWED_HOSTS setting must be a list or a tuple. で設定の読み込み自体を拒否する。