如何提高Postgres Docker容器的最大连接数限制？

方法1：启动时通过命令参数直接调整（最简便） #

启动容器时直接在镜像名后追加postgres启动参数，覆盖max_connections配置，示例命令如下：

docker run -d --name postgres \
  -e POSTGRES_PASSWORD=你的密码 \
  postgres:latest \
  postgres -c max_connections=200

仅需临时调整或者只需要改最大连接数这一项配置时，优先用这个方案。

方法2：挂载自定义postgresql.conf配置文件 #

如果需要同时调整多项Postgres配置，可以把自定义配置文件挂载到容器内生效：

1. 先准备好修改后的postgresql.conf文件，将其中max_connections参数调整为你需要的数值，比如：

   max_connections = 300
   

2. 启动容器时挂载配置文件，示例命令如下：

   docker run -d --name postgres \
     -e POSTGRES_PASSWORD=你的密码 \
     -v /本地自定义配置路径/postgresql.conf:/var/lib/postgresql/data/postgresql.conf \
     postgres:latest
   

后续调整配置只需修改本地的postgresql.conf，重启容器即可生效。

方法3：Docker Compose场景下的配置 #

如果使用Docker Compose管理容器，根据你的需求选以下两种写法之一即可：

直接追加启动参数 #

version: '3.8'
services:
  postgres:
    image: postgres:latest
    environment:
      POSTGRES_PASSWORD: 你的密码
    command: postgres -c max_connections=200

挂载自定义配置文件 #

version: '3.8'
services:
  postgres:
    image: postgres:latest
    environment:
      POSTGRES_PASSWORD: 你的密码
    volumes:
      - /本地自定义配置路径/postgresql.conf:/var/lib/postgresql/data/postgresql.conf

验证配置是否生效 #

容器启动后执行以下命令，可查看当前生效的最大连接数：

docker exec -it 你的容器名 psql -U postgres -c 'show max_connections;'

注意事项 #

• max_connections默认值为100，每个连接会占用约10MB内存，调整时需要结合容器分配的内存上限合理设置，避免设置过高引发OOM（内存溢出）导致容器异常退出。
• 如果容器挂载了持久化数据卷，首次调整配置后需要重启容器才会生效。

内容的提问来源于stack exchange，提问作者wingedsubmariner