koslib/postgresql

PostgreSQL on Alpine 镜像文档

镜像概述

本镜像基于Alpine Linux构建，预安装了PostgreSQL数据库，旨在提供一个轻量级、易于部署的PostgreSQL运行环境。Alpine Linux的特性使镜像体积大幅减小，同时保留PostgreSQL的核心功能，适合资源受限场景或需要快速启动的环境。

核心功能与特性

• 轻量级设计：基于Alpine Linux，镜像体积远小于基于Debian/Ubuntu的同类镜像，节省存储空间和网络传输成本
• 预配置就绪：PostgreSQL已预先安装并配置基础环境，无需手动安装依赖
• 灵活配置：支持通过环境变量自定义数据库用户、密码、数据库名称等核心参数
• 标准兼容：完全兼容PostgreSQL官方客户端和工具链，支持标准SQL语法和数据库操作
• 数据持久化：支持通过Docker卷挂载实现数据持久化，避免容器重启导致数据丢失

使用场景

• 开发环境：本地快速搭建PostgreSQL数据库，用于应用开发和调试
• 测试环境：轻量级部署用于CI/CD流程中的自动化测试
• 小型生产环境：资源受限的服务器或边缘设备上部署PostgreSQL服务
• 学习环境：简单快速地搭建PostgreSQL学习和实验环境

使用方法与配置说明

基本使用（docker run）

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

bash
docker run -d \
  --name postgres-alpine \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgres-data:/var/lib/postgresql/data \
  postgres-alpine

参数说明：

• -d：后台运行容器
• --name postgres-alpine：指定容器名称
• -p 5432:5432：映射容器5432端口到主机5432端口（PostgreSQL默认端口）
• -e POSTGRES_PASSWORD=mysecretpassword：设置数据库超级用户密码
• -v postgres-data:/var/lib/postgresql/data：挂载数据卷到PostgreSQL数据目录，实现数据持久化

环境变量配置

示例：创建自定义用户和数据库

bash
docker run -d \
  --name postgres-custom \
  -p 5432:5432 \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -v postgres-custom-data:/var/lib/postgresql/data \
  postgres-alpine

数据持久化

为避免容器删除或重启导致数据丢失，强烈建议使用Docker卷挂载PostgreSQL数据目录：

bash
# 创建命名卷（推荐）
docker volume create postgres-data

# 使用命名卷启动容器
docker run -d \
  --name postgres-alpine \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgres-data:/var/lib/postgresql/data \
  postgres-alpine

也可使用主机目录挂载（适用于需要直接访问数据文件的场景）：

bash
docker run -d \
  --name postgres-alpine \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v /path/on/host:/var/lib/postgresql/data \
  postgres-alpine

连接数据库

容器启动后，可通过本地PostgreSQL客户端连接：

bash
psql -h localhost -p 5432 -U postgres

输入环境变量POSTGRES_PASSWORD设置的密码即可登录。

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'

services:
  postgres:
    image: postgres-alpine
    container_name: postgres-alpine
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

启动服务：

bash
docker-compose up -d

停止服务：

bash
docker-compose down

（停止并删除数据卷：docker-compose down -v）