Alpine + PGBouncer 镜像文档

镜像概述

本镜像基于 alpine:3.8 构建，内置 pgbouncer 轻量级连接池工具，专为PostgreSQL数据库设计，用于管理数据库连接，减少频繁建立/关闭连接带来的性能开销，提升数据库资源利用率。

核心功能与特性

• 轻量级基础：基于Alpine Linux 3.8，镜像体积小、启动快，资源占用低
• 连接池管理：通过pgbouncer实现PostgreSQL连接复用，有效控制数据库连接数，降低数据库负载
• 兼容性强：支持标准PostgreSQL协议，可无缝对接各类使用PostgreSQL的应用系统

使用场景

• 高并发应用中，优化PostgreSQL数据库连接性能
• 需要限制客户端直接连接数据库，通过连接池统一管理访问的场景
• 资源受限环境下，需轻量级连接池解决方案的部署需求

使用方法

基本运行命令

通过环境变量配置数据库连接信息，启动pgbouncer容器：

docker run -d \
  --name pgbouncer \
  -e DB_HOST=your-postgres-host \
  -e DB_PORT=5432 \
  -e DB_USER=your-db-user \
  -e DB_PASSWORD=your-db-password \
  -e DB_NAME=your-db-name \
  -e POOL_SIZE=20 \
  -p 6432:6432 \
  alpine-pgbouncer

环境变量配置说明

自定义配置文件

如需更复杂的pgbouncer配置（如用户认证、连接超时等），可通过挂载配置文件实现：

1. 本地创建pgbouncer.ini配置文件（示例）：

   [databases]
   your-db-name = host=your-postgres-host port=5432 user=your-db-user password=your-db-password dbname=your-db-name
   
   [pgbouncer]
   listen_addr = 0.0.0.0
   listen_port = 6432
   auth_type = md5
   pool_mode = session
   max_client_conn = 100
   default_pool_size = 20
   

2. 挂载配置文件启动容器：

   docker run -d \
     --name pgbouncer \
     -v /path/to/your/pgbouncer.ini:/etc/pgbouncer/pgbouncer.ini \
     -p 6432:6432 \
     alpine-pgbouncer
   

连接测试

容器启动后，通过pgbouncer端口连接数据库：

psql -h localhost -p 6432 -U your-db-user -d your-db-name