避坑指南:SmartWaterServer项目用Docker部署PostgreSQL时遇到的远程连接问题及解决方案

SmartWaterServer数据库配置全流程:从Docker安装到RuoYi-Vue-Plus项目集成 本文详细介绍了基于RuoYi-Vue-Plus框架的SmartWaterServer项目数据库配置全流程。通过Docker容器化技术,逐步部署并配置Redis缓存和PostgreSQL主数据库,深入解决了远程连接、数据持久化等常见问题,并利用Docker Compose实现多服务编排,最终完成与Spring Boot项目的无缝集成,为智慧水务系统开发提供稳定可靠的环境搭建方案。 阅读详情

从容器到客户端:彻底解决Docker化PostgreSQL远程连接难题

最近在帮一个团队部署他们的智慧水务管理平台,技术栈选用了RuoYi-Vue-Plus作为基础框架,后端服务需要连接PostgreSQL数据库。按照常规做法,我们用Docker快速拉起了一个PostgreSQL实例,本以为几分钟就能搞定的事情,却在IDE连接数据库时卡住了——经典的“Connection refused”错误。这场景太熟悉了,几乎每个刚开始用Docker部署数据库的开发者都会遇到。问题看似简单,但背后涉及容器网络、PostgreSQL的认证机制、配置文件加载顺序等多个层面的知识。今天我就把这次排查过程中积累的经验系统梳理出来,帮你绕过这些坑,让数据库连接变得顺畅。

1. 理解问题的本质:为什么容器内的数据库无法从外部访问?

当你第一次在Docker中运行PostgreSQL,然后尝试从宿主机或同一网络中的其他机器连接时,大概率会遇到连接失败。很多人第一反应是“端口没映射对”,于是反复检查-p 5432:5432这个参数。但实际情况往往更复杂。

PostgreSQL的安全模型设计得相当严格。默认情况下,它只接受来自本地Unix域套接字的连接,即使你通过-p参数将端口暴露给了外部世界,PostgreSQL自身的配置也会拒绝这些连接尝试。这其实是个好设计——数据库不应该默认对全网开放。

问题的核心在于两个配置文件:postgresql.conf和pg_hba.conf。前者控制PostgreSQL服务器的基本行为,包括监听地址;后者则负责客户端认证,决定哪些主机、哪些用户、通过什么方式可以连接哪些数据库。

关键点:Docker官方PostgreSQL镜像在初始化时,会生成默认的配置。这些默认配置通常只允许本地连接。当你从容器外部尝试连接时,请求虽然能到达容器的5432端口,但会被pg_hba.conf中的规则拒绝。

注意:很多人误以为修改宿主机上的PostgreSQL配置文件就能生效,但实际上需要修改的是容器内部的配置文件,或者通过数据卷挂载的方式让容器使用你预先准备好的配置。

2. 诊断步骤:如何快速定位连接问题的根源?

遇到连接问题时,盲目尝试各种解决方案往往事倍功半。我建议按照以下系统化的诊断流程来排查,这样能更快找到问题的真正原因。

2.1 第一步:确认容器状态和端口映射

首先,确保你的PostgreSQL容器正在运行,并且端口映射正确:

# 查看容器状态
docker ps | grep postgres

# 如果容器名为smart-postgres,查看其详细信息
docker inspect smart-postgres | grep -A 10 "Ports"

你应该看到类似这样的输出:

"Ports": {
  "5432/tcp": [
    {
      "HostIp": "0.0.0.0",
      "HostPort": "5432"
    }
  ]
}

这表示容器的5432端口已经映射到了宿主机的5432端口。如果这里显示为空或者映射的宿主机端口不是你期望的,那么问题可能出在容器启动参数上。

2.2 第二步:测试网络连通性

从宿主机测试是否能连接到容器的端口:

# 使用telnet或nc测试端口连通性
telnet localhost 5432

# 或者使用更专业的工具
nc -zv localhost 5432

如果连接被拒绝,可能是PostgreSQL服务没有在容器内正常启动。进入容器检查服务状态:

docker exec -it smart-postgres bash
ps aux | grep postgres

2.3 第三步:检查PostgreSQL的监听配置

进入容器,查看postgresql.conf中的监听设置:

docker exec -it smart-postgres bash
cat /var/lib/postgresql/data/postgresql.conf | grep listen_addresses

默认情况下,你可能会看到:

listen_addresses = 'localhost'

这意味着PostgreSQL只监听本地回环地址。要接受外部连接,需要将其改为:

listen_addresses = '*'

