Rust 单文件守护进程 · macOS & Linux
一把守护 CLI,让 NetBird 永不静默掉线。
平时零打扰,仅在 NetBird 到期或断开时触发。macOS 自动弹出浏览器登录,Linux 与多设备由飞书机器人直接私聊推送登录按钮,手机点一下即恢复。
$
✓ 自动识别 macOS / Linux
✓ 自动注册后台守护进程
✓ 平时静音,仅到期时推送飞书
Terminal · nbg
$ nbg status
Device : MBP-2.local
DaemonStatus : Connected
FQDN : mbp-2.netbird.selfhosted
NetBird IP : 10.110.68.221/16
Expires At : 2026-11-23 12:55:18 (剩余 1天 5小时)
[12:55:19] 检测到 Session 已过期,需要重新登录
[12:55:20] 执行 netbird up --no-browser
[12:55:21] 捕获 SSO 链接 → 自动打开浏览器 & 推送飞书私聊
[12:55:35] ✓ SSO 登录已完成,已恢复连接
飞书机器人私聊预览
仅到期时发送
🚨 NetBird 已断开,请重新登录 · us-vps-01
设备:
us-vps-01 (Linux)状态:Session 已过期,需要重新登录
FQDN:
us-vps-01.netbird.selfhostedNetBird IP:
10.110.72.15/16🔗 点击登录 NetBird
Features
为多设备工程师设计的零打扰体验
01 · ZERO NOISE
平时完全静音,仅到期时主动通知
默认 renew_before_secs = 0,不会提前刷屏、也不会发多余的状态消息;只有真正到期或断开需要登录时,才会发一条带按钮的飞书卡片。
02 · NATIVE DESKTOP
macOS 自动弹出浏览器 + 桌面通知
在 Mac 上检测到过期时,自动拉起默认浏览器直达公司 SSO 认证页,内置冷却防刷屏,不会弹出满屏标签页。
03 · FEISHU DIRECT MESSAGE
飞书机器人精准私聊,支持无限台设备
每台 Mac、Linux 开发机、云端 VPS 只需填自己的公司邮箱。哪台过期,飞书直接私聊通知你本人,手机点开按钮即可完成认证。
04 · 3MB RUST BINARY
纯 Rust 编译,零依赖一键后台托管
不依赖 Node / Python 运行时,内存占用极低。支持 nbg install 一键注册 macOS launchd 与 Linux systemd 服务。
CLI Reference
常用命令
| 命令 | 说明 |
|---|---|
nbg status | 查看 NetBird 连接状态、FQDN、内网 IP 与剩余过期时间 |
nbg check | 立即执行一次检查(如果已到期或断开会立刻触发登录) |
nbg test | 手动发送一条测试卡片到飞书,验证机器人配置 |
nbg install | 安装并启动开机自启后台服务(macOS launchd / Linux systemd) |
nbg uninstall | 停止并卸载后台守护服务 |