热门搜索:
alpine/psql
PostgreSQL命令行客户端，用于通过命令行与PostgreSQL数据库交互，执行SQL命令及管理数据库。
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
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源码
https://github.com/alpine-docker/multi-arch-libs/blob/master/psql/Dockerfile
镜像标签
https://hub.docker.com/repository/docker/alpine/psql/tags%EF%BC%88%E5%8F%AF%E9%80%9A%E8%BF%87%E6%A0%87%E7%AD%BE%E9%80%89%E6%8B%A9%E7%89%B9%E5%AE%9A%E7%89%88%E6%9C%AC%EF%BC%89
每日CI构建日志
暂无（N/A）
使用方法
快速开始
1. 设置命令别名（推荐）
通过alias将psql命令映射到容器运行，简化后续使用：
bashalias psql="docker run -ti --rm alpine/psql"
--rm：容器退出后自动删除，避免残留容器。-ti：分配交互式终端，支持命令行输入。
2. 直接连接数据库
使用psql参数指定数据库信息连接：
bashpsql -d <数据库名> -U <用户名> -W
-d：指定目标数据库名称。-U：指定连接用户名。-W：强制提示输入密码（避免明文密码暴露）。
3. 使用连接字符串连接
通过完整连接字符串连接（推荐用于复杂配置，如SSL、端口自定义等）：
bash# 示例连接字符串格式：postgres://用户名:密码@主机:端口/数据库名?参数 export PSQL_CONNECTION_STRING="postgres://psqladmin:Eha72NtzKe01@postgresql.example:5432/psql?sslmode=require" psql $PSQL_CONNECTION_STRING
- 连接字符串参数说明：
sslmode=require：强制使用SSL加密连接（根据数据库配置调整，可选值：disable、allow、prefer、require等）。
4. 运行SQL脚本文件
执行本地SQL脚本文件（需将脚本挂载到容器内，或通过标准输入传递）：
bash# 方法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客户端常用参数如下：
| 参数 | 说明 |
|---|---|
-d, --dbname=DBNAME | 指定连接的数据库名称 |
-U, --username=USERNAME | 指定连接用户名 |
-h, --host=HOSTNAME | 指定数据库主机地址（默认：localhost） |
-p, --port=PORT | 指定数据库端口（默认：5432） |
-W, --password | 强制提示输入密码（即使未指定，若数据库要求密码也会提示） |
-f, --file=FILENAME | 执行指定文件中的SQL命令 |
-c, --command=COMMAND | 执行单行SQL命令（如：psql -c "SELECT version();"） |
-t, --tuples-only | 仅输出查询结果数据，不包含表头和额外格式 |
-v, --set=VAR=VALUE | 设置psql变量（如：-v ON_ERROR_STOP=1 遇到错误时停止执行） |
环境变量
| 变量名 | 说明 | 示例 |
|---|---|---|
PSQL_CONNECTION_STRING | 存储完整的PostgreSQL连接字符串，用于简化命令行输入 | postgres://user:pass@host:5432/db?sslmode=require |
参考链接
- Dockerfile源码：https://github.com/alpine-docker/multi-arch-libs/blob/master/psql/Dockerfile
- 镜像标签列表：https://hub.docker.com/repository/docker/alpine/psql/tags%EF%BC%88%E5%8F%AF%E9%80%89%E6%8B%A9%E7%89%B9%E5%AE%9A%E7%89%88%E6%9C%AC%EF%BC%8C%E5%A6%82%60latest%60%E3%80%81%6014%60%E7%AD%89%EF%BC%89
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull alpine/psql:<标签>
更多 psql 镜像推荐
lichti/psql
lichti
psql client
1万+ 次下载
8 年前更新
softwareplant/psql
softwareplant
为JIRA实例预先配置的PostgreSQL数据库镜像
2 次收藏100万+ 次下载
3 天前更新
materialize/psql
materialize
暂无描述
50万+ 次下载
3 天前更新
guigo2k/psql
guigo2k
暂无描述
50万+ 次下载
6 年前更新
returnpath/psql
returnpath
这是一个安装了PostgreSQL命令行客户端psql的基础容器，可在Docker或Kubernetes环境中快速连接并操作PostgreSQL数据库。
1万+ 次下载
9 年前更新
iartem/psql
iartem
暂无描述
10万+ 次下载
9 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"