2026年 8月 14日
PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)
PostgreSQL 作为全球顶尖开源关系型数据库,广泛应用于个人开发、中小型 Web 项目、企业级业务系统与数据仓库。想要正常使用 PostgreSQL,第一步就是完成系统环境安装与基础初始化配置。本文完整覆盖Windows 本地手动安装、Linux 服务器手动部署两套实操流程,同时给大家介绍无需手动配置、开箱即用的 RakSmart PostgreSQL 应用模板方案,兼顾本地学习与线上生产场景,零基础也能跟着完成环境搭建。
一、Windows 系统手动安装 PostgreSQL 完整流程
1. 安装包下载
前往 EnterpriseDB 官方下载对应系统版本安装程序(
.exe安装包),推荐选择 15/16/17 稳定版,适配 Windows 10/11 64 位系统。2. 图形化安装向导步骤
- 双击安装包启动向导,自定义安装目录(建议不放在 C 盘系统盘);
- 组件勾选:全选 PostgreSQL Server、pgAdmin 4、命令行工具,方便后续可视化管理;
- 设置数据存储目录,单独划分大容量磁盘存放数据库文件;
- 设置
postgres超级用户密码,务必妥善保存,后续连接数据库必备; - 数据库端口默认 5432,无端口占用无需修改;
- 语言区域选择英文 UTF-8,避免中文乱码问题;
- 等待安装完成,取消 StackBuilder 附加工具,点击 Finish 结束安装。
3. 系统环境变量配置
- 右键此电脑→属性→高级系统设置→环境变量;
- 在系统变量
Path中新增 PostgreSQL 安装目录下bin文件夹路径; - 保存后重启终端,任意 CMD 窗口可直接调用
psql、pg_ctl等命令行工具。
4. 验证安装与基础连接
- 命令行验证:打开 CMD,输入
psql -U postgres,输入密码出现postgres=#提示符即成功;执行SELECT version();查看数据库版本; - pgAdmin 图形化验证:从开始菜单启动 pgAdmin 4,设置本地登录密码,新建服务器连接,填写localhost、5432 端口、postgres 账号密码,成功读取系统数据库代表环境配置完成。
二、Linux 系统手动安装 PostgreSQL(Ubuntu/CentOS 通用)
2.1 Ubuntu/Debian 系列安装
- 添加官方 PG 源并导入密钥

- 安装指定版本数据库(示例 17)

- 管理服务、设置开机自启

- 初始化账号密码

2.2 CentOS/RHEL 系列安装
- 安装 PG 官方 yum 源

- 安装数据库服务并初始化

- 启动并设置开机自启

