Gatus 多语言配置教程：几行配置切换状态页语言

Gatus 多语言配置教程：几行配置切换状态页语言

【免费下载链接】gatusAutomated developer-oriented status page with alerting and incident support项目地址: https://gitcode.com/GitHub_Trending/ga/gatus

Gatus 是一款面向开发者的自动化状态监控系统，默认界面全是英文。改语言不需要动前端代码，在 YAML 配置里改几个文本字段，状态监控系统多语言配置就完成了。

场景与痛点：英文界面遇上中文团队

给团队搭状态页时你大概率会碰到这类问题：产品同事想看中文，海外同事想看英文；你只想改一行文案，却得改模板、重新构建整个前端；多个部署环境的页面还要不同的叫法。每次“翻译”都变成一次代码变更，代价不小。

其实页面上大部分文案，压根不用写死在前端。

原理速览：Gatus 国际化是怎么工作的

Gatus 的多语言机制是一条三步链路。启动时它先读配置文件的 ui 块，没写的字段填英文默认值，逻辑在 UI 默认配置。接着用 Go 模板渲染内置的 index.html，把你配置的文案写进页面的 window.config 变量。前端组件展示时直接读这个变量（见 前端页面），读到什么显示什么，没配就回退英文。

进程运行期间还会每 30 秒检查一次配置文件，发现改动就重新加载，不用手动重启。

分步配置：Gatus 多语言配置的 3 个步骤

第一步：把主文案写进 ui 块

打开配置文件（比如 config/config.yaml），在 ui 节点下加这几行：

ui: title: "健康监控仪表板 | Gatus" header: "团队状态页" dashboard-heading: "健康监控仪表板" dashboard-subheading: "实时监控端点的健康状态"

保存后刷新浏览器，新的中文标题、副标题就出来了。title 同时是浏览器标签页标题和页面 meta 描述。

第二步：顺手把按钮文案也配上

页面头部如果有自定义按钮，文案同样来自配置文件：

ui: buttons: - name: "事故反馈" link: "/incidents"

注意 name 和 link 缺一不可，少一个启动时校验直接报错。

第三步：等热加载生效

不用重启服务。Gatus 每 30 秒扫一次配置文件，发现改动就自动加载新配置，界面文案随之切换。

易错点与进阶：3 个容易踩的地方

• 字段只配了一半：只改了 dashboard-heading，忘了 dashboard-subheading，页面就是中文标题配英文副标题。各字段相互独立，不会互相继承。
• 改坏配置会重启服务：新配置 YAML 有语法错误时，默认行为是 panic 重启。生产环境可加skip-invalid-config-update: true，让服务保留旧配置并只记错误日志。
• 按钮校验失败：button 缺 name 或 link 时 Gatus 根本起不来，报 “invalid button configuration” 先查这里。

进阶选项：页面要对外展示时，可以用dark-mode: false关掉默认开启的深色模式；开了 OIDC 登录的话，login-subtitle 还能单独改登录页的副标题文案。

收尾

Gatus 的多语言配置本质上就是“翻译即改配置”：默认值兜底英文，热加载即时生效，维护多套文案的成本很低。下一步建议直接建两份配置——一份中文一份英文，各部署一个 Gatus 实例，两套状态页就都有了。

【免费下载链接】gatusAutomated developer-oriented status page with alerting and incident support项目地址: https://gitcode.com/GitHub_Trending/ga/gatus