Debian迁移pgAdmin数据的正确做法
一、先明确迁移对象
- pgAdmin配置与元数据：指pgAdmin自身的配置、服务器/连接列表、用户偏好等。Debian上常见路径为：/etc/pgadmin4/（配置）与**/var/lib/pgadmin/**（数据与会话存储）。迁移这些目录即可在新机器上保留原有布局和连接信息。
- 被管理的PostgreSQL数据库：指业务数据本身。迁移它们与pgAdmin无关，可用pg_dump/pg_restore或pgAdmin的导出/导入工具完成，目标库需提前建好且版本兼容。
二、迁移pgAdmin配置与元数据（保持连接与布局）
- 在源机器准备备份（建议停机或确保无写入）：
- 配置文件：sudo tar czf pgadmin4-conf-$(date +%F).tar.gz -C /etc/pgadmin4 .
- 数据与存储：sudo tar czf pgadmin4-data-$(date +%F).tar.gz -C /var/lib/pgadmin .
- 将备份传输到目标Debian机器（示例）：
- scp pgadmin4-*.tar.gz user@newhost:/tmp
- 在目标机器安装同版本pgAdmin4（Debian 12示例）：
- 添加仓库与密钥、安装包：
- curl -fsSL https://www.pgadmin.org/static/packages_pgadmin_org.pub | sudo gpg --dearmor -o /usr/share/keyrings/packages-pgadmin-org.gpg
- echo “deb [signed-by=/usr/share/keyrings/packages-pgadmin-org.gpg] https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/$(lsb_release -cs) pgadmin4 main” | sudo tee /etc/apt/sources.list.d/pgadmin4.list
- sudo apt update && sudo apt install pgadmin4 -y
- 首次运行设置（创建登录主密码）：sudo /usr/pgadmin4/bin/setup-web.sh
- 停止服务并恢复数据（避免运行时写入冲突）：
- sudo systemctl stop pgadmin4
- sudo tar xzf /tmp/pgadmin4-conf-*.tar.gz -C /etc/pgadmin4
- sudo tar xzf /tmp/pgadmin4-data-*.tar.gz -C /var/lib/pgadmin
- 修正所有权（以Debian常见包为例，pgadmin用户/组通常为pgadmin）：
- sudo chown -R pgadmin:pgadmin /etc/pgadmin4 /var/lib/pgadmin
- 启动服务：sudo systemctl start pgadmin4
- 访问验证：浏览器打开 http://服务器IP/pgadmin4，使用原先的主密码登录，检查服务器/连接是否完整。
三、迁移被管理的PostgreSQL数据库（业务数据）
- 方式A（推荐，灵活跨版本）：逻辑备份/恢复
- 源库导出（自定义格式，便于跨小版本恢复）：
- pg_dump -h 源主机 -U 用户名 -F c -b -v -f backup.custom 目标数据库
- 目标库准备（如库不存在先创建）：createdb -O 属主 目标数据库
- 目标库恢复：
- pg_restore -h 目标主机 -U 用户名 -d 目标数据库 -v backup.custom
- 方式B：纯SQL脚本
- 导出：pg_dump -h 源主机 -U 用户名 -f backup.sql 目标数据库
- 恢复：psql -h 目标主机 -U 用户名 -d 目标数据库 -f backup.sql
- 传输与权限要点：
- 使用scp/rsync安全拷贝备份文件；恢复用户需具备相应权限（CREATE、CONNECT、OWNER等）。
- 版本兼容：尽量保持源/目标PostgreSQL小版本一致；跨大版本时优先用自定义格式并测试关键对象（视图、函数、扩展）。
四、常见问题与排错
- 版本不一致导致恢复失败：自定义格式（-F c）更耐小版本差异；必要时在目标库手动创建扩展（CREATE EXTENSION IF NOT EXISTS …）。
- 权限与所有权错误：恢复后若pgAdmin页面异常或无法登录，检查**/var/lib/pgadmin与/etc/pgadmin4属主是否为pgadmin:pgadmin**，必要时用chown修正。
- 服务端口与访问路径：Debian常见为5050端口或**/pgadmin4路径；若端口冲突或被占用，可在/etc/pgadmin4/pgadmin4.conf**调整（如 SERVER_PORT），并重启服务；如有防火墙，放行对应端口（如 ufw allow 5050/tcp）。
- 迁移后连接信息过时：若迁移仅更换了数据库主机，需在pgAdmin中更新或新增服务器连接，避免沿用旧地址。