PostgreSQL 连接
PostgreSQL 创建完成后，在应用详情页 概览 的 连接信息 中可以获取连接方式。
所有字段默认隐藏，点击眼睛图标显示，点击复制图标复制。
| 字段 | 说明 |
|---|---|
| 用户名 / 密码 | 数据库账号 |
| 内网链接信息 | 同一项目内的应用使用，格式 postgresql://用户名:密码@内网地址:端口 |
| 外网访问 | 开关。开启后才能从项目外部（本地电脑、其他云）连接 |
| 外网链接信息 | 外网连接串，带 ?sslmode=require |
| PSQL Command | 可直接复制执行的 psql 命令 |
| IP 白名单 | 允许外网连接的来源 IP |
右上角 编辑 可以修改数据库组件的资源规格。
从应用内网连接（推荐）
同一项目中的 Web 应用请使用 内网链接信息：速度更快，不经过公网，也不需要开启外网访问。
建议把连接串保存为 密钥，不要写在代码仓库里。例如在 Node.js 中：
import pg from 'pg';
const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
const { rows } = await pool.query('select now()');从外网连接
- 在 连接信息 中打开 外网访问 开关。
- 建议先编辑 IP 白名单，只允许你的出口 IP 访问。
- 复制 外网链接信息 或 PSQL Command 连接。
important
外网连接必须使用 TLS，请保留连接串中的 sslmode=require 参数，否则连接会被拒绝。
psql 命令格式：
PGPASSWORD=<密码> PGSSLMODE=require psql -h <外网域名> -p <端口> -U <用户名> postgres注意命令末尾的数据库名 postgres 不能省略。使用 DBeaver、Navicat、DataGrip 等图形工具时，把 SSL 模式设置为 require，主机、端口、用户名、密码从外网链接信息中获取。
IP 白名单
点击 IP 白名单 右侧的 编辑：
- 每行填写一个 IPv4 地址或 CIDR 网段，例如
1.2.3.4或10.0.0.0/24（掩码 0 ~ 32）。 - 点击 新增一行 添加更多地址，垃圾桶图标删除一行。
- 空行会被忽略，重复地址会自动去重。格式错误时提示"格式无效，请填写 IPv4 地址或 CIDR 网段"。
warning
白名单为空表示允许所有来源 IP 访问，任意公网地址都可以尝试连接数据库。在空白名单下开启外网访问或保存空白名单时，控制台会再次确认。强烈建议至少添加一条来源 IP。
查询本机出口 IP 可以访问 https://ifconfig.me 等网站。
关闭外网访问
不再需要外网连接时，关闭 外网访问 开关即可，内网连接不受影响。
更新于