PostgreSQL 版本部署指南

环境要求

Docker 20.10+
Docker Compose 1.29+

快速开始

1. 下载配置文件

# 下载 docker-compose.yml 配置文件
curl -O https://raw.githubusercontent.com/dushixiang/pika/main/docker-compose.postgresql.yml
# 下载配置文件示例
curl -o config.yaml https://raw.githubusercontent.com/dushixiang/pika/main/config.postgresql.yaml

# 或使用 wget
wget https://raw.githubusercontent.com/dushixiang/pika/main/docker-compose.postgresql.yml
wget -O config.yaml https://raw.githubusercontent.com/dushixiang/pika/main/config.postgresql.yaml

2. 修改配置

数据库配置（PostgreSQL）：

database:
  enabled: true
  type: postgres
  postgres:
    hostname: pika-postgresql  # Docker Compose 服务名
    port: 5432
    username: pika
    password: pika  # 生产环境建议修改
    database: pika

注意：如果修改了 docker-compose.postgresql.yml 中的数据库密码（POSTGRES_PASSWORD），也需要同步修改 config.yaml 中的数据库密码。

其他配置项请参考通用配置说明。

3. 启动服务

# 启动所有服务
docker-compose -f docker-compose.postgresql.yml up -d

# 查看服务状态
docker-compose -f docker-compose.postgresql.yml ps

# 查看日志
docker-compose -f docker-compose.postgresql.yml logs -f pika

4. 访问服务

服务启动后，访问 http://localhost:8080

默认账户：

用户名: admin
密码: admin123

5. 停止服务

# 停止服务
docker-compose -f docker-compose.postgresql.yml stop

# 停止并删除容器
docker-compose -f docker-compose.postgresql.yml down

# 停止并删除容器及数据卷
docker-compose -f docker-compose.postgresql.yml down -v

生产环境安全配置

修改 docker-compose.postgresql.yml 中的默认数据库密码（POSTGRES_PASSWORD）
修改 config.yaml 中的数据库密码（database.postgres.password），与 docker-compose 中的设置保持一致
限制数据库端口仅允许内部访问（docker-compose.yml 中已配置为 127.0.0.1:5432:5432）

其他安全配置请参考通用配置说明。

数据持久化

系统数据分别存储在以下目录：

PostgreSQL 数据：./data/postgresql - 存储配置和审计数据
VictoriaMetrics 数据：./data/vmdata - 存储时序指标数据（默认保留 7 天）

备份 PostgreSQL 数据库

# 备份数据库
docker-compose -f docker-compose.postgresql.yml exec postgresql pg_dump -U pika pika > backup.sql

# 恢复数据库
docker-compose -f docker-compose.postgresql.yml exec -T postgresql psql -U pika pika < backup.sql

备份 VictoriaMetrics 数据

# 备份 VictoriaMetrics 数据
tar -czf vmdata-backup-$(date +%Y%m%d).tar.gz ./data/vmdata

# 恢复时停止服务，解压到 ./data/vmdata 目录即可

故障排查

数据库连接失败

确认 PostgreSQL 容器已启动且健康检查通过
检查 config.yaml 中的数据库配置是否正确：
- hostname 应该为 pika-postgresql（Docker Compose 服务名）
- password 应该与 docker-compose.postgresql.yml 中的 POSTGRES_PASSWORD 一致
确认 config.yaml 文件已正确映射到容器中
查看数据库日志：docker-compose -f docker-compose.postgresql.yml logs postgresql
查看应用日志：docker-compose -f docker-compose.postgresql.yml logs pika

其他故障排查请参考通用配置说明。

3.5 KiB Raw Blame History Unescape Escape