Linux 下的pg数据库 tar.gz如何安装

金融业务专家

于 2025-07-15 17:40:01 发布

阅读量335

点赞数 4

CC 4.0 BY-SA版权

文章标签：微信公众平台微信开放平台

本文链接：https://blog.csdn.net/qq_34401027/article/details/149361772

以下是基于Linux系统安装PostgreSQL(通常简称pg数据库)的tar.gz源码包的完整步骤。本指南适用于常见Linux发行版(如CentOS、Ubuntu等)，假设您已下载tar.gz安装包(例如从PostgreSQL官网)。安装过程包括依赖安装、解压、编译、配置和初始化等关键步骤。请按顺序操作，确保每一步成功后再继续。

### 步骤1：安装依赖包
PostgreSQL需要一些基础库支持，如readline、zlib等。使用包管理器安装这些依赖(以CentOS/Red Hat为例，Ubuntu用户可将`yum`替换为`apt-get`)：

```bash
# 更新系统包列表(可选)
sudo yum update -y

# 安装核心依赖
sudo yum install -y readline-devel zlib-devel gcc-c++ openssl-devel libxml2-devel libxslt-devel

# 如果遇到readline或zlib报错(如“readline library not found”)，确保安装对应开发包
# 例如：yum install -y readline readline-devel
```

### 步骤2：解压tar.gz安装包
将下载的tar.gz文件上传到Linux服务器(例如使用`scp`或FTP)，然后解压到指定目录(如`/opt`或`/home/username`)：

```bash
# 切换到安装包目录
cd /path/to/downloaded/file

# 解压tar.gz文件(替换为您的实际文件名)
tar -zxvf postgresql-XX.Y.tar.gz # XX.Y为版本号，例如14.7

# 进入解压后的源码目录
cd postgresql-XX.Y
```

### 步骤3：配置和编译源码
配置安装路径和选项，然后编译并安装。推荐指定安装目录(如`/usr/local/pgsql`)以避免权限冲突。

```bash
# 创建安装目录(可选，如果未指定--prefix)
sudo mkdir -p /usr/local/pgsql
sudo chown $USER:$USER /usr/local/pgsql # 确保当前用户有权限

# 运行配置脚本(指定安装路径；其他选项如--with-python可添加支持)
./configure --prefix=/usr/local/pgsql

# 编译和安装(过程可能需要几分钟)
make
sudo make install
```

### 步骤4：创建PostgreSQL用户和数据目录
为安全起见，建议使用专用用户运行数据库，并初始化数据存储目录：

```bash
# 创建PostgreSQL用户和组(如果不存在)
sudo groupadd postgres
sudo useradd -g postgres -m postgres

# 创建数据目录并设置权限
sudo mkdir -p /usr/local/pgsql/data
sudo chown -R postgres:postgres /usr/local/pgsql/data
```

### 步骤5：初始化数据库
切换到`postgres`用户并执行初始化命令。这一步设置数据库的基本结构和配置文件。

```bash
# 切换到PostgreSQL用户
sudo su - postgres

# 初始化数据库(指定数据目录)
/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

# 退出postgres用户
exit
```

### 步骤6：配置环境变量(可选，但推荐)
为方便使用`psql`等命令，将PostgreSQL路径添加到环境变量中(编辑`~/.bashrc`或`/etc/profile`)：

```bash
# 编辑当前用户环境变量文件
vi ~/.bashrc

# 添加以下行(替换路径为您的实际安装目录)
export PGHOME=/usr/local/pgsql
export PGDATA=/usr/local/pgsql/data
export PATH=$PATH:$PGHOME/bin

# 使配置生效
source ~/.bashrc
```

### 步骤7：启动和管理数据库服务
使用`pg_ctl`命令启动服务，并设置开机自启(可选)。

```bash
# 切换到PostgreSQL用户
sudo su - postgres

# 启动数据库服务(指定数据目录和日志文件)
$PGHOME/bin/pg_ctl -D $PGDATA -l /usr/local/pgsql/logfile start

# 检查服务状态(应显示“server started”)
$PGHOME/bin/pg_ctl status -D $PGDATA

# 设置开机自启(需创建systemd服务或使用脚本，示例服务配置)：
# 创建文件 /etc/systemd/system/postgresql.service：
# [Unit]
# Description=PostgreSQL database server
# After=network.target
# [Service]
# User=postgres
# Group=postgres
# ExecStart=/usr/local/pgsql/bin/pg_ctl start -D /usr/local/pgsql/data -l /usr/local/pgsql/logfile
# ExecStop=/usr/local/pgsql/bin/pg_ctl stop -D /usr/local/pgsql/data
# [Install]
# WantedBy=multi-user.target
# 然后运行：sudo systemctl daemon-reload && sudo systemctl enable postgresql
```

### 步骤8：配置远程访问(可选)
如果需要远程连接，修改配置文件：

1. 编辑`/usr/local/pgsql/data/postgresql.conf`：
- 设置监听地址：`listen_addresses = '*'`
- 设置端口(默认5432)：`port = 5432`

2. 编辑`/usr/local/pgsql/data/pg_hba.conf`：
- 添加行允许远程连接(例如所有IP使用密码认证)：
```
host all all 0.0.0.0/0 md5
```

3. 重启服务：`$PGHOME/bin/pg_ctl restart -D $PGDATA`

### 常见问题解决
- **依赖报错**：如`readline library not found`，安装对应开发包(如`yum install readline-devel`)。
- **权限问题**：确保数据目录归`postgres`用户所有，避免用root初始化数据库。
- **启动失败**：检查日志文件(如`/usr/local/pgsql/logfile`)中的错误信息。

安装完成后，您可以使用`psql`命令登录数据库：`psql -U postgres`。建议进一步配置防火墙(如`sudo firewall-cmd --add-port=5432/tcp --permanent`)以允许远程访问。如果遇到问题，请提供具体错误信息以便排查。