或者至少是:

listen_addresses = '0.0.0.0'

2.4 第四步:检查客户端认证配置

这是最常见的问题所在。查看pg_hba.conf文件:

cat /var/lib/postgresql/data/pg_hba.conf

重点关注文件末尾的规则。默认配置通常如下:

# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   all             all                                     peer
host    all             all             127.0.0.1/32            md5
host    all             all             ::1/128                 md5

这个配置只允许:

  • 本地Unix域套接字连接(peer认证)
  • 来自127.0.0.1(IPv4本地回环)的TCP连接
  • 来自::1(IPv6本地回环)的TCP连接

诊断表格:常见连接问题及可能原因

错误现象可能原因检查方法
Connection refused服务未启动或端口未监听docker ps, netstat -tlnp
Connection timeout防火墙阻止或网络配置问题检查防火墙规则,测试网络连通性
Password authentication failed密码错误或用户不存在检查POSTGRES_PASSWORD环境变量
No pg_hba.conf entry for hostpg_hba.conf配置不允许该连接检查pg_hba.conf文件规则
Database does not exist数据库不存在检查POSTGRES_DB环境变量或手动创建数据库

3. 解决方案:四种方法彻底解决远程连接问题

根据不同的使用场景和需求,我推荐以下几种解决方案。每种方法都有其适用场景,你可以根据实际情况选择。

3.1 方法一:启动时直接配置(最简单)

如果你只是需要快速启动一个允许远程连接的PostgreSQL实例,可以在启动容器时通过环境变量直接配置:

docker run -d \
  --name smart-postgres \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=admin \
  -e POSTGRES_DB=smartwater \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  postgres:15 \
  -c 'listen_addresses=*'

这里的关键是在镜像名后面添加了-c 'listen_addresses=*'参数,这会在启动时覆盖默认的监听配置。

但这种方法有个限制:它只解决了监听地址的问题,pg_hba.conf中的认证规则还是默认的。所以你可能还需要进入容器手动修改pg_hba.conf,或者使用方法二。

3.2 方法二:自定义配置文件(推荐用于生产环境)

对于生产环境或需要长期使用的开发环境,我强烈推荐使用自定义配置文件。这样可以确保配置的持久化和一致性。

步骤1:创建自定义配置文件

在宿主机上创建目录存放配置文件:

mkdir -p ~/docker/postgres/conf

创建postgresql.conf:

cat > ~/docker/postgres/conf/postgresql.conf << EOF
listen_addresses = '*'
max_connections = 100
shared_buffers = 128MB
dynamic_shared_memory_type = posix
EOF

创建pg_hba.conf:

cat > ~/docker/postgres/conf/pg_hba.conf << EOF
# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   all             all                                     peer
host    all             all             0.0.0.0/0               md5
host    all             all             ::/0                    md5
EOF

步骤2:启动容器时挂载配置文件

docker run -d \
  --name smart-postgres \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=admin \
  -e POSTGRES_DB=smartwater \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  -v ~/docker/postgres/conf/postgresql.conf:/etc/postgresql/postgresql.conf \
  -v ~/docker/postgres/conf/pg_hba.conf:/etc/postgresql/pg_hba.conf \
  postgres:15 \
  -c 'config_file=/etc/postgresql/postgresql.conf' \
  -c 'hba_file=/etc/postgresql/pg_hba.conf'

这种方法的好处是:

  • 配置文件在宿主机上,易于管理和版本控制
  • 重启容器时配置不会丢失
  • 可以针对不同环境(开发、测试、生产)使用不同的配置文件

3.3 方法三:使用初始化脚本

如果你需要在数据库初始化时执行一些额外的操作(比如创建特定用户、数据库或扩展),可以使用Docker的初始化脚本功能。

步骤1:创建初始化脚本

cat > ~/docker/postgres/init/01-init.sh << 'EOF'
#!/bin/bash
set -e

# 修改pg_hba.conf以允许远程连接
echo "host all all 0.0.0.0/0 md5" >> /var/lib/postgresql/data/pg_hba.conf

# 修改postgresql.conf以监听所有地址
sed -i "s/#listen_addresses = 'localhost'/listen_addresses = '*'/" /var/lib/postgresql/data/postgresql.conf

# 创建额外的数据库(如果需要)
psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
    CREATE DATABASE smartwater_test;
    CREATE USER app_user WITH PASSWORD 'app_password';
    GRANT ALL PRIVILEGES ON DATABASE smartwater_test TO app_user;
EOSQL
EOF

