Docker 多容器共享中心数据库

Dejavu's Blog

甲骨文 ARM 实例部署 Gemma 4 模型 Headscale + Tailscale 组建虚拟专用网在 Linux 上使用 Yubikey OpenPGP 应用 BuyVM VPS 块存储挂载教程 Alpine Linux 服务器配置指南 Alpine Linux 安装 Cloudflared 安装 Komari 服务器监控工具 Scaleway VPS 安装 Debian Linux Debian 13 下部署 AsmBB 论坛使用 Kopia 自动化备份服务器数据给 Docker 启用 IPv6 支持 Netcup 服务器安装自定义 ISO 镜像烽火 HG5582A 光猫开启桥接模式 Docker 自托管 Shlink 短链服务部署 Obsidian LiveSync 实时同步服务指南我的 2025 年不完全回顾 Linux 下 Intel 核显驱动配置与硬件加速 Fedora Linux 安装配置记录 2025 年优雅地自托管 RSS 服务 Woodpecker CI 和 Gitea 实现 Hugo 自动部署 Gitea/Forgejo 集成 Woodpecker CI/CD 在 Blinko 中使用 Ollama 作为 AI 供应商 Docker 部署 Gitea/Forgejo Plausible CE 启用城市级地理位置识别 Blinko 开源 AI 知识库 Docker 部署指南 Netcup 免税账号注册及购买服务器全记录 Docker 自托管 Cloudreve Pro 私有网盘服务 GiffGaff SIM 卡使用体验和注意事项简体中文互联网在变得糟糕吗？如何低成本申请 S/MIME 证书用于个人邮件服务迁移到 NameCrane Mail 域名邮箱套件服务香烟与咖啡在 Windows 中使用 Yubikey 的 OpenPGP 应用 Windows 11 IoT LTSC 养老指南巧用浏览器生成 HAR 文件批量下载所需网页资源聊聊静态网站的评论系统在 Hugo 站点中优雅地展示实况照片使用 snac 部署一个简洁优雅的 ActivityPub 实例当 25 岁来临的时候断网的这两年从 Bitwarden/Vaultwarden 到 KeePassXC 也许是 Android 上最好的本地播放器 - 椒盐音乐 2023 半年小结写一个好玩的 Hugo 货币汇率转换短代码写一个 Hugo 短代码将不同类别的总字数统计转换为书名显示海信 Touch Lite 墨水屏音乐阅读器的简单体验从 Debian 11(bullseye) 无感升级到 Debian 12(bookworm) 使用 GitHub Actions 自动提交 URL 到 IndexNow 批量重写 Git 历史提交记录使用 cgit 托管小小的也很可爱的 Git 服务器在 Debian 上使用 stagit 和 Nginx 的简单 Git 服务器托管简单 Git 服务器的一些尝试使用 stagit 自托管纯静态 Git 存储库使用 Docker 快速部署单人 Fediverse 实例我是如何建立自己的个人博客的？简单、隐私友好的谷歌分析替代品，Plausible 自托管部署指南服务器使用 Cloudflare CDN 的最佳实践甲骨文服务器分配并启用 IPv6 地址 Git 版本控制学习笔记（二） Cloudflare WAF 防护策略简易指南 Mastodon 服务器批量导入自定义表情低成本自托管 Mastodon 实例简明指南自托管服务指南──有了服务器可以做什么？使用 Miniflux + RSSHub 打造个人 RSS 阅读器构建支持多种 CPU 架构的 Docker 镜像一个可自托管的静态短链接应用别了，二〇二二！ Duplicacy CLI 进阶使用指南 Duplicacy CLI 备份工具的基本使用初探 Cloudflare 零信任 - 通过 Docker 部署 Bitwarden 密码管理器 Yubikey 转运日志及上手指南初探 Cloudflare 零信任 — 通过 Cloudflare Tunnel 搭建 SSH 聊天室初探 Cloudflare 零信任 - 通过 Cloudflare Tunnel 访问服务某科学的 PGP 算号指南 2022 年的 MacBook Air M1 使用体验及应用推荐使用 Vercel 和 Supabase 自托管 Cusdis 评论系统为什么你的搜索引擎不好用？个人在 Windows 上常用软件清单 macOS 基础开发环境设置指南在 macOS 上使用 Canokey 的 OpenPGP 应用提取 Windows UWP 应用商店的安装包以供离线安装 Git 版本控制学习笔记（一）使用 Notion 管理 GitHub Star 项目使用 Vercel 免费部署 Giscus 评论系统将博客评论从 Utterances 无缝迁移到 Giscus Canokey 签名和认证应用指南 Canokey 的基本使用指南 Canokey Pigeon 揽件日志及简单开箱关于 Google Play 保护机制和 DRM 安全等级的那些事记录一次捡垃圾装机 GitHub 使用 GPG 密钥提交签名认证使用 Scoop 管理 Windows 下的软件和开发环境 Windows Terminal+PowerShell 7 打造 Windows 下最好用的终端一个好用的 Telegram 文件批量上传/下载工具 Clash for Windows 优雅地使用 TUN 模式接管系统流量全平台搭建 Hexo 静态博客指南尝试将 Manjaro 作为主力操作系统使用 Hexo 进行 SEO 优化的基本指南使用本地代理给 Git 和 NPM 加速使用 flowerss 部署 Telegram RSS 订阅机器人

