1707 字
9 分钟
PostgreSQL 安装与初始配置
2026-11-15

这一篇解决什么#

选型(《数据库怎么选》)和练功房(《用 Docker 快速搭建三大数据库》)都走完了,这一篇正式进入 PostgreSQL:把它以「能长期用」的标准装好——不是能跑就行,而是监听范围、访问控制、基础参数都配置到位。

两种装法都讲:Docker 装法胜在干净隔离、版本随意切换,适合开发和中小部署;系统包装法胜在和系统服务体系融合、运维工具齐全,适合长期跑在 VPS 上的正式服务。原理部分(配置文件、认证)两边相通,学会一边另一边自然懂。

方式一:Docker 安装#

单跑 PostgreSQL 的精简 Compose(练功房里已有全套的可以跳过):

services:
postgres:
image: postgres:17
container_name: postgres
restart: unless-stopped
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: change_me_strong_password
POSTGRES_DB: appdb
TZ: Asia/Shanghai
ports:
- "127.0.0.1:5432:5432"
volumes:
- pg_data:/var/lib/postgresql/data
- ./postgresql.conf:/etc/postgresql/postgresql.conf
command: postgres -c config_file=/etc/postgresql/postgresql.conf
volumes:
pg_data:

官方镜像的约定要记牢:

  • 数据目录固定 /var/lib/postgresql/data,必须挂卷,否则删容器即丢数据。
  • POSTGRES_PASSWORD 等环境变量只在数据目录为空时生效,首次初始化后改密码要进库里用 SQL 改(下一篇 《PostgreSQL 用户、角色与权限管理》 专门讲)。
  • 想自定义配置,就把配置文件挂进去并用 command 指定,这是 Docker 下调参的标准姿势。
Terminal window
docker compose up -d
docker exec -it postgres psql -U postgres -d appdb -c "SELECT version();"

方式二:Debian / Ubuntu 系统包安装#

用 PostgreSQL 官方 APT 源装 17 版(系统自带源版本往往偏旧):

Terminal window
sudo apt install -y wget gnupg lsb-release
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/postgresql.gpg
sudo apt update
sudo apt install -y postgresql-17

安装后服务由 systemd 管理,关键路径:

路径内容
/etc/postgresql/17/main/postgresql.conf主配置文件
/etc/postgresql/17/main/pg_hba.conf客户端认证(谁能连、用什么方式验)
/var/lib/postgresql/17/main/数据目录
/var/log/postgresql/postgresql-17-main.log日志
Terminal window
sudo systemctl status postgresql
sudo -u postgres psql -c "SELECT version();"

系统包默认建了一个系统用户 postgres 和同名超级用户,sudo -u postgres psql 是本机免密进库的入口——它能免密是因为 pg_hba.conf 里本地连接默认走 peer 认证(系统用户和数据库用户同名即放行)。

核心配置一:监听与连接#

postgresql.conf 里最先要动的几个参数:

listen_addresses = 'localhost' # 只监听本机;要内网访问改成 '*' 或具体网卡 IP
port = 5432
max_connections = 100 # 默认 100,按机器配置和业务量调整

改完 listen_addresses 必须重启服务才生效(sudo systemctl restart postgresql 或容器重建);多数其他参数用 reload 即可:

Terminal window
sudo -u postgres psql -c "SELECT pg_reload_conf();"
WARNING

把 listen_addresses 改成 '*' 之前,先想清楚 pg_hba.conf 是否已经收紧、防火墙是否到位。监听全网卡 + 弱口令 + pg_hba 放行全网,是数据库被扫被拖库的经典组合。远程管理优先用 SSH 隧道:ssh -L 5432:localhost:5432 user@服务器,既加密又不用暴露端口。

核心配置二:pg_hba.conf 访问控制#

pg_hba.conf 是 PostgreSQL 的门卫,规则从上往下匹配,命中第一条就停。每行五要素:连接类型、数据库、用户、来源地址、认证方式。

