文档中心

AI 原生 BaaS 平台 Supabase 版

使用 Supabase 控制台

配置 Custom Routes

Custom Routes 用于为当前 Workspace / Branch 配置自定义公网路径，并将请求转发到同一分支内的 public Storage object 或 Edge Function。对于需要在域名根路径下访问校验文件的场景，例如微信开放平台授权回调域名校验、小程序域名校验等，您可以先将校验文件上传到 public Storage bucket，再通过 Custom Route 将平台要求的文件路径转发到该文件。

使用限制

仅支持将自定义路径转发到同一 Branch 内的 public Storage object 或 Edge Function。

不支持转发到任意外部 URL、IP、localhost 或内网地址。

不支持跨 Workspace、跨实例或跨 Branch 转发。

不支持 Static response，不在 Custom Route 中保存文件正文。

如果目标是 Storage object，请确认对应 Bucket 为 public，且文件路径与平台要求的校验路径一致。

前提条件

已创建使用 Supabase 引擎的 Workspace，且该 Workspace 处于运行中状态。详细操作请参见创建 Workspace。

已成功登录到目标 Workspace 对应的 Supabase 控制台。详细操作请参见登录 Supabase 控制台。

如需将路由转发到 Storage object，则需要先创建 public Bucket，并已上传目标文件。

如需将路由转发到 Edge Function，则需要先创建并部署目标 Edge Function。

操作步骤

在 Supabase 控制台左侧导航栏单击 Project Settings，进入 Settings 页面。

在 Settings 页面，完成以下配置后，单击 + Add route。

配置项			说明
Name			自定义路由的名称，用于在 Custom Routes 路由列表中识别和管理该路由。建议填写能体现用途的名称，例如 site-verification。
Paths			自定义公网路径，必须以 / 开头。该路径是第三方平台访问校验文件时请求的路径，必须与第三方平台要求访问的公网路径一致，例如校验文件名为 .well-known/verify.txt 时，可配置路径为 /.well-known/verify.txt。微信开放平台或小程序校验时，填写平台指定名称和目录的校验文件路径。
Target			目标类型。可选值为 Storage 和 Edge Functions。选择 Storage 时将请求转发到同一分支内的 public Storage object。选择 Edge Functions 时将请求转发到指定 Edge Function。
Methods			允许访问该路由的 HTTP Method，例如 GET。用于限制可访问该路由的请求方法；域名归属校验文件通常只需使用 GET。
Storage path	Bucket	仅当 Target 为 Storage 时展示。通过下拉框选择当前 Branch 内的公开（public）bucket。如果当前没有公开 bucket，界面会提示 No public buckets available.，此时需要先创建 public bucket 并上传校验文件后再配置路由。
		文件路径	选择 Bucket 后，通过路径浏览器在 bucket 内选择校验文件，界面以 ↑ / 形式展示 bucket 根目录。
Resolved path			只读字段。系统根据所选 bucket 和文件自动生成的实际解析路径，例如 /object/public/bucket/file.txt，用于确认转发目标是否正确。
Enabled			路由启用开关，默认开启。开启后路由才会生效；关闭后路由配置保留，但不再转发请求。
Require JWT auth			是否要求请求携带 JWT 鉴权，默认关闭。域名归属校验文件需要被第三方平台匿名访问，配置校验路由时应保持关闭。
Path passthrough			是否将请求路径原样透传给目标资源，默认关闭。请根据目标类型和实际资源路径选择。

说明

在 Settings 页面顶部只读展示当前 Branch 的访问域名，例如 https://br-zappy-puma-bea2****.supabase.aidap-global.cn-beijing.volces.com，可单击复制；自定义路径在该域名下生效。

最佳实践：验证域名归属

当第三方平台要求您在授权回调域名根目录下放置校验文件时，可以通过 Custom Routes 完成校验。以下以微信开放平台的授权回调域名校验为例。

在第三方平台获取校验文件名称和文件内容。例如微信开放平台可能要求在域名根目录放置指定名称的 txt 文件。

在 Supabase Storage 中创建或选择 public Bucket，并上传该校验文件。

创建 Custom Route，将第三方平台要求访问的根路径文件名映射到该 Storage object。例如将 /MP_verify_xxx.txt 转发到 public Bucket 中的 MP_verify_xxx.txt。

关闭该路由的 JWT 鉴权，确保第三方平台可以直接访问校验文件。

访问 https:// 您的授权回调域名 /MP_verify_xxx.txt，确认返回内容与第三方平台提供的校验文件内容一致。

返回第三方平台完成域名归属验证。

如果校验失败，请检查 Custom Route 是否已同步完成、Storage Bucket 是否为 public、文件路径是否与第三方平台要求完全一致，以及该路由是否关闭 JWT 鉴权。