Django如何在指定端点禁用HTTP_HOST检查？

针对生产环境中不想将localhost加入ALLOWED_HOSTS的需求，以下是几种可行的解决方案：

方案一：使用127.0.0.1替代localhost并加入ALLOWED_HOSTS #

将Docker Compose的健康检查请求目标改为127.0.0.1，同时将127.0.0.1添加到Django的ALLOWED_HOSTS中。这种方式安全且简单，因为127.0.0.1仅指向容器内部回环地址，外部请求无法使用该主机头访问服务。

修改Docker Compose的健康检查配置：

healthcheck:
  test: ["CMD", "curl", "-f", "http://127.0.0.1:5000/healthcheck/"]
  start_period: 20s
  interval: 15s
  timeout: 10s
  retries: 5

在生产环境的Django配置文件中添加：

ALLOWED_HOSTS += ['127.0.0.1']

方案二：自定义中间件跳过健康检查端点的HOST验证 #

通过自定义Django中间件，针对/healthcheck/路径跳过ALLOWED_HOSTS检查。注意需确保该端点仅能被容器内部访问（比如配合反向代理限制来源）。

创建中间件文件（例如middleware/healthcheck_host.py）：

from django.utils.deprecation import MiddlewareMixin

class HealthCheckHostMiddleware(MiddlewareMixin):
    def process_request(self, request):
        if request.path == '/healthcheck/':
            # 跳过ALLOWED_HOSTS验证，直接设置为合法主机头
            request.META['HTTP_HOST'] = YOUR_PRODUCTION_DOMAIN  # 替换为你的生产域名
        return None

在settings.py的MIDDLEWARE列表中，将该中间件放在django.middleware.common.CommonMiddleware之前：

MIDDLEWARE = [
    'your_app.middleware.healthcheck_host.HealthCheckHostMiddleware',
    'django.middleware.common.CommonMiddleware',
    # 其他中间件...
]

方案三：使用命令行执行健康检查（最优方案） #

完全避免HTTP端点，直接通过Django命令行工具执行健康检查，比如验证数据库连接状态。这种方式无需暴露任何接口，安全性最高。

1. 创建自定义Django命令：
   在应用的management/commands目录下新建healthcheck.py：

from django.core.management.base import BaseCommand
from django.db import connections
from django.db.utils import OperationalError

class Command(BaseCommand):
    help = '执行服务健康检查'

    def handle(self, *args, **options):
        try:
            # 验证默认数据库连接
            with connections['default'].cursor():
                self.stdout.write(self.style.SUCCESS('健康检查通过'))
                return 0
        except OperationalError as e:
            self.stderr.write(self.style.ERROR(f'健康检查失败：数据库连接异常 - {str(e)}'))
            return 1
        except Exception as e:
            self.stderr.write(self.style.ERROR(f'健康检查失败：{str(e)}'))
            return 1

2. 修改Docker Compose的健康检查配置：

healthcheck:
  test: ["CMD", "python", "/app/manage.py", "healthcheck"]
  start_period: 20s
  interval: 15s
  timeout: 10s
  retries: 5

总结 #

• 若需保留HTTP端点，优先选择方案一，配置简单且安全；
• 若严格不想修改ALLOWED_HOSTS，可使用方案二；
• 追求最高安全性和简洁性，推荐方案三，完全避免HTTP接口暴露。

内容的提问来源于stack exchange，提问作者browser-bug