chmod +x ~/docker/postgres/init/01-init.sh

步骤2:启动容器并挂载初始化脚本

docker run -d \
  --name smart-postgres \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=admin \
  -e POSTGRES_DB=smartwater \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  -v ~/docker/postgres/init:/docker-entrypoint-initdb.d \
  postgres:15

PostgreSQL的Docker镜像会在第一次启动时(数据目录为空时)执行/docker-entrypoint-initdb.d目录下的所有.sh和.sql脚本。这是一个非常强大的功能,可以自动化很多初始化工作。

3.4 方法四:使用Docker Compose管理多服务

在实际项目中,数据库很少单独存在。通常我们会有应用服务、数据库、缓存等多个容器。使用Docker Compose可以更好地管理这些服务之间的依赖和网络。

docker-compose.yml示例:

version: '3.8'

services:
  postgres:
    image: postgres:15
    container_name: smart-postgres
    environment:
      POSTGRES_USER: admin
      POSTGRES_PASSWORD: your_secure_password
      POSTGRES_DB: smartwater
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --locale=C"
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
      - ./config/postgresql.conf:/etc/postgresql/postgresql.conf
      - ./config/pg_hba.conf:/etc/postgresql/pg_hba.conf
    command: >
      postgres 
      -c config_file=/etc/postgresql/postgresql.conf 
      -c hba_file=/etc/postgresql/pg_hba.conf
    networks:
      - backend-network
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U admin"]
      interval: 10s
      timeout: 5s
      retries: 5

  redis:
    image: redis:7-alpine
    container_name: smart-redis
    command: redis-server --requirepass your_redis_password
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    networks:
      - backend-network

  app:
    build: .
    container_name: smartwater-app
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_started
    environment:
      DATABASE_URL: postgresql://admin:your_secure_password@postgres:5432/smartwater
      REDIS_URL: redis://:your_redis_password@redis:6379/0
    ports:
      - "8080:8080"
    networks:
      - backend-network

volumes:
  postgres-data:
  redis-data:

networks:
  backend-network:
    driver: bridge

这个配置的关键点:

  1. 自定义网络:所有服务在同一个自定义网络中,可以通过服务名互相访问
  2. 健康检查:确保应用服务在数据库就绪后才启动
  3. 环境变量注入:应用通过环境变量获取数据库连接信息
  4. 配置文件挂载:PostgreSQL使用自定义配置文件

启动所有服务:

docker-compose up -d

4. 高级技巧与最佳实践

解决了基本的连接问题后,我们还需要考虑安全性、性能和可维护性。以下是一些在实际项目中积累的经验。

4.1 安全加固建议

允许远程连接虽然方便,但也带来了安全风险。以下是一些加固措施:

最小权限原则:不要使用超级用户连接应用

-- 在PostgreSQL中创建专用应用用户
CREATE USER app_user WITH PASSWORD 'strong_password_here';
GRANT CONNECT ON DATABASE smartwater TO app_user;
GRANT USAGE ON SCHEMA public TO app_user;
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO app_user;

限制连接来源:在pg_hba.conf中精确指定允许的IP范围

# 只允许特定IP段连接
host    smartwater    app_user    192.168.1.0/24          md5
host    smartwater    app_user    10.0.0.0/8              md5

# 拒绝其他所有连接
host    all           all         0.0.0.0/0               reject

使用SSL连接:在生产环境中强制使用SSL

# 在postgresql.conf中启用SSL
ssl = on
ssl_cert_file = '/var/lib/postgresql/data/server.crt'
ssl_key_file = '/var/lib/postgresql/data/server.key'

4.2 性能调优配置

对于生产环境,默认配置往往不够。以下是一些关键的性能参数:

内存相关配置(根据服务器内存调整):

# 通常设置为系统内存的25%
shared_buffers = 4GB

# 工作内存,用于排序和哈希操作
work_mem = 16MB

# 维护操作(如VACUUM)使用的内存
maintenance_work_mem = 512MB

WAL(Write-Ahead Logging)配置:

# WAL日志级别
wal_level = replica

# 检查点相关
checkpoint_timeout = 15min
max_wal_size = 4GB
min_wal_size = 1GB

4.3 监控与维护

连接池管理:使用PgBouncer或PgPool-II管理连接

# docker-compose中添加PgBouncer
pgbouncer:
  image: edoburu/pgbouncer
  environment:
    DB_USER: admin
    DB_PASSWORD: your_secure_password
    DB_HOST: postgres
    DB_NAME: smartwater
    POOL_MODE: transaction
    MAX_CLIENT_CONN: 100
    DEFAULT_POOL_SIZE: 20
  ports:
    - "6432:6432"