2.3 Linux 环境变量持久化配置
编辑全局环境配置文件
/etc/profile,追加如下内容:
执行
source /etc/profile刷新配置,任意终端可直接调用 pg 命令。三、线上服务器快速部署:RakSmart PostgreSQL 应用模板(一站式免配置方案)
本地手动安装适合学习测试,但线上 VPS / 云服务器手动部署、初始化、配置权限、搭建管理工具流程繁琐,新手极易出现端口、权限、初始化失败等问题。推荐使用 RakSmart 提供的 PostgreSQL 应用模板一键部署,一站式数据库管理体验,无需专业 DBA 也能快速搭建可用生产数据库。
模板三大核心优势
1. pgAdmin 可视化管理
模板预装完整 pgAdmin Web 管理界面,部署完成后直接通过浏览器访问,无需单独下载安装客户端。支持可视化完成全量数据库操作:新建 / 删除数据库、创建数据表、在线执行 SQL 查询、批量导入导出数据、备份单库 / 整实例、查看表结构与数据,可视化操作替代复杂命令行,大幅降低管理门槛。
2. 零配置启动,开箱即用
实例部署完成后系统自动执行全套初始化流程:自动生成数据存储目录、初始化数据库集群、创建 postgres 超级管理员账号、自动配置账号访问权限、开放默认 5432 端口放行策略。无需手动执行
initdb初始化、不用修改pg_hba.conf权限文件,实例开机即可通过本地程序、远程客户端直接连接数据库,省去 90% 基础配置工作。3. 内置便捷运维脚本
模板封装全套运维脚本,简化日常数据库管理:一键启动、停止、重启 PostgreSQL 服务;定时全量备份 / 增量备份脚本;备份文件自动打包存储;故障快速重启脚本。无需手动编写 shell 批处理,新手也能完成日常运维,降低数据库丢失、服务异常风险。
3 步快速部署 RakSmart 托管 PostgreSQL
- 选购套餐:根据业务规模选择开发学习、小型应用、中型业务、高性能业务四档配置,从 1 核 2G 到 8 核 16G NVME 机型全覆盖;
- 一键部署:应用市场选择 PostgreSQL 模板,点击一键部署,系统秒级完成环境搭建;
- 连接使用:后台获取数据库 IP、端口、账号密码,通过 pgAdmin 或业务代码直接连接使用。
四、基础环境通用核心配置项说明
无论 Windows 本地、Linux 手动部署还是 RakSmart 模板,完成安装后都需要了解三项基础核心配置:
- 端口配置:默认 5432,端口冲突可修改
postgresql.conf中port参数; - 远程访问权限:本地环境默认仅本地访问,线上服务器需修改
pg_hba.conf允许指定 IP 远程连接;RakSmart 模板已提前配置好远程访问规则; - 字符集:统一设置 UTF-8 编码,避免中文存储乱码,模板部署实例默认全局 UTF-8。
五、FAQ 常见安装配置问题解答
Q1:Windows 安装后 cmd 输入 psql 提示不是内部命令?
A:未配置系统环境变量,将 PostgreSQL 安装目录下 bin 文件夹添加至系统 Path,重启终端即可生效。
Q2:Linux 切换 postgres 用户提示权限不足,初始化失败?
A:数据目录归属权限错误,执行
chown -R postgres:postgres 数据目录路径修改文件夹所有者。Q3:本地 pgAdmin 连接数据库提示密码认证失败?
A:安装时设置的 postgres 超级用户密码输入错误;RakSmart 模板可在主机后台直接重置数据库账号密码。
Q4:线上服务器手动部署数据库,外部程序无法远程连接?
A:两点排查:①防火墙未放行 5432 端口;②
pg_hba.conf未添加客户端 IP 访问权限;使用 RakSmart PostgreSQL 模板无此问题,模板自动放行远程访问。Q5:新手学习 PostgreSQL,选本地安装还是 RakSmart 模板?
A:学习语法、本地开发测试用 Windows/Linux 手动安装;需要线上项目、远程协作、长期稳定运行数据库,直接选用 RakSmart 应用模板,省去环境维护成本。
Q6:如何备份数据库,担心数据丢失?
A:本地手动部署需自行编写备份脚本;RakSmart PostgreSQL 模板内置一键备份运维脚本,支持定时自动备份,文件独立存储。
六、总结
- Windows、Linux 两套手动安装流程适用于本地开发、离线学习场景,完整覆盖下载、安装、环境变量、初始化、连接验证全流程,适合想要深入了解底层部署逻辑的开发者;
- 手动部署存在步骤多、易踩坑、远程权限、备份脚本需要自行维护等痛点,线上业务更推荐 RakSmart PostgreSQL 应用模板;
- RakSmart 模板提供预装 pgAdmin 可视化界面、零配置自动初始化、全套运维脚本三大核心能力,一站式搭建可用 PostgreSQL 实例,无需专业 DBA 操作,适配开发测试、个人项目、中小型线上业务;
- 完成环境安装与基础配置是学习 PostgreSQL 的第一步,后续本系列教程将继续讲解数据库创建、数据表设计、SQL 增删改查、索引、事务等进阶内容。
