当前位置：首页 > article >正文

PostgreSQL17 编译安装+相关问题解决

article 2025/6/7 7:56:27

更新时间：2025.6.6，当前最新稳定版本17.5，演示的是17.5，最新测试版本18beta1
演示系统：debian12
很多时候，只有编译安装才能用上最新的软件版本或指定的版本。这也是编译安装的意义。

一、编译安装

（一）相关链接

链接：postgresql官网
这里可以看到目前的版本：postgresql当前可用版本

（二）下载源码并编译

以下操作默认使用root用户，如果非root用户请自行添加sudo提权
个人习惯在/usr/local目录安装软件

1.进入目录并下载源码

官方下载地址: pgsql17.5

cd /usr/local && wget https://ftp.postgresql.org/pub/source/v17.5/postgresql-17.5.tar.gz

2.解压源代码

tar -zxvf postgresql-17.5.tar.gz && cd postgresql-17.5

3.安装相关依赖

根据自己需要的增加依赖，这里的依赖是根据下面的编译参数确定的。（简单来讲，就是扩展的功能需要依赖外部已有的程序），我这里装一些常用的。
如果你的ssh客户端不支持多行，需要手动合并成一行来运行
pgsql的拓展能力很强，有很多插件可以安装，不过默认的情况下初学也是够用了。
下面的依赖还包括了postgis的依赖（最后两行，不需要可以去掉）。有一些常用插件是默认编译的，安装完成后可以直接使用简单命令就可以使用。

apt-get -y install 
build-essential
liblz4-dev lz4 bison flex
pkg-config libreadline-dev zlib1g-dev
libxml2-dev libxml2 libssh-dev
uuid-dev libossp-uuid-dev llvm clang
libgeos-dev libproj-dev libprotobuf-c-dev 
protobuf-c-compiler gdal-bin libgdal-dev xsltproc

4.编译安装

编译参数，根据自己的需要添加。
查看所有编译参数：
安装的位置不是数据存放地址，数据通常放到别的分区

./configure --help

./configure
--enable-debug
--with-lz4
--with-openssl
--with-libxml
--with-ossp-uuid
--with-llvm

如果没有报错，则提示类似下面内容：

在这里插入图片描述

编译安装

make && make install

（三）初始化数据和用户

1.创建用户

初始化pgsql不能用root账户
添加用户组

groupadd postgres

添加用户

useradd -g postgres postgres -m

2.创建数据目录

pgsql的默认数据存储目录是/var/pgsqldata

创建文件夹（我就默认的来创建）

mkdir /var/pgsqldata

转移所属权

chown postgres:postgres /var/pgsqldata

3.配置环境变量

编辑环境变量文件

vi /etc/profile

添加如下内容，并保存（pghome和pgdata的变量名不能改成别的，否则无法启动）
PGDATA这个数据地址，调成自己的数据目录（如果单机多开这个可以不不设置这次变量）

export PGHOME=/usr/local/pgsql
export PGDATA=/var/pgsqldata
PATH=$PATH:$PGHOME/bin:$PGHOME/bin

刷新环境变量

source /etc/profile

4.切换postgres用户并初始化数据库

除了这一步要用postgres用户，其他都可以用root创建
pgsql不允许用root初始化和登录，必须用创建的账号
先进入到指定目录

cd /var/pgsqldata

su postgres

initdb

如果一切顺利，可以看到下面的内容：
在这里插入图片描述

启动测试（如果不使用默认的/var/pgsqldata目录，这里把位置改为相应的）

pg_ctl -D /var/pgsqldata start

停止测试

pg_ctl -D /var/pgsqldata stop

（四）管理

切换回root用户

1.通过systemctl管理

vi /usr/lib/systemd/system/pgsql.service

内容如下（如果不是使用默认的/var/pgsqldata目录，下面的三处也要改）

[Unit]
Description=postgresql[Service]
Type=forking
Group=postgres
User=postgres
ExecStart=/usr/local/pgsql/bin/pg_ctl -D /var/pgsqldata start
ExecReload=/usr/local/pgsql/bin/pg_ctl -D /var/pgsqldata restart
ExecStop=/usr/local/pgsql/bin/pg_ctl -D /var/pgsqldata stop[Install]
WantedBy=multi-user.target

2.启动运行

重新加载脚本

systemctl daemon-reload

启动并开机启动

systemctl start pgsql.service && systemctl enable pgsql.service

查看状态

systemctl status pgsql.service

通常是运行正常的，如果不正常，等待看看返回的是什么结果
在这里插入图片描述

3.修改配置文件

修改的是存储位置的，如果上面一步初始化不是/var/pgsqldata ，需要修改那个目录下的conf
编辑postgresql.conf

vi /var/pgsqldata/postgresql.conf

修改listen_addresses为listen_addresses = ‘*’，并取消前面的#号，允许别的机器访问
修改max_connections=1000，修改最大连接数（100太低了，当然设的太高如果性能不够也没用）

开启日志logging，方便检查错误
找到logging_collector = off ,改为logging_collector = on。
删除log_destination = 'stderr’前面的#
找到log_statement = ‘none’，删除前面的#，改为log_statement = ‘all’

编辑pg_hba.conf

vi /var/pgsqldata/pg_hba.conf

在文件最下面添加，允许外部密码登录

host all all 0.0.0.0/0 md5

4.linux进入命令行并创建密码

再次切换到postgres用户

su postgres

进入命令行（这种方法就是最基础的cli来操作数据库，通常只有极少情况会使用psql）

psql

下面操作修改密码为abc123456，根据自己的密码修改
最后的分号不能少，下面就是修改pgsql默认的postgres账号的密码（之前版本的初始密码是postgres，后面的版本就必须要重新设定密码了，我这里改为abc123456）

ALTER USER postgres WITH PASSWORD 'abc123456';

输入quit退出

5.默认账号密码

pgsql数据库
账号：postgres
密码：上面设定的abc123456
本地访问（127.0.0.1）是可以无密码的。

二、插件安装相关

1.pg_stat_statements:

链接

2.pg_trgm，rum:

链接

3.postgis :

链接