Docker自托管Plausible配置自定义Postgres用户密码遇错求助

问题根源分析 #

1. Docker Compose配置存在语法错误（缩进、环境变量格式、注释位置）
2. DATABASE_URL配置错误（主机名、端口选择不当）
3. 可能存在旧数据库卷残留的默认认证信息

分步解决方案 #

1. 修正Docker Compose配置语法 #

你的docker-compose.yaml有多处语法错误，会导致环境变量无法正确加载、服务启动异常。以下是修正后的完整配置：

version: '3.8'

services:
  plausible_db:
    # supported versions are 12, 13, and 14
    image: postgres:14-alpine
    restart: always
    ports:
      - "1234:5432"
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: abc
      POSTGRES_USER: def
      POSTGRES_PASSWORD: xyz

  plausible_events_db:
    image: yandex/clickhouse-server:23.3.7.5-alpine
    restart: always
    volumes:
      - event-data:/var/lib/clickhouse
    ulimits:
      nofile:
        soft: 262144
        hard: 262144

  mail:
    image: bytemark/smtp
    restart: always

  plausible:
    image: plausible/analytics:v1.5
    restart: always
    command: sh -c "sleep 15 && /entrypoint.sh db createdb && /entrypoint.sh db migrate && /entrypoint.sh run"
    depends_on:
      - plausible_db
      - plausible_events_db
      - mail
    ports:
      - "8000:8000" # 替换为你实际需要的端口映射
    env_file:
      - plausible-conf.env

volumes:
  db-data:
    driver: local
  event-data:
    driver: local

修正点说明：

• 添加了version字段（Docker Compose必填）
• 修复所有缩进问题（严格遵循YAML缩进规则）
• environment字段改用KEY: VALUE格式（原KEY=VALUE格式仅适用于env_file）
• 修正ports写法（需用- "宿主机端口:容器端口"格式）
• 补充缺失的plausible_events_db和mail服务定义（原配置依赖这两个服务但未定义）
• 延长sleep时间到15秒，确保PostgreSQL服务完全就绪

2. 正确配置DATABASE_URL #

在plausible-conf.env文件中，设置正确的数据库连接地址：

DATABASE_URL=postgres://def:xyz@plausible_db:5432/abc

配置说明：

• 使用Docker Compose内部服务名plausible_db作为主机名：容器之间通过服务名自动解析IP，无需使用宿主机IP或localhost
• 端口使用容器内部的5432：服务间通信直接用容器端口，不需要宿主机映射的1234
• 不要使用$POSTGRES_DB这类变量：除非你在plausible-conf.env中同时定义该变量，否则会被当作字符串解析

3. 清除旧数据库卷（解决认证失败） #

如果之前启动过容器，db-data卷可能残留默认的postgres用户数据，导致新认证信息不生效。执行以下命令清除旧卷并重新启动：

# 停止并删除容器及卷
docker-compose down -v
# 重新启动服务
docker-compose up -d

4. 验证服务状态 #

启动后检查日志确认服务正常：

# 查看plausible服务日志
docker-compose logs plausible
# 查看postgres服务日志
docker-compose logs plausible_db

如果看到Plausible Analytics is running on http://0.0.0.0:8000则说明启动成功。

常见问题排查 #

• 连接池超时：使用宿主机IP时，需确保PostgreSQL容器的postgresql.conf设置了listen_addresses = '*'，且pg_hba.conf允许宿主机IP访问。但内部服务通信优先用服务名，无需配置这些。
• 连接拒绝（localhost）：Plausible容器内的localhost指向容器自身而非宿主机，因此无法访问宿主机上的PostgreSQL服务。

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