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


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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,542评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,596评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,021评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,682评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,792评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,985评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,107评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,845评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,299评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,612评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,747评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,441评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,072评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,828评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,069评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,545评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,658评论 2 350