giosg/postgres

本地PostgreSQL仓库镜像

镜像概述

本镜像为本地PostgreSQL仓库镜像，基于官方PostgreSQL镜像进行定制化修改，并通过不同标签区分不同的修改版本。旨在为本地开发、测试及定制化部署场景提供便捷的PostgreSQL实例获取方式。

核心功能与特性

• 基于官方镜像构建：保留官方PostgreSQL镜像的核心功能和兼容性，确保基础数据库功能稳定可靠
• 多标签版本管理：通过不同标签标识对官方镜像的特定修改，如配置调整、扩展集成、版本适配等
• 本地仓库部署：专为本地环境设计，可快速拉取和使用定制化PostgreSQL版本，减少网络依赖

使用场景

• 本地开发环境：需要特定配置或扩展的PostgreSQL开发环境
• 测试验证场景：验证不同修改版本的PostgreSQL功能及兼容性
• 定制化部署需求：在官方镜像基础上添加自定义配置、扩展或补丁的场景

使用方法

拉取镜像

从本地仓库拉取指定标签的镜像：

bash
docker pull [本地仓库地址]/postgres:[标签]

注：[本地仓库地址]为镜像所在的本地仓库路径，[标签]为具体修改版本标识

运行容器

基本运行命令（替换[标签]为实际使用的标签）：

bash
docker run -d \
  --name postgres-local \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 5432:5432 \
  [本地仓库地址]/postgres:[标签]

标签说明

镜像标签用于区分不同的修改版本，具体标签含义需参考本地仓库的标签说明文档，常见标签类型包括：

• custom-config：包含自定义配置文件的版本
• with-extensions：集成常用扩展（如pg_trgm、uuid-ossp等）的版本
• 14-custom/15-custom：基于特定官方版本（如14、15）的定制版本

环境变量配置

支持与官方PostgreSQL镜像兼容的环境变量，常用配置包括：

• POSTGRES_PASSWORD：设置数据库超级用户密码（必填）
• POSTGRES_USER：指定数据库超级用户名（默认：postgres）
• POSTGRES_DB：指定初始数据库名称（默认与POSTGRES_USER同名）
• PGDATA：指定数据库文件存储路径（默认：/var/lib/postgresql/data）

注意事项

• 使用前需确保本地仓库已正确配置并包含所需标签的镜像
• 不同标签的镜像可能有特定的依赖或配置要求，使用前请查阅对应标签的修改说明
• 生产环境使用前建议进行充分测试，确保定制化修改的稳定性和安全性