crystaldba/postgres-mcp

postgres-mcp 镜像文档

概述

postgres-mcp (PostgreSQL Management and Configuration Platform) 是一个功能全面的PostgreSQL数据库管理平台，旨在简化PostgreSQL数据库的部署、配置、监控和维护流程。该镜像集成了图形化管理界面、自动化备份工具、性能监控模块和配置管理系统，适用于各种规模的PostgreSQL数据库环境。

核心功能和特性

• 直观的图形化管理界面：提供Web-based管理控制台，支持数据库实例管理、用户权限控制和数据操作
• 自动化备份与恢复：支持定时备份、点-in-time恢复和跨版本迁移功能
• 性能监控与分析：实时监控数据库性能指标，提供可视化报表和优化建议
• 配置管理：集中管理数据库配置参数，支持版本控制和配置比较
• 多实例管理：支持同时管理多个PostgreSQL实例，统一监控和操作界面
• 安全审计：记录所有数据库操作，提供完整的审计日志和安全事件告警

使用场景

• 中小型企业PostgreSQL数据库的集中管理
• 开发和测试环境的快速数据库部署与配置
• PostgreSQL数据库的日常运维自动化
• 多实例PostgreSQL环境的统一监控与管理
• 数据库迁移和升级的辅助工具

使用方法

基本启动命令

bash
docker run -d \
  --name postgres-mcp \
  -p 8080:8080 \
  -e DB_HOST=postgres-server \
  -e DB_PORT=5432 \
  -e DB_USER=admin \
  -e DB_PASSWORD=securepassword \
  -v postgres-mcp-data:/app/data \
  crystaldba/postgres-mcp

Docker Compose 配置

yaml
version: '3'
services:
  postgres-mcp:
    image: crystaldba/postgres-mcp
    container_name: postgres-mcp
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=postgres-server
      - DB_PORT=5432
      - DB_USER=admin
      - DB_PASSWORD=securepassword
      - TZ=Asia/Shanghai
      - BACKUP_SCHEDULE=0 0 * * *
    volumes:
      - postgres-mcp-data:/app/data
      - postgres-mcp-backups:/app/backups
    restart: unless-stopped

volumes:
  postgres-mcp-data:
  postgres-mcp-backups:

环境变量配置

访问管理界面

启动容器后，通过以下URL访问postgres-mcp管理界面：

http://<your-server-ip>:8080

默认登录凭据：

• 用户名: admin
• 密码: admin123

安全提示: 首次登录后请立即修改默认密码。

数据持久化

为确保数据安全，建议挂载以下目录：

• /app/data: 存储应用配置和元数据
• /app/backups: 存储数据库备份文件

备份与恢复

创建手动备份

bash
docker exec -it postgres-mcp /app/scripts/create_backup.sh

恢复备份

bash
docker exec -it postgres-mcp /app/scripts/restore_backup.sh <backup-file-name>

监控与日志

查看应用日志：

bash
docker logs -f postgres-mcp

访问内置监控面板：

http://<your-server-ip>:8080/monitoring

常见问题

如何修改默认端口？

通过 -e HTTP_PORT=<new-port> 环境变量修改，并相应调整端口映射 -p <host-port>:<new-port>

如何升级postgres-mcp？

1. 备份现有数据卷
2. 停止并删除当前容器
3. 使用最新镜像启动新容器，挂载原数据卷

支持哪些PostgreSQL版本？

支持PostgreSQL 9.6及以上版本，推荐使用PostgreSQL 12+以获得最佳性能和兼容性。