Docker 多容器共享中心数据库

Dejavu Moe · 2026-03-13 · via Dejavu's Blog

引言

今天看了下新迁移的服务器，已经运行着 7 个 PostgreSQL 实例。随着自托管服务的增多，若单个服务都使用独立的数据库容器，会对服务器有限的硬件资源造成浪费。

同时，考虑到 immich 和 Plausible 本身对数据库版本有特定要求，暂不将其并入共享 PostgreSQL 实例。

但对其他应用而言，将数据库迁移到统一的 PostgreSQL 共享实例更为合理。这样不仅能减少基础内存占用，还能显著简化后续的统一备份与维护工作。

部署 PostgreSQL 中心数据库

设立一个中心化 PostgreSQL 实例，compose.yml 配置示例如下：

# /home/dejavu/postgres-alpine-18/compose.yml
services:
  postgres-alpine:
    image: postgres:18.3-alpine3.23
    container_name: postgres-alpine
    restart: unless-stopped
    deploy:
      resources:
        limits:
          memory: 4G
    networks:
      - postgres-alpine
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    volumes:
      - ./database:/var/lib/postgresql
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "postgres"]
      interval: 5s
      timeout: 3s
      retries: 8
      start_period: 10s
    command:
      - "postgres"
      - "-c"
      - "max_connections=300"
      - "-c"
      - "shared_buffers=1GB"
      - "-c"
      - "work_mem=16MB"
      - "-c"
      - "maintenance_work_mem=512MB"
      - "-c"
      - "effective_cache_size=3GB"
      - "-c"
      - "random_page_cost=1.1"
networks:
  postgres-alpine:
    name: postgres-alpine
    driver: bridge
    # 如需 IPv6 支持
    # 可参考 https://blog.dejavu.moe/posts/enable-ipv6-in-docker/
    # enable_ipv6: true

启动服务：

sudo docker compose up -d

接下来，我们开始将现有服务迁移到该共享中心数据库。

容器数据库迁移实践

我将容器数据库迁移的逻辑过程简化为以下 5 步：

备份：停止应用服务，保持旧数据库运行并导出数据；
初始化：在中心数据库创建独立库与用户，实现逻辑隔离；
还原：将备份数据导入中心数据库；
启动：修改 compose.yml 模板，启动服务并观察日志；
收尾：确认无误后可删除临时备份。

LiteLLM 迁移示例

以 LiteLLM 服务的迁移过程为例，这是原来的 compose.yml 如下：

