选择服务器的安装方式
| 方式 | 适用场景 | 需要 |
|---|---|---|
| 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. 现成的虚拟机镜像
VMware ESXi、Workstation、VirtualBox
ESXi Host Client:Create / Register VM → Deploy a virtual machine from an OVF or OVA file。vCenter:Deploy OVF Template。
Proxmox VE 和 KVM
创建一台不带磁盘的虚拟机(2 vCPU、2 GB 内存、VirtIO 网络),导入磁盘,将其作为 SCSI 启动盘挂载,并启用 QEMU guest agent。
在 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.msi | Windows 代理——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.msi | Windows 版 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 文件夹,便于在新机器上恢复。