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

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

  • pg_hba.conf的配置

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

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

sudo service postgresql restart

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

连接类型 数据库 用户名 数据库地址 校验方式
local database user auth-method [auth-options]
host database user address auth-method [auth-options]
hostssl database user address auth-method [auth-options]
hostnossl database user address auth-method [auth-options]
host database user IP-address IP-mask auth-method [auth-options]
hostssl database user IP-address IP-mask auth-method [auth-options]
hostnossl database user IP-address IP-mask auth-method [auth-options]

连接类型

  • 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


Vapor奇幻之旅(07 连接服务端PostgreSQL)_第1张图片
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
}

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


Vapor奇幻之旅(07 连接服务端PostgreSQL)_第2张图片
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

你可能感兴趣的:(Vapor奇幻之旅(07 连接服务端PostgreSQL))