第 19.2 节 pgAdmin4
警告
本文基于 FreeBSD 14.3-RELEASE。
pgAdmin4 是一款用于管理 PostgreSQL 数据库服务器的开源软件。pgAdmin4 提供了功能丰富的图形用户界面，轻松管理数据库。它是用 Python 和 Javascript/jQuery 编写的。它支持多种环境（如 Windows、Unix、Linux 等），亦可在桌面和服务器模式下使用。
注意
在安装 pgAdmin4 前，请先行安装 PostgreSQL 数据库，否则 pgAdmin4 会安装失败。
pgAdmin4 需要在 python 环境下运行，并且安装时要通过 python 的 pip 进行安装，所以先安装 python。本文用的默认版本是 Python3.8，请注意，FreeBSD 13 系统上默认没有 python 环境。可通过以下命令查看：
# python
python: Command not found # 说明当前未安装 python 环境技巧
你可使用以下命令查看已安装的 Python 版本。
$ python3 -V Python 3.11.12
安装 Python 及 pip
使用 pkg 安装：
# pkg install python devel/py-pip或者使用 Ports：
# cd /usr/ports/lang/python/ && make install clean
# cd /usr/ports/devel/py-pip/ && make install clean说明：pip 是 Python 包的包管理器。它用于安装和管理 Python 包和依赖包的关系。
安装配置 virtualenv
virtualenv 的功能是用来建立虚拟的 python 环境——一个专属于项目的 python 环境。
本文实际安装过程中是通过 virtualenv 创建独立的 Python 环境来安装 pgAdmin4。
使用 virtualenv 创建独立的 Python 环境。Virtualenv 会创建一个自己的 Python 安装的环境，它不支持具有全局或另一个虚拟环境的库。运行以下命令来安装 Virtualenv。
使用 pkg 安装：
# pkg install devel/py-virtualenv使用 Ports 安装：
# cd /usr/ports/devel/py-virtualenv/
# make install clean通过运行以下命令为 pgAdmin4 创建虚拟环境
# virtualenv pgadmin4如果创建完成则有如下显示：
root@ykla:~ # virtualenv pgadmin4
created virtual environment CPython3.11.12.final.0-64 in 607ms
creator CPython3Posix(dest=/root/pgadmin4, clear=False, no_vcs_ignore=False, global=False)
seeder FromAppData(download=False, pip=bundle, setuptools=bundle, via=copy, app_data_dir=/root/.local/share/virtualenv)
added seed packages: pip==25.1.1, setuptools==80.3.1
activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator在 root 用户的根目录下生成了一个名为 pgadmin4 的虚拟环境（输出已省略其他文件）：
# ls
pgadmin4安装 sqlite3
使用 pkg 安装：
# pkg install py311-sqlite3技巧
注意版本要和 Port
lang/python相同。
或者使用 Ports 安装：
# cd /usr/ports/databases/py-sqlite3/
# make install clean激活创建的虚拟环境（注意有个点）：
# . pgadmin4/bin/activate你会看到 shell 已经变为（pgadmin4）（以下操作均在该 shell 下进行）：
(pgadmin4) root@ykla:~ #安装 pgAdmin4
现在 pip 源一律要求使用 https，由于缺少 SSL 证书还需要安装。
(pgadmin4) root@ykla:~# pkg install ca_root_nss由于网络问题，此处对 pip 进行换源，此处使用 TUNA 清华源：
(pgadmin4) root@ykla:~# pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
Writing to /root/.config/pip/pip.conf安装依赖：
(pgadmin4) root@ykla:~# pkg install openjpeg rust然后再安装 pgAdmin4：
(pgadmin4) root@ykla:~# pip install pgadmin4==9.4注意
如果内存不足（小于 4GB）且没有 swap，会提示
killed，如出现该问题请先添加交换空间（swap）。
故障排除
如果报错：
WARNING: Retrying (Retry(total=3, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: certificate is not yet valid (_ssl.c:1136)'))': /simple/pgadmin4/是由于时间不正确引发的，先同步时间：
ntpdate ntp.api.bz
(pgadmin4) root@ykla:~# ntpdate ntp.api.bz
17 Dec 16:35:36 ntpdate[1453]: step time server 114.118.7.161 offset +401965.911037 sec配置并运行 pgAdmin4
安装完成后为 pgAdmin4 创建配置文件，复制 pgAdmin4 配置文件（注意 Python 版本）：
(pgadmin4) root@ykla:~# touch ./pgadmin4/lib/python3.11/site-packages/pgadmin4/config_local.py警告
请不要直接把
./pgadmin4/lib/python3.11/site-packages/pgadmin4/config.py复制为./pgadmin4/lib/python3.11/site-packages/pgadmin4/config_local.py，这样再怎样改动也是无效的，请直接创建空文件。
编辑配置 ./pgadmin4/lib/python3.11/site-packages/pgadmin4/config_local.py。实例如下：
DEFAULT_SERVER = '0.0.0.0'
DEFAULT_SERVER_PORT = 5050DEFAULT_SERVER默认服务器侦听地址更改为0.0.0.0。DEFAULT_SERVER_PORT可改应用程序监听的端口。
手动创建软件目录：
(pgadmin4) root@ykla:~# mkdir -p /var/lib/pgadmin
(pgadmin4) root@ykla:~# mkdir /var/log/pgadmin配置文件编辑完成后执行以下命令来初始化账号和登录密码。
(pgadmin4) root@ykla:~# pgadmin4显示实例如下：
NOTE: Configuring authentication for SERVER mode.
Enter the email address and password to use for the initial pgAdmin user account:
Email address: your_email # 输入你的邮件地址
Password: your_new_password # 输入你的登录密码，最少 6 位数；同样不会打印密码，也不会是 ***
Retype password: # 再次输入密码
pgAdmin 4 - Application Initialisation
======================================
Starting pgAdmin 4. Please navigate to http://0.0.0.0:5050 in your browser.
* Serving Flask app 'pgadmin'
* Debug mode: off现在我们已经安装并运行了 pgAdmin4，并可以通过 http://ip:5050 访问 Web 控制面板：
箭头所指方向可以切换语言。
保持 pgAdmin4 后台运行
如果服务关闭下次要运行时需使用 pgadmin4 的安装用户（此处是 root）进入根目录，执行如下命令：
root@ykla:~# . pgadmin4/bin/activate
(pgadmin4) root@ykla:~# pgadmin4 &提示：& 表示后台运行
服务启动后在当前界面中输入 & 按回车键，可切换至前台命令行，让服务程序在后台运行。
升级 pgAdmin4
本文测试如果直接使用 pip 升级后还是提示旧版本。
pgadmin4 更新频率较高，如需升级要先删除原有用 virtualenv 创建的 pgadmin4 目录然后用安装用户再次执行如下指令：
root@ykla:~# virtualenv pgadmin4虚拟目录创建完成后激活
root@ykla:~# . pgadmin4/bin/activate激活后不要开启服务，直接执行升级
(pgadmin4) root@ykla:~# pip install --upgrade pgadmin4完成升级后启动服务
(pgadmin4) root@ykla:~# pgadmin4登录账户和密码还是原来的 (登录后再无更新提示，查看版本已是为最新)。
参考文献
最后更新于
