返回资讯中心
外部精选
软件工程
#开发者实时流

Labcheck 发布:一条命令检查 Linux 服务器健康状态

来源标题:Labcheck – one command to check if a Linux server is healthy

开源工具 Labcheck 发布 v0.1.0,用一条命令即可检查 Linux 家庭实验室服务器的健康状态。它执行只读检查并输出简洁报告,同时返回 nagios 风格状态码,供 cron、systemd 和监控系统据此采取行动。工具仅需 Python 3.11+,无运行时依赖,当前可通过 pipx 从 GitHub Release 安装,尚未上架 PyPI。

Hacker News 最新Linuxuser052026/11/17 · 今天26 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

一个零依赖的 Linux homelab 健康检查工具。 labcheck 会执行一组只读检查,打印一份简洁的报告,并以 Nagios 风格的状态码退出,因此 cron、systemd 和监控系统可以根据结果采取行动。它只需要 Python 3.11+ 以及典型 homelab 主机上已有的工具。

这是 labcheck --verbose 的真实输出。Docker、RAID、备份和证书检查在服务或目标存在之前会报告 SKIP。 pipx install https://github.com/jacoblockard2007-hub/labcheck/releases/download/v0.1.0/labcheck-0.1.0-py3-none-any.whl labcheck -v

支持 Linux、Python 3.11+,无运行时依赖。wheel 来自最新 release; 目前还没有 PyPI 条目。如果缺少 pipx,可以用 sudo apt install pipx 或 sudo dnf install pipx 安装。

因为 homelab 往往还没有监控栈,而为了回答「一切是否仍然正常?」专门部署一个完整 agent 又太重了。labcheck 的定位是:

检查项 检查内容 跳过条件 system 每核负载、内存、swap、最热的温度传感器、uptime /proc 指标不可读(报告为错误) storage 已挂载本地文件系统的空间和 inode 使用率 所有挂载点都被过滤掉 services 失败的 systemd unit 以及配置的必需服务 systemctl 缺失或 systemd 不可达 docker 容器状态、不健康的容器、必需容器 Docker 未安装 raid 来自 /proc/mdstat 的 Linux md 软件 RAID 阵列 不存在阵列 smart 通过 smartctl 检查 SMART 总体健康状态(需手动启用) 未配置设备或 smartctl 缺失 backups 每个已配置目标中最新匹配文件的年龄 未配置目标 certificates 远程端点的 TLS 证书过期时间 未配置目标 clock 通过 timedatectl 检查 NTP 同步 timedatectl 或 systemd 不可用

安装 要求: 发行版 Python 验证情况 Debian 13 (trixie), x86_64 3.13 完整报告 Ubuntu 26.04.1 LTS, x86_64 3.14 完整报告 Fedora Linux 45, x86_64 3.15 完整报告

需要服务或已配置目标的检查在目标存在之前会报告 SKIP,因此一台干净的主机会对 Docker、RAID、备份和证书显示 SKIP。如果出现异常行为,请在 issue 中报告你的发行版。

每个 release 都会附带 wheel、sdist 和 SHA256SUMS。上面的快速开始通过 URL 安装当前 wheel。要固定其他版本,请从 releases 页面下载对应资产并安装该文件: pipx install ~/Downloads/labcheck-X.Y.Z-py3-none-any.whl

用附带的校验和验证下载文件: sha256sum -c SHA256SUMS

使用 pipx 从 git 安装 pipx install git+https://github.com/jacoblockard2007-hub/labcheck.git

从本地检出安装 python3 -m pip install . labcheck --version

免安装运行 也可以直接从本地检出运行,无需安装任何东西: python3 -m labcheck --version

如果你偏好隔离的应用环境,pipx install . 也可以。没有需要下载的运行时依赖。

labcheck # 完整报告 labcheck --verbose # 增加每项检查的详细信息 labcheck --only storage,system # 只运行子集(逗号分隔) labcheck --skip docker # 从已配置的检查集中移除某些检查 labcheck --list-checks # 显示检查项以及配置是否启用它们 labcheck --json # 机器可读的报告 labcheck --prometheus # Prometheus 文本暴露格式 labcheck --output report.txt # 原子写入文件 labcheck --config ./labcheck.toml

--only 也可以运行配置中禁用的检查,这在临时做一次 SMART 测试时很方便: labcheck --only smart --verbose

示例报告 $ labcheck labcheck 0.1.0 · atlas · 2026-06-01 12:00:00 UTC OK System load 0.42 (8 cores), memory 38%, swap 2%, up 27d 4h WARN Storage /srv at 84% used (+1 more), 5 mounts OK Services no failed units CRIT Containers 1 unhealthy: nextcloud OK RAID 2 arrays healthy (md0, md1) SKIP SMART no devices configured OK Backups 2 targets fresh WARN Certificates cloud.example.com:443 9d left OK Clock NTP synchronized Summary: 1 critical, 2 warnings, 5 ok, 1 skipped (0.31s)

退出码 代码 含义 0 OK,或所有检查都被跳过 1 至少有一个警告 2 至少有一个严重问题 3 某项检查无法运行,或 labcheck 自身失败(配置错误、参数错误、输出不可写)

跳过的检查永远不会改变退出码。警告和严重问题会合并为单一的总体状态。

仅当 stdout 是终端时才启用 ANSI 颜色。--no-color 可以禁用颜色,设置 NO_COLOR 环境变量也可以。

所有设置都是可选的。优先使用显式配置路径,否则依次查找:

完整的带注释文件包含在 labcheck.example.toml 中。最小示例: [storage] warn_disk_percent = 75 ignore_mounts = ["/snap/"] [systemd] required_services = ["ssh.service", "smbd.service"] [backups] [[backups.targets]] name = "database" path = "/srv/backups/database-.sql.gz" max_age_hours = 26 [certificates] [[certificates.targets]] host = "cloud.example.com" warn_days = 30 crit_days = 7

说明: 段 键与默认值 [system] enabled, warn_load_per_core = 1.5, crit_load_per_core = 3.0, warn_memory_percent = 85, crit_memory_percent = 95, warn_swap_percent = 50, crit_swap_percent = 80, warn_temperature_c = 75, crit_temperature_c = 85, check_swap = true [storage] enabled, warn_disk_percent = 80, crit_disk_percent = 90, warn_inode_percent = 85, crit_inode_percent = 95, ignore_mounts = [], only_mounts = [], ignore_filesystems = [] [systemd] enabled, required_services = [], allow_failed = [] [docker] enabled, require_running = [], ignore = [] [raid] enabled [smart] enabled = false, devices = [] [backups] enabled, [[backups.targets]] 包含 name, path, max_age_hours = 24 [certificates] enabled, timeout_seconds = 5, [[certificates.targets]] 包含 host, port = 443, warn_days = 14, crit_days = 7 [clock] enabled

Cron 与 node_exporter 一个简单的 cron 任务,用于写入人类可读的快照: */15 * * * * root /usr/local/bin/labcheck --output /var/lib/labcheck/status.txt 退出码仍然反映结果,并且 --output 使用临时文件

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →