FastAPI+Docker环境下如何修改url_for生成的Base URL？

问题原因 #

Docker容器内运行的FastAPI服务默认基于容器内的127.0.0.1生成URL，当部署到公网时，若未配置正确的基础地址参数，url_for会输出无法被公网访问的http://127.0.0.1/styles.css这类地址。

可行解决方案 #

1. 设置FastAPI的root_path参数 #

如果你的服务通过反向代理（如Nginx）部署，或公网访问有固定前缀，可在启动服务时指定root_path，FastAPI会自动用该前缀生成正确的URL，同时会信任请求中的Host头来替换127.0.0.1。

• 方式一：启动Uvicorn时指定

uvicorn main:app --host 0.0.0.0 --port 8000 --root-path "/your-app-prefix"

• 方式二：实例化FastAPI时设置

from fastapi import FastAPI

# 若公网访问地址为https://example.com/your-app，root_path设为"/your-app"
app = FastAPI(root_path="/your-app")

2. 自定义中间件强制替换Base URL #

如果需要固定公网域名，可编写中间件直接修改请求的base_url属性，让url_for基于指定的公网地址生成链接：

from fastapi import Request
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.datastructures import URL

class BaseURLMiddleware(BaseHTTPMiddleware):
    def __init__(self, app, public_domain: str):
        super().__init__(app)
        self.public_url = URL(public_domain)

    async def dispatch(self, request: Request, call_next):
        # 替换请求的base_url为指定的公网域名
        request.base_url = self.public_url
        response = await call_next(request)
        return response

# 注册中间件，替换为你的公网域名
app.add_middleware(BaseURLMiddleware, public_domain="https://your-public-domain.com")

3. 直接使用静态文件绝对URL #

若域名固定且无需动态生成，可跳过url_for，直接在模板中写入静态文件的公网绝对路径：

<link href="https://your-public-domain.com/static/styles.css" rel="stylesheet">

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