# /home/dejavu/litellm/compose.yml
services:
  litellm:
    image: ghcr.io/berriai/litellm:main-v1.81.14-stable
    container_name: litellm
    ports:
      - "127.0.0.1:4000:4000"
    volumes:
      - ./config.yaml:/app/config.yaml
      - ./vertex-key.json:/app/vertex-key.json
    environment:
      - GOOGLE_APPLICATION_CREDENTIALS=/app/vertex-key.json
      - VERTEX_PROJECT=my-project
      - VERTEX_LOCATION=us-central1
      - LITELLM_MASTER_KEY=sk-some-words
      - LITELLM_SALT_KEY=
      - DATABASE_URL=postgresql://litellm:litellm@db:5432/litellm
    command: ["--config", "/app/config.yaml", "--port", "4000"]
    restart: unless-stopped
  db:
    image: postgres:18-alpine
    container_name: litellm-db
    restart: unless-stopped
    environment:
      - POSTGRES_DB=litellm
      - POSTGRES_USER=litellm
      - POSTGRES_PASSWORD=litellm
    deploy:
      resources:
        limits:
          memory: 256M
    volumes:
      - ./db:/var/lib/postgresql

先停止 LiteLLM 服务，并保持数据库服务运行

# 备份 Compose 模板
cp compose.yml compose.yml.bak
# 停止 litellm 应用
sudo docker compose stop litellm
# 导出旧数据库的数据
sudo docker exec -t litellm-db pg_dump -U litellm litellm -c > litellm_backup.sql
# 停止旧数据库
sudo docker compose down

登录共享的 PostgreSQL 实例：

sudo docker exec -it postgres-alpine psql -U postgres

执行以下 SQL 语句：

CREATE USER litellm WITH ENCRYPTED PASSWORD 'litellm';
CREATE DATABASE litellm;
ALTER DATABASE litellm OWNER TO litellm;
\q

导入备份数据

cat litellm_backup.sql | sudo docker exec -i postgres-alpine psql -U litellm -d litellm

接下来调整 compose.yml 应用编排配置：

# /home/dejavu/litellm/compose.yml
services:
  litellm:
    image: ghcr.io/berriai/litellm:main-v1.81.14-stable
    container_name: litellm
    # 加入中心数据库的 Docker 子网
    networks:
      - postgres-alpine
    # 以上为新增字段
    ports:
      - "127.0.0.1:4000:4000"
    volumes:
      - ./config.yaml:/app/config.yaml
      - ./vertex-key.json:/app/vertex-key.json
    environment:
      - GOOGLE_APPLICATION_CREDENTIALS=/app/vertex-key.json
      - VERTEX_PROJECT=my-project
      - VERTEX_LOCATION=us-central1
      - LITELLM_MASTER_KEY=sk-some-words
      - LITELLM_SALT_KEY=
      - DATABASE_URL=postgresql://litellm:litellm@db:5432/litellm
    command: ["--config", "/app/config.yaml", "--port", "4000"]
    restart: unless-stopped
    # 删除 db 服务
# 声明加入外部 Docker 子网
networks:
  postgres-alpine:
    external: true

重新启动服务并注意观察日志：

sudo docker compose up -d && sudo docker compose logs -f litellm

确认连接正常，数据库正确迁移，我们就可以删除备份了：

# 删除备份文件和旧目录
rm compose.yml.bak
rm litellm_backup.sql
sudo rm -rf ./db

Miniflux 迁移示例

第二个示例是 Miniflux，与前文一致，停止应用并导出数据：

# 停止 Miniflux 服务
sudo docker compose stop miniflux
# 导出旧数据库备份
sudo docker exec -t miniflux-db pg_dump -U miniflux miniflux -c > miniflux_backup.sql
# 停止并销毁容器
sudo docker compose down
# 备份 compose.yml
cp compose.yml compose.yml.bak

进入中心数据库容器：

sudo docker exec -it postgres-alpine psql -U postgres

初始化数据库与用户：

CREATE USER miniflux WITH ENCRYPTED PASSWORD 'miniflux';
CREATE DATABASE miniflux;
ALTER DATABASE miniflux OWNER TO miniflux;
\q

导入备份数据：

