团队节点部署

装在内网一台常开的 Linux 服务器上,团队成员的 Wuffy 桌面端连它协作。

部署架构

团队节点是客户内网里一台常开 Linux 服务器上的后台服务:告警源和被纳管主机都在内网里由它直连;团队成员的桌面端从各自电脑连进来,排查结论推到群和手机。

团队成员的桌面端每人自己的电脑上装 Wuffy 桌面端,连节点看结论、下指令、确认操作
通知渠道群机器人、手机:排查结论推到这里
客户内网
一台常开的 Linux 服务器 · x86_64 / ARM64 · glibc ≥ 2.28
wuffy-node 后台服务systemd 常驻,7×24 运行,个人电脑关机不影响
  • 告警接入
  • 自动排查
  • 巡检
  • 定时任务
  • 成员与权限
告警数据源Alertmanager / Prometheus / Zabbix
被纳管主机SSH 直连,主机上不装 Agent
网络设备华为 / H3C / 思科

部署步骤

  1. 拿到授权文件 wuffy.lic

    申请企业试用,授权文件发到邮箱;团队版、政企版用采购时拿到的文件。桌面端和节点用同一个文件。

  2. 下载安装包

    到下载页的「团队节点」按服务器架构(x86_64 / ARM64)下载 .tar.gz 包,拷到服务器上。

  3. 在服务器上安装

    解压后执行 sudo bash install.sh,再导入授权文件、建管理员账号;命令见下文「安装」。

  4. 桌面端连上节点

    设置 → 团队节点,填 <服务器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 部分并签名,官网下载页才会指向新包。

联系我们

企业部署、信创适配、批量授权与报价,用企业微信扫码直接沟通。

企业微信二维码

试用信息处理说明

申请试用时,服务端会处理你填写的称呼、邮箱、使用平台,选填的公司或团队、纳管规模和从哪里知道 Wuffy,以及请求来源的 IP 地址和由它在服务器本地查出的大致归属地(省市与运营商),用于发送邮箱验证码、签发与管理 30 天、50 台设备的企业试用授权,并防止重复领取和滥用。验证码与授权文件会发送到你填写的邮箱。

「同意联系我」单独勾选、默认不勾。勾选后,我们会保存你选填的手机号或微信号,并可能通过邮箱、电话或微信回访试用情况、介绍产品和报价;不勾选不影响领取,也不保存手机号或微信号,我们不会向你推销。想撤回同意,发邮件到 contact@wuffy.cn,我们会删除手机号或微信号,不再联系。

领取成功后,申请记录(含申请时的 IP 与归属地)保存在服务端;授权文件直接交付给你。验证码与领取请求的记录(时间、IP、归属地、邮箱、结果)最多保留 7 天,防滥用请求计数最多保留 24 小时。表单不会收集服务器密码或模型密钥。

自动授权服务未开放时,表单信息不会保存。

软件和官网处理数据的完整说明见《隐私政策》。

个人信息处理者:北京格物致用科技有限公司。