Vapor奇幻之旅(07 连接服务端PostgreSQL)

在配置ubuntu16.4服务器上的postgresql数据库时遇到了很多问题，网上查了很多资料，都没有太深的理解。于是我先查看了官方文档，先搞清楚这些配置是做什么的，再根据需要配置自己的服务器，这样就可以清楚的知道自己在做什么了，下面讲讲这些配置是怎样的。

• pg_hba.conf的配置

postgresql的连接配置都是在pg_hba.conf这个配置文件中配置的,可以通过一下命令编辑这个文件。

修改过后需要重启服务才能生效：

sudo service postgresql restart

在此文件中用户校验有以下7种配置方式：

连接类型

• local: 本地连接
• host: 使用TCP/IP连接
• hostssl: 通过SSL加密的TCP/IP连接
• hostnossl:无需加密的TCP/IP连接

database

数据库名称，可以指定特定的数据库名称，也可以设置所有数据库，其中可配置的属性包含：

• 数据库名称
• all: 所有数据库
• sameuser：数据库拥有者访问，也就是需要访问者的名字和数据库的名字要相同。
• samerole： 相同角色访问，需要访问者需要和数据库的角色名相同，如管理员，但是管理员角色不能访问普通角色的数据库。
• replication： 允许复制物理连接

user

用户名称：

• all表示所有用户
• 加前缀+代表用户组（如+support ）
• 多个用户可以用逗号隔开（如Jack, Marry）
• 独立的用户名可以加前缀@

address

客户端匹配的地址规则，可以是一个主机名， 可以是一个ip地址范围，也可以是一些关键词。

下面是一些例子：

• IPv4 172.20.143.89/32 代表一个单独的主机（ip地址后加/32） 172.20.143.0/24 代表一个小型网络 10.6.0.0/16 代表一个大型网络 0.0.0.0/0 代表所有IPv4地址
• IPv6 ::1/128 代表一个单独的主机（ip地址后加/128） fe80::7a31:c1ff:0000:0000/96 一个小型网络 ::0/0 代表所有IPv6地址
• all 表示所有的连接地址和所有连接类型

IP-address IP-mask

从上表可以看出，这种配置只能用在 host, hostssl和hostnossl三种记录中，

例如：

host all all 127.0.0.1 255.255.255.255 trust

255.0.0.0代表8位的CIDR

255.255.255.255代表32位的CIDR

auth-method

postgresql对连接具有多种权限，这样可以用各种方式来安全的连接数据库。

包含的选项如下：

• trust 只要能连接到postgresql数据库的服务器就能够连接数据库，无需密码或其他校验
• reject 拒绝连接，可以用来设置黑名单
• scram-sha-256 通过SCRAM-SHA-256校验来验证用户密码
• md5 通过SCRAM-SHA-256或者MD5校验来验证用户密码
• password 明文密码校验，不建议用于不安全的网络
• gss 使用GSSAPI校验，这种方式只适用于TCP/IP连接
• sspi 使用SSPI校验用户，只适用于windows
• ident 本地用peer代替，获取客户端操作系统的用户名，校验是否匹配数据库的用户名，只适用于TCP/IP连接
• peer 用于本地连接，获取客户端操作系统的用户名，校验是否匹配数据库的用户名
• ldap 使用LDAP服务验证
• radius 使用RADIUS服务验证
• cert 使用SSL客户端证书验证
• pam 使用系统提供的Pluggable Authentication Modules (PAM)服务校验
• bsd 使用系统提供的BSD服务校验

auth-options

=号连接的键值对，用来配置校验方法，如

ident map=omicron

• 配置服务端postgresql

经过对pg_hba.conf中各种配置的解释，我想以下的内容就很好理解了：

1、打开文件

sudo vim /etc/postgresql/10/main/pg_hba.conf

2、修改

local   all             postgres                                     peer

为

local   all             all                                     peer

3、修改

host    all             all             0.0.0.0/0               peer

为

host    all             all             0.0.0.0/0               trust

表示信任所有远程ipv4地址连接

4、最后修改

/etc/postgresql/10/main/postgresql.conf

找到

#------------------------------------------------------------------------------
# CONNECTIONS AND AUTHENTICATION
#------------------------------------------------------------------------------

这一栏，设置

listen_addresses = '*'

表示监听所有ip地址的连接

5、在本地电脑上配置pgAdmin4

image.png

这时就可以连接远程服务器了。

• Trouble Shooting

1、服务端执行psql postgres提示：

psql: FATAL:  role "root" does not exist

这是因为在ubuntu系统安装postgresql的时候，并不会像在Mac OS上那样在root下创建数据库，出于安全考虑，postgresql会创建一个名为postgres的用户，然后创建一个名为** postgres**的数据库，所以上面的讲解都是连接到默认数据库的。那么，怎么才能操作这个额数据库呢？执行以下命令就可以：

$ su - postgres
$ psql postgres

这样就可以进入postgres数据库进行操作了

2、远程连接时出现

could not connect to server:Connection refused Is the server running on host 
"xxx.xxx.xxx.xxx" and acceptation TCP/IP connections on port 5444?

出现这个错误有几个原因:

• 一个原因是未启动数据库服务，启动即可：

sudo service postgresql restart

• 一个原因是ip规则未设置为全局，将pg_hba.conf文件中的127.0.0.1改为0.0.0.0，且postgresql.conf 中修改listen_addresses的值为*

在服务端执行

netstat -ntpl

出现

tcp        0      0 0.0.0.0:5432

和

tcp6       0      0 :::5432

就表示服务端的服务已经开启，且面向外网开放。

• 如果前面的设置都还是连不上，就要检查安全策略了： 检查防火墙，使防火墙允许端口5432:

sudo ufw allow 22

或者关闭防火墙.

更多防火墙设置请用命令查看手册：

man ufw

由于我用的是阿里云，在检查各种设置无果的情况下想到了安全组设置，在控制台添加允许5432端口的入方向即可。

3、其他问题

连接问题通过修改pg_hba.conf和postgresql.conf文件都可以解决，需要加深对不同配置的理解

• 配置vapor项目

在Vapor奇幻之旅(06 PostgreSQL)一文中我介绍了怎么连接到Mac 本地的postgresql数据库，那么现在我们就可以连接远程的数据库了。

首先修改项目中Config/secrets/postgresql.json文件

{
    "hostname": "xxx.xxx.xxx.xxx",
    "user": "postgres",
    "password": "*******",
    "database": "postgres",
    "port": 5432
}

接着运行程序，执行插入和查询操作，可以看到数据成功插入了服务器的数据库中

image.png

到这里，我们成功完成了项目对远程服务器数据库的连接，就此可以打造一个完整的web的接口项目了。

关于Vapor其他知识，可以参考以下文章：

Vapor奇幻之旅(01开始)

Vapor奇幻之旅(02部署)

Vapor奇幻之旅(03上手)

Vapor奇幻之旅(04Routing)

Vapor奇幻之旅(05 Fluent)

Vapor奇幻之旅(06 PostgreSQL)

Vapor奇幻之旅(07 连接服务端PostgreSQL)

Vapor奇幻之旅(08 连接服务端MongoDB)

Vapor奇幻之旅(09 连接MySQL)

希望你对我的教程能够喜欢，你们的赞是我持续的动力，欢迎加入QQ群参与互动：431296189