部署架构
团队节点是客户内网里一台常开 Linux 服务器上的后台服务:告警源和被纳管主机都在内网里由它直连;团队成员的桌面端从各自电脑连进来,排查结论推到群和手机。
- 告警接入
- 自动排查
- 巡检
- 定时任务
- 成员与权限
部署步骤
- 拿到授权文件
wuffy.lic申请企业试用,授权文件发到邮箱;团队版、政企版用采购时拿到的文件。桌面端和节点用同一个文件。
- 下载安装包
到下载页的「团队节点」按服务器架构(x86_64 / ARM64)下载 .tar.gz 包,拷到服务器上。
- 在服务器上安装
解压后执行
sudo bash install.sh,再导入授权文件、建管理员账号;命令见下文「安装」。 - 桌面端连上节点
设置 → 团队节点,填
<服务器IP>:7443,核对指纹后用管理员登录;其他成员由管理员添加。
团队节点是一台常开的 Linux 服务器上的后台服务:7×24 接收告警(Alertmanager / Zabbix)、自动排查、跑团队的巡检与批量脚本定时,团队成员的 Wuffy 桌面端连它协作。
对服务器的要求
- Linux,x86_64 或 aarch64(鲲鹏、飞腾),glibc ≥ 2.28:麒麟 V10、统信 20、openEuler、CentOS / RHEL 8 及以上、Ubuntu 20.04 及以上、Debian 10 及以上。有 systemd。
- 网络位置:要能直连被监控的东西——告警数据源地址(Alertmanager / Prometheus / Zabbix)和值守主机的 SSH 端口都从节点发起。放在客户内网。桌面端经内网(或中转)连节点的端口(默认 7443)。
- 资源:常驻 100–300MB 内存;Web 巡检时临时再多几百 MB。磁盘 1GB 起(安装约 400MB,另有截图与记录)。
- Web 巡检要用自带的 Chromium,它依赖一些系统库(安装时会检查并提示缺哪些);不做 Web 巡检可以不装这些库,告警、SSH 巡检、批量脚本不受影响。
安装
tar xzf wuffy-node-<版本>-linux-<架构>.tar.gz
cd wuffy-node-<版本>-linux-<架构>
sudo bash install.sh # 默认监听 0.0.0.0:7443,数据在 /var/lib/wuffy-node
# 可选:sudo bash install.sh --listen 0.0.0.0:7443 --name 运维节点 --data-dir /data/wuffy-node
装完:
sudo wuffy-node license /path/to/wuffy.lic # 团队版授权(到期即停值守,续期后一分钟内恢复)
sudo wuffy-node init-admin admin # 建管理员,打印初始密码(只显示一次)
sudo wuffy-node fingerprint # 节点证书指纹,桌面端首次连接时核对
防火墙放行端口(如 firewalld:firewall-cmd --permanent --add-port=7443/tcp && firewall-cmd --reload)。桌面端:设置 → 团队节点,填 <服务器IP>:7443,核对指纹后用管理员登录;其他成员由管理员在桌面端添加,把「邀请信息」发给本人即可。
日常管理
| 命令 | 作用 |
|---|---|
wuffy-node status | 服务状态 |
sudo wuffy-node restart | 重启 |
wuffy-node logs / wuffy-node logs -f | 日志(详细日志在数据目录 logs/) |
wuffy-node version | 版本 |
sudo wuffy-node license <文件> | 更换授权 |
sudo wuffy-node init-admin <用户名> | 建管理员 / 忘了密码时重置 |
sudo wuffy-node backup [目录] | 备份(短暂停服几秒) |
sudo wuffy-node restore <备份文件> | 恢复 |
设置在 /etc/wuffy-node.conf(监听地址、节点名、数据目录),改完 sudo wuffy-node restart。服务名 wuffy-node(systemd),以专用用户 wuffy-node 运行,开机自启、异常退出 5 秒后自动拉起。
银河麒麟:系统开着 kysec 执行控制时,没进信任表的程序会被拒绝运行(报「权限不够」,root 也一样)。install.sh 每次安装、升级都会自动把节点程序、Node、Chromium 和 wuffy-node 命令加入信任表,所以安装要用sudo bash install.sh,不要 ./install.sh。如果服务起不来、日志里是 Permission denied,或 Web 巡检报headless_shell EACCES,手动补一次信任再重启:sudo sh /opt/wuffy-node/lib/wuffy/kysec-trust.sh /opt/wuffy-node /usr/local/bin/wuffy-node && sudo wuffy-node restart。
升级
解压新版本的包,再运行一次 sudo bash install.sh(不用带参数,沿用上次的设置)。数据、授权、账号都不动;桌面端无需重新配对。升级前建议先 sudo wuffy-node backup。
备份(重要)
数据目录里的 node/master.key 是节点主密钥:各主机的密码、私钥、数据源密钥都用它加密。主密钥和数据库必须一起备份,丢了主密钥,凭据全部作废,只能在桌面端重新推送。wuffy-node backup 会把整个数据目录(不含日志)打成一个文件,请放到别的机器上保存。
卸载
sudo wuffy-node uninstall # 卸载程序,保留数据(重装后原样接着用)
sudo wuffy-node uninstall --purge # 连数据一起删(先备份)
目录
| 路径 | 内容 |
|---|---|
/opt/wuffy-node/bin/wuffy-sentinel | 节点程序 |
/opt/wuffy-node/lib/wuffy/ | Web 巡检运行环境(Node、巡检程序、Chromium) |
/var/lib/wuffy-node/ | 数据:数据库、主密钥、证书、授权、截图、日志(仅服务用户可读) |
/etc/wuffy-node.conf | 设置 |
/etc/systemd/system/wuffy-node.service | 服务 |
/usr/local/bin/wuffy-node | 管理命令 |
> 打完包别忘了更新清单:tar.gz 上传后按 packaging/README.md「发版后:更新清单」改> website/releases/stable.src.json 的 node 部分并签名,官网下载页才会指向新包。