Hypercorn server_names配置求助：无法实现仅本机访问API（经代理）

问题核心 #

你混淆了server_names配置项的作用——它不是用来限制客户端IP来源的，而是用来匹配请求中的Host请求头的。这就是你配置后返回404的根本原因：请求经过代理后，Host头可能被代理修改，无法匹配你设置的192.168.1.1或机器名，导致Hypercorn拒绝处理请求。

正确实现方案 #

根据你的代理场景（本机→代理→API），推荐以下两种方式：

方式1：绑定到本地回环地址（最简单） #

修改Hypercorn的bind配置，只绑定到本机回环地址，这样只有本机（包括本机代理）能访问API，其他机器无法连接：

# Hypercorn配置文件示例
bind = ["127.0.0.1:8000"]
# 或者用localhost
# bind = ["localhost:8000"]

这种方式下，API只监听本机内部的请求，外部机器甚至无法建立连接，完全符合你的需求。

方式2：用FastAPI中间件限制客户端IP（适合需要绑定局域网IP的场景） #

如果必须让Hypercorn绑定到局域网IP（比如192.168.1.1:8000），可以通过FastAPI中间件检查真实客户端IP（注意代理会修改请求的源IP，需要从X-Forwarded-For头获取）：

from fastapi import FastAPI, Request, HTTPException

app = FastAPI()

# 允许访问的本机IP（根据实际情况修改）
ALLOWED_IPS = {"192.168.1.1", "127.0.0.1"}

@app.middleware("http")
async def restrict_ip(request: Request, call_next):
    # 从代理头获取真实客户端IP
    client_ip = request.headers.get("X-Forwarded-For", "").split(",")[0].strip()
    # 如果没有代理头，直接取客户端IP
    if not client_ip:
        client_ip = request.client.host
    
    if client_ip not in ALLOWED_IPS:
        raise HTTPException(status_code=404, detail="Not Found")
    
    response = await call_next(request)
    return response

这种方式会对所有请求做IP校验，非允许IP直接返回404。

为什么之前的配置失败？ #

当请求经过代理时，代理会向Hypercorn发送请求，此时：

• 请求的源IP是代理的IP，不是你的电脑IP
• Host头通常被代理设置为API的绑定地址（比如192.168.1.1:8000），而不是你电脑的机器名
  所以你设置的server_names无法匹配，Hypercorn会拒绝处理该请求，返回404。

内容的提问来源于stack exchange，提问作者Carlos