Apifox接口文档自定义域名怎么配置？发布设置详解-git-PHP中文网

apifox接口文档走自定义域名必须用「自有服务器中转」模式，因cname方式下apifox cdn强制校验host头与项目绑定关系，导致403错误；需nginx反向代理配置proxy_pass、proxy_set_header host和x-apifox-project-id三项联动，并在apifox后台设置为中转模式、填正确域名及公开权限。

apifox接口文档自定义域名怎么配置？发布设置详解

Apifox 接口文档要走自定义域名，必须用「自有服务器中转」模式，CNAME 方式不支持公开文档发布（会 403）。 直接填域名、点保存是没用的，关键在 Nginx 反向代理配置和 Apifox 后台两个地方联动生效。

为什么 CNAME 不行？

Apifox 公开文档的 CDN 节点强制校验 Host 头和项目绑定关系。CNAME 解析过去后，请求实际发到 Apifox 的 CDN 域名（如 5491021.n3.apifox.cn），但浏览器或客户端带的是你的域名（如 docs.example.com），Apifox 服务端会拒绝响应，返回 403 Forbidden。

只有「自有服务器中转」模式允许你用自己的 Nginx 接收请求，再以指定 Host 和 X-Apifox-Project-ID 头转发，才能绕过校验。

Nginx 反向代理必须配对的三项

以下配置缺一不可，顺序和大小写都影响生效：

Apifox(接口调试工具)

Apifox是一款拥有可视化管理界面的接口开发调试工具，支持接口调试，自动校验数据结构，自动化测试等功能，能够帮助用户更好的测试API，能够有效提高团队的办公效率，有需要的用户欢迎下载使用！功能介绍可视化接口管理方便快捷可视化接口管理，成倍提升团队多人协作效率。支持数据结构（JSON Schema）管理，多接口可复用相同数据结构。接口调试Postman 有的功能，比如环境变量、预执行脚本、后执行脚本、Cookie/Session 全局共享等功能，Apifox 都有，并且和 Postman 一样高效好用。

下载

proxy_pass 必须指向 Apifox 提供的专属文档域名（形如 http://xxx.n3.apifox.cn），不是官网地址
proxy_set_header Host 必须设为你自己的自定义域名（如 docs.example.com），不能省略或写错
proxy_set_header X-Apifox-Project-ID 必须填你在 Apifox 后台「自定义域名」设置页看到的完整 ID（如 6576754），不是项目 ID 或分享 ID

示例片段（注意 listen 和 server_name 匹配你的域名）：

server {
    listen 80;
    server_name docs.example.com;
    location / {
        proxy_pass http://5491021.n3.apifox.cn;
        proxy_set_header Host docs.example.com;
        proxy_set_header X-Apifox-Project-ID 6576754;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Apifox 后台「自定义域名」设置关键点

这个页面不只是填个域名那么简单，它决定了 Nginx 转发时需要携带的认证头：

「解析方式」必须选「自有服务器中转」，别选 CNAME
「自定义域名」栏填你最终要访问的完整域名（如 docs.example.com），不要带 http://
保存后页面会显示 X-Apifox-Project-ID 值——这就是上一步 Nginx 配置里要用的那个数字，每次新建分享都会变
「文档权限」必须设为「公开发布」，否则即使域名通了也会跳登录页

HTTPS 怎么加？

Apifox 自有证书只支持 CNAME 模式，所以走自有服务器中转时，SSL 必须由你自己的 Nginx 终止：

用 Certbot 或其他工具申请并部署证书到 Nginx
把 listen 80 改成 listen 443 ssl，加上 ssl_certificate 和 ssl_certificate_key 指向你的 PEM 文件
建议加一个 listen 80 的 server 块，301 跳转到 HTTPS
别在 Apifox 后台勾选「自动 HTTPS」——它对中转模式无效

真正容易被忽略的，是 X-Apifox-Project-ID 这个头：它不是静态值，每次重新生成分享链接或修改发布设置都会刷新；只要文档重发布，Nginx 配置就得同步更新，否则 404 或 403。