前阵子有个朋友问我，pgAdmin 4到底怎么连数据库。他折腾了一下午，界面打开了，服务器信息也填了，就是连不上。我问他报什么错，他说“could not connect to server: Connection refused”。这种错误，做数据库的人基本都遇到过。pgAdmin 4虽然是 PostgreSQL 官方推荐的图形化管理工具，但初次上手，坑确实不少。咱们今天就把这事说清楚，从安装到连接，每一步都掰开揉碎地讲。
先说说 pgAdmin 4 的安装。很多新手会直接在官网下载安装包，一路点“下一步”就完事了。但这里有个细节容易被忽略——pgAdmin 4 有桌面版和 Web 版两种模式。桌面版是独立的应用程序，双击就能跑；Web 版运行在浏览器里，需要先启动一个服务进程。如果你只是本地开发用，桌面版最省事；如果要远程管理服务器，Web 版更方便，因为可以通过浏览器访问，不用在每台机器上都装客户端。我建议新手先从桌面版入手，等熟悉了再考虑 Web 版。安装时注意版本匹配：Windows 系统直接下载 exe 文件，Mac 用 dmg 包，Linux 用户则可以通过 apt 或 yum 安装。装完后，第一次启动会让你设置一个主密码，这个密码用于保护你保存的数据库连接信息，别设得太简单，也别忘了。
安装完 pgAdmin 4，接下来就是创建服务器连接。打开界面，左侧面板有个 “Servers” 的树形结构，右键点击它，选择 “Create → Server”。这时会弹出一个对话框，需要填一堆信息。很多人看到这个对话框就懵了，因为里面密密麻麻的选项卡：General、Connection、SSL、SSH Tunnel、Advanced。别慌，大部分保持默认就行，真正需要填的只有 Connection 选项卡里的几项。Name 随便起个名字，比如 “本地测试库”；Host name/address 填 IP 地址，如果是本机就填 localhost 或 127.0.0.1；Port 默认是 5432，如果改了端口就填你设置的那个；Maintenance database 填 postgres，这是默认的管理数据库；Username 填 postgres，Password 填对应的密码。填完这些，点 Save 保存，应该就能连上了。
但很多时候，你填完信息点 Save 后，却看到熟悉的 “Connection refused” 错误。这通常不是 pgAdmin 4 的问题，而是 PostgreSQL 服务器本身没配置好。默认情况下，PostgreSQL 只监听 localhost 地址，也就是只允许本机连接。如果要远程连接，需要修改配置文件 postgresql.conf，找到 listenaddresses 那一行，改成 listenaddresses = '*'，表示监听所有网络接口。改完后重启服务，再用 pgAdmin 4 连接试试。另外还有一个文件 pg_hba.conf，控制客户端访问权限。如果里面没有为你的 IP 地址添加规则，也会被拒绝。比如想让所有 IP 都能连接，可以在文件末尾加一行 ，但这只建议在开发环境使用，生产环境要严格限制 IP 范围。
再说说 SSL 连接的问题。有些数据库服务器强制要求 SSL 加密连接，比如云服务商提供的 PostgreSQL 实例。这种情况下，你在 pgAdmin 4 里需要勾选 SSL 选项卡，把 “SSL mode” 设置成 “require” 或 “verify-full”。如果是自签名证书，还得把 CA 证书文件上传到 pgAdmin 4。很多人卡在这一步，是因为不知道证书文件放在哪里，或者格式不对。通常云服务商会提供一个 .pem 或 .crt 文件，你把它下载到本地，然后在 SSL 选项卡里找到 “Root certificate”，选择该文件即可。如果仍然连不上，检查 SSL mode 是否选对。有时 “require” 就够，有时必须选 “verify-full” 才能通过验证。
除了普通的 TCP/IP 连接，还有一种情况是通过 SSH 隧道连接数据库。比如你有一个远程服务器，为了安全起见，数据库只允许本地连接，不允许外部直接访问。这时就需要先 SSH 登录到服务器，再通过隧道连接数据库。pgAdmin 4 支持这种模式，只需在创建服务器连接时切换到 SSH Tunnel 选项卡，填上 SSH 主机的 IP、端口、用户名和密码（或密钥文件）。这样 pgAdmin 4 会先建立 SSH 连接，再通过隧道去连接数据库。好处是即使数据库没有开启远程访问，你也能安全地管理它。缺点是 SSH 本身不稳定，网络不好时会频繁断开重连，使用时要注意。
连接成功后，pgAdmin 4 的界面其实挺友好的。左侧面板会展开显示你的服务器，下面有 Databases、Tablespaces、Login/Group Roles 等节点。双击 Databases 就能看到所有数据库的列表。如果想执行 SQL 查询，右键点击某个数据库，选择 Query Tool，就会打开一个 SQL 编辑器。这里有个小技巧：可以同时打开多个查询窗口，每个窗口独立运行，互不干扰。另外，pgAdmin 4 还提供了图形化的表结构设计工具，右键点击某个表，选择 Properties，就能看到字段、索引、约束等信息，还能直接修改。对于不熟悉 SQL 语句的新手来说，这种可视化操作能省不少事。
说一点，pgAdmin 4 本身是个挺“重”的工具，启动慢、内存占用高，有时会卡顿。如果你只是临时查个数据，或者执行简单的 SQL 语句，完全可以用命令行工具 psql，轻量又快速。但如果需要频繁查看表结构、编写复杂查询、管理多个数据库，pgAdmin 4 的图形界面确实能提高效率。工具的选择最终还是看使用场景。就像有人喜欢用筷子，有人喜欢用刀叉，没有绝对的好坏，只有是否适合。掌握了 pgAdmin 4 的连接方法，你已经迈出了管理数据库的第一步，剩下的就是在实践中慢慢摸索了。
