Skip to main content
反向代理配置仅适用于 Custom 方案
要通过自定义反向代理提供文档服务,你需要配置路由规则、缓存策略和请求头转发。 实施反向代理时,请留意可能出现的 domain 验证、SSL 证书签发、认证流程、性能以及 Analytics 跟踪等问题。

路由配置

按以下缓存策略将这些路径代理到你的 Mintlify 子域:

必需的请求头配置

按以下请求头要求配置你的反向代理:
  • Origin:包含目标子域 <your-subdomain>.mintlify.app
  • X-Forwarded-For:保留客户端 IP 信息
  • X-Forwarded-Proto:保留原始协议(HTTP/HTTPS)
  • X-Real-IP:转发真实的客户端 IP 地址
  • User-Agent:转发用户代理
确保不要转发 Host 请求头

Nginx 配置示例

疑难解答

404 错误

现象:文档可以加载,但部分功能不可用。API 调用失败。 原因:转发了 Host 头,或缺少 Origin 头。 解决方案
  • 停止转发 Host
  • Origin 头设置为 <your-subdomain>.mintlify.app

性能问题

表现:页面加载缓慢,出现布局位移。 原因:缓存配置不正确。 解决方案:仅对 /mintlify-assets/_next/static/* 路径启用缓存。