🛠️ PostgreSQL 安装后配置数据库的详细步骤
✅ 目标
- 启动 PostgreSQL 服务
- 创建数据库用户和数据库
- 配置远程访问(可选)
- 注册为 Windows 服务(开机自启)
- 使用 pgAdmin 4 添加服务器连接
🧰 第一步:确认 PostgreSQL 是否已启动
方法一:通过命令行启动(如未注册为服务)
cd "D:\environment\PostgreSQL\16\bin"
.\pg_ctl.exe -D "D:\environment\PostgreSQL\16\data" start
如果输出:
server started
→ 表示数据库已经成功启动 ✅
🧱 第二步:登录 PostgreSQL 并创建用户和数据库
.\psql.exe -U postgres -d postgres
输入你设置的 postgres 用户密码后,进入 PostgreSQL 命令行界面:
postgres=#
1. 创建新用户(用于 Strapi)
CREATE USER username WITH PASSWORD '你的密码';
2. 创建新数据库,并指定拥有者
CREATE DATABASE username _db OWNER username ;
3. 退出 psql
\q
🧑💻 第三步:使用新用户验证是否能登录数据库
.\psql.exe -U username _user -d username _db
如果你进入了命令行并看到提示符变成:
crowdfundx_db=>
✅ 表示用户和数据库配置成功!
🛠️ 第四步:将 PostgreSQL 注册为 Windows 服务(推荐)
这样你可以设置 PostgreSQL 开机自动启动 ,无需每次手动运行命令。
.\pg_ctl.exe register -N "username -PG" -D "D:\environment\PostgreSQL\16\data"
-N 是服务名称,你可以根据需要修改,比如 Strapi-PG
启动服务:
powershell1net start username -PG
设置为开机自启:
powershell1sc config username -PG start= auto
🔐 第五步:配置远程访问(可选)
如果你希望其他电脑或 Docker 能访问这台机器上的 PostgreSQL,你需要:
1. 编辑 postgresql.conf
路径:
D:\environment\PostgreSQL\16\data\postgresql.conf
找到并修改以下配置:
listen_addresses = '*'
port = 5432
2. 编辑 pg_hba.conf
路径:
D:\environment\PostgreSQL\16\data\pg_hba.conf
在文件末尾添加一行允许远程访问的规则:
host all all 0.0.0.0/0 scram-sha-256
⚠️ 如果你是本地开发,此步骤不是必须的。仅当你需要从外部设备访问时才需要。
3. 重启 PostgreSQL 服务
net stop username -PG
net start username -PG
📦 第六步:保存数据库信息到文档(建议)
你可以将以下信息保存为 .env 文件或 Markdown 文档,便于后续开发使用。
示例 .env 文件内容:
DATABASE_NAME=username_db
DATABASE_USERNAME=username_user
DATABASE_PASSWORD=你的密码
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_PROVIDER=postgres
示例 Markdown 文档:
# PostgreSQL 数据库配置信息
## 数据库详情
- **数据库名称**: username_db
- **用户名**: username_user
- **密码**: ***********(即:你的密码)
- **主机地址**: localhost
- **端口**: 5432
- **数据库类型**: PostgreSQL
🎯 第七步:在 pgAdmin 4 中添加服务器连接
步骤如下:
- 打开 pgAdmin 4 浏览器页面(默认地址是 [http://127.0.0.1:5050)](http://127.0.0.1:5050%EF%BC%89/)
- 在左侧导航栏中,右键点击空白处 → Create → Server
- 输入以下信息:
General 标签页:
Connection 标签页:
✅ 成功添加后,你应该能看到你的数据库和用户列表。