HelloHello Docs

安装与配置

这页只放部署现场要用的内容：怎么装、配置文件在哪、每段配置管什么，以及双 IPG 的职责边界。完整字段口径跟当前示例配置和运行实现保持一致。

01

快速开始

安装后打开 TUI，再按现场需要启用监控目标。

bash — hellohello
安装$curl -fsSL https://hello.ahua.space/sh | bash
更新$curl -fsSL https://hello.ahua.space/sh | bash -s -- update
卸载$curl -fsSL https://hello.ahua.space/sh | bash -s -- uninstall
TUI$sudo hello
配置文件/Library/Application Support/HelloHello/config.toml
02

默认不主动监控示例地址

安装生成的示例配置保持 opt-in。普通主机需要取消对应[[hosts]] 注释；IPG 需要取消[ipg]、[ipg.car]、[ipg.onset] 相关注释。

普通主机

只走 ICMP。字段最少需要 name 和 ip。

双 IPG

先填 ipg.car.ip，再配置现场 IPG。

通知

灵动岛默认启用；钉钉需要配置 Webhook 地址和签名密钥。

03

配置清单

按配置段查字段职责。这里不复制整份 TOML，只保留部署时最容易查错的字段和边界。

基础配置常规监控与通知5 个配置段
[general]

基础检测参数

控制普通主机的默认检测节奏和 UP / DOWN 防抖阈值。

version
配置文件版本号，固定为 1。
interval_seconds
默认检测间隔，普通主机未单独设置时使用。
fail_count / success_count
普通 ICMP 主机连续失败或连续成功达到阈值后才切换状态。
[notify]

通知模板

定义告警、恢复和预警正文；IPG 可使用专属模板。

down / up / warn
分别用于 DOWN、UP、WARN 通知。
{detail}
IPG 语义告警的摘要会进入这个占位符。
[notify.ipg]
仅对 ipg.car / ipg.onset 生效，未配置时回退到全局模板。
[[hosts]]

普通主机

只放普通 ICMP 主机；IPG 不再写在这里。

name / ip
普通主机显示名称和 IP 或域名。
protocol
可省略，默认 icmp；不要写 protocol = "ipg"。
at_mobiles
该主机触发通知时额外 @ 的手机号列表。
[webhook]

钉钉 Webhook

控制钉钉机器人通知通道。

enabled
是否启用钉钉 Webhook。
url
钉钉机器人 Webhook 地址。
secret
钉钉机器人 HMAC-SHA256 签名密钥。
[macos]

macOS 灵动岛

控制本机灵动岛通知的显示行为。

dynamic_island_enabled
是否启用灵动岛通知通道。
dynamic_island_duration_ms
展示时长；0 表示手动关闭，自动关闭时最小 500。
startup_silence_seconds
启动静默期，避免服务刚启动就刷屏。
IPG 配置车载与现场设备4 个配置段
[ipg]

双 IPG 共用参数

WebSocket 连接参数和双 IPG 共用提醒手机号。

scheme / port / path
连接协议、端口和路径；path 必须以 / 开头。
connect / read / reconnect
建连、读取和断线重连超时。
stale_timeout_seconds
超过该时间未收到状态推送则判定状态超时。
at_mobiles
双 IPG 共用的 @ 手机号列表。
[ipg.car] / [ipg.onset]

固定设备

HelloHello 固定把 IPG 拆成车载和现场两台设备。

ipg.car.ip
车载 IPG 地址，负责 OPG 光链路。
ipg.onset.ip
现场 IPG 地址，负责 SDI IN / OUT 和电池电压。
依赖关系
配置现场 IPG 前必须先配置 ipg.car.ip。
[ipg.expect]

期望通道

声明哪些通道需要持续参与判定。

required_opg_channels
参与车载链路平均光功率判定的 OPG 通道。
required_sdi_rx_channels
需要持续跟踪的现场 SDI IN 通道。
required_sdi_tx_channels
需要持续跟踪的现场 SDI OUT 通道。
[ipg.thresholds]

IPG 业务阈值

控制 OPG、SDI、Battery 的预警条件。

opg_warn_min / opg_down_min
平均光功率低于阈值进入 WARN / DOWN；0 或正数也进入 WARN。
sdi_rx_warn_enabled / sdi_tx_warn_enabled
是否启用现场 SDI IN / OUT 掉线预警。
battery_warn_enabled / battery_min
是否启用现场电池预警及低压下限；battery_min <= 11 视为未装电池。
04

IPG 成对使用，职责固定

HelloHello 当前固定把 IPG 拆成车载和现场两台设备。车载 IPG 负责 OPG；现场 IPG 负责 SDI 和电池电压。

车载 IPGipg.car
OPG→平均光功率判定 → WARN / DOWN
现场 IPGipg.onset
SDI IN→required 通道掉线检测
SDI OUT→required 通道掉线检测
Battery→低压预警，未装电池可关闭
HelloHello 监控引擎
状态变化 → 灵动岛 / 钉钉通知
05

验证与排错

修改配置后先看 TUI 和服务状态。配置错误不会把旧配置拖下水，但需要及时修正新文件。

验证步骤
  • 配置后运行 sudo hello 查看 TUI。
  • 配置保存后服务会热重载；校验失败时保留旧配置继续运行。
  • IPG 管理固定展示 ipg.car / ipg.onset，并可编辑共用 @ 手机号。
常见排查
  • IPG 启用后必须填写 ipg.port 和以 / 开头的 ipg.path。
  • ipg.onset.ip 不能单独配置，必须先配置 ipg.car.ip。
  • SDI 和电池告警来自现场 IPG；OPG 告警来自车载 IPG。
  • [[hosts]] protocol = "ipg" 已废弃，请迁移到 [ipg.car] / [ipg.onset]。