备份策略:定期备份数据库

# 使用pg_dump进行逻辑备份
docker exec smart-postgres pg_dump -U admin smartwater > backup_$(date +%Y%m%d).sql

# 或者使用物理备份
docker exec smart-postgres pg_basebackup -D /backup -U replicator -P -v

4.4 与RuoYi-Vue-Plus框架的集成

对于使用RuoYi-Vue-Plus框架的项目,数据库连接配置通常在application.yml或application-dev.yml中:

spring:
  datasource:
    driver-class-name: org.postgresql.Driver
    url: jdbc:postgresql://localhost:5432/smartwater?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8
    username: app_user
    password: strong_password_here
    
  # Redis配置
  redis:
    host: localhost
    port: 6379
    password: your_redis_password
    database: 0
    timeout: 3000ms
    lettuce:
      pool:
        max-active: 20
        max-wait: -1ms
        max-idle: 10
        min-idle: 0

常见问题排查:

  1. 时区问题:确保数据库和应用的时区设置一致
  2. 连接池耗尽:调整连接池大小,监控连接数
  3. 长连接超时:配置合理的超时时间和心跳检测

4.5 多环境配置管理

在实际开发中,我们通常需要为不同环境(开发、测试、生产)配置不同的数据库连接参数。我推荐使用环境变量和配置文件结合的方式:

application.yml:

