19.2 pgAdmin4
警告
本文基于 FreeBSD 14.3-RELEASE。
pgAdmin4 是一款用于管理 PostgreSQL 数据库服务器的开源软件。它提供功能丰富的图形用户界面，便于数据库管理。pgAdmin4 使用 Python 和 JavaScript/jQuery 编写，支持多种操作系统环境（如 Windows、UNIX、Linux 等），可在桌面模式和服务器模式下运行。
注意
在安装 pgAdmin4 前，请先行安装 PostgreSQL 数据库，否则 pgAdmin4 会安装失败。
pgAdmin4 需要在 Python 环境下运行，且安装时需使用 Python 的 pip 工具。因此，应先安装 Python。本文以系统默认的 Python 版本为例进行说明，请注意，FreeBSD 系统可能默认未安装 Python。可通过启动 Python 解释器确认是否已安装：
# python
python: Command not found # 说明当前未安装 python 环境技巧
你可使用以下命令查看显示已安装的 Python 3 版本：
$ python3 -V Python 3.11.12
安装 Python 及 pip
使用 pkg 安装：
# pkg install python devel/py-pip或者使用 Ports：
说明：pip 是 Python 包的包管理器。它用于安装和管理 Python 包和依赖包的关系。
安装配置 virtualenv
virtualenv 的功能是创建虚拟 Python 环境，即为每个项目提供独立的 Python 环境。
本文实际安装过程中是通过 virtualenv 创建独立的 Python 环境来安装 pgAdmin4。
使用 virtualenv 创建独立的 Python 环境。virtualenv 会创建独立的 Python 安装环境，不会使用全局或其他虚拟环境的库。
以下命令用于安装 virtualenv：
使用 pkg 安装：
使用 Ports 安装：
通过运行以下命令创建名为 pgadmin4 的 Python 虚拟环境（virtual environment）：
创建完成后，将显示如下信息：
在 root 用户的根目录下生成了名为 pgadmin4 的虚拟环境（省略其他文件输出）：
安装 sqlite3
使用 pkg 安装：
技巧
注意版本要和 Port
lang/python相同。
或者使用 Ports 安装：
激活 pgadmin4 虚拟环境（命令前须加点 . 和空格）：
你会看到 shell 已经变为（pgadmin4）（以下操作均在该 shell 下进行）：
安装 pgAdmin4
当前 pip 源要求使用 HTTPS，如系统缺少 SSL 证书，则需先安装证书包。
如遇网络问题，可通过更改 pip 镜像源，设置为清华大学镜像源：
安装依赖项，包括 OpenJPEG 库和 Rust 编程语言环境：
安装指定版本的 pgAdmin4（版本 9.4）：
注意
如果内存不足（小于 4GB）且没有 swap，会提示
killed，如出现该问题请先添加交换空间（swap）。
故障排除
如果报错：
是由于时间不正确引发的，使用 ntpdate 同步系统时间到服务器 ntp.api.bz：
配置并运行 pgAdmin4
安装完成后创建 pgAdmin4 本地配置文件，复制 pgAdmin4 配置文件（注意 Python 版本）：
警告
请不要直接将
./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可改应用程序监听的端口。
手动创建 pgAdmin4 数据和日志目录：
配置文件编辑完成后执行以下命令来初始化账号和登录密码。
启动 pgAdmin4 应用：
显示实例如下：
现在我们已经安装并运行了 pgAdmin4，并可以通过 http://ip:5050 访问 Web 控制面板：
箭头所指方向可以切换语言。
保持 pgAdmin4 后台运行
如果服务关闭下次要运行时需使用 pgadmin4 的安装用户（此处是 root）进入根目录，执行如下命令激活 pgadmin4 虚拟环境：
提示：& 表示后台运行
服务启动后，在当前终端中输入 & 并按回车，可将服务切换至后台运行，同时保留前台命令行操作。
升级 pgAdmin4
在本文测试中，直接使用 pip 升级 pgAdmin4 仍可能显示旧版本信息。
pgadmin4 更新频率较高，如需升级要先删除原有用 virtualenv 创建的 pgadmin4 目录然后用安装用户再次执行如下指令，创建名为 pgadmin4 的 Python 虚拟环境：
虚拟目录创建完成后激活 pgadmin4 虚拟环境：
激活后不要开启服务，直接升级 pgAdmin4 到最新版本：
完成升级后启动 pgAdmin4 应用：
登录账户和密码保持不变（登录后不会再提示更新，版本已为最新）。
参考文献
最后更新于
这有帮助吗？