不能只用Uvicorn直接监听80/443端口,因其不支持SSL/TLS终止、静态文件服务、防攻击、HTTP/2及安全连接管理,且绑定特权端口需root权限,违背最小权限原则;必须由Nginx前置代理并正确配置HTTPS与WebSocket透传。

直接暴露 FastAPI 的 uvicorn 进程到公网是危险的,Nginx 不只是“转发一下”,它承担了 HTTPS 终止、请求过滤、静态文件服务和连接管理等关键职责。必须用 Nginx 做反向代理,并配好 HTTPS,否则生产环境等于裸奔。
为什么不能只用 uvicorn 直接监听 0.0.0.0:80 或 443
Uvicorn 是 ASGI 服务器,不是全功能 Web 服务器。它不处理 SSL/TLS 握手、不缓存静态资源、不防慢速攻击、不支持 HTTP/2(原生)、也没有健壮的连接复用机制。Linux 下绑定 1–1023 端口还需 root 权限,而让 uvicorn 以 root 运行又违背最小权限原则。所以必须用 Nginx 做前置 —— 它监听 80/443,再把解密后的 HTTP 流量转给本地的 uvicorn(比如 127.0.0.1:8000)。
Nginx 配置中 proxy_pass 后面要不要加斜杠
这是最容易出错的地方,直接影响后端路由是否能匹配:
- 如果写
proxy_pass http://127.0.0.1:8000;(末尾无/),Nginx 会把原始路径完整传递,例如请求/api/users→ 后端收到/api/users;此时 FastAPI 必须挂载在根路径,或你自己处理/api前缀(如app = FastAPI(prefix="/api")) - 如果写
proxy_pass http://127.0.0.1:8000/;(末尾有/),Nginx 会剥离 location 匹配部分:比如location /api { ... }+proxy_pass http://.../;,那么/api/users会被重写为/users发往后端 —— 此时 FastAPI 应该部署在根路径(app = FastAPI()),且不带 prefix - 常见错误:前端调
/api/login,Nginx 配了location /api { proxy_pass http://127.0.0.1:8000; },但 FastAPI 没设prefix="/api",结果后端收不到路由,返回 404
HTTPS 配置必须包含的三个关键项
只加 ssl_certificate 和 ssl_certificate_key 不够,缺一不可:
-
listen 443 ssl;:明确启用 SSL,不能只写listen 443; -
ssl_protocols TLSv1.2 TLSv1.3;:禁用已不安全的 TLSv1.0/1.1;Nginx 1.19+ 默认已不启用它们,但显式声明更稳妥 -
proxy_set_header X-Forwarded-Proto $scheme;:让 FastAPI 知道原始请求是https,否则request.url可能生成http://开头的链接,OAuth 回调、密码重置邮件里的 URL 就会失效 - 额外建议:加上
ssl_ciphers限制加密套件(避免弱算法),并确保server_name和证书域名完全一致(包括 www 前缀)
WebSocket 支持要额外加两行配置
FastAPI 的 WebSocket 路由(如 @app.websocket("/ws"))在 Nginx 下默认不通,因为 HTTP 升级协议需要显式透传:
- 必须在
location块里加:proxy_http_version 1.1; - 必须加:
proxy_set_header Upgrade $http_upgrade;和proxy_set_header Connection "upgrade"; - 漏掉任意一行,WebSocket 握手会卡在 101 Switching Protocols,实际返回 502 或直接断连
- 如果 FastAPI 同时提供 REST API 和 WebSocket,建议把 WebSocket 路由单独配一个
location /ws块,避免影响其他规则
最常被忽略的是 X-Forwarded-Proto 和 WebSocket 的 Upgrade 头 —— 它们不报错,但会让功能“看似正常实则失效”:比如登录跳转回 HTTP、实时消息永远连不上。检查时别只看状态码,要用浏览器 DevTools 的 Network 标签页确认实际协议和响应头。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











