专用的 IPv4 地址用于入站

将 IPv4 地址附加到您的数据库

Supabase IPv4 插件为您的 Postgres 数据库连接提供专用的 IPv4 地址。可以在插件设置中进行配置。

了解 IP 地址#

互联网协议 (IP) 为互联网上的设备分配地址。主要有两个版本

IPv4：较旧的版本，地址空间有限。
IPv6：较新的版本，提供更大的地址空间，并且是面向未来的选择。

何时需要 IPv4 插件：#

IPv4 地址保证对于入站流量是静态的。如果您的数据库正在建立出站连接，则出站 IP 地址不是静态的，并且无法保证。

在使用 IPv6 不兼容网络的直接连接字符串，而不是 Supavisor 或客户端库时。
当您需要直接连接字符串的专用 IP 地址时

启用 IPv4 插件#

您可以在项目的插件设置中启用 IPv4 插件。

您还可以使用管理 API 管理 IPv4 插件

1
# Get your access token from https://supabase.org.cn/dashboard/account/tokens
2
export SUPABASE_ACCESS_TOKEN="your-access-token"
3
export PROJECT_REF="your-project-ref"
4
5
# Get current IPv4 add-on status
6
curl -X GET "https://api.supabase.com/v1/projects/$PROJECT_REF/billing/addons" \
7
  -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN"
8
9
# Enable IPv4 add-on
10
curl -X POST "https://api.supabase.com/v1/projects/$PROJECT_REF/addons" \
11
  -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN" \
12
  -H "Content-Type: application/json" \
13
  -d '{
14
    "addon_type": "ipv4"
15
  }'
16
17
# Disable IPv4 add-on
18
curl -X DELETE "https://api.supabase.com/v1/projects/$PROJECT_REF/billing/addons/ipv4" \
19
  -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN"

请注意，由于 DNS 重配置和传播，切换插件时直接数据库连接可能会经历短暂的停机时间。通常，这应该少于一分钟。

只读副本和 IPv4 插件#

在使用该插件时，每个数据库（包括只读副本）都会收到一个 IPv4 地址。每个副本都会增加 IPv4 成本。

变更和更新#

虽然 IPv4 地址通常保持不变，但暂停/取消暂停项目或启用/禁用插件等操作可能会导致新的 IPv4 地址。

Supabase 和 IPv6 兼容性#

默认情况下，Supabase Postgres 使用 IPv6 地址。如果您的系统不支持 IPv6，您有以下选项

Supavisor 连接字符串：Supavisor 连接字符串是直接连接的 IPv4 兼容替代方案
Supabase 客户端库：这些库与 IPv4 兼容
专用 IPv4 插件（专业版及以上）：对于直接连接的保证 IPv4 和静态数据库地址，请启用此付费插件。

检查您的网络 IPv6 支持#

您可以在 https://test-ipv6.com 上检查您的个人网络是否兼容 IPv6。

检查平台是否支持 IPv6：#

大多数服务都与 IPv6 兼容。但是，有一些著名的服务仅接受 IPv4 连接

查找您的数据库的 IP 地址#

使用 IP 查找网站或此命令（替换 <PROJECT_REF>）

1
nslookup db.<PROJECT_REF>.supabase.co

识别您的连接#

池化器和直接连接字符串可以在项目连接页面中找到

直接连接#

启用 IPv4 插件前使用 IPv6

1
# Example direct connection string
2
postgresql://postgres:[YOUR-PASSWORD]@db.ajrbwkcuthywfihaarmflo.supabase.co:5432/postgres

Supavisor 在事务模式下（端口 6543）：#

始终使用 IPv4 地址

1
# Example transaction string
2
postgresql://postgres.ajrbwkcuthywddfihrmflo:[YOUR-PASSWORD]@aws-0-us-east-1.pooler.supabase.com:6543/postgres

Supavisor 在会话模式下（端口 5432）：#