Gatus 监控面板中文化:3 步改好界面文案
【免费下载链接】gatusAutomated developer-oriented status page with alerting and incident support项目地址: https://gitcode.com/GitHub_Trending/ga/gatus
公司状态页刚上线,客户第一句话就是:这英文标题是什么意思?不用慌,Gatus 的界面文案都能通过配置文件改。你只需要动几个参数,监控面板马上会说"普通话"。
功能速览 📌
Gatus 是一个自动状态监控页:它按固定频率请求你的接口,把健康状态和响应时间画成一格一格的时间轴,接口挂了还能自动触发告警。对新手最友好的一点是,界面文字全是配置项,你不需要碰任何前端代码。
上手前准备 📝
- 一台能跑 Gatus 的机器,默认监听 8080 端口
- 一个 YAML 配置文件(一般叫 config.yaml,启动时用
--config指定) - 想替换的那几段文字:页面标题、大标题、副标题、按钮名
三步完成界面文案配置
第1步:替换默认标题与副标题
打开 config.yaml,在顶层ui节点下改几个键,没写的字段会自动回落到英文默认值:
ui: title: "服务健康看板 | Gatus" dashboard-heading: "服务健康看板" dashboard-subheading: "实时掌握每个接口的存活状态"title决定浏览器标签页显示的文字,description是页面元描述,可一并修改;顺手把header改成公司名,它会显示在左上角。
第2步:加两个导航按钮
顶部 logo 右侧可以放自定义按钮,每个按钮必须同时写name和link:
ui: buttons: - name: "联系我们" link: "https://status.example.org"第3步:设置默认排序与筛选
在同一个ui节点下追加default-sort-by(可选 name、group、health)和default-filter-by(可选 none、failing、unstable)。比如填default-sort-by: group会让面板按分组折叠展示;填default-filter-by: failing则打开页面就先筛出异常端点。字段定义可对照 config/ui/ui.go 里的Config结构体逐个确认。
效果验证 🔍
保存后重启 Gatus 进程,再刷新浏览器。标签页标题应变成你写的title,顶部大标题和副标题同步更新,点"联系我们"能正常跳转。如果按分组展示正常,界面应该长这样:
常见坑与注意 ⚠️
- 按钮只写了
name没写link(或反过来),Gatus 会报invalid button configuration: missing required name or link并拒绝启动。 default-sort-by填了表外的值,会报must be 'name', 'group', or 'health',核对一下拼写和大小写即可。- 改完文案后默认排序没变?浏览器 localStorage 缓存了你上次手动选的排序,清一下站点数据再刷新。
ui节点缩进写错(比如缩到web下面),整段配置会被忽略,页面保持英文默认样式,可对照 README.md 的字段表排查。
把ui节点里的默认英文换成团队自己的措辞,监控面板就有了统一的脸面——现在就可以打开 config.yaml 改起来。
【免费下载链接】gatusAutomated developer-oriented status page with alerting and incident support项目地址: https://gitcode.com/GitHub_Trending/ga/gatus
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考