spring:
  datasource:
    url: ${DATABASE_URL:jdbc:postgresql://localhost:5432/smartwater}
    username: ${DATABASE_USERNAME:app_user}
    password: ${DATABASE_PASSWORD:}

Docker启动命令:

docker run -d \
  --name smartwater-app \
  -e DATABASE_URL=jdbc:postgresql://postgres:5432/smartwater \
  -e DATABASE_USERNAME=app_user \
  -e DATABASE_PASSWORD=strong_password_here \
  -p 8080:8080 \
  smartwater-app:latest

这种方式的好处是:

  • 敏感信息(如密码)不进入代码仓库
  • 不同环境使用不同的配置
  • 配置变更不需要重新构建镜像

5. 故障排除工具箱

即使按照最佳实践配置,偶尔还是会遇到问题。这里整理了一些实用的故障排除命令和技巧。

5.1 连接问题快速诊断

检查PostgreSQL日志:

# 查看容器日志
docker logs smart-postgres

# 或者直接查看PostgreSQL日志文件
docker exec smart-postgres tail -f /var/lib/postgresql/data/log/postgresql-*.log

测试数据库连接:

# 从宿主机测试
psql -h localhost -p 5432 -U admin -d smartwater

# 从容器内部测试
docker exec -it smart-postgres psql -U admin -d smartwater

查看当前连接:

-- 在psql中执行
SELECT * FROM pg_stat_activity;

5.2 性能问题诊断

查看慢查询:

-- 启用慢查询日志(在postgresql.conf中)
log_min_duration_statement = 1000  -- 记录执行时间超过1秒的查询

-- 查看当前正在运行的慢查询
SELECT pid, now() - pg_stat_activity.query_start AS duration, query 
FROM pg_stat_activity 
WHERE (now() - pg_stat_activity.query_start) > interval '1 second';

索引使用情况:

-- 查看未使用的索引
SELECT schemaname, tablename, indexname 
FROM pg_stat_user_indexes 
WHERE idx_scan = 0;

5.3 容器特定问题

数据卷权限问题:

# 如果PostgreSQL启动失败,可能是数据卷权限问题
docker run --rm -v postgres-data:/var/lib/postgresql/data alpine chown -R 999:999 /var/lib/postgresql/data

网络问题诊断:

# 检查容器网络配置
docker network inspect bridge

# 测试容器间连通性
docker exec smartwater-app ping postgres

资源限制问题:

# 查看容器资源使用情况
docker stats smart-postgres

# 调整容器资源限制
docker update --memory 2g --memory-swap 3g smart-postgres

5.4 常见错误及解决方案

错误信息可能原因解决方案
FATAL: password authentication failed for user密码错误或用户不存在检查环境变量,确认用户已创建
FATAL: no pg_hba.conf entry for host客户端IP不在允许列表中修改pg_hba.conf添加相应规则
could not connect to server: Connection refused服务未启动或端口未监听检查容器状态和端口映射
database "xxx" does not exist数据库不存在创建数据库或检查连接URL
remaining connection slots are reserved for non-replication superuser connections连接池耗尽增加max_connections或使用连接池

6. 实际案例:SmartWaterServer项目部署实录

让我分享一个最近部署的真实案例。团队使用的是RuoYi-Vue-Plus 5.X版本,需要同时部署PostgreSQL和Redis,并且要支持多个环境的配置。

6.1 项目结构

smartwater-server/
├── docker-compose.yml
├── docker-compose.prod.yml
├── config/
│   ├── postgresql/
│   │   ├── postgresql.conf
│   │   └── pg_hba.conf
│   └── redis/
│       └── redis.conf
├── init-scripts/
│   └── 01-init-db.sql
└── .env

6.2 环境配置文件

.env文件(不提交到版本控制):

# 数据库配置
POSTGRES_USER=smartwater_admin
POSTGRES_PASSWORD=ChangeThisInProduction!
POSTGRES_DB=smartwater_prod
POSTGRES_PORT=5432

# Redis配置
REDIS_PASSWORD=RedisPassword123
REDIS_PORT=6379

# 应用配置
APP_PORT=8080
APP_ENV=production

6.3 Docker Compose配置

docker-compose.yml:

version: '3.8'

services:
  postgres:
    image: postgres:15-alpine
    container_name: ${POSTGRES_CONTAINER_NAME:-smartwater-postgres}
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --locale=C --lc-collate=C --lc-ctype=C"
    ports:
      - "${POSTGRES_PORT}:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
      - ./config/postgresql/postgresql.conf:/etc/postgresql/postgresql.conf
      - ./config/postgresql/pg_hba.conf:/etc/postgresql/pg_hba.conf
      - ./init-scripts:/docker-entrypoint-initdb.d
    command: >
      postgres 
      -c config_file=/etc/postgresql/postgresql.conf 
      -c hba_file=/etc/postgresql/pg_hba.conf
      -c shared_preload_libraries=pg_stat_statements
    networks:
      - smartwater-network
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER}"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    restart: unless-stopped
    deploy:
      resources:
        limits:
          memory: 2G
        reservations:
          memory: 512M

  redis:
    image: redis:7-alpine
    container_name: ${REDIS_CONTAINER_NAME:-smartwater-redis}
    command: >
      redis-server 
      --requirepass ${REDIS_PASSWORD}
      --appendonly yes
      --appendfsync everysec
      --maxmemory 512mb
      --maxmemory-policy allkeys-lru
    ports:
      - "${REDIS_PORT}:6379"
    volumes:
      - redis-data:/data
      - ./config/redis/redis.conf:/usr/local/etc/redis/redis.conf
    networks:
      - smartwater-network
    healthcheck:
      test: ["CMD", "redis-cli", "--raw", "incr", "ping"]
      interval: 10s
      timeout: 3s
      retries: 3
    restart: unless-stopped

  app:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        APP_ENV: ${APP_ENV:-production}
    container_name: ${APP_CONTAINER_NAME:-smartwater-app}
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/${POSTGRES_DB}
      SPRING_DATASOURCE_USERNAME: ${POSTGRES_USER}
      SPRING_DATASOURCE_PASSWORD: ${POSTGRES_PASSWORD}
      SPRING_REDIS_HOST: redis
      SPRING_REDIS_PORT: 6379
      SPRING_REDIS_PASSWORD: ${REDIS_PASSWORD}
      JAVA_OPTS: "-Xmx1g -Xms512m -XX:+UseG1GC"
    ports:
      - "${APP_PORT}:8080"
    networks:
      - smartwater-network
    restart: unless-stopped
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

volumes:
  postgres-data:
    driver: local
    driver_opts:
      type: none
      device: ${PWD}/data/postgres
      o: bind
  redis-data:
    driver: local
    driver_opts:
      type: none
      device: ${PWD}/data/redis
      o: bind

networks:
  smartwater-network:
    driver: bridge
    ipam:
      config:
        - subnet: 172.20.0.0/16

6.4 初始化脚本

init-scripts/01-init-db.sql:

-- 创建应用专用用户(非超级用户)
CREATE USER smartwater_app WITH PASSWORD 'AppPassword123!';

-- 创建监控用户(用于Prometheus等监控工具)
CREATE USER monitor WITH PASSWORD 'MonitorPass456!';

-- 为应用用户授权
GRANT CONNECT ON DATABASE smartwater_prod TO smartwater_app;
GRANT USAGE ON SCHEMA public TO smartwater_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO smartwater_app;
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO smartwater_app;

