开源推荐
morning
GitHub 热门项目:tinystatus
2026-06-20
1 阅读
GitHub Trending
GitHub 项目:tinystatus
仓库地址:https://github.com/harsxv/tinystatus
星级:1592 | 作者:harsxv
项目描述:Python脚本生成的微型状态页面
===================================================
自述文件内容:
# 微小状态
TinyStatus 是一个简单的、可定制的状态页面生成器,允许您监视各种服务的状态并将它们显示在干净、响应灵敏的网页上。
查看在线演示 https://status.harry.id
|灯光模式 |深色模式 |
|-|-|
|  |  |
## 特点
- 监控 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 &
````