宝塔安装PostgreSQL教程及扩展方法

想在宝塔面板中轻松使用 PostgreSQL——这个强大而灵活的关系型数据库，却苦于官方仅默认支持 MySQL 和 Redis？本文手把手教你完成 PostgreSQL 的完整集成：从系统级安装与安全配置（监听本地端口、启用密码认证）、创建专用用户与数据库，到安装并启用社区维护的宝塔 PostgreSQL 插件，最后一步到位测试连接、关联网站应用。无论你是开发者还是运维人员，都能零门槛扩展宝塔数据库生态，让 PostgreSQL 无缝融入你的生产环境。

如果您希望在宝塔面板中使用 PostgreSQL 数据库，但默认安装的宝塔仅支持 MySQL 和 Redis，则需手动集成 PostgreSQL 服务。以下是完成该集成的具体操作步骤：

一、通过系统包管理器安装 PostgreSQL

此方法利用操作系统原生仓库安装 PostgreSQL，兼容性高，便于后续与宝塔共存。安装后需配置监听地址与认证方式，使其可被宝塔识别并管理。

1、执行命令更新软件源：sudo apt update（Ubuntu/Debian）或 sudo yum update（CentOS 7）或 sudo dnf update（CentOS 8+/AlmaLinux/Rocky）。

2、安装 PostgreSQL 服务：sudo apt install postgresql postgresql-contrib（Debian/Ubuntu）或 sudo yum install postgresql-server postgresql-contrib（CentOS 7），或 sudo dnf install postgresql-server postgresql-contrib（CentOS 8+）。

3、初始化数据库集群：sudo postgresql-setup initdb（RHEL 系列）或该步骤在 Debian/Ubuntu 中由安装过程自动完成。

4、启动并启用开机自启：sudo systemctl start postgresql && sudo systemctl enable postgresql。

二、配置 PostgreSQL 允许远程连接与密码认证

宝塔面板需通过本地 TCP 连接访问 PostgreSQL 实例，因此必须修改 pg_hba.conf 与 postgresql.conf，开放监听及认证规则。

1、查找配置文件路径：执行 sudo -u postgres psql -c "SHOW config_file;" 获取 postgresql.conf 位置；再执行 sudo -u postgres psql -c "SHOW hba_file;" 获取 pg_hba.conf 路径。

2、编辑 postgresql.conf，将 listen_addresses 行修改为：listen_addresses = '127.0.0.1'（仅限本地通信，确保安全）。

3、编辑 pg_hba.conf，在末尾新增一行：host all all 127.0.0.1/32 md5。

4、重启服务使配置生效：sudo systemctl restart postgresql。

三、创建专用 PostgreSQL 用户与数据库

为保障安全性与权限隔离，需为宝塔管理创建独立数据库用户，避免使用默认 postgres 超级用户。

1、切换至 postgres 用户：sudo -i -u postgres。

2、进入 psql 命令行：psql。

3、执行建库指令：CREATE DATABASE bt_pgdb OWNER bt_user;（其中 bt_pgdb 为数据库名，bt_user 为下一步创建的用户名）。

4、创建用户并设密码：CREATE USER bt_user WITH PASSWORD 'StrongPass123!';。

5、退出 psql：\q，再退出 postgres 用户 shell。

四、在宝塔面板中添加 PostgreSQL 数据库（通过第三方插件）

宝塔官方未内置 PostgreSQL 插件，但社区维护的开源插件可实现基础管理功能。该插件以 Python 脚本形式运行，不依赖编译，适配宝塔 7.x–8.x。

1、进入宝塔终端，切换到插件目录：cd /www/server/panel/plugin。

2、下载插件压缩包（以 GitHub 镜像为例）：wget https://ghproxy.com/https://github.com/zhaojun1998/bt-postgresql/archive/refs/tags/v1.2.tar.gz。

3、解压并重命名：tar -xzf v1.2.tar.gz && mv bt-postgresql-1.2 postgresql。

4、赋予执行权限：chmod +x /www/server/panel/plugin/postgresql/index.py。

5、重启宝塔面板：bt restart，登录后台后即可在“软件商店”→“已安装”中看到 PostgreSQL 插件。

五、验证连接并配置网站关联

完成插件安装后，需在插件界面填写已创建的数据库连接参数，并测试连通性，确保 PHP 或其他应用能正常调用。

1、进入宝塔后台 → 左侧菜单点击“PostgreSQL”插件图标。

2、在“数据库列表”页点击“添加数据库”，填写名称、用户名、密码，主机填 127.0.0.1，端口填 5432。

3、点击“测试连接”，确认返回 连接成功 提示。

4、在网站根目录的配置文件（如 .env 或 config/database.php）中，将数据库类型设为 pgsql，主机、端口、数据库名、用户名、密码按实际值填写。

今天关于《宝塔安装PostgreSQL教程及扩展方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！