cat miniflux_backup.sql | sudo docker exec -i postgres-alpine psql -U miniflux -d miniflux

原来的 compose.yml 模板如下：

services:
  miniflux:
    image: miniflux/miniflux:2.2.17
    container_name: miniflux
    restart: unless-stopped
    ports:
      - "127.0.0.1:8081:8080"
    depends_on:
      db:
        condition: service_healthy
    networks:
      - miniflux-internal
      - warp-tunnel
      - rsshub
      - apprise
    environment:
      - DATABASE_URL=postgres://miniflux:miniflux@db/miniflux?sslmode=disable
      # ...
  db:
    image: postgres:18-alpine
    container_name: miniflux-db
    restart: unless-stopped
    networks:
      - miniflux-internal
    environment:
      - POSTGRES_USER=miniflux
      - POSTGRES_PASSWORD=miniflux
      - POSTGRES_DB=miniflux
    volumes:
      - ./db:/var/lib/postgresql
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "miniflux"]
      interval: 10s
      start_period: 30s
networks:
  warp-tunnel:
    external: true
  apprise:
    external: true
  rsshub:
    external: true
  miniflux-internal:
    name: miniflux-internal
    driver: bridge

我们需要修改 compose.yml 模板：

services:
  miniflux:
    image: miniflux/miniflux:2.2.17
    container_name: miniflux
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:8080"
    # 移除 db 服务依赖
    networks:
      - postgres-alpine  # 新增 Docker 子网络
      - warp-tunnel
      - rsshub
      - apprise
    environment:
      # 修改 PostgreSQL 连接配置，指向中心数据库
      - DATABASE_URL=postgres://miniflux:miniflux@postgres-alpine:5432/miniflux?sslmode=disable
      # ...
# 删除原来的 db 服务
networks:
  warp-tunnel:
    external: true
  apprise:
    external: true
  rsshub:
    external: true
  # 替换原来的 miniflux-internal 子网络
  postgres-alpine:
    external: true

Shlink 迁移示例

在 我的配置 中，Shlink 后端服务与 Web 仪表盘共用了一个数据库，需要同时迁移两个独立的数据库。

这是原来的 compose.yml 配置文件：

services:
  db:
    image: postgres:18-alpine
    container_name: shlink-db
    restart: unless-stopped
    environment:
      - POSTGRES_DB=shlink
      - POSTGRES_USER=shlink
      - POSTGRES_PASSWORD=shlink
    volumes:
      - ./data:/var/lib/postgresql
      - ./init-db.sql:/docker-entrypoint-initdb.d/init-db.sql:ro
    # ...
  valkey:
    image: valkey/valkey:8.1.5-alpine
    container_name: shlink-valkey
    restart: unless-stopped
    # ...
  mercure:
    image: dunglas/mercure:v0.17
    container_name: shlink-mercure
    restart: unless-stopped
    # ...
  shlink-backend:
    image: shlinkio/shlink:5.0.1
    container_name: shlink-backend
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
      valkey:
        condition: service_healthy
      mercure:
        condition: service_healthy
    environment:
      - DB_DRIVER=postgres
      - DB_HOST=db
      - DB_NAME=shlink
      - DB_USER=shlink
      - DB_PASSWORD=shlink
      # ...
    ports:
      - "127.0.0.1:8080:8080"
  shlink-web:
    image: shlinkio/shlink-dashboard:0.2.3
    container_name: shlink-web
    user: "1000:1000"
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "127.0.0.1:3005:3005"
    environment:
      SHLINK_DASHBOARD_DB_DRIVER: postgres
      SHLINK_DASHBOARD_DB_HOST: db
      SHLINK_DASHBOARD_DB_PORT: 5432
      SHLINK_DASHBOARD_DB_NAME: dashboard
      SHLINK_DASHBOARD_DB_USER: shlink
      SHLINK_DASHBOARD_DB_PASSWORD: shlink

迁移步骤如下：

