psql — PostgreSQL命令行客户端

镜像概述与主要用途

alpine/psql 是一个基于Alpine Linux的轻量级Docker镜像，包含PostgreSQL官方命令行客户端psql。该镜像旨在提供便捷的PostgreSQL数据库连接与管理工具，无需在主机系统直接安装psql客户端，即可通过容器化方式快速与PostgreSQL数据库交互。

核心功能与特性

• 官方兼容性：集成PostgreSQL官方psql客户端，支持与各版本PostgreSQL数据库的标准交互。
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低。
• 完整交互能力：支持执行SQL命令、查询数据、管理数据库对象（如表、视图、索引等）。
• 脚本执行支持：可直接运行外部SQL脚本文件，适用于批量操作或自动化任务。

使用场景与适用范围

• 开发环境快速连接：开发人员无需在本地安装psql，通过容器快速连接远程或本地PostgreSQL数据库。
• 自动化脚本与CI/CD流程：在自动化部署、数据库迁移或数据验证流程中，执行SQL命令或脚本。
• 临时数据库管理：临时需要查询或修改数据库内容，避免主机环境依赖。
• 多环境隔离：通过容器化方式，在不同项目或环境中使用特定版本的psql客户端，避免版本冲突。

镜像信息

Dockerfile源码

[***]

镜像标签

[***]

每日CI构建日志

暂无（N/A）

使用方法

快速开始

1. 设置命令别名（推荐）

通过alias将psql命令映射到容器运行，简化后续使用：

alias psql="docker run -ti --rm alpine/psql"

• --rm：容器退出后自动删除，避免残留容器。
• -ti：分配交互式终端，支持命令行输入。

2. 直接连接数据库

使用psql参数指定数据库信息连接：

psql -d <数据库名> -U <用户名> -W

• -d：指定目标数据库名称。
• -U：指定连接用户名。
• -W：强制提示输入密码（避免明文密码暴露）。

3. 使用连接字符串连接

通过完整连接字符串连接（推荐用于复杂配置，如SSL、端口自定义等）：

# 示例连接字符串格式：postgres://用户名:密码@主机:端口/数据库名?参数
export PSQL_CONNECTION_STRING="postgres://psqladmin:***:5432/psql?sslmode=require"
psql $PSQL_CONNECTION_STRING

• 连接字符串参数说明：
  • sslmode=require：强制使用SSL加密连接（根据数据库配置调整，可选值：disable、allow、prefer、require等）。

4. 运行SQL脚本文件

执行本地SQL脚本文件（需将脚本挂载到容器内，或通过标准输入传递）：

# 方法1：通过`-v`挂载本地脚本文件到容器/tmp目录
docker run -ti --rm -v $(pwd)/policy.sql:/tmp/policy.sql alpine/psql $PSQL_CONNECTION_STRING -f /tmp/policy.sql

# 方法2：使用管道传递脚本内容（适用于无需持久化的临时脚本）
cat policy.sql | psql $PSQL_CONNECTION_STRING

• -f：指定要执行的SQL脚本文件路径（容器内路径）。

配置参数说明

psql客户端常用参数如下：

环境变量

参考链接

• Dockerfile源码：[***]
• 镜像标签列表：[***]latest、14等）