★ FEATURED ARTICLE 1. 安装前的方案选型别急着敲命令很多朋友拿到PostgreSQL安装任务第一反应就是去官网下载安装包或者直接复制粘贴网上搜来的命令。我见过不少项目栽在第一步——版本选错、平台不匹配、包管理器源不对装到一半卡住最后不得不清干净重来。所以在动手之前花十分钟把方案定下来比什么都重要。先说版本选择。PostgreSQL的版本号规则是主版本.次版本比如16.4、15.9其中16是主版本4是补丁版本。主版本每年发布一次次版本不定期修复Bug和安全漏洞。我的建议是新项目优先选最近两年内发布的主版本比如当前的17系列或16系列这两个版本在性能、并发处理和JSON能力上都有明显改进。不要迷信最新版因为生态工具链比如备份工具、监控插件有时候会滞后也不要死守老版本PostgreSQL 12及以下已经进入维护末期官方支持周期快结束了安全风险不好控。如果公司有历史包袱必须用老版本至少要清楚它已经不再有新的安全补丁这一点要写进运维手册。然后是平台选择。你是装在开发机上的Windows还是生产环境的Linux服务器还是想快速拉起一套测试环境用Docker这决定了安装路径完全不一样。Linux下面还要区分发行版Ubuntu/Debian系用aptCentOS/RHEL系用dnf或yumopenSUSE用zypper。包管理器不同安装命令、默认数据目录、服务管理方式都有差异。不要以为“Linux装PG都一样”这种认知在排查问题的时候会害死你。最后确认一下权限和网络环境。安装PostgreSQL需要root权限或者sudo权限生产环境尤其要确认防火墙策略、是否允许外部连接、是否要配置SSL。这些虽然在安装阶段用不上但安装完马上就会遇到。提前准备好后面能少折腾两个小时。提示如果只是本地学习和跑Demo我强烈建议用Docker装干净利落删掉不残留。如果是生产环境老老实实走系统包管理器或者源码编译原因我后面细说。2. 各平台安装实操从Linux到Windows再到Docker2.1 Ubuntu/Debian系apt源安装全流程Ubuntu是开发者最常用的发行版PostgreSQL在Ubuntu官方源里就有但版本往往偏旧。比如Ubuntu 22.04自带的PostgreSQL是14Ubuntu 24.04自带的是16对绝大多数场景是够用的但如果你需要特定大版本就要用PostgreSQL官方维护的APT源。先更新系统包索引然后安装带contrib包的版本。contrib包里包含了一些扩展工具比如pg_stat_statements、postgres_fdw后面做性能监控和跨库查询都会用到建议一起装上。sudo apt update sudo apt install -y postgresql postgresql-contrib安装完后PostgreSQL会自动创建名为postgres的系统用户并且初始化好一个默认集群。注意这里的“集群”不是多台机器组成的那种集群而是指一个数据目录加一套运行实例。在Debian系上默认集群名是main端口是5432数据目录在/var/lib/postgresql/版本号/main。想知道具体版本可以用pg_lsclusters这个命令是Debian系特有的会列出所有集群的状态、端口、数据目录排查问题的时候非常有用。如果要安装特定版本比如PostgreSQL 16需要先添加官方源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 apt-key add - sudo apt update sudo apt install -y postgresql-16装完之后服务会自动启动可以用systemctl status postgresql确认状态。如果没启动手动执行sudo systemctl start postgresql。这里有个细节Debian系PostgreSQL服务通常分为postgresql.service总控和postgresql16-main.service具体实例操作实例时用后者更精确。2.2 CentOS/RHEL系dnf与官方仓库的选择CentOS 7时代大家习惯用yum装PG到了CentOS 9 Stream、Rocky Linux 9这些新系统包管理器换成了dnf底层逻辑是兼容的。CentOS官方源里的PostgreSQL版本同样偏旧所以生产环境一般用PostgreSQL官方提供的RHEL仓库。先安装官方仓库RPM包sudo dnf install -y https://download.postgresql.org/pub/repos/dnf/reporpms/EL-$(rpm -E %{rhel})-x86_64/pgdg-redhat-repo-latest.noarch.rpm然后禁用系统自带的模块化PostgreSQL这一步特别容易漏sudo dnf -qy module disable postgresql再装指定版本比如17sudo dnf install -y postgresql17-server注意RHEL系的包名带有完整版本号比如postgresql17-server、postgresql17-contrib没有默认安装的contrib包需要自己带上。装完后不会自动初始化数据目录必须手动执行sudo /usr/pgsql-17/bin/postgresql-17-setup initdb这个脚本会创建数据目录/var/lib/pgsql/17/data/并生成初始配置文件。然后启动服务sudo systemctl enable --now postgresql-17RHEL系的默认数据目录、配置路径、服务名都和Debian系不一样很多从Ubuntu转过来的朋友在这里踩坑——拿着/etc/postgresql/16/main/postgresql.conf的路径去CentOS上找当然找不到。CentOS上配置文件直接在/var/lib/pgsql/17/data/底下postgresql.conf和pg_hba.conf都在那里改配置之前先弄清楚路径。2.3 Windows和macOS图形化安装与注意事项Windows安装最省心的方式是使用EnterpriseDB提供的图形化安装包也就是PostgreSQL官网首页那个“Download”按钮指向的安装器。双击运行一路Next中间有几个关键步骤需要留意。一个是安装目录默认在C:\Program Files\PostgreSQL\17建议改到非系统盘比如D:\PostgreSQL\17防止系统盘空间不足或者权限问题影响数据库运行。另一个是data目录默认就在安装目录下的data文件夹里也建议分开比如D:\PostgreSQL\17\data备份和迁移的时候会方便很多。然后是设置超级用户密码。安装器会让你为postgres用户设置密码这个密码就是数据库超级管理员密码务必记好。这里有个很多人忽略的点安装器还会让你选端口默认5432如果端口被占记得换一个并同步修改防火墙规则。最后安装器问是否安装Stack Builder时除非需要配套工具比如pgAdmin已经单独集成了一般可以取消勾选。macOS用户就简单得多两种方式都很好用。一种是直接下载Postgres.app这是个绿色软件解压就能用菜单栏点一下启动自带pgAdmin和命令行工具最适合开发机。另一种是用Homebrewbrew install postgresql17Homebrew装完需要初始化/opt/homebrew/opt/postgresql17/bin/initdb --localeen_US.UTF-8 /opt/homebrew/var/postgresql17然后在~/.zshrc里加上环境变量把PostgreSQL的bin目录加到PATH里不然每次都要写全路径export PATH/opt/homebrew/opt/postgresql17/bin:$PATH2.4 Docker方式一条命令拉起测试环境Docker装PostgreSQL优点是无侵入、可重复、删了不残留非常适合本地开发、CI测试、临时Demo。一条命令就能起来docker run -d \ --name my-postgres \ -e POSTGRES_USERadmin \ -e POSTGRES_PASSWORDsecret \ -e POSTGRES_DBmydb \ -p 5432:5432 \ -v pgdata:/var/lib/postgresql/data \ postgres:17这里有几个参数要说清楚。POSTGRES_USER和POSTGRES_PASSWORD是容器初始化时自动创建的超级用户和密码POSTGRES_DB是自动创建的默认数据库。-v pgdata:/var/lib/postgresql/data是把数据持久化到Docker卷里这样删掉容器数据不会丢。注意PostgreSQL官方镜像有个坑镜像里的数据目录在/var/lib/postgresql/data但如果你挂载了本地目录比如-v /my/local/path:/var/lib/postgresql/data第一次启动会报错“data directory has wrong ownership”因为容器里的postgres用户UID是999而宿主机目录的属主是root。解决方法是先手动改目录属主sudo chown -R 999:999 /my/local/path或者干脆用命名卷named volumeDocker会自动处理属主问题省心很多。用Docker也有局限第一容器默认只监听localhost外部机器访问需要额外配置端口映射和网络策略第二数据目录的IO性能比裸机部署有损耗高并发场景下不明显但基准测试能看得出来第三容器升级PostgreSQL大版本时要手动做逻辑备份恢复不是简单拉新镜像就能无缝升级。所以生产环境我一般不用Docker跑数据库开发测试环境它是最好的选择。3. 初始化配置与基础调优装完不等于能跑安装完成、服务启动成功这只是万里长征第一步。默认配置下PostgreSQL只能本机访问数据目录权限、监听地址、密码策略都处于最保守状态。接下来要做几件事。3.1 修改postgres用户密码和认证方式安装完成后系统会创建一个postgres操作系统用户同时数据库里也有一个同名超级用户。在Debian系上本机通过sudo -u postgres psql可以直接进入数据库不需要密码。这是本地认证的一种方式叫peer认证。生产环境不能这样裸奔第一步就是给数据库超级用户设一个强密码。先在系统层面切换用户进入psqlsudo -u postgres psql在psql里执行ALTER USER postgres WITH PASSWORD 你的强密码;然后修改pg_hba.conf的认证方式。这个文件控制哪些客户端可以用什么方式连接数据库。默认配置里本地连接是peerIPv4/IPv6是scram-sha-256密码传输方式很安全。如果你是在本机开发保留默认就够用了。如果需要远程连接把对应IP段的那行改一下# TYPE DATABASE USER ADDRESS METHOD host all all 0.0.0.0/0 scram-sha-256注意0.0.0.0/0代表允许所有IP连接生产环境绝对不能这么写应该精确到内网网段比如192.168.1.0/24。改完配置要重载sudo systemctl reload postgresql如果是Docker容器docker exec my-postgres pg_ctl reload注意修改pg_hba.conf之前先备份。这个文件写错了会导致数据库完全拒绝连接我见过有人把认证方式写成了trust等于任何人都能免密登录这是灾难性的安全漏洞。正确的做法是只放开需要的IP段密码认证一律用scram-sha-256。3.2 配置文件关键参数速查postgresql.conf是PostgreSQL的主配置文件里面有一堆参数新手容易看花眼。我挑几个最关键的说一下每个都附上适用场景。listen_addresses默认是localhost只监听本机。如果要让其他机器连接改成*或者具体IP。生产环境建议写具体IP减少暴露面。port默认5432被占用才改建议保持默认避免各种工具链默认端口失配。max_connections默认100对于开发机够用生产环境要根据应用并发量调整。这个值不是越大越好每个连接都会消耗内存开太多会把内存吃光。经验值是一个连接大约占用2MB10MB内存取决于work_mem和缓存设置所以如果你给PG分配了8GB内存max_connections设到300~500是比较合理的。shared_buffersPostgreSQL的共享缓冲池默认128MB对生产环境太小。经验值是物理内存的25%左右。比如机器有16GB内存设为4GB。注意不要超过内存的一半因为PG还有其他内存消耗操作系统也要留余量。work_mem排序和哈希操作使用的内存默认4MB。这个参数不是越大越好因为它是每个连接每次排序都能用到的。如果100个连接同时做复杂查询work_mem设64MB理论上可能吃掉6.4GB内存。所以这个参数要根据实际查询复杂度和连接数来权衡我一般先保持默认值等出现排序慢的问题时再针对性调大。effective_cache_size告诉优化器操作系统页面缓存有多大默认4GB。本机内存大就设大点这会影响优化器选择索引扫描还是顺序扫描。其实它不分配任何内存只是给优化器参考所以可以放心地设为总内存的50%~75%。wal_level默认replica支持归档和复制够用了。除非你需要逻辑复制或者CDC才需要改成logical。fsync默认on保证崩溃恢复安全千万别关。关掉确实能提升性能但数据库崩溃时很可能损坏数据损失远大于收益。这些参数改了之后重启服务生效sudo systemctl restart postgresql或者用SQL热加载大部分参数pg_reload_conf()但像shared_buffers这类参数必须重启才生效。3.3 设置开机自启与服务管理Linux上通过包管理器安装时服务默认已经在systemd里注册好了只需确认开机自启是打开的sudo systemctl enable postgresqlWindows上PostgreSQL安装器会把服务注册成Windows服务名为postgresql-x64-17默认开机自启。可以在“服务”管理界面里确认启动类型是“自动”。Docker容器的开机自启则要加--restart unless-stopped参数docker run -d \ --name my-postgres \ --restart unless-stopped \ ...这样可以保证Docker守护进程启动时容器跟着起来断电重启也不会手动去拉。4. 常见安装问题与排查技巧实录4.1 端口冲突和启动失败PostgreSQL启动失败最常见的原因就是5432端口被占用。排查顺序sudo ss -tlnp | grep 5432看占用进程是谁。很多时候是之前残留的另一个PostgreSQL实例或者是其他软件霸占了端口。解决办法要么杀掉旧进程要么修改postgresql.conf里的port参数。日志怎么看Debian系在/var/log/postgresql/目录下RHEL系在/var/lib/pgsql/版本/data/log/或者journald里。启动失败时先看日志比瞎猜强一百倍。sudo journalctl -u postgresql-17 --since today4.2 “psql: error: FATAL: database xxx does not exist”这个报错特别常见原因是psql默认连接和你当前系统用户名同名的数据库。比如你系统用户是john直接运行psql它会尝试连接名为john的数据库。解决方法是显式指定用户和数据库psql -U postgres -d mydb或者先切到postgres系统用户再连sudo -u postgres psql -d mydb4.3 认证失败“FATAL: password authentication failed for user”这个问题的排查方向有三个密码确实不对、pg_hba.conf里认证方式和你输入密码的方式不匹配、还有可能是你连错端口连到了另一个实例上。先确认端口psql -h localhost -p 5432 -U postgres然后查看pg_hba.conf里对应IP段的认证方式是scram-sha-256还是md5。如果数据库密码是用旧版本方式设置的可能需要重新设置一次ALTER USER postgres WITH PASSWORD 新密码;4.4 远程连接不上的排查五步法装了PG之后想从另一台机器连过来连不上是最常见的问题。我的排查顺序是第一步确认PG配置允许监听外部地址listen_addresses不是localhost。第二步确认pg_hba.conf里有对应IP段的授权记录。第三步确认服务已重载配置。第四步检查防火墙。Ubuntu的ufw、CentOS的firewalld或者云平台的安全组规则都要放行5432端口。sudo ufw allow 5432/tcp第五步从客户端机器用telnet或nc测试端口通不通nc -zv 服务器IP 5432哪一步不通就排查哪一步基本能解决90%的问题。4.5 误删数据文件怎么办这个场景我见过不止一次——清理磁盘、误删目录然后数据库启动报错“could not open file”。如果数据目录被删了唯一的办法是从备份恢复。如果删的是单个表对应的数据文件而WAL日志还在且开启了归档理论上可以尝试恢复但这非常考验功底成功率不稳定。我强烈建议安装完成后第一时间配置备份至少用pg_dump做逻辑备份有条件就上pgBackRest或barman做物理备份。备份不是可选项是必选项。10分钟不备份一年白干。5. 安装完成后的安全加固与验证清单5.1 三条必做的安全动作第一禁止trust认证。再次核查pg_hba.conf确保没有一行是trust除非是本地socket并且明确知道风险。任何网络连接都必须是scram-sha-256。第二限制超级用户远程登录。生产环境可以创建一个业务专用账号只授予业务所需的库和表权限应用连接用这个账号不直接使用postgres超级用户。SQL如下CREATE USER app_user WITH PASSWORD 强密码; GRANT CONNECT ON DATABASE mydb TO app_user; GRANT USAGE ON SCHEMA public TO app_user; GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO app_user;这样即使应用账号泄露攻击者也没法删库、看其他库的数据。第三关闭不必要的插件和扩展。安装时默认开启的插件用不到就禁掉减少攻击面。这个属于细水长流的维护功夫但安全意识要从安装第一天就开始。5.2 到底装没装成功完整验证checklist安装完成后我习惯按下面的清单过一遍确认万无一失服务状态正常systemctl status postgresql显示active (running)。端口监听中ss -tlnp | grep 5432有输出。本机能连数据库sudo -u postgres psql -c SELECT version();能返回版本号。密码认证可用psql -h localhost -U postgres -W能输密码进入。远程连接测试如需要从另一台机器能正常连上。配置文件语法正确pg_ctl -D /var/lib/postgresql/17/main configtest不报错路径按实际环境改。基本增删改查能跑通建库、建表、插入、查询别偷懒测一轮。最后再分享一个经验每次改完配置文件先跑一遍configtest再重启服务能拦截掉80%的低级错误。这个习惯我养了多年因为重启一次生产数据库要经历各种审批等待提前发现问题省得自己尴尬。5.3 一个容易忽略的测试环境小技巧本地开发环境我建议装一个可视化管理工具pgAdmin 4或者DBeaver都行。pgAdmin 4是官方工具功能全面适合新手DBeaver是通用的数据库客户端界面清爽跨数据库支持好。这些工具配合命令行一起用调试效率会高很多。另外建议把psql的常用操作记录下来。密码这种信息别明文写在脚本里用~/.pgpass文件管理localhost:5432:mydb:app_user:密码文件权限要设为600chmod 600 ~/.pgpass这样psql会自动读取凭据脚本里也不用暴露明文密码。这些细节虽然不属于安装范畴但装好之后第一周就会用到我说在前面省得你走弯路。
阅读完成 · 觉得有帮助？
