babim/postgresql

babim/postgresql:alpine

镜像概述

babim/postgresql:alpine是基于Alpine Linux的PostgreSQL数据库镜像，提供轻量级、高效的PostgreSQL运行环境。该镜像包含PostgreSQL服务，默认暴露5432端口，支持通过环境变量配置数据库用户、密码、数据库名称等关键参数，适用于开发、测试及轻量级生产环境。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 便捷配置：通过环境变量灵活配置数据库用户、密码、数据库名称等
• 默认初始化：启动时自动执行initdb，创建默认用户和数据库
• 端口暴露：默认暴露5432端口，支持容器链接和网络访问
• 多版本支持：通过标签可选择不同PostgreSQL版本（具体版本参见镜像标签）

使用场景

• 开发环境中的本地PostgreSQL数据库服务
• 测试环境的数据库实例快速部署
• 轻量级生产环境中对资源占用敏感的PostgreSQL部署
• 需要快速启动和配置的临时数据库服务

使用方法

启动PostgreSQL实例

使用以下命令启动一个PostgreSQL容器，设置管理员密码：

console
$ docker run --name some-postgres -e POSTGRES_PASSWORD=mysecretpassword -d babim/postgresql:alpine

说明：该镜像默认暴露5432端口（PostgreSQL默认端口），通过容器链接（linking）可使其他容器自动访问该数据库服务。入口点脚本会通过initdb创建默认的postgres用户和数据库。

注：postgres数据库是默认数据库，供用户、工具和第三方应用使用。详情参见PostgreSQL文档

从应用连接

通过容器链接（linking）使应用容器访问PostgreSQL服务：

console
$ docker run --name some-app --link some-postgres:postgres -d application-that-uses-postgres

通过psql连接

使用psql客户端直接连接到运行中的PostgreSQL容器：

console
$ docker run -it --link some-postgres:postgres --rm babim/postgresql:alpine sh -c 'exec psql -h "$POSTGRES_PORT_5432_TCP_ADDR" -p "$POSTGRES_PORT_5432_TCP_PORT" -U postgres'

环境变量

PostgreSQL镜像使用多个环境变量进行配置，以下是关键变量说明：

DB_PASS

推荐使用的环境变量，用于设置PostgreSQL超级用户密码。默认超级用户由DB_USER定义。示例中设置为"mysecretpassword"。

DB_USER

可选环境变量，与DB_PASS配合使用，用于创建具有超级用户权限的用户及同名数据库。若未指定，默认用户为postgres。

PGDATA

可选环境变量，用于定义数据库文件的存储位置。默认值为/var/lib/postgresql。若使用文件系统挂载点作为数据卷（如GCE持久磁盘），PostgreSQL的initdb推荐使用子目录（例如/var/lib/postgresql/pgdata）存储数据。

DB_NAME

可选环境变量，用于定义首次启动镜像时创建的默认数据库名称。若未指定，默认使用DB_USER的值作为数据库名称。

LANG

可选环境变量，用于定义创建集群的区域设置。默认值为en_US.UTF-8。