0xfurai/peekaping-bundle-sqlite

Peekaping Docker镜像文档

镜像概述

Peekaping 是一款现代化的自托管正常运行时间监控解决方案，基于 Go 后端和 React 前端构建。该解决方案专为需要监控网站、API 及各类服务可用性的用户设计，提供实时通知、直观的状态页面和全面的性能分析功能，支持私有部署以确保数据隐私与控制权。

核心功能与特性

• 多目标监控：支持对网站、API 端点及各类网络服务进行可用性检测
• 实时通知：服务异常或恢复时触发即时通知（支持多种通知渠道，具体可参考官方文档）
• 可视化状态页面：可自定义的美观状态页面，清晰展示各服务当前状态与历史可用性
• 数据 analytics：提供服务响应时间、可用性百分比等关键指标的详细分析报告
• 自托管架构：数据存储于本地环境，避免第三方依赖，确保数据安全与隐私
• 技术优势：Go 后端保障高效稳定的监控性能，React 前端提供流畅的用户体验

使用场景与适用范围

• 个人开发者监控自有网站或 API 服务的运行状态
• 小型团队部署私有监控系统，跟踪内部服务可用性
• 企业需要向用户展示公开服务状态页面（如 SaaS 产品状态页）
• 对服务响应时间、错误率等性能指标有持续观测需求的场景

源码与官方文档

源代码仓库：https://github.com/0xfurai/peekaping
（更多配置细节、通知渠道设置及高级功能请参考官方文档）

部署与使用指南

基本 Docker 运行命令

bash
# 简单启动（使用默认SQLite数据库，数据存储于容器内）
docker run -d \
  --name peekaping \
  -p 8080:8080 \  # 映射Web访问端口（默认端口可能为8080，具体以官方为准）
  0xfurai/peekaping-bundle-sqlite

Docker Compose 持久化部署（推荐）

yaml
version: '3.8'

services:
  peekaping:
    image: 0xfurai/peekaping-bundle-sqlite
    container_name: peekaping
    restart: unless-stopped
    ports:
      - "8080:8080"  # 根据需求调整宿主机端口
    volumes:
      - ./peekaping-data:/app/data  # 挂载数据卷，持久化SQLite数据库及配置
    environment:
      - TZ=Asia/Shanghai  # 设置时区（可选）
      # 更多环境变量配置请参考官方文档（如通知密钥、自定义端口等）

访问与初始化

1. 部署完成后，通过 http://<宿主机IP>:8080 访问 Peekaping 管理界面
2. 首次登录需创建管理员账户（具体步骤请参考官方初始化指南）
3. 登录后可添加监控目标、配置通知规则及自定义状态页面

注意事项

• 持久化存储：建议通过挂载数据卷（如示例中的 ./peekaping-data）保存数据库文件，避免容器重建导致数据丢失
• 资源需求：根据监控目标数量调整容器资源（CPU/内存），大量监控任务建议适当增加配置
• 网络策略：确保容器可访问被监控的目标服务，同时开放宿主机端口以允许外部访问状态页面