GitHub 热门项目:tinystatus

2026-06-20 1 阅读 GitHub Trending
GitHub 项目:tinystatus 仓库地址:https://github.com/harsxv/tinystatus 星级:1592 | 作者:harsxv 项目描述:Python脚本生成的微型状态页面 =================================================== 自述文件内容:
# 微小状态 TinyStatus 是一个简单的、可定制的状态页面生成器,允许您监视各种服务的状态并将它们显示在干净、响应灵敏的网页上。 查看在线演示 https://status.harry.id |灯光模式 |深色模式 | |-|-| | ![轻](https://github.com/user-attachments/assets/3ea7b55e-397f-4f7c-8189-64b74a03594b) | ![暗](https://github.com/user-attachments/assets/92072f9e-1031-4f07-8392-1111df57453a) | ## 特点 - 监控 HTTP 端点、ping 主机并检查开放端口 - 状态页面和历史页面的响应式设计 - 通过 YAML 配置可定制的服务检查 - 事件历史追踪 - 以可配置的时间间隔自动更新状态 - 支持浅色和深色主题 - 支持分组 - 可点击的卡片(可选) ## 先决条件 - Python 3.11 或更高版本 - pip(Python 包管理器) ## 安装 1.克隆存储库或下载源代码: ```` git 克隆 https://github.com/harsxv/tinystatus.git cd 微小状态 ```` 2.安装所需的依赖项: ```` pip install -r 要求.txt ```` ## 配置 1.在项目根目录创建`.env`文件并自定义变量: ```` MONITOR_CONTINOUSLY=真 检查间隔=30 MAX_HISTORY_ENTRIES=100 LOG_LEVEL=信息 CHECKS_FILE=checks.yaml INCIDENTS_FILE=事件.md TEMPLATE_FILE=index.html.主题 HISTORY_TEMPLATE_FILE=history.html.主题 STATUS_HISTORY_FILE=历史记录.json HTML_OUTPUT_DIRECTORY=/var/www/htdocs/status/ ```` 2. 编辑 `checks.yaml` 文件以添加或修改要监控的服务。 示例: ````yaml - 标题:“第一组” 检查: - 名称:GitHub 主页 类型:http 主机:https://github.com 网址:https://docs.github.com/en 预期代码:200 - 名称:谷歌公共 DNS 类型:平 主机:8.8.8.8 - 名称:虚拟 MySQL 数据库 类型: 港口 主机:db.example.com 端口:3306 - 名称:具有自签名证书的家庭服务器 类型:http 主机:https://homeserver.local ssc:正确 预期代码:200 ```` 3.(可选)自定义“incidents.md”文件以添加任何已知事件或维护计划。 4. (可选)修改“index.html.theme”和“history.html.theme”文件以自定义状态页面的外观和风格。 ## 用法 1. 运行 TinyStatus 脚本: ```` 蟒蛇tinystatus.py ```` 2.脚本会生成三个文件: - `index.html`:主状态页面 - `history.html`:状态历史页面 - `history.json`:状态历史记录和时间戳数据 3. 要保持状态页面持续更新,可以在后台运行脚本: - 在类 Unix 系统(Linux、macOS)上: ```` nohup python tinystatus.py & ````