★ FEATURED ARTICLE 1. 安装之前先想清楚这三件事做数据库安装这类事情最忌讳的就是上来就敲命令。我见过不少同事在Windows上把安装包一路Next装完连初始密码都没记住就关掉了窗口等到要用的时候连本地连接都进不去。PostgreSQL虽然以稳定和功能强大著称但它的安装方式比其他数据库要更“手工”一些很多细节在安装向导里不会主动提醒你。这篇教程里我会把我在Linux、Windows和macOS三个平台上的安装过程完整复盘一遍包括每个步骤为什么会这么做、哪些参数必须提前想好以及装完之后别急着走、还要做的几件收尾事。不管你是刚接触数据库的新人还是需要在服务器上部署一套生产环境的开发者这篇文章都应该能帮你少走几趟弯路。1.1 PostgreSQL的版本选择别只看“最新”很多人的第一反应是装最新版这个思路放在个人练习项目里没问题但如果部署到生产环境我的建议始终是“选中庸版本”。PostgreSQL的版本号规则很简单主版本号每年发布一次比如16、17这种次版本号则是安全修复和小补丁。官方维护策略是每个主版本发布后维护五年左右所以一个刚出来的新主版本虽然功能很新但很多周边生态、监控工具、备份工具未必已经做了完整适配。我更推荐的做法是先确认你计划使用的ORM、数据库连接池、可视化客户端对哪个主版本的兼容性最好再确认你的操作系统自带软件源里默认是哪个版本最后通过官方源或二进制包来安装那个版本。如果你在Linux上已经有比较老的发行版自带源里的PostgreSQL往往会比最新版落后好几个主版本这时就需要自己配置官方软件源。1.2 三个主流平台的安装方式差异不同平台的安装思路差异很大Linux最灵活有两种主流方式一种是用发行版自带的包管理器直接装另一种是下载官方源码自己编译。前者省事后者适合需要定制编译参数、离线环境部署的场景。Windows官方提供图形化安装包双击后跟着向导走即可安装过程会顺带帮你注册成Windows服务开机自启也帮你配好。需要注意的是安装向导的每一步都有坑比如让你设置超级用户密码、选择端口号、指定数据目录这些都不能跳过或乱选。macOS官方推荐用Postgres.app这种绿色应用或者用Homebrew安装。Homebrew最方便也能直接把PATH配好适合开发机。我在后面的章节会把每个平台的操作细节都展开讲这里先记住一个大原则无论哪个平台数据目录和日志文件的存放位置都要在安装前想好而不是用默认值到底。1.3 我建议先在Linux上做一次完整安装如果你对PostgreSQL完全陌生我一开始就建议你先在Linux服务器上完整走一遍安装流程原因是Linux的各种安装记录、配置文件路径、服务管理方式查阅资料最容易而且踩坑后的报错信息也最直观。等你在Linux上理解了整个体系再回到Windows或macOS会轻松很多。当然如果你手边只有一台Windows电脑那就直接用Windows安装包起步后面我会匹配对应的说明。我的整体举例会以Linux为主其他平台单独分块讲因为它最能讲清楚整个安装逻辑。2. Linux环境下把两条路线都走通Linux下安装PostgreSQL最常见的两条路线是用系统包管理器直接安装以及用源码编译安装。两者不是谁替代谁的关系而是应用场景不同。我先把两条路线都演示一遍再告诉你什么情况选哪条。2.1 包管理器安装最快但版本不一定新以某Debian系发行版为例系统自带源里的包名通常是postgresql但因为自带的版本往往比较旧我更推荐先加官方软件源。# 先安装一些基础工具 sudo apt update sudo apt install -y wget ca-certificates # 添加官方软件源的仓库配置 sudo install -d /usr/share/postgresql-common/pgdg sudo wget -O /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc https://www.postgresql.org/media/keys/ACCC4CF8.asc # 把软件源写进apt源列表 echo deb [signed-by/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main | sudo tee /etc/apt/sources.list.d/pgdg.list # 刷新源并安装指定版本 sudo apt update sudo apt install -y postgresql-16安装完成后包管理器会自动创建一个名为postgres的系统用户以及一个同名的默认数据库用户还会在/etc/postgresql/16/main/目录下生成配置模板数据目录则默认在/var/lib/postgresql/16/main。如果你用的是某红帽系发行版官方软件源的配置方式不同但逻辑一样也是下载官方repo文件再安装。唯一要注意的是红帽系发行版默认开启SELinux安装后如果是自定义数据目录需要额外处理SELinux的上下文标签否则服务启动会被拦截。这部分安装完先别急着连库直接用包管理器装的PostgreSQL默认是“只监听本地回环地址且仅允许本地以trust方式认证”这个状态在生产环境下不安全后面初始化配置章节会专门讲怎么改。2.2 源码编译可控性最强但别忽略依赖源码编译适合两类人一类是需要自定义安装路径、把数据目录放到独立磁盘上的另一类是离线环境里必须从本地包安装的。源码编译其实不复杂但前提是依赖库要齐全。# 安装编译需要的依赖 sudo apt install -y build-essential libreadline-dev zlib1g-dev flex bison # 下载源码包 wget https://ftp.postgresql.org/pub/source/v16.4/postgresql-16.4.tar.gz tar -zxvf postgresql-16.4.tar.gz cd postgresql-16.4 # 配置编译选项--prefix指定安装目录 ./configure --prefix/opt/pgsql16 make -j$(nproc) sudo make install源码安装后默认不会生成postgres用户需要手动创建sudo useradd -m -d /home/postgres -s /bin/bash postgres sudo mkdir -p /opt/pgsql16/data sudo chown postgres:postgres /opt/pgsql16/data然后切换到这个系统用户初始化数据目录sudo -u postgres /opt/pgsql16/bin/initdb -D /opt/pgsql16/data -U postgres --encodingUTF8 --localeen_US.UTF-8initdb是初始化数据目录的核心命令它的作用是在空目录里创建PostgreSQL的系统表、模板数据库和配置文件。-U postgres指定数据库超级用户的名称--encodingUTF8和--locale决定了数据库的字符集和排序规则这两个参数直接影响后面存储中文等非ASCII字符时的行为建议提前设好避免数据库建完才发现编码不对又要重建。源码安装的启动方式也更原始没有自动注册系统服务需要手动用pg_ctl命令操作或者自己写一份systemd服务文件。如果你只是装在自己的电脑上研究直接前台启动也行sudo -u postgres /opt/pgsql16/bin/pg_ctl -D /opt/pgsql16/data -l /opt/pgsql16/logfile start2.3 包管理器和源码编译怎么选我把两条路线的取舍用表格整理一下方便你对照自己的情况做决策对比维度包管理器安装源码编译安装安装速度快几分钟内完成慢视机器性能约10-30分钟版本控制随发行版或官方源控制完全自己决定定制能力低安装路径和参数相对固定高可自定义路径、编译参数系统集成好自动注册服务、创建用户差需要手动配置系统用户和服务维护方式通过包管理器统一升级需要手动重新编译或使用二进制包适合场景大多数服务器部署、学习环境离线部署、特殊路径、嵌入式设备我个人在给生产服务器部署时九成情况会选包管理器加官方源因为后续升级、打安全补丁实在太方便了。源码编译通常留给那些需要把数据库装到非标准路径的特定场景比如配合其他软件打包发布。3. Windows和macOS的安装器用法这两个平台在开发者和个人电脑上很常见虽然不负责生产环境的大头但作为日常开发、本地调试的数据库完全够用。两个平台各有各的“官方推荐方式”照着走基本不会出错但有一些细节值得单独说一说。3.1 Windows安装向导中容易被跳过的三个选项Windows下官方提供的是一个基于图形界面的安装程序双击运行后会一路引导你设置安装目录、数据目录、超级用户密码、端口号等。整个向导里有三个选项我会建议你认真思考第一个是安装目录。很多人习惯用默认路径也就是C:\Program Files\PostgreSQL\16但如果你C盘空间紧张或者你有独立的数据盘建议把安装目录改到非系统盘。不过要注意路径中不要包含中文或空格否则后期某些脚本和工具处理路径时容易出现奇怪的问题。第二个是数据目录。默认是C:\Program Files\PostgreSQL\16\data这也是很多人安装后磁盘怼满的根源。数据库的表数据、索引、WAL日志都放在这个目录下建议单独放在一个容量充足的磁盘分区里。后期想挪目录也能做但流程比现在直接设置要麻烦不少为什么不从源头就避免呢。第三个是超级用户密码。安装向导会让你设置PostgreSQL超级用户postgres的密码这个密码必须记牢不像很多软件能“找回密码”PostgreSQL的超级用户密码如果忘了只能通过修改配置文件、重启服务、以本地信任方式登入后重置过程繁琐而且有一定安全风险。向导走到最后一步会让你选择安装为Windows服务并设置开机自启。个人开发机可以勾选生产环境的Windows服务器建议先不勾选等系统防火墙规则和服务账户权限都准备好之后再手动注册服务更稳妥。3.2 macOS上Homebrew安装需要注意的环境变量macOS上最常用的安装方式是Homebrew命令非常简单brew install postgresql16用Homebrew安装的好处是安装过程自动把二进制文件软链到了/usr/local/bin或/opt/homebrew/bin下终端里直接敲psql就能用。但有一个细节要注意Homebrew默认安装的是“不随开机自动启动”的版本需要手动执行一条命令让它常驻后台brew services start postgresql16如果不执行这一步每次重启机器后你得自己手动启动PostgreSQL。开发机用着用着发现数据库连不上了多半就是忘了开机启动这回事。Homebrew安装的版本数据目录默认在/opt/homebrew/var/postgresql16Apple Silicon芯片)或/usr/local/var/postgresql16Intel芯片这在后续备份和迁移时很重要记住这个路径就行。安装完成后终端里直接敲psql -d postgres就能进入数据库命令行因为Homebrew默认创建了一个和当前系统用户名相同的超级用户并且认证方式是本地trust。如果你不想暴露这个默认用户可以在初始化时指定# 如果需要手动初始化可以这样指定超级用户和编码 initdb --usernamepostgres --encodingUTF8 --localeen_US.UTF-8 /opt/homebrew/var/postgresql16不过要注意Homebrew的安装脚本通常已经帮你做了初始化手动initdb前需要确保目标目录是空的否则会报“目录非空”的错误。3.3 安装器装完之后先别急着关窗口无论是Windows还是macOS图形安装器或者Homebrew结束后终端里都要马上做一件事情——验证是否真的装好了。我最常看到的情况是安装过程报“Success”结果一敲psql提示找不到命令原因多半是PATH没有生效。Windows下需要手动把C:\Program Files\PostgreSQL\16\bin加到系统PATH环境变量里然后重开一个终端。macOS下如果用的安装器而非Homebrew也需要检查/Library/PostgreSQL/16/bin是否在PATH中。验证方式很简单psql --version pg_config --version两条命令都能输出版本号才算安装路径配置成功。这两条命令还是后续日常运维的基础几乎每天都会用到。4. 初始化配置改密码、开远程、验证连接不管用哪种方式装的PostgreSQL安装完成之后系统已经帮你初始化好了数据目录并且能通过本地socket连接。但“能连”距离“能用”之间还有几步关键配置很多人就是在这里踩了跟头所以我单独开一章详细说明。4.1 先改超级用户密码如果你是用官方安装器装的向导里会让你设置密码这步可以略过。但如果是通过源码编译或某些脚本化方式安装的初始化后超级用户postgres可能没有密码或者密码为空。这时第一步就要进入数据库改密码# 在Linux下切换到postgres用户 sudo -i -u postgres psql进入psql交互界面后执行ALTER USER postgres WITH PASSWORD 你的新密码;这里的密码策略建议至少12位混合大小写字母、数字和特殊字符。很多初始化脚本只设了简单密码导致服务器刚上线就被扫描爆破这就是最常见的数据库安全事件入口。顺便说一句如果你用源码编译的方式安装并且没有设置系统用户postgres的密码建议也设置一下因为数据库服务本身就是以这个系统用户运行的。4.2 修改监听地址允许远程连接PostgreSQL安装后默认只监听localhost也就是只能从本机连接。如果你需要在另一台机器上用客户端连过来要改两个配置文件postgresql.conf和pg_hba.conf。先打开postgresql.conf找到下面这行#listen_addresses localhost把它改成listen_addresses *如果你有固定的内网IP比如192.168.1.100也可以改成具体的IP只允许从那个网卡进来安全上更稳妥。生产环境我一般不建议直接监听所有地址而是监听内网地址。然后打开pg_hba.conf这个文件是“客户端认证控制文件”它决定了哪些IP来源可以用什么方式连接。默认配置里通常只有localhost和127.0.0.1的记录你需要追加一行host all all 192.168.1.0/24 scram-sha-256这行的含义是允许来自192.168.1.0/24网段的客户端以scram-sha-256加密方式认证连接所有数据库。scram-sha-256是目前推荐的安全认证方式不要用老旧的md5更不能用trust——trust意味着完全信任对方不需要密码就能进只适合本机调试。改完两个文件重启服务让配置生效# Linux systemd sudo systemctl restart postgresql # 源码安装的 sudo -u postgres /opt/pgsql16/bin/pg_ctl -D /opt/pgsql16/data restart # Windows net stop postgresql-16 net start postgresql-16 # macOS Homebrew brew services restart postgresql164.3 开放防火墙端口这一步很容易被忽略服务已经监听0.0.0.0了但你从外部连不上很可能就是防火墙把5432端口挡住了。Linux下sudo firewall-cmd --permanent --add-port5432/tcp sudo firewall-cmd --reload某些发行版使用ufw的话sudo ufw allow 5432/tcpWindows下需要在“Windows Defender防火墙”里添加入站规则放行TCP 5432端口。macOS一般默认不拦但如果打开了系统防火墙也要在“防火墙选项”里允许postgres进程接受传入连接。端口开放后建议从另一台机器测试一下端口通不通telnet 服务器IP 5432如果能看到PostgreSQL的版本字符串返回说明端口和服务都已经正常工作了。4.4 验证连接psql的三种连接方式配置完成后可以通过psql验证连接是否正常。我习惯用三种方式测试覆盖本机、局域网和指定数据库几种场景# 方式一本机通过Unix socket连接 psql -U postgres -d postgres # 方式二本机通过TCP连接 psql -h 127.0.0.1 -p 5432 -U postgres -d postgres # 方式三远程连接 psql -h 192.168.1.100 -p 5432 -U postgres -d postgres输入正确的密码后如果看见postgres#这样的提示符说明连接成功。此时可以用一条简单SQL验证版本和当前时间SELECT version(); SELECT now();这不仅能确认数据库活着也能确认时区配置是否正确。如果now()返回的时间和服务器本地时间不符多半是postgresql.conf里的timezone没有设置成Asia/Shanghai之类的本地时区。5. 安装后的日常运维与常见问题安装完成、连接验证通过这只是上半场。真正让PostgreSQL“跑得稳”的是安装完成后那几分钟的运维配置。我做了这么多年总结下来最值得做的几件事就写在这里。5.1 设置开机自启包管理器安装的版本基本都自动注册了服务但源码编译安装的不会要手动写一份systemd服务文件。下面是参考配置[Unit] DescriptionPostgreSQL database server Afternetwork.target [Service] Typenotify Userpostgres Grouppostgres ExecStart/opt/pgsql16/bin/postgres -D /opt/pgsql16/data ExecReload/bin/kill -HUP $MAINPID KillModemixed TimeoutSec300 [Install] WantedBymulti-user.target保存为/etc/systemd/system/postgresql.service后执行sudo systemctl daemon-reload sudo systemctl enable --now postgresqlWindows安装器在安装时可以选择注册服务并设为自动启动macOS用brew services start即可。这件事一定要装完马上做不然哪天机器重启了数据库起不来你还在那排查半天最后发现只是没设置自启。5.2 数据和日志的备份策略很多人安装完就开始建表写数据却完全没考虑备份。PostgreSQL的数据备份思路主要有两种逻辑备份用pg_dump物理备份用归档和流复制来实现。对于个人开发机或小规模应用pg_dump足够pg_dump -h localhost -U postgres -d 数据库名 -F c -f 备份文件.dump恢复时pg_restore -h localhost -U postgres -d 目标数据库 备份文件.dump我建议每周至少做一次全量备份每天做一次增量归档具体频率看你接受丢失多少数据。如果你用的是云服务器还可以配合对象存储把备份文件自动同步到异地去成本很低但换来的保障很大。另外PostgreSQL的日志默认输出到系统日志或logfile不会自动轮转。建议在postgresql.conf里开启日志收集并设置轮转参数logging_collector on log_directory log log_filename postgresql-%Y-%m-%d.log log_rotation_age 1d log_rotation_size 10MB这样日志会按天和大小自动切割排查问题时也能快速定位到具体日期的日志文件。5.3 安装后最容易踩的三个坑第一初始密码丢失或未设置。这是最高频的问题尤其是Windows安装器弹出来一个密码输入框有人顺手点了取消或直接关掉导致后续连接失败。解决办法是进入数据目录临时把pg_hba.conf里的认证方式改成trust重启服务登进去改密码再改回scram-sha-256重启服务。这个流程网上有很多描述但有一点很多人没提改回scram-sha-256后如果还连接失败检查一下密码是否包含特殊字符被终端转义了用psql的-W参数提示输入密码会避免这类问题。第二端口被占用。PostgreSQL默认用5432端口如果你机器上还跑着其他数据库或服务可能冲突。启动时会报“FATAL: could not bind socket”之类错误。这时候要么换个端口要么找到占用进程处理掉。顺便提醒一句如果你为了让别人猜不到而换成非常规端口记得在连接字符串里显式指定端口否则默认5432会连不上。第三时区和编码问题。初始化时没有指定--encodingUTF8和--locale的数据库可能出现中文字符乱码、排序异常等问题。数据量少时重建数据库还来得及生产环境数据多了再改编码代价就是完整的迁移流程。所以我在前文反复强调初始化时这两项要提前设好。5.4 要不要装图形化管理工具这是一个老生常谈的问题后台也经常有人问。我的回答是命令行必须会图形工具可以做辅助。PostgreSQL的命令行工具psql非常强大脚本化运维、备份恢复、批量执行都离不开它。但日常开发中看表结构、看数据内容、写复杂JOIN查询图形工具的体验确实顺滑很多。开源工具里比较推荐的是DBeaver和pgAdmin前者连接多种数据库都很方便后者是PostgreSQL官方周边工具。两个都免费装一个就行不用两个都装。无论用哪个图形工具底层连接方式和我上面讲的一样都需要主机地址、端口、数据库名、用户名和密码这五个要素。如果连不上回过头检查我前面讲的监听地址、pg_hba.conf和防火墙这三处九成问题都出在这。6. 从安装到交出一份可用的库写到这里整套安装流程已经走得差不多了。最后我想用比较短的篇幅把安装成功之后的那一小时内值得做的事串一遍。很多人问“装完之后到底该干什么”其实答案很简单建库、建用户、做权限隔离。生产环境里我非常不建议直接在postgres超级用户下建业务表因为超级用户权限太大一旦业务连接信息泄露攻击者能直接操作整个数据库实例。更合理的做法是单独创建一个业务用户只授予它特定数据库的权限# 创建业务数据库 sudo -u postgres createdb exampledb # 进入psql创建用户并授权 sudo -u postgres psqlCREATE USER app_user WITH PASSWORD 强密码; GRANT CONNECT ON DATABASE exampledb TO app_user; GRANT ALL PRIVILEGES ON DATABASE exampledb TO app_user;如果业务库里有多个schema还需要按schema维度进一步授权这是另一个大话题。但做到这一步你的PostgreSQL已经是一个可供业务正常使用的稳定实例而不是一台裸装的软件了。在这个过程里我个人的习惯是从不跳过配置文件的每一项。PostgreSQL的好处是所有行为都可配置、可追踪坏处也是配置文件太多容易让人眼花缭乱。但只要你抓住postgresql.conf服务运行参数和pg_hba.conf认证规则这两个核心其他大部分场景可以后置到真正需要时再去研究。安装不是一口气吃成胖子先把基础打牢后续的调优、高可用、备份恢复都是水到渠成的事。
阅读完成 · 觉得有帮助？
