Django「Invalid HTTP_HOST header」の原因と直し方
Invalid HTTP_HOST header は、Host ヘッダが ALLOWED_HOSTS に無いと返る 400 エラーだ。
エラー文の「You may need to add」に出るホスト名を足せば直る。
公開: 更新:
python manage.py runserver 0.0.0.0:8000 CommandError: You must set settings.ALLOWED_HOSTS if DEBUG is False.
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.12Debian 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:80002. 本番用の設定では公開ドメインを列挙する
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" が一致しなくなるので、カンマの前後に空白を置かない。
よくある原因
ALLOWED_HOSTSが空のまま、別の名前でアクセスしている。DEBUG = TrueかつALLOWED_HOSTSが空のとき、Django は['.localhost', '127.0.0.1', '[::1]']だけを許可する。
LAN の IP アドレスや独自ドメインで開くと、この 3 つに一致せず 400 になる。DEBUG = FalseでALLOWED_HOSTSが空になっている。
この組み合わせでは既定の許可リストも無くなる。runserverは起動時点でCommandError: You must set settings.ALLOWED_HOSTS if DEBUG is False.を出して止まる。- プロキシが Host ヘッダを書き換えている。
nginx は既定でproxy_set_header Host $proxy_host;を使い、proxy_passに書いた転送先の名前を Host として送る。
Docker Compose でproxy_pass http://web:8000;としていると、Django にはweb:8000が届く。 - 環境変数を文字列のまま代入している。
ALLOWED_HOSTS = os.environ.get("DJANGO_ALLOWED_HOSTS")のように文字列を入れると、現行の Django はThe ALLOWED_HOSTS setting must be a list or a tuple.で設定の読み込み自体を拒否する。