pgAdmin4 CentOS7部署

一、前言

实习老板要求我开发一个PostgreSQL的数据库管理工具，要求是B/S型。我当场疑惑，这不是安装的时候就自带一个pgAdmin4，而且完美符合他的要求吗？一问之下才发现，原来数据库在公司里一直是部署在Linux(CentOS7)上的，一方面Linux上默认不装图形界面，另外大家也习惯用Navicat去做连接，所以才会提出这个需求。

好家伙，这不是白给？然而当我尝试在虚拟机中部署pgAdmin4的时候才发现，网上（包括Google）的一众教程，没一个能一遍顺下来的的，多多少少有点问题。我总结了一下部署流程中遇到的问题，希望能给有需要的人提供帮助。

二、安装流程

以下的安装流程，参考的是这篇文章，修正了其中的一些问题（或者说指出了一些注意事项），但流程不变。

2.1 安装pgAdmin4

首先需要添加包含PostgreSQL一系列软件的rpm源。这一步应该在安装PostgreSQL时就已经做过了，以下的安装流程也是建立在已经安装好PostgreSQL的前提下进行的。

sudo yum -y install epel-release
sudo yum -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo yum -y update

确保rpm源安装过后，就可以安装pgadmin4了

sudo yum -y install pgadmin4

2.2 配置Apache服务器

pgadmin4是Web Based的Python程序，所以需要用Apache服务器，使用yum安装时会解决这些环境问题。下面需要配置服务器设置：

sudo cp /etc/httpd/conf.d/pgadmin4.conf.sample /etc/httpd/conf.d/pgadmin4.conf

首先复制一个（修改后缀）自动生成的样例文件，然后将其改为如下内容（不建议copy）:

<VirtualHost *:80>
ServerName pgadmin.example.com
LoadModule wsgi_module modules/pgadmin4-python3-mod_wsgi.so
WSGIDaemonProcess pgadmin processes=1 threads=25
WSGIScriptAlias /pgadmin4 /usr/lib/python3.6/site-packages/pgadmin4-web/pgAdmin4.wsgi

<Directory /usr/lib/python3.6/site-packages/pgadmin4-web/>
	WSGIProcessGroup pgadmin
	WSGIApplicationGroup %{GLOBAL}
	<IfModule mod_authz_core.c>
		# Apache 2.4
		Require all granted
	</IfModule>
	<IfModule !mod_authz_core.c>
		# Apache 2.2
		Order Deny,Allow
		Deny from All
		Allow from 127.0.0.1
		Allow from ::1
	</IfModule>
</Directory>
</VirtualHost>

这里我说不建议copy的原因是python版本可能不一样，你只需要添加<VirtualHost *:80>、ServerName xxx.com和</VirtualHost>这三行就可以了。修改完毕后检查一下是否符合httpd的语法要求，然后就可以启动Apache服务了。

sudo httpd -t

sudo systemctl restart httpd

2.3 建立数据保存路径

sudo mkdir -p /var/lib/pgadmin4/ /var/log/pgadmin4/

修改这两个文件夹的权限，让Apache服务器能够写入数据：

sudo chown -R apache:apache /var/lib/pgadmin4 /var/log/pgadmin4

2.4 修改config_local.py

这里要注意，包括我一开始贴出的参考教程，他们写的版本都是python2.7。至少对于我而言这是不对的，我使用yum安装后pgadmin4-web是在python3.6的路径中的，要以/usr/lib/python(2.7或3.x)/site-packages/pgadmin4-web这个文件夹所在位置为准（或者你可以去看看前面pgadmin4.conf中的路径）。

sudo gedit /usr/lib/python3.6/site-packages/pgadmin4-web/config_distro.py

在其中添加以下路径设置：

LOG_FILE = '/var/log/pgadmin4/pgadmin4.log'
SQLITE_PATH = '/var/lib/pgadmin4/pgadmin4.db'
SESSION_DB_PATH = '/var/lib/pgadmin4/sessions'
STORAGE_DIR = '/var/lib/pgadmin4/storage'

2.5 创建pgadmin登录用户

在config_local.py的同目录下有一个setup.py，这是用来创建用户的。

sudo python3 /usr/lib/python3.6/site-packages/pgadmin4-web/setup.py

输入一个邮箱和密码即可创建用户。

这里一定要调用正确版本的python，一般Linux都会自带python2，如果用python2去调用上述语句会出现语法错误（input邮箱后会报Syntax Error）。这里可能还会遇到一些包依赖问题，在下面的常见错误中我会总结。

2.6 SElinux配置

这玩意在虚拟机里我都关掉，但是真的部署估计会需要开启，那么需要做如下设置：

sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/lib/pgadmin4(/.*)?"
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/log/pgadmin4(/.*)?"
sudo restorecon -R /var/lib/pgadmin4/
sudo restorecon -R /var/log/pgadmin4/
sudo systemctl restart httpd

2.7 防火墙通行

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --reload

2.8 运行

在浏览器中输入以下格式去使用pgAdmin4：http://localhost/pgadmin4或者http://ip_address/pgadmin4

三、常见错误

这里我也只能总结一些我遇到过的问题，如果你有其他问题可以在评论中写出来。

3.1 setup.py依赖错误

一开始我没有意识到python版本的问题，所以在2.5步中我用python2.7去运行的setup.py，我遇到了一个报错：No module named builtins。
这个问题可以通过pip install future解决。

我不清楚一开始就用python3调用会不会有这个问题，但如果你遇到了，也可以用上面的方法解决。

3.2 运行问题

在我给出的参考教程中，他最后提供的启动方法是：http://pgadmin.example.com/pgadmin4，中间的部分应该是在/etc/httpd/conf.d/pgadmin4.conf中添加的ServeName，但是我实测这种方法无法启动，也许我还有一些配置没有完成。我实测只有回环地址127.0.0.1，localhost，和本机内网ip三种方式可以启动。

3.3 Internal Server Error

为了确保该教程有效，我又在阿里云服务器上测试了一次，发现走一遍下来，浏览器跳转后会提示：Internal Server Error。首先这说明Apache服务器配置是有效的，不然会提示没有该服务或者无权限访问，然后就是解决问题。

我确认了一遍文件中的内容和虚拟机中一致，所以最后又再次修改了log和lib的权限就好了。

sudo chown -R apache:apache /var/lib/pgadmin4 
sudo chown -R apache:apache /var/log/pgadmin4

我现在无法确认是写在同一行没有生效，还是不应该在创建文件夹后立即修改权限。但如果你遇到了这个问题，修改权限可以解决。