Postgres Manager — Postgres 管理员

PostgreSQL 管理器 管理共享的 PostgreSQL Docker 容器用于本地开发环境。 架构 postgres-manager/ ├── docker-compose.yml # PostgreSQL 16 Alpine 容器 └── run.sh # 生命周期 + 数据库管理 CLI 加入共享的 nginx-proxy_net 网络（由 proxy-manager 创建），使应用容器通过 hostname codai_postgres 连接。 数据持久化在命名卷中。

命令 ./run.sh start # 启动 PostgreSQL 容器 ./run.sh stop # 停止容器（数据持久化在卷中） ./run.sh status # 状态 + 列出数据库 ./run.sh wait # 阻塞直到 PostgreSQL 准备就绪 ./run.sh create-db # CREATE DATABASE（幂等） ./run.sh drop-db # DROP DATABASE（交互式确认） ./run.sh dump # pg_dump src | psql dest ./run.sh list-dbs # 列出所有非模板数据库 ./run.sh psql [] # 打开 psql 交互式会话

如何执行任务 首次启动 PostgreSQL cd postgres-manager && ./run.sh start 第一次运行，Docker 创建卷并初始化 codai_main。 为新实例创建数据库 ./run.sh create-db codai_feature 将主数据库快照到新实例 ./run.sh dump codai_main codai_feature 删除工作树数据库 ./run.sh drop-db codai_feature # 提示确认 打开交互式 psql ./run.sh psql # 连接到 codai_main ./run.sh psql codai_feature # 连接到特定数据库

启动顺序 proxy-manager 启动 — 创建共享 Docker 网络 postgres-manager 启动 — 加入共享网络 worktree-manager 启动

配置变量 默认值 目的 POSTGRES_CONTAINER codai_postgres 容器名称 POSTGRES_USER codai 数据库用户 POSTGRES_PASSWORD pgpass 数据库密码 POSTGRES_MAIN_DB codai_main 主数据库名称 POSTGRES_PORT 5433 主机端口（映射到 5432） CODAI_NETWORK nginx-proxy_net 共享 Docker 网络名称

应用连接 后端容器连接到 PostgreSQL： 主机：codai_postgres（容器名称在共享网络上） 端口：5432 用户：codai / 密码：pgpass 数据库：codai_main（或实例特定数据库）

规则 永远不要删除 POSTGRES_MAIN_DB — 它是快照的源头。 drop-db 总是提示确认。 stop 保留数据在 Docker 卷中。 网络是 external：true — proxy-manager 必须先启动。

相关插件 proxy-manager — 创建共享 Docker 网络（先启动） mysql-manager — MySQL 替代品 redis-manager — 内存缓存伴侣 worktree-manager — 消费 PostgreSQL 的应用实例