# 类型 数据库 用户 来源地址 认证方式
local all all peer
host appdb appuser 127.0.0.1/32 scram-sha-256
host appdb appuser 192.168.1.0/24 scram-sha-256
host all all 0.0.0.0/0 reject

认证方式怎么选:

方式含义建议
peer系统用户名与数据库用户名一致即放行仅限 local 本机连接
scram-sha-256密码认证(当前推荐)网络连接一律用它
md5老版密码认证能不用就不用,逐步迁移到 scram
trust无条件信任,不验密码只允许出现在本机开发环境,生产用等于裸奔

改完 pg_hba.conf 执行 reload 即可生效,不用重启。验证当前生效的规则:

SELECT * FROM pg_hba_file_rules;

核心配置三:性能起步参数#

默认配置是为「能在任何破机器上跑起来」定的,正式使用至少要按内存调这几个(以 4 GB 内存的机器为例):

shared_buffers = 1GB # 总内存的约 25%,数据缓存
work_mem = 16MB # 单个排序/哈希操作可用内存,按连接数保守给
maintenance_work_mem = 256MB # 建索引、VACUUM 等维护操作用
effective_cache_size = 3GB # 告诉规划器「系统总共能缓存多少」,约总内存 75%

这里的关键认知是:参数调优没有通用最优解,只有与你的内存、连接数、查询形态匹配的配置。起步先按上面这组比例给,之后用 《数据库性能监控与常见故障排障》 里的方法看实际瓶颈再动。索引和查询层面的优化则是下一篇之后的内容,见《PostgreSQL 索引与查询优化入门》。

首次上手动作清单#

装完建议按顺序做完这五件事,再交付使用:

-- 1. 给超级用户 postgres 设密码(默认无密码,靠 peer 认证进)
ALTER USER postgres WITH PASSWORD 'strong_password_here';
-- 2. 建业务库和业务用户(不要拿超级用户跑业务,下一篇细讲)
CREATE DATABASE appdb;
CREATE USER appuser WITH PASSWORD 'another_strong_password';
GRANT ALL PRIVILEGES ON DATABASE appdb TO appuser;
Terminal window
# 3. 确认时区与编码
sudo -u postgres psql -c "SHOW timezone;" -c "SHOW server_encoding;"
# 4. 从目标机器实测一次远程/本机连接
psql "host=127.0.0.1 port=5432 dbname=appdb user=appuser" -c "SELECT 1;"
# 5. 确认服务开机自启
sudo systemctl enable postgresql

常见问题#

Q:psql: error: connection to server ... FATAL: password authentication failed? A:密码错、或 pg_hba 里该来源走的认证方式和你想的不一样。先确认命中的是哪条规则(pg_hba_file_rules),再确认密码——注意超级用户初始无密码时,网络连接用密码登录必然失败,先按上文设密码。

Q:远程连不上,但本机能连? A:按顺序查四层:listen_addresses 是否包含目标网卡;pg_hba 是否放行来源 IP;服务器防火墙 / 云厂商安全组是否放行 5432;中间网络是否可达(telnet 目标 5432 或 nc -vz 目标 5432)。四层里必有一层没过。

Q:改了 postgresql.conf 重启没生效? A:先确认改的是不是正在用的那份配置:SHOW config_file; 看路径,Docker 场景还要确认挂载和 config_file 参数对得上。再确认参数是否需要重启才生效:SELECT name, pending_restart FROM pg_settings WHERE pending_restart;

Q:端口 5432 被占怎么办? A:sudo ss -tlnp | grep 5432 查是谁占的。是另一个 PostgreSQL 实例就换端口跑(改 port 并同步客户端),是无关进程就处理掉它。

小结#

安装只是把软件放进机器,真正决定它能不能长期稳定服务的,是监听范围、pg_hba 门卫规则和按内存调过的起步参数这三件事。下一篇把用户、角色与权限这套体系讲透——装得再对,权限给错了照样出事。

PostgreSQL 安装与初始配置
https://www.anexns.cloudns.org/posts/postgresql-install-config/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0