💾 数据库安装指南

🔄 安装流程

📦 TimescaleDB 安装

Docker Compose 安装方式

环境要求

• Docker 20.10.0+
• Docker Compose 2.0.0+
• 4GB+ 可用内存
• 20GB+ 可用磁盘空间

1. 创建安装目录

mkdir -p /srv/timescaledb
cd /srv/timescaledb

2. 创建 Docker Compose 配置

version: '3.8'
services:
  timescaledb:
    # 镜像配置
    image: timescale/timescaledb:latest-pg16
    container_name: timescaledb
    
    # 环境变量
    environment:
      POSTGRES_PASSWORD: wueasy123321    # 数据库密码
      POSTGRES_USER: postgres            # 数据库用户名
      POSTGRES_DB: operation_log         # 默认数据库名
      TIMESCALEDB_TELEMETRY: 'off'      # 关闭遥测
    
    # 端口映射
    ports:
      - "5432:5432"
    
    # 数据持久化
    volumes:
      - ./data:/var/lib/postgresql/data  # 数据目录
      - ./backup:/backup                 # 备份目录
    
    # 资源限制
    deploy:
      resources:
        limits:
          memory: 4G
        reservations:
          memory: 2G
    
    # 健康检查
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
      timeout: 5s
      retries: 5
    
    # 重启策略
    restart: always

3. 启动服务

# 启动数据库
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f

🛠️ 配置优化

性能调优

# 编辑 postgresql.conf
vim data/postgresql.conf

# 推荐配置
max_connections = 200
shared_buffers = 1GB
effective_cache_size = 3GB
maintenance_work_mem = 256MB
checkpoint_completion_target = 0.9
wal_buffers = 16MB
default_statistics_target = 100
random_page_cost = 1.1
effective_io_concurrency = 200
work_mem = 5242kB
min_wal_size = 1GB
max_wal_size = 4GB

安全配置

1. 访问控制

# 编辑 pg_hba.conf
vim data/pg_hba.conf

# 添加访问控制规则
host    all    all    192.168.1.0/24    md5

2. 密码策略

-- 设置密码有效期
ALTER ROLE postgres PASSWORD 'new_password' VALID UNTIL '2025-12-31';

📊 监控管理

1. 查看数据库状态

-- 查看数据库大小
SELECT pg_size_pretty(pg_database_size('operation_log'));

-- 查看表大小
SELECT pg_size_pretty(pg_total_relation_size('operation_logs'));

2. 性能监控

-- 查看活动连接
SELECT * FROM pg_stat_activity;

-- 查看查询性能
SELECT * FROM pg_stat_statements;

❗ 常见问题

1. 启动失败

   • 检查端口占用
   • 验证目录权限
   • 查看错误日志

2. 性能问题

   • 检查资源使用
   • 优化配置参数
   • 执行维护任务

注意事项

• 定期备份数据
• 监控磁盘空间
• 及时更新版本
• 设置合理的资源限制

📚 相关文档

• TimescaleDB官方文档
• PostgreSQL官方文档