WatchZit

下载 WatchZit

每个链接都指向 GitHub 上的最新版本。版本均经过签名;服务器也从这些版本自行更新。

选择服务器的安装方式

方式适用场景需要
1. 现成的虚拟机镜像导入、启动、登录——几分钟完成VMware、Proxmox/KVM 或 Hyper-V;无需互联网
2. 设备 ISO新虚拟机或物理服务器,无人值守安装期间需要互联网
3. 安装脚本现有的 Debian、Ubuntu、AlmaLinux 或 Rocky Linux 服务器root 权限和互联网
4. 手动安装软件包自有 PostgreSQL、配置管理、离线服务器该版本的 deb 或 rpm 软件包

服务器需要 2 vCPU、2 GB 内存和 16 GB 磁盘。浏览器通过 TCP 8443 访问控制台,代理和远程采集器通过 TCP 8444 连接。

1. 现成的虚拟机镜像

OVA

VMware ESXi、Workstation、VirtualBox

watchzit-appliance.ova

ESXi Host Client:Create / Register VM → Deploy a virtual machine from an OVF or OVA file。vCenter:Deploy OVF Template。

QC

Proxmox VE 和 KVM

watchzit-appliance.qcow2

创建一台不带磁盘的虚拟机(2 vCPU、2 GB 内存、VirtIO 网络),导入磁盘,将其作为 SCSI 启动盘挂载,并启用 QEMU guest agent。

VHD

Hyper-V(第 1 代)

watchzit-appliance-vhdx.zip

解压后创建一台 2 GB 内存的第 1 代虚拟机,并选择该 VHDX 作为磁盘。

在 Proxmox VE 上,把镜像复制到节点后:

qm importdisk <vmid> watchzit-appliance.qcow2 local-lvm

启动虚拟机:屏幕上会显示控制台地址和设置令牌。打开 https://<地址>:8443,接受一次控制台自带的证书,输入令牌并创建启用双因素登录的第一个管理员。设备通过 DHCP 获取地址;在虚拟机屏幕上以 wzadmin 登录(初始密码 watchzit,必须立即修改),即可设置固定地址、服务器名称和时区。需要更多空间时,扩大虚拟机磁盘即可:设备会在下次启动时扩展文件系统。

2. 设备 ISO

watchzit-appliance.iso——用它启动虚拟机或服务器(2 vCPU、2 GB 内存、16 GB 或更大的磁盘)。5 秒后自动开始无人值守安装:它会清除第一块磁盘,在大约 10–20 分钟内安装 Debian、PostgreSQL 和 WatchZit,然后显示控制台地址和设置令牌。

3. 安装脚本

在 Debian 12+、Ubuntu 22.04+、AlmaLinux 或 Rocky Linux 9+(x86-64)上以 root 运行:

curl -fsSL https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh | sudo sh

脚本会安装 PostgreSQL,下载最新版本并校验其签名和校验和,用随机密码创建数据库,开启操作系统的自动安全更新,在 firewalld 或 ufw 中开放 8443 和 8444 端口,并输出控制台地址和设置令牌。再次运行即可更新。sh -s -- 之后可用的选项:--version X、--db postgres://…、--no-auto-updates、--source URL。如需先阅读脚本:

curl -fsSLO https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh

4. 软件包与代理

sudo apt install ./watchzit-server_X_amd64.deb      # Debian, Ubuntu
sudo dnf install ./watchzit-server-X-1.x86_64.rpm   # AlmaLinux, Rocky Linux

为 WatchZit 创建 PostgreSQL 数据库和用户,在 /etc/watchzit/server.env 中设置 WATCHZIT_DB,然后运行 systemctl enable --now watchzit-server。设置令牌位于 /var/lib/watchzit/setup-token.txt。以下文件名中带有版本号,列在版本页面上:

文件说明
watchzit-server_X_amd64.deb, .rpm用于手动安装的服务器
watchzit-agent-X-x64.msiWindows 代理——Windows 10/11 和 Windows Server(x86-64)
watchzit-agent_X_amd64.deb, .rpm, arm64适用于 x86-64 和 ARM64 的 Linux 代理软件包
watchzit-agent-X-linux-amd64, -arm64单个程序形式的 Linux 代理
maxzit-launcher-X-x64.msiWindows 版 MaxZit Launcher:用本地程序打开设备
SHA256SUMS程序和软件包的校验和
SHA256SUMS-appliance虚拟机镜像和 ISO 的校验和

安装代理

在控制台中打开代理,创建一个注册码(WZ1-…)。该页面提供下载链接以及已填入代码的完整命令。

msiexec /i watchzit-agent-x64.msi ENROLLCODE="WZ1-…" /qn      # Windows(也可用 GPO、Intune)
sudo apt install ./watchzit-agent_X_amd64.deb              # Linux 软件包,然后:
sudo watchzit-agent enroll --code "WZ1-…"
sudo systemctl start watchzit-agent

对于 Linux,代理页面还会显示一条命令,它从您的服务器下载代理、校验 SHA-256 并将其安装为 watchzit-agent 服务。代理会从控制台自动更新。要把某个代理用作分支机构的远程采集器,请在其设备页面点击用作远程采集器。

校验下载文件

sha256sum -c SHA256SUMS --ignore-missing             # 程序和软件包
sha256sum -c SHA256SUMS-appliance --ignore-missing   # OVA、qcow2、VHDX zip、ISO

服务器和安装脚本在安装任何内容之前都会校验签名的版本清单;参见安全。

更新

设置 → 更新与服务器会显示新版本并立即安装,或在选定的时间自动安装——对于没有互联网的服务器,也可以从上传的文件安装。只会安装使用 WatchZit 发布密钥签名的版本;服务器会先备份数据库和程序,如果新版本无法启动,会自动退回旧版本。测试渠道为测试控制台提供候选版本。同一页面还可以安装设备镜像的操作系统更新。控制台备份每天把备份(可选加密)保存到 SFTP 文件夹,便于在新机器上恢复。