PostgreSQL / 系统课时
安装与连接工具
安装与连接工具
本节完成一套可验证的 PostgreSQL 18 工具链:在 Debian/Ubuntu 安装服务端与 psql,创建独立实验账号,再用命令行和图形客户端验证本地连接,最后安全地放开远程 TCP 访问。
学习目标
- 安装 PostgreSQL 18 服务端与
psql客户端,并确认服务可用。 - 使用命令行和图形化客户端连接同一数据库实例。
- 配置
listen_addresses与pg_hba.conf,并按错误现象定位远程连接问题。
安装服务端与 psql
下面以 Debian/Ubuntu 为主路径。先安装 PostgreSQL 公共仓库辅助脚本,再安装 18 版服务端与客户端;需要具备 sudo 权限和可访问软件仓库的网络。
sudo apt update
sudo apt install -y postgresql-common ca-certificates
sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh
sudo apt update
sudo apt install -y postgresql-18 postgresql-client-18
psql --version预期输出
psql (PostgreSQL) 18.<MINOR><MINOR> 会随当前安装的 PostgreSQL 18 小版本变化。随后启动服务,并用 pg_isready 检查 5432 端口是否已经接受连接。
sudo systemctl enable --now postgresql
pg_isready -h 127.0.0.1 -p 5432预期输出
127.0.0.1:5432 - accepting connections如果系统使用其他服务管理方式,只要最终 pg_isready 返回 accepting connections 即可进入下一步。
创建实验账号并验证本地连接
不要直接用超级用户做日常练习。下面创建登录角色 lab_user 和由它拥有的数据库 labdb;密码只用于本地实验,生产环境应换成随机强密码并避免写入 Shell 历史。
sudo -u postgres psql <<'SQL'
CREATE ROLE lab_user LOGIN PASSWORD 'ChangeMe_18!';
CREATE DATABASE labdb OWNER lab_user;
SQL预期输出
CREATE ROLE
CREATE DATABASE再强制通过 TCP 连接本机,而不是依赖 Unix Socket,这样后续远程连接与本地验证使用的是同一类认证链路。
PGPASSWORD='ChangeMe_18!' psql -h 127.0.0.1 -p 5432 -U lab_user -d labdb -c "SELECT current_database() AS db, current_user AS user_name;"预期输出
db | user_name
---------+-----------
labdb | lab_user
(1 row)如果这里失败,先不要继续配置远程访问;本机 TCP 连接成功说明服务、用户、密码、数据库和主机认证至少已经形成一条可用基线。
安装并配置图形化客户端
图形客户端可选 pgAdmin 4、DBeaver 等。桌面系统也可以使用各自的官方安装包;若 Ubuntu Desktop 已启用 Snap,下面用 DBeaver Community 完成一个可复现的安装检查。
sudo snap install dbeaver-ce >/dev/null 2>&1
snap list dbeaver-ce | awk 'NR==2 {print $1}'预期输出
dbeaver-ce安装后在连接配置中填写同一组参数:主机 127.0.0.1,端口 5432,数据库 labdb,用户 lab_user,密码为实验密码。连接成功后,在查询编辑器执行下面的 SQL 即可完成 GUI 侧验证。
SELECT current_database() AS db, current_user AS user_name;预期结果
db | user_name
---------+-----------
labdb | lab_user
(1 row)命令行和 GUI 得到相同结果,说明它们连接的是同一个实例和同一个数据库,而不是另一个本地默认实例。
放开远程连接
PostgreSQL 远程连接同时受监听地址、pg_hba.conf 和主机防火墙控制。先让服务器自己告诉你配置文件实际位置,避免硬编码发行版路径。
sudo -u postgres psql -Atc "SHOW config_file; SHOW hba_file;"预期输出
<PATH>/postgresql.conf
<PATH>/pg_hba.conf在 postgresql.conf 中设置监听地址,并在 pg_hba.conf 追加只允许实验数据库、实验用户和指定客户端网段的规则。下面是配置片段,不是可独立执行的 Shell 命令。
listen_addresses = '*'host labdb lab_user <CLIENT_CIDR> scram-sha-256<CLIENT_CIDR> 应替换为实际客户端网段,例如 10.20.30.0/24,不要为了省事长期使用 0.0.0.0/0。修改后重启 PostgreSQL,并确认监听配置已经生效。
sudo systemctl restart postgresql
sudo -u postgres psql -Atc "SHOW listen_addresses;"预期输出
*还需要在服务器防火墙或云安全组中只向可信来源开放 TCP 5432。最后从另一台已安装 psql 的主机发起连接。
PGPASSWORD='ChangeMe_18!' psql -h <SERVER_IP> -p 5432 -U lab_user -d labdb -c "SELECT inet_server_addr() IS NOT NULL AS tcp_connected, current_user;"预期输出
tcp_connected | current_user
---------------+--------------
t | lab_user
(1 row)<SERVER_IP> 的实际值因环境而异。如果出现 connection refused,优先检查服务、监听地址和防火墙;出现 no pg_hba.conf entry 时检查客户端源地址与 HBA 规则;出现 password authentication failed 时再核对角色、密码和目标数据库。按这个顺序定位,比反复修改所有配置更容易找到真正故障点。