darvion/postgres16-peb

PostgreSQL 16.1 psql客户端镜像

镜像概述

本镜像包含PostgreSQL 16.1版本的psql客户端工具，基于Debian系统（版本标识16.1-1.pgdg120+1），由PEB-PAK打包，构建日期为2025年1月29日。psql是PostgreSQL官方提供的命令行客户端，用于与PostgreSQL数据库进行交互、执行SQL命令及管理数据库对象。

核心功能与特性

• 版本信息：集成PostgreSQL 16.1官方psql客户端，支持该版本新增功能及语法
• 系统基础：基于Debian系统构建，包含运行psql所需的基础依赖库
• 轻量设计：仅包含psql客户端及必要组件，镜像体积精简
• 标准兼容：完全兼容PostgreSQL 16.1的命令行交互协议及SQL语法

使用场景

• PostgreSQL数据库日常命令行管理与维护
• 执行SQL脚本进行数据库初始化、数据迁移或批量操作
• 数据库查询调试与性能分析
• 与PostgreSQL服务容器配合，实现容器化环境下的数据库交互

使用方法

基本连接示例

通过docker run命令启动容器并连接到PostgreSQL数据库：

bash
docker run --rm -it docker.xuanyuan.run/psql:16.1-debian psql -h <数据库主机地址> -p <端口> -U <用户名> -d <数据库名>

• --rm：容器退出后自动删除
• -it：启用交互式终端，支持命令行输入
• <数据库主机地址>：目标PostgreSQL服务的IP或域名（如容器网络中的服务名）
• <端口>：PostgreSQL服务端口（默认5432）
• <用户名>：数据库登录用户（如postgres）
• <数据库名>：要连接的数据库名称

执行SQL脚本

挂载本地SQL文件到容器内并执行：

bash
docker run --rm -v $(pwd):/scripts -it docker.xuanyuan.run/psql:16.1-debian psql -h <主机> -U <用户> -d <数据库> -f /scripts/your_script.sql

• -v $(pwd):/scripts：将当前目录挂载到容器内/scripts目录
• -f /scripts/your_script.sql：指定要执行的SQL脚本路径

环境变量配置

可通过环境变量预设连接参数（需镜像支持，具体以实际构建为准）：

bash
docker run --rm -it \
  -e PGHOST=<数据库主机> \
  -e PGPORT=<端口> \
  -e PGUSER=<用户名> \
  -e PGDATABASE=<数据库名> \
  docker.xuanyuan.run/psql:16.1-debian psql

此时直接执行psql即可使用预设参数连接数据库。

注意事项

• 确保目标PostgreSQL服务允许远程连接（需配置pg_hba.conf及postgresql.conf）
• 敏感信息（如密码）建议通过环境变量或.pgpass文件传递，避免直接在命令行暴露
• 如需持久化配置，可挂载PostgreSQL客户端配置文件（如~/.psqlrc）到容器对应路径