clefos/postgresql

PostgreSQL Docker镜像文档

镜像概述和主要用途

该Docker镜像提供PostgreSQL数据库服务器的快速部署方案，允许用户通过简单配置启动PostgreSQL服务。支持创建超级用户、设置密码及初始化数据库，适合开发、测试环境使用（不推荐生产环境直接使用）。

核心功能和特性

• 快速启动PostgreSQL服务，无需复杂配置
• 支持通过环境变量创建超级用户（DB_USER）、设置密码（DB_PASS）及初始化数据库（DB_NAME）
• 提供便捷的容器内管理连接方式
• 支持端口映射，便于外部访问数据库服务

使用场景和适用范围

• 开发环境中快速搭建PostgreSQL数据库
• 测试环境中临时部署数据库服务
• 学习和演示PostgreSQL功能的场景
• 注意：不推荐用于生产环境，生产环境需额外配置数据持久化、安全加固等措施

使用方法和配置说明

快速启动（不推荐生产环境）

通过以下命令快速启动PostgreSQL容器：

bash
docker run --name=postgresql -d -p 5432:5432 docker.xuanyuan.run/<yourname>/postgresql

• --name=postgresql：指定容器名称为postgresql
• -d：后台运行容器
• -p 5432:5432：将容器的5432端口映射到主机的5432端口，允许外部访问

以管理员用户连接容器

使用以下命令以postgres管理员用户连接到运行中的容器：

bash
docker run -it --rm --volumes-from=postgresql docker.xuanyuan.run/<yourname>/postgres sudo -u postgres -H psql

• -it：交互式终端模式
• --rm：退出后自动删除临时容器
• --volumes-from=postgresql：共享postgresql容器的卷

启动时创建数据库和用户

通过环境变量可在启动时创建超级用户、设置密码及初始化数据库：

bash
docker run --name postgresql -d \
  -e 'DB_USER=username' \
  -e 'DB_PASS=ridiculously-complex_password1' \
  -e 'DB_NAME=my_database' \
  docker.xuanyuan.run/<yourname>/postgresql

环境变量说明：

• DB_USER：要创建的超级用户名
• DB_PASS：超级用户的密码
• DB_NAME：要初始化的数据库名称

连接新创建的数据库

使用以下命令连接到新创建的数据库（需替换<yourname>为实际镜像名称）：

bash
psql -U username -h $(docker inspect --format {{.NetworkSettings.IPAddress}} postgresql)

• -U username：指定用户名（与DB_USER对应）
• -h：指定数据库主机地址，通过docker inspect获取容器IP