Pika 探针监控系统

一个基于 Go + PostgreSQL 的实时探针监控系统

快速开始 • 功能特性 • 文档 • 架构

简介

Pika 是一个轻量级的探针监控系统，支持实时数据采集、存储和查询。系统采用 WebSocket 进行探针与服务端的通信，使用 PostgreSQL 存储时序数据，提供完整的 RESTful API 和用户管理功能。

快速开始

环境要求

• Docker 20.10+
• Docker Compose 1.29+

使用 Docker Compose 部署（推荐）

1. 克隆项目

git clone https://github.com/dushixiang/pika.git
cd pika

2. 配置环境变量

编辑 docker-compose.yml 文件，修改以下配置项：

# PostgreSQL 数据库配置
POSTGRES_DB: pika           # 数据库名称
POSTGRES_USER: pika         # 数据库用户名
POSTGRES_PASSWORD: pika     # 数据库密码（建议修改）

# Pika 应用配置
DATABASE_POSTGRES_HOSTNAME: postgresql  # 数据库主机名
DATABASE_POSTGRES_PORT: 5432           # 数据库端口
DATABASE_POSTGRES_USERNAME: pika       # 数据库用户名
DATABASE_POSTGRES_PASSWORD: pika       # 数据库密码（需与上面一致）
DATABASE_POSTGRES_DATABASE: pika       # 数据库名称
SERVER_ADDR: "0.0.0.0:8080"           # 服务监听地址
SERVER_IP_EXTRACTOR: "x-forwarded-for" # IP 提取方式
APP_JWT_SECRET: "your-secret-key"      # JWT 密钥（必须修改！）

重要：请务必修改 APP_JWT_SECRET 为您自己的密钥，建议使用至少 32 位的随机字符串。

生成随机密钥示例：

# 使用 openssl 生成 32 位随机字符串
openssl rand -base64 32

3. 启动服务

# 启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f pika

4. 验证部署

服务启动后，访问以下地址：

• API 服务：http://localhost:8080
• 健康检查：http://localhost:8080/health（如果有）

5. 停止服务

# 停止服务
docker-compose stop

# 停止并删除容器
docker-compose down

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

生产环境部署建议

1. 安全配置

• 修改默认的数据库密码
• 设置强随机的 JWT 密钥
• 使用 HTTPS 反向代理（如 Nginx）
• 限制数据库端口仅允许内部访问

2. 数据持久化

数据库数据默认存储在 ./data/postgresql 目录，请定期备份：

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

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

3. 反向代理配置（Nginx 示例）

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket 支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

故障排查

服务无法启动

# 查看详细日志
docker-compose logs -f

# 检查容器状态
docker-compose ps

# 重启服务
docker-compose restart

数据库连接失败

• 确认 PostgreSQL 容器已启动且健康检查通过
• 检查数据库配置是否正确
• 查看数据库日志：docker-compose logs postgresql

端口冲突

如果 8080 或 5432 端口被占用，修改 docker-compose.yml 中的端口映射：

ports:
  - "8081:8080"  # 将 8080 改为其他端口