-- 为监控用户授权(只读)
GRANT CONNECT ON DATABASE smartwater_prod TO monitor;
GRANT USAGE ON SCHEMA public TO monitor;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO monitor;

-- 启用扩展
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
CREATE EXTENSION IF NOT EXISTS "pg_stat_statements";

-- 创建监控视图
CREATE OR REPLACE VIEW public.database_stats AS
SELECT 
  datname,
  numbackends as active_connections,
  xact_commit as transactions_committed,
  xact_rollback as transactions_rolled_back
FROM pg_stat_database 
WHERE datname = current_database();

6.5 部署和验证

启动服务:

# 开发环境
docker-compose up -d

# 生产环境(使用覆盖文件)
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

验证连接:

# 测试数据库连接
docker exec smartwater-app curl -X GET "http://localhost:8080/api/health"

# 检查数据库状态
docker exec smartwater-postgres psql -U smartwater_admin -d smartwater_prod -c "SELECT version();"

# 查看服务日志
docker-compose logs -f app

监控配置:

# 查看资源使用情况
docker stats

# 查看服务状态
docker-compose ps

# 进入数据库容器进行维护
docker exec -it smartwater-postgres psql -U smartwater_admin -d smartwater_prod

这个配置在实际项目中运行稳定,支持了团队的开发、测试和生产环境。关键点在于:

  1. 环境变量管理:敏感信息通过.env文件管理,不进入代码仓库
  2. 健康检查:确保服务依赖关系正确
  3. 资源限制:防止单个容器占用过多资源
  4. 数据持久化:使用绑定挂载,数据在宿主机上
  5. 网络隔离:自定义网络,提高安全性

7. 经验总结与实用建议

经过多个项目的实践,我发现大多数Docker化PostgreSQL的连接问题都可以归结为几个常见原因。这里分享一些从实际运维中总结的经验。

配置文件加载顺序很重要。PostgreSQL在启动时会按特定顺序加载配置,如果你同时使用了多种配置方式(环境变量、命令行参数、配置文件),需要了解它们的优先级。一般来说,命令行参数的优先级最高,然后是配置文件,最后是环境变量。

数据卷的权限问题经常被忽略。特别是当你在Linux宿主机上以非root用户运行Docker时,PostgreSQL容器(默认以postgres用户运行,UID=999)可能没有权限写入挂载的数据目录。解决方法是在启动容器前确保目录权限正确,或者使用命名卷让Docker自动管理权限。

网络模式影响连接方式。如果你使用Docker的host网络模式,容器会直接使用宿主机的网络栈,这时localhost在容器内和宿主机上是同一个。但在默认的bridge网络模式下,每个容器有自己的网络命名空间,localhost只指向容器自身。

连接池是必须的。即使你的应用连接数不多,也建议使用连接池。这不仅能提高性能,还能避免因为连接泄漏导致数据库连接耗尽。在Spring Boot项目中,HikariCP是默认的连接池,但需要合理配置:

spring:
  datasource:
    hikari:
      maximum-pool-size: 20
      minimum-idle: 5
      connection-timeout: 30000
      idle-timeout: 600000
      max-lifetime: 1800000
      connection-test-query: SELECT 1

定期维护不能少。即使运行在容器中,PostgreSQL也需要定期维护。设置定时任务执行VACUUM、ANALYZE和备份:

# 在宿主机上设置cron任务
0 2 * * * docker exec smart-postgres pg_dump -U admin smartwater > /backups/smartwater_$(date +\%Y\%m\%d).sql
0 3 * * * docker exec smart-postgres vacuumdb -U admin -d smartwater -z

监控告警要提前设置。使用Prometheus + Grafana监控数据库关键指标:

  • 连接数
  • 查询性能
  • 锁等待
  • 磁盘使用
  • 复制延迟(如果有从库)

最后,保持镜像和配置的版本控制。所有Dockerfile、docker-compose.yml和配置文件都应该纳入版本控制系统。每次变更都要有记录,这样在出现问题时可以快速回滚。

我在实际项目中遇到过最棘手的一个问题是连接数缓慢增长直到耗尽,最后发现是一个第三方库没有正确关闭数据库连接。通过监控及时发现并修复了这个问题。所以,无论配置多么完美,监控和日志永远是排查问题的第一道防线。

