配置指南
项目本地开发时使用本地psql数据库
Created: 12/27/2025
Updated: 12/28/2025
写在前面
相信大伙在本地启动使用Supabase时经常会遇到一些网络连接问题导致的慢或者其他诡异问题,官方也是建议咱们在本地开发时连接本地psql数据库,提升开发效率
安装 PostgreSQL(Mac)
安装postgresql@16
访问 https://postgresapp.com/downloads.html 下载

下载,安装完成后
打开 Postgres.app-点击 "Initialize"
然后终端添加到 PATH:
echo 'export PATH="/Applications/Postgres.app/Contents/Versions/latest/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
创建数据库
createdb shipany_nanobanana_dev


配置.env.development
# database
DATABASE_URL = "postgresql://你的电脑名@localhost:5432/shipany_nanobanana_dev"
DATABASE_PROVIDER = "postgresql"
DB_SINGLETON_ENABLED = "true"

此时,数据库已配置好,请返回项目快速上手图文教程 继续操作。
测试发现:响应快很多,比魔法+Supabase快,提升开发效率

安装 PostgreSQL 官方安装器(Windwos)
打开:https://www.postgresql.org/download/windows/
下载 EDB 安装器

运行安装,记住设置的密码
验证安装成功,打开 PowerShell 或 CMD
psql --version
如果能显示版本号,就说明好了,PATH也自动添加了。
安装后操作
打开 PowerShell 或 CMD
创建数据库:
shipany_nanobanana_dev为数据库名称,可以自行修改
createdb -U postgres shipany_nanobanana_dev
配置 .env.development:
DATABASE_URL = "postgresql://postgres:你的密码@localhost:5432/shipany_nanobanana_dev"
此时,数据库已配置好,请返回项目快速上手图文教程 继续操作