cleanstart/pgbouncer

CleanStart Container for PgBouncer

镜像概述和主要用途

PgBouncer是PostgreSQL数据库的轻量级连接池器。本容器提供生产就绪的PgBouncer实例，具备增强的安全特性和企业级配置。它通过维护连接池并提供连接池化、连接限制和查询缓存功能，高效管理PostgreSQL数据库连接。容器包含内置监控、指标暴露和高级连接管理功能，针对高吞吐量数据库环境进行了优化。

📌 CleanStart基础：为企业容器化环境设计的安全加固、最小化基础操作系统。

核心功能和特性

• PostgreSQL数据库的高级连接池化
• 查询缓存和连接负载均衡
• 基于会话和基于事务的池化模式
• 内置监控和指标暴露

使用场景和适用范围

• 高性能数据库连接管理
• 微服务架构的数据库连接池
• PostgreSQL部署的资源优化
• 云环境中扩展PostgreSQL连接

详细的使用方法和配置说明

快速开始

拉取最新镜像

从镜像仓库下载容器镜像

bash
docker pull cleanstart/pgbouncer:latest
docker pull cleanstart/pgbouncer:latest-dev

基本运行

使用基本配置运行容器

bash
docker run -d --name pgbouncer -p 6432:6432 cleanstart/pgbouncer:latest

生产部署

使用生产安全设置部署容器

bash
docker run -d --name pgbouncer-prod \
  --read-only \
  --security-opt=no-new-privileges \
  --user 1000:1000 \
  -p 6432:6432 \
  -v pgbouncer-config:/etc/pgbouncer \
  cleanstart/pgbouncer:latest

配置说明

环境变量

安全与最佳实践

推荐安全上下文

yaml
securityContext:
  runAsNonRoot: true
  runAsUser: 1000
  runAsGroup: 1000
  readOnlyRootFilesystem: true
  allowPrivilegeEscalation: false
  capabilities:
    drop: ['ALL']

最佳实践

• 生产环境使用特定镜像标签（避免使用latest）
• 配置资源限制：内存和CPU约束
• 尽可能启用只读根文件系统
• 使用非root用户运行容器（--user 1000:1000）
• 使用--security-opt=no-new-privileges标志
• 定期更新容器镜像以获取安全补丁
• 实施适当的网络分段
• 监控容器指标以检测异常

架构支持

多平台镜像

bash
docker pull --platform linux/amd64 cleanstart/pgbouncer:latest
docker pull --platform linux/arm64 cleanstart/pgbouncer:latest

资源与文档

• CleanStart官网：[***]
• PgBouncer文档：[***]
• CleanStart社区镜像：https://hub.docker.com/u/cleanstart
• CleanStart镜像运行指南及示例项目：https://github.com/cleanstart-dev/cleanstart-containers
  • 使用Dockerfile运行示例项目
  • 通过Kubernetes YAML部署
  • 从公共镜像迁移到CleanStart镜像

漏洞免责声明

CleanStart提供的Docker镜像包含由独立贡献者维护的第三方开源库和软件包。尽管CleanStart维护这些镜像并应用行业标准的安全实践，但无法保证超出其控制范围的上游组件的安全性或完整性。

用户确认并同意，开源软件可能包含未发现的漏洞，或通过更新引入新风险。对于源自第三方库的安全问题，包括但不限于零日漏洞、供应链***或贡献者引入的风险，CleanStart不承担责任。

安全是共同责任：CleanStart在可能的情况下提供更新的镜像和指导，而用户负责评估部署并实施适当的控制措施。