PostgreSQL远程连接失败?别慌,这5个配置检查清单帮你快速定位(附CentOS 7/8实战) 本文详细解析了PostgreSQL远程连接失败的常见原因及解决方案,包括防火墙设置、监听地址配置、客户端认证、服务状态检查等关键步骤。特别针对CentOS 7/8环境提供了实战指南,帮助用户快速定位并解决连接问题,确保数据库的稳定访问。 阅读详情

相关推荐

500道C++面试高频题解析(附答案、实战示例与进阶追问)

本文提供500道C++面试高频题的详细解析,涵盖基础概念到进阶应用,包括面向对象编程、内存管理、现代C++特性、并发编程等核心考点。每道题配有实战示例和进阶追问,帮助开发者突破八股文局限,掌握解决实际问题的能力,适合准备C++技术面试的工程师系统复习。

weixin_29002595的博客 312

云原生之使用docker部署Postgresql数据库

云原生之使用docker部署Postgresql数据库

jks212454的博客 5337

Gazebo仿真UUV水下机器人:从环境搭建到避障算法实战

本文详细介绍了使用Gazebo仿真平台进行UUV水下机器人开发的全流程,涵盖从环境搭建、uuv_simulator配置、传感器集成到核心避障算法实战。通过搭建水下仿真实验室并实现基于激光雷达数据的反应式避障算法,为水下机器人算法验证与开发提供了高效、低成本的解决方案。

weixin_28840591的博客 265

docker一键运行postgres,postgis,并开启远程访问

docker run --name postgres -p 5432:5432 -e POSTGRES_PASSWORD=postgres -e ALLOW_IP_RANGE=0.0.0.0/0 postgis/postgis -d postgres

taizhimin 1754

机器学习 线性回归 头歌实训

第1关:简单线性回归与多元线性回归 第2关:线性回归的正规方程解 第3关:衡量线性回归的性能指标 第4关:scikit-learn线性回归实践 - 波斯顿房价预测

weixin_57270536的博客 1万+

微信H5网页支付JSAPI部分用户报错:system:access_denied 的解决方案

JSAPI 支付仅支持微信内置浏览器调用。

代码简单说 Vue、JAVA、PHP、Node.js 熟练运用,接口、架构、性能全搞定。 1688

docker部署postgres并配置远程访问

使用PostgreSQL客户端工具(如pgAdmin或psql)连接到PostgreSQL服务器。在连接时,需要提供Docker主机的IP地址和5432端口。以上步骤概述了如何使用Docker部署PostgreSQL并配置远程访问。具体的命令和配置文件修改可能需要根据你的实际环境和需求进行调整。创建一个PostgreSQL容器,并设置环境变量、端口映射和数据卷。使用Docker命令拉取PostgreSQL的官方镜像。应用配置更改后,需要重启容器以使更改生效。,密码为创建容器时设置的密码。

未来已来,AI时代,学AI编程,做AI量化,就来大鹏AI教育。 2480

社区版 ABAP MCP 能不能读取 SAP S/4HANA 公有云开发对象,我的判断是能试,但不能当成已被 SAP 背书的标准通道

文章摘要:当前存在多个社区项目(如mcp-abap-adt、mcp-abap-abap-adt-api等)通过包装ABAP ADT能力为MCP Server,使AI开发工具能读取ABAP对象。这些项目技术上依赖ADT HTTP API或SAP官方ADT language server,但针对SAP S/4HANA Cloud Public Edition的完整适配仍存在挑战。SAP官方已通过VS Code扩展提供ADT MCP能力,而社区方案在云环境下需遵循ABAP Cloud的严格限制,仅能访问已授权的开

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 90

postgres 禁止远程登录_Postgresql允许远程访问配置修改

1、解决不能连接远程postgresql:postgresql默认情况下,远程访问不能成功,如果需要允许远程访问,需要修改两个配置文件,说明如下:1.postgresql.conf将该文件中的listen_addresses项值设定为“*”,在9.0 Windows版中,该项配置已经是“*”无需修改。2.pg_hba.conf在该配置文件的host all all 127.0.0.1/32 md5...

weixin_31052141的博客 1113

[QMT量化交易小白入门]-五十、十年基本保证每年盈利,全天ETF候稳稳的幸福

全局参数raise_rate = -1 # 触发rebalance的上涨比例period: 设定为22,表示每22个交易日执行一次调仓(即大约每月一次)。这是策略的时间框架基础。raise_rate: 初始值设为-1,意味着默认情况下不会因为资产的涨幅而触发调仓。这一参数用于控制是否基于资产表现动态调整仓位。run_count: 用于记录策略运行的次数,帮助判断何时执行定期调仓。1、为了简便计算,回撤时将调仓再平衡是先卖出再买入,没有比较持仓,实盘时是需要计算的,减少交易费用。

