Pika 探针监控系统

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

快速开始 • 截图 • 功能特性 • 加入群聊

简介

Pika 是一个轻量级的探针监控系统，支持实时数据采集、存储和查询。系统采用 WebSocket 进行探针与服务端的通信，使用 PostgreSQL 存储时序数据。除了基础监控功能外，还提供 Linux 应急响应和安全基线检查能力，帮助快速发现和分析系统安全风险。

功能特性

📊 实时性能监控

• 系统资源监控：CPU、内存、磁盘、网络、GPU、温度等指标
• 时序数据查询：支持多种时间范围（5分钟、15分钟、30分钟、1小时），实时刷新和历史趋势分析

🔍 服务监控

• HTTP/HTTPS 监控：支持状态码检查、响应时间测量、内容匹配、HTTPS 证书到期检测
• TCP 端口监控：检测端口连通性和响应时间
• ICMP/Ping 监控：测量网络延迟和丢包率

🛡️ 防篡改保护

• 文件保护：保护关键目录，防止未授权修改
• 实时监控：基于 fsnotify 实时监控受保护目录的文件变动
• 属性巡检：定期检查不可变属性，自动恢复被篡改的保护
• 事件告警：实时上报文件变动事件和属性篡改告警

🔒 安全审计与应急响应

• 资产清单收集：支持收集网络资产（端口、连接、防火墙）、进程资产、用户资产（SSH配置、密钥）、登录日志、文件资产（Cron、服务、启动脚本）、内核资产等
• 安全风险分析：自动检测登录异常、可疑进程、用户权限风险、SSH配置安全问题等，并按严重程度分级（Critical/High/Medium/Low）
• 历史审计记录：保存审计历史，支持查询和对比

🔐 认证与授权

• 支持多种认证方式：Basic Auth（bcrypt）、OIDC、GitHub OAuth
• 灵活的权限管理：管理员权限、公开页面、JWT Token 认证

📦 部署与运维

• Docker Compose 一键部署，数据持久化到 PostgreSQL
• 灵活的 YAML 配置文件，支持网卡过滤和数据保留策略

截图

加入群聊

请备注 pika

快速开始

环境要求

• Docker 20.10+
• Docker Compose 1.29+

一键部署

1. 下载配置文件

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

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

2. 修改配置（重要）

编辑 config.yaml 文件，根据需要修改以下配置：

• 数据库配置：确保数据库连接信息与 docker-compose.yml 中的 PostgreSQL 服务配置一致

  Database:
    Postgres:
      Hostname: pika-postgresql  # Docker Compose 服务名
      Port: 5432
      Username: pika
      Password: pika  # 生产环境建议修改
      Database: pika
  

• JWT 密钥：必须修改为强随机字符串

  App:
    JWT:
      Secret: "your-secret-key-here"  # 必须修改
  

  生成随机密钥：

  openssl rand -base64 32
  

• 用户认证：配置管理员账户或启用 OIDC/GitHub 登录

  App:
    # Basic Auth 用户（默认用户名: admin，密码: admin123）
    Users:
      admin: "$2y$12$7DXcOiX1D59xNTIn5riUKusAPLP88LxxoczWmUT83MBj5EFznbp8a"
  
    # 可选：启用 OIDC 认证
    OIDC:
      Enabled: false
      Issuer: "https://your-oidc-provider.com"
      ClientID: "your-client-id"
      ClientSecret: "your-client-secret"
  
    # 可选：启用 GitHub OAuth
    GitHub:
      Enabled: false
      ClientID: "your-github-client-id"
      ClientSecret: "your-github-client-secret"
  

• 生成新的管理员密码：

  # 使用 htpasswd 工具
  htpasswd -nBC 12 '' | tr -d ':\n'
  

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

3. 启动服务

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

# 查看服务状态
docker-compose ps

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

4. 访问服务

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

5. 停止服务

# 停止服务
docker-compose stop

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

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

生产环境部署建议

1. 安全配置

• 修改 docker-compose.yml 中的默认数据库密码（POSTGRES_PASSWORD）
• 修改 config.yaml 中的数据库密码（Database.Postgres.Password），与 docker-compose 中的设置保持一致
• 在 config.yaml 中设置强随机的 JWT 密钥（App.JWT.Secret）
• 修改默认管理员密码或启用 OIDC/GitHub 认证
• 使用 HTTPS 反向代理（如 Nginx）
• 限制数据库端口仅允许内部访问（docker-compose.yml 中已配置为 127.0.0.1:5432:5432）
• 妥善保管 config.yaml 文件，避免泄露敏感信息

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

配置文件问题

• 确认 config.yaml 文件存在于与 docker-compose.yml 同一目录
• 检查 config.yaml 文件格式是否正确（YAML 语法）
• 验证配置文件权限：ls -l config.yaml
• 查看容器内是否成功加载配置：

  docker-compose exec pika cat /app/config.yaml
  

端口冲突

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

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

网卡过滤

如果探针采集到了很多网卡，说明默认的过滤规则已经不适用于你的环境了。

你可以参考 agent.example.yaml 修改 collector 下的 network_include 或者 network_exclude 配置。

IP 归属地

• 注意：GeoIP 数据库需要手动下载并配置路径
• 下载地址 https://github.com/P3TERX/GeoLite.mmdb
• 下载后将config.yaml 中的 GeoIP.Enabled 配置启用，并把路径替换为您的实际路径
• 需要同步修改 docker-compose.yaml 中的文件映射