怎么用Netlify反代

✨ 什么是 Netlify 反向代理？#

Netlify 的 Rewrites / Proxies 功能，本质上是把重定向状态码设为 200。

浏览器地址栏不会变，但请求会由 Netlify 的 CDN 在后端帮你转发到目标地址。
超级适合：

• 解决跨域（CORS）问题
• 隐藏真实 API 地址
• 把多个服务统一到一个域名下
• 网站迁移时平滑过渡

官方文档：Rewrites and proxies

🧁 方法一：使用 _redirects 文件（最简单）#

在网站的发布目录（通常是 public、dist、build 或根目录）下创建 _redirects 文件（注意：没有扩展名）。

1
# 把 /api/* 代理到 https://api.example.com/*
2
/api/*  https://api.example.com/:splat  200
3

4
# 强制代理（即使本地有同名文件也优先代理）
5
/api/*  https://api.example.com/:splat  200!
6

7
# 代理整个网站
8
/*  https://target-site.com/:splat  200

• :splat 会自动捕获后面的所有路径
• 末尾加 ! 表示强制生效（对应 force = true）

🍬 方法二：使用 netlify.toml（推荐，功能更强）#

在项目根目录创建或编辑 netlify.toml：

1
[[redirects]]
2
  from = "/api/*"
3
  to = "https://api.example.com/:splat"
4
  status = 200
5
  force = true
6

7
# 还可以添加自定义请求头哦～
8
[[redirects]]
9
  from = "/search"
10
  to = "https://api.mysearch.com"
11
  status = 200
12
  force = true
13
  headers = {X-From = "Netlify", X-Custom = "value"}

🍓 常见使用场景示例#

1
[[redirects]]
2
  from = "/api/*"
3
  to = "https://api.example.com/:splat"
4
  status = 200
5
  force = true

1
[[redirects]]
2
  from = "/other/*"
3
  to = "https://my-other-site.netlify.app/:splat"
4
  status = 200
5
  force = true

1
/*  https://old-site.com/:splat  200!

📌 小贴士与注意事项#

🌈 更复杂的需求怎么办？#

如果需要：

• 任意 URL 通用代理
• 自动重写 HTML 内容
• 添加密码保护
• 更灵活的逻辑处理

可以尝试使用 Netlify Edge Functions（基于 Deno）。
GitHub 上搜索 netlify proxy edge function 有很多现成模板可以参考～

✅ 快速验证方法#

部署完成后，打开浏览器开发者工具（F12）→ Network 面板：

1. 访问你的域名 + 代理路径
2. 看请求状态码是否为 200
3. 确认返回内容来自目标站点

如果一切正常，就成功啦！🎉

💌 写在最后#

Netlify 的反向代理功能真的很贴心，配置简单、全球 CDN 加速、免费额度也够用。
希望这篇小教程能帮到你～

有具体需求（比如代理某个 AI 接口、整个博客、或者复杂路由）随时告诉我，我可以帮你写出更精确的配置～

祝部署顺利，代码无 Bug！✨