木头大左的博客 808

优快云独家首发!万字长文,YOLOv5/v7/v8算法模型yaml文件史上最详细解析与教程!小白也能看懂!掌握了这个就掌握了魔改YOLO的核心!

🍀🍀🍀YOLOv5/v7/v8算法模型yaml文件史上最详细解析与教程,全网最强,学不会算我输!!!

Coding... 1万+

若依框架RuoYi-Vue-Plus-5.X的启动,本地安装docker,再部署 Redis、PG数据库SmartWaterServer

拉取镜像启动Redis容器。

m0_73456341的博客 9052

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

postgresql数据库开启远程访问(FATAL: no pg_hba.conf entry for host)

docker 安装postgresql,开启远程访问postgresql数据库开启远程访问1.docker安装数据库2.解决org.postgresql.util.PSQLException: FATAL: no pg_hba.conf entry for host postgresql数据库开启远程访问 1.docker安装数据库 docker run --name postgresql14 -v /mysoft/postgresql/datadir:/var/lib/postgresql/data -e

不如打代码 3713

廖雪峰Python教程[完整版]

廖雪峰的python教程整理的,已经排好版了,而且还是完整的,适合小白

数学建模模型总结

这是本人在两年内准备参加数学建模竞赛搜集到的模型资料,已经经过了本人的筛选和整理,希望能够对准备参加数学建模竞赛的学弟学妹们提供一些帮助!

记录ruoyi-plus-vue部署的问题

注意 构建镜像时 先查看 端口有没有被占用,占用的修改掉。无法在外网访问, 查看 是否开启了防火墙,将端口开放。idea连接eidocker 运行。

wonder_dog的博客 970

VC中sqlite的使用

在VC中对sqlite的使用,实现数据库大批数据的快速插入,读取数据库中的数据在ListCtrl中显示

PostgreSQL 允许远程访问设置方法

安 装PostgreSQL数据库之后,默认是只接受本地访问连接。如果想在其他主机上访问PostgreSQL数据库服务器,就需要进行相应的配置。配置远 程连接PostgreSQL数据库的步骤很简单,只需要修改data目录下的pg_hba.conf和postgresql.conf。 pg_hba.conf:配置对数据库的访问权限, postgresql.conf:配置PostgreSQL数据库服务

═☆冰之旅☆═的专栏 8万+

docker postgres远程数据库配置

准备 安装好docker docker pull postgres docker pull dpage/pgadmin4 启动docker数据库 在根目录新建一个文件夹database run postgres docker image docker run --name postgres -v dv_pgdata:/database -e POSTGRES_PASSWORD=Password -p 5432:5432 -d postgres 为数据库设置user postgres, conta

u013269668的博客 1522

Docker postgresql数据卷挂载,端口映射,数据库备份

网上找了好多docker安装postgresql的教程,但是很多的命令只有一部分,像映射端口,远程连接,从本机导入.sql文件,从postgresql容器导出数据库,比较片面,只好自己总结一个。  docker run --name your-postgresql -v ~/Docker/your-postgresql/data:/home/data/ -e POSTGRES_PASSWOR

anderfang的博客 1万+

gitlab docker中postgresql远程访问配置

1.配置postgresql远程访问 配置postgresql远程访问,需要修改两个文件,在gitlab-ce的docker中位置为 /var/opt/gitlab/postgresql/data 首先,修改pg_hba.conf 在最后加入host  all  all  0.0.0.0/0  trust 然后,修改postgresql.conf 查找listen,会知道listen=...

weixin_30258901的博客 1984

连接在docker中运行的PostgreSQL数据库

背景描述 随着容器化进程的加速,相比于传统虚拟机存在的巨大优势,分布式云计算的兴起,以docker为代表的容器化技术解决方案越来越流行。作为一种不算新兴技术的技术,毕竟docker所用到的技术在早很多年就存在,只是docker的出现让这些技术真正的组合在了一起,并开始发挥效用。docker相比于虚拟机的解决方案使用更少的宿主机资源,可扩展性更加优秀,相比于单独的软件安装,出现的问题更少,更容易部署...

左手是诗,右手是代码。 1万+
上一篇: 嵌入式开发必备:i2cset命令实战指南(附常见设备操作示例)
下一篇: 5分钟搞定Prettier + 路径别名:提升Tauri2.0+Vue3项目的开发体验
pluto
博客等级 码龄25年 46粉丝 1562原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值