安装选项
安装脚本 install.sh 的完整参数。所有参数都可以在后台的「安装命令」对话框里勾选， 生成好的命令直接贴到机器上即可。
参数
| 参数 | 默认 | 说明 |
|---|---|---|
--server | 必填 | 面板地址，wss://panel.example.com |
--token | 必填 | 该机器的凭据，后台生成 |
--install-dir | /opt/pulse-agent | 安装目录 |
--interval | 2 | 上报间隔（秒） |
--net-include | 空 | 只统计这些网卡（逗号分隔，支持 eth* 通配） |
--net-exclude | 内置黑名单 | 排除这些网卡 |
--enable-gpu | 关 | 采集 GPU 使用率（需要 nvidia-smi） |
--disable-auto-update | 关 | 关掉自更新，面板会显示「可升级」由你手动升 |
--download-base | 官方源 | 自建镜像源时用 |
--update-base | 空 | 自更新的下载源，不设则自更新不可用 |
--ca-cert | 空 | 额外信任的 CA 证书（面板用私有 CA / 自签证书时） |
--uninstall | — | 卸载 |
--download-base和--update-base必须是命令行参数，不能只靠环境变量 —— 安装命令是curl … | sudo bash的形式，sudo默认会清掉环境变量。
网卡过滤
默认排除这些（虚拟网卡、容器网桥、隧道）：
lo lo0 veth* docker* br-* virbr* tun* tap* kube* cni*
flannel* zt* wg* utun* awdl* llw* bridge* vmnet* gif* stf*--net-include 一旦给了就只统计列出的网卡，--net-exclude 不再生效。
三个平台
Linux
默认用 musl 静态链接，一个二进制在任何发行版上都能跑。
装完之后：
- 以非特权用户
pulse运行 - 零 capabilities（
getpcaps输出为空） - 不监听任何端口
- systemd 加固评分约 2.0
非 root 采不到的东西会如实标记为「不可用」，而不是显示 0。 比如某些机器上的 CPU 温度需要额外权限，那一项就整块不显示 —— 显示 0°C 是撒谎。
Windows
powershell
irm https://panel.example.com/install.ps1 -OutFile install.ps1
.\install.ps1 -Server wss://panel.example.com -Token <TOKEN>装成 Windows 服务，以 LocalService 运行。
macOS
装成 launchd 用户级 agent，不需要 root：
bash
curl -fsSL https://panel.example.com/install.sh | bash -s -- \
--server wss://panel.example.com --token <TOKEN>自更新
探针可以自己升级，但有 5 道防线：
- 下载源只从本地配置读 —— 面板影响不了它。面板即使被攻陷也指不了源
- 签名校验 —— minisign 公钥内置在二进制里
- 摘要比对 —— 下载完先对 SHA-256
- 拒绝降级 —— 版本号必须更高
- 试用期回滚 —— 新版本起来后要在限定时间内成功连上面板并上报，否则自动回退到旧版本
不配 --update-base 就整个关掉，面板会如实显示「需手动升级」。
卸载
bash
sh install.sh --uninstall会停服务、删 unit、删二进制和配置，不动面板上的历史数据。要一并清掉的话， 在后台把这台机器删掉。