geerlingguy/chronytop
运维与部署仿 btop 风格的终端界面,实时监控 chrony NTP 服务器、客户端和主机资源占用。
项目介绍
chronytop 是给 chrony NTP 时间服务器运维者用的终端界面,视觉风格参考 btop。它绘制每秒 NTP 请求量曲线,并展示服务器计数器、被 chronyd 限流最多的客户端、时间源、跟踪状态、带宽,以及主机(含 chronyd 进程)的 CPU 和内存占用。面板随终端尺寸调整,可单独显示或隐藏。
它是一个不依赖 Go 标准库之外组件的静态二进制,只读取 /proc 和调用 /usr/bin/chronyc,不建立网络连接。在运行 chrony 的主机上启动它,就能查看守护进程的运行统计。
快速使用
需要 Linux 和 chrony 4.0 及以上(/usr/bin/chronyc),server 与 offenders 面板需要 root 或 sudo。
-
从 Releases 下载对应架构的二进制并安装:
sudo install -o root -g root -m 755 chronytop-linux-amd64 /usr/local/bin/chronytop -
以提权方式运行:
sudo chronytop -
用
1–7显示或隐藏各面板,+/-调慢或调快采样,?或h打开帮助,q或Esc退出。也可用-i指定采样间隔(默认1s,范围 500ms–10s),用-p设置客户端进入 offenders 列表的最小包数(默认100)。
也可以从源码构建,需要 Go 1.24 及以上:
CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" -o chronytop .
非 root 运行
tracking、sources、net 和 system 面板对任意用户可见。server 和 offenders 面板依赖 chronyd 的 serverstats 与 clients 命令,默认只通过 /run/chrony 下的 Unix socket 应答。
chrony 4.7 及以上可在 chrony.conf 中加入 opencommands activity manual rtcdata smoothing sourcename sources sourcestats tracking serverstats clients 允许本地用户使用这些命令,然后重启 chronyd。更老的版本把用户加入 chrony 用户组仅在组可写 /run/chrony 时有效;Debian 和 Ubuntu 把该目录建为 0700,所以仍需 sudo。加入用户组会获得 chronyd 控制 socket 的完整权限,而不只是统计信息。具体步骤见 Running without root。
使用约束
- 需要 Linux 主机和 chrony 4.0 及以上,其他平台未涉及。
- 面板可见性和采样间隔在退出时保存到
~/.config/chronytop/chronytop.conf(用sudo时为/root/.config/...),下次启动恢复;-i会覆盖已保存的间隔。 - offenders 列表每 10 秒在后台刷新一次,因此在有大量客户端的公共服务器上开销也不高。
- 由于通常以 root 运行,chronytop 只读取
/proc、用绝对路径且不经 shell 调用chronyc,只把设置写入属于当前用户的路径并通过临时文件保存,同时过滤 chrony 数据中的非打印字符。 - 采用 MIT 许可证。
HotRepo 点评
HotRepo 记录到 chronytop 在 2026-11-18 进入 Go 语言新项目榜,约 16 小时的窗口内新增 102 Star、5 Fork,未记录到全语言日榜名次。由于只有一个时间点,这更像早期关注度的快照,而非成型的趋势。把 btop 式的交互布局带给原本以命令行为主的 chrony 统计,是它最实际的差异点;对维护公共或繁忙 NTP 服务器、需要快速定位被限流客户端的人价值最大。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- henrygd/beszel轻量自托管的服务器与 Docker 容器监控中心,带历史数据和告警。
- prometheus/prometheus用单机拉取式监控服务器采集、查询服务指标并按条件触发告警。
- VictoriaMetrics/VictoriaMetrics面向需要长期存储并查询海量指标数据的团队,可作为 Prometheus 兼容的时序数据库与监控后端。
- ValidatorStack/solana-vigil面向 Linux Solana 验证节点的只读监控与主机审计工具,覆盖 VAT 余额、BLS、出块与告警。
- gnacho/netpulse自托管的 OpenWrt/GL.iNet 家庭网络监控面板,实时汇总体检、设备、WireGuard 和 AdGuard 统计。