# 停止应用服务
sudo docker compose stop shlink-backend shlink-web
# 导出 Shlink 后端数据库
sudo docker exec -t shlink-db pg_dump -U shlink shlink -c > shlink_backup.sql
# 导出 Shlink 仪表盘数据库库
sudo docker exec -t shlink-db pg_dump -U shlink dashboard -c > dashboard_backup.sql
# 停止并销毁容器
sudo docker compose down
# 进入中心数据库执行操作
sudo docker exec -it postgres-alpine psql -U postgres

执行 SQL 查询：

CREATE USER shlink WITH ENCRYPTED PASSWORD 'shlink';
CREATE DATABASE shlink;
ALTER DATABASE shlink OWNER TO shlink;
CREATE DATABASE dashboard;
ALTER DATABASE dashboard OWNER TO shlink;
\q

分别导入备份数据

# 导入 Shlink 后端数据库
cat shlink_backup.sql | sudo docker exec -i postgres-alpine psql -U shlink -d shlink
# 导入 Shlink 仪表盘数据库
cat dashboard_backup.sql | sudo docker exec -i postgres-alpine psql -U shlink -d dashboard

修改后的 compose.yml 结构类似这样：

services:
  # 删除 db 服务
  valkey:
    image: valkey/valkey:8.1.5-alpine
    container_name: shlink-valkey
    restart: unless-stopped
    command: "valkey-server --save 60 1 --loglevel warning --protected-mode no"
    # 声明子网络
    networks:
      - postgres-alpine
    volumes:
      - ./valkey:/data
    # ...
  mercure:
    image: dunglas/mercure:v0.17
    container_name: shlink-mercure
    restart: unless-stopped
    # 声明子网络
    networks:
      - postgres-alpine
    ports:
      - "127.0.0.1:29090:80"
    # ..
  shlink-backend:
    image: shlinkio/shlink:5.0.1
    container_name: shlink-backend
    restart: unless-stopped
    # 声明子网络
    networks:
      - postgres-alpine
    depends_on:
      # 移除 db 服务依赖
      valkey:
        condition: service_healthy
      mercure:
        condition: service_healthy
    environment:
      - DB_DRIVER=postgres
      - DB_HOST=postgres-alpine # 修改数据库主机名
      - DB_NAME=shlink
      - DB_USER=shlink
      - DB_PASSWORD=shlink
      # ...
    ports:
      - "127.0.0.1:8080:8080"
  shlink-web:
    image: shlinkio/shlink-dashboard:0.2.3
    container_name: shlink-web
    user: "1000:1000"
    restart: unless-stopped
    # 声明子网络
    networks:
      - postgres-alpine
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "127.0.0.1:3005:3005"
    environment:
      SHLINK_DASHBOARD_DB_DRIVER: postgres
      SHLINK_DASHBOARD_DB_HOST: postgres-alpine # 修改数据库主机名
      SHLINK_DASHBOARD_DB_PORT: 5432
      SHLINK_DASHBOARD_DB_NAME: dashboard
      SHLINK_DASHBOARD_DB_USER: shlink
      SHLINK_DASHBOARD_DB_PASSWORD: shlink
# 声明 Docker 网络
networks:
  postgres-alpine:
    external: true

验证与维护

迁移完成后，建议检查中心数据库的状态，确保各库与用户权限配置无误。中心数据库应以稳为主，除非必要，否则尽量减少升级操作。

# 查看数据库列表
sudo docker exec -it postgres-alpine psql -U postgres -c "\l"
# 查看角色列表
sudo docker exec -it postgres-alpine psql -U postgres -c "\du"

结论

对比迁移前后，虽然关停多余的 PostgreSQL 容器节省了一些 RAM 和磁盘占用，使得整体服务更加集中，但是也增加了「单点故障」风险，自行权衡利弊吧。

此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。原文来自 — 版权归原作者所有。

推荐订阅源

Dejavu's Blog

引言

部署 PostgreSQL 中心数据库

容器数据库迁移实践

LiteLLM 迁移示例

Miniflux 迁移示例

Shlink 迁移示例

验证与维护

结论