yalelibraryit/dc-postgres

多数据库PostgreSQL数字馆藏镜像

镜像概述

本镜像基于PostgreSQL构建，是专为数字馆藏场景设计的定制化数据库解决方案。通过优化配置与扩展功能，支持在单个PostgreSQL实例中高效管理多个独立数据库，满足数字资源存储、元数据管理及多维度数据组织需求，适用于各类数字文化资源的长期存储与访问。

核心功能与特性

多数据库并行管理

• 支持通过环境变量一次性定义并创建多个独立数据库
• 各数据库拥有独立权限控制与资源隔离
• 统一实例管理简化部署与维护复杂度

数字馆藏优化特性

• 预设数字资源元数据表结构模板（支持文本、图像、音视频资源描述）
• 优化大字段存储性能（BLOB/TEXT类型数据索引策略）
• 支持资源关联关系管理（如藏品-元数据-访问记录关联模型）

数据可靠性保障

• 原生支持PostgreSQL WAL（Write-Ahead Logging）事务日志
• 兼容主流备份工具（pg_dump、pg_basebackup）
• 支持数据卷挂载实现持久化存储，防止容器重启数据丢失

安全增强配置

• 默认启用密码认证机制
• 支持SSL/TLS加密连接（可通过挂载证书配置）
• 内置数据库用户权限最小化原则

适用场景

图书馆数字资源系统

• 管理电子书、期刊论文、学位论文等多类型文献数据库
• 支持按资源类型（图书/期刊/会议）拆分独立数据库

博物馆藏品管理平台

• 存储文物基础信息、图像资料、展览记录等多维度数据
• 按藏品类别（青铜器/陶瓷/书画）建立独立数据库

档案馆数字档案系统

• 管理不同全宗单位档案数据
• 支持档案著录规则与元数据标准适配

数字文化遗产项目

• 整合散落的文化遗产资源，按地域/年代/类型划分数据库
• 支持多语言元数据存储与检索

使用方法与配置说明

环境变量配置

基础部署命令

快速启动（无持久化）

bash
docker run -d \
  --name digicollection-db \
  -e POSTGRES_USER=digiadmin \
  -e POSTGRES_PASSWORD=SecurePass123! \
  -e DB_NAMES=books,exhibits,archives \
  -p 5432:5432 \
  multi-db-postgres-digital-collections:latest

带数据持久化部署

bash
docker run -d \
  --name digicollection-db \
  -e POSTGRES_USER=digiadmin \
  -e POSTGRES_PASSWORD=SecurePass123! \
  -e DB_NAMES=ancient_texts,historical_photos,audio_records \
  -e DB_COLLATION=zh_CN.UTF-8 \
  -v /data/digicollection/postgres:/var/lib/postgresql/data \
  -p 5432:5432 \
  --restart unless-stopped \
  multi-db-postgres-digital-collections:latest

Docker Compose部署示例

yaml
version: '3.8'

services:
  digital-collection-db:
    image: multi-db-postgres-digital-collections:latest
    container_name: digicollection-db
    environment:
      POSTGRES_USER: digiadmin
      POSTGRES_PASSWORD: ${DB_PASSWORD}  # 建议通过.env文件管理密码
      DB_NAMES: books,manuscripts,exhibits,media_resources
      DB_ENCODING: UTF8
      DB_COLLATION: zh_CN.UTF-8
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./init-scripts:/docker-entrypoint-initdb.d  # 挂载初始化脚本
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U digiadmin -d books"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped

volumes:
  postgres_data:  # 命名卷确保数据持久化

数据库访问方法

使用PostgreSQL客户端工具连接：

bash
# 访问books数据库
psql -h localhost -p 5432 -U digiadmin -d books

# 查看所有数据库
\l  # 在psql交互模式中执行

高级配置指南

自定义初始化脚本

1. 创建包含数据库表结构定义的.sql文件（如init_schema.sql）
2. 将脚本文件挂载至容器/docker-entrypoint-initdb.d目录
3. 容器启动时将自动按文件名顺序执行脚本

SSL加密配置

1. 准备SSL证书文件（server.crt、server.key）
2. 挂载证书至容器：-v /host/certs:/var/lib/postgresql/ssl
3. 添加环境变量：-e SSL_MODE=on
4. 客户端连接时指定SSL模式：psql "sslmode=require host=localhost dbname=books user=digiadmin"

性能调优参数

通过环境变量POSTGRES_INITDB_ARGS传递数据库配置参数：

bash
-e POSTGRES_INITDB_ARGS="--shared_buffers=1GB --work_mem=64MB --maintenance_work_mem=256MB"

备份策略示例

bash
# 创建全量备份
docker exec digicollection-db pg_dumpall -U digiadmin > /backup/digi_full_$(date +%Y%m%d).sql

# 单个数据库备份
docker exec digicollection-db pg_dump -U digiadmin manuscripts > /backup/manuscripts_$(date +%Y%m%d).sql