PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)
2026年 8月 14日

PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)

作者 admin

PostgreSQL 作为全球顶尖开源关系型数据库,广泛应用于个人开发、中小型 Web 项目、企业级业务系统与数据仓库。想要正常使用 PostgreSQL,第一步就是完成系统环境安装与基础初始化配置。本文完整覆盖Windows 本地手动安装Linux 服务器手动部署两套实操流程,同时给大家介绍无需手动配置、开箱即用的 RakSmart PostgreSQL 应用模板方案,兼顾本地学习与线上生产场景,零基础也能跟着完成环境搭建。

一、Windows 系统手动安装 PostgreSQL 完整流程

1. 安装包下载

前往 EnterpriseDB 官方下载对应系统版本安装程序(.exe安装包),推荐选择 15/16/17 稳定版,适配 Windows 10/11 64 位系统。

2. 图形化安装向导步骤

  1. 双击安装包启动向导,自定义安装目录(建议不放在 C 盘系统盘);
  2. 组件勾选:全选 PostgreSQL Server、pgAdmin 4、命令行工具,方便后续可视化管理;
  3. 设置数据存储目录,单独划分大容量磁盘存放数据库文件;
  4. 设置postgres超级用户密码,务必妥善保存,后续连接数据库必备;
  5. 数据库端口默认 5432,无端口占用无需修改;
  6. 语言区域选择英文 UTF-8,避免中文乱码问题;
  7. 等待安装完成,取消 StackBuilder 附加工具,点击 Finish 结束安装。

3. 系统环境变量配置

  1. 右键此电脑→属性→高级系统设置→环境变量;
  2. 在系统变量Path中新增 PostgreSQL 安装目录下bin文件夹路径;
  3. 保存后重启终端,任意 CMD 窗口可直接调用psqlpg_ctl等命令行工具。

4. 验证安装与基础连接

  1. 命令行验证:打开 CMD,输入psql -U postgres,输入密码出现postgres=#提示符即成功;执行SELECT version();查看数据库版本;
  2. pgAdmin 图形化验证:从开始菜单启动 pgAdmin 4,设置本地登录密码,新建服务器连接,填写localhost、5432 端口、postgres 账号密码,成功读取系统数据库代表环境配置完成。

二、Linux 系统手动安装 PostgreSQL(Ubuntu/CentOS 通用)

2.1 Ubuntu/Debian 系列安装

  1. 添加官方 PG 源并导入密钥
PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)
  1. 安装指定版本数据库(示例 17)
PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)
  1. 管理服务、设置开机自启
PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)
  1. 初始化账号密码
PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)

2.2 CentOS/RHEL 系列安装

  1. 安装 PG 官方 yum 源
PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)
  1. 安装数据库服务并初始化
PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)
  1. 启动并设置开机自启
PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)

2.3 Linux 环境变量持久化配置

编辑全局环境配置文件/etc/profile,追加如下内容:
PostgreSQL 教程:环境安装与基础环境配置(Windows/Linux)
执行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. 选购套餐:根据业务规模选择开发学习、小型应用、中型业务、高性能业务四档配置,从 1 核 2G 到 8 核 16G NVME 机型全覆盖;
  2. 一键部署:应用市场选择 PostgreSQL 模板,点击一键部署,系统秒级完成环境搭建;
  3. 连接使用:后台获取数据库 IP、端口、账号密码,通过 pgAdmin 或业务代码直接连接使用。

四、基础环境通用核心配置项说明

无论 Windows 本地、Linux 手动部署还是 RakSmart 模板,完成安装后都需要了解三项基础核心配置:
  1. 端口配置:默认 5432,端口冲突可修改postgresql.confport参数;
  2. 远程访问权限:本地环境默认仅本地访问,线上服务器需修改pg_hba.conf允许指定 IP 远程连接;RakSmart 模板已提前配置好远程访问规则;
  3. 字符集:统一设置 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 模板内置一键备份运维脚本,支持定时自动备份,文件独立存储。

六、总结

  1. Windows、Linux 两套手动安装流程适用于本地开发、离线学习场景,完整覆盖下载、安装、环境变量、初始化、连接验证全流程,适合想要深入了解底层部署逻辑的开发者;
  2. 手动部署存在步骤多、易踩坑、远程权限、备份脚本需要自行维护等痛点,线上业务更推荐 RakSmart PostgreSQL 应用模板
  3. RakSmart 模板提供预装 pgAdmin 可视化界面、零配置自动初始化、全套运维脚本三大核心能力,一站式搭建可用 PostgreSQL 实例,无需专业 DBA 操作,适配开发测试、个人项目、中小型线上业务;
  4. 完成环境安装与基础配置是学习 PostgreSQL 的第一步,后续本系列教程将继续讲解数据库创建、数据表设计、SQL 增删改查、索引、事务等进阶内容。