观澜目前以 GitHub prerelease(测试版通道)持续发布。版本说明注明测试版不更新 latest、不用于生产部署;请先在非生产环境验证。
Windows
安装程序推荐
DeviceStateConsole-Windows-Setup-v3.0.158.exe
安装到 %ProgramFiles%\DeviceStateConsoleAgent,创建快捷方式并注册开机自启的机器级 Agent 服务;支持静默安装、更新和卸载。
便携版
DeviceStateConsole-Windows-Portable-v3.0.158.zip
无需安装的 Windows 便携版。
更新包
DeviceStateConsole-Windows-Update-v3.0.158.zip
仅用于已安装客户端的更新分发,不应作为首次安装方式。
安装后打开「观澜」,在「配置」页填写中枢地址、访问密钥和设备名称。应用运行后显示在系统托盘:左键打开主界面,右键查看状态或退出。采集与上报由机器级服务负责,关闭窗口或注销登录都不会中断。
无界面安装(PowerShell)
& "DeviceStateConsole-Windows-Setup-vX.Y.Z.exe" /S `
/HUB="https://hub.example.com" /KEY="<ACCESS_KEY>" `
/DEVICE=node-01 /HOSTNAME="节点01" /VERIFY=120
Linux
.deb 安装包推荐
DeviceStateConsole-Linux-Install-v3.0.158.deb
适用于 Ubuntu / Debian amd64(以 Ubuntu 24.04 构建)。提供 /usr/bin/guanlan 桌面端与 guanlan-agent 命令,并启用系统级 guanlan-agent.service。
适用于 Ubuntu / Debian amd64。安装后提供 /usr/bin/guanlan 桌面端与 /usr/bin/guanlan-agent 命令;系统级 guanlan-agent.service 随安装启用,无桌面会话也会持续采集与上报。首次打开桌面端可在「连接」页填写中枢地址和访问密钥。Fedora / RPM、Arch 等发行版目前没有原生包,可用任意进程管理器运行包内的 device-state-console-agent。
无界面安装(bash)
sudo GUANLAN_HUB=https://hub.example.com GUANLAN_KEY="$KEY" GUANLAN_DEVICE_ID=node-01 \
apt-get install -y ./DeviceStateConsole-Linux-Install-vX.Y.Z.deb
sudo guanlan-agent wait-for-upload --timeout 120 # 退出码 0 表示已确认上报
Android
APK推荐
DeviceStateConsole-Android-v3.0.158.apk
使用 IGNGserver 发布证书签名。首次打开填写与 Windows 端相同的中枢地址和查看密钥。
安装后首次打开时填写与 Windows 端相同的中枢地址和查看密钥。客户端支持 http:// 与 https://;未配置 TLS 时仅建议在可信局域网或受控内网穿透中使用 HTTP。Android 提示未知来源安装时,需要由用户确认允许该来源。
校验
核对 SHA-256
下载对应的 .sha256 文件,把其中的摘要与本地计算结果比对。
# Linux
sha256sum DeviceStateConsole-Linux-Install-vX.Y.Z.deb
# Windows PowerShell
Get-FileHash -Algorithm SHA256 .\DeviceStateConsole-Windows-Setup-vX.Y.Z.exe连接
填写中枢地址
所有客户端和 Agent 使用同一个公开入口。没有中枢?先 部署中枢。
- 局域网 HTTP
- http://服务器IP:38472
- 局域网
- https://服务器域名:38472
- 公网
- https://你的域名
- 受控 HTTP 内网穿透
- http://公网IP:转发端口