本产品及文档完善中，如果有什么问题请联系我们：18721583683(同微信)或chaho@qq.com
维护
本章说明 XAgent 的部署与日常维护操作：命令行启动方式、管理口令、HTTPS 证书、导出盘点数据与常见排障。适用版本为 XAgent（Go 模块 xagent），支持 Windows（含系统托盘驻守）与 Linux 平台。
命令树总览
xagent 综合运维代理
├── run 标准运行：独立提供 Web 服务（HTTP / HTTPS）
│ --addr / -p / --https / --cert / --key / --silent / --log / --server(可选)
├── tray 驻守 Windows 桌面右下角系统托盘（后台常驻）
│ （继承 run 的 addr/https/cert/key/log/server 参数）
├── export 本地导出盘点信息（txt / excel / html / json）
│ --output / --type
├── print 打印指定板块资产信息（all 或 20 个板块）
│ all | basic | bios | motherboard | opSys | cpu | mem | slots | disks
│ logicalDisks | videos | sounds | nics | pointingDevices | keyboards
│ connectors | controllers | printers | usbs | softs
└── version 打印版本号
查看帮助：
xagent --help # 根命令帮助
xagent run --help # run 子命令帮助
xagent export --help # export 子命令帮助
快速开始
标准启动（默认 HTTP，监听 0.0.0.0:9090）：
xagent run
启动后浏览器访问 http://<本机IP>:9090，输入管理口令 itildesk1 即可进入资产盘点页。
登录页展示本机 IP、主机名、CPU、内存实时指标与口令输入框：
仅启动服务、不依赖远程管理服务器：run 的 --server 参数为可选。不填也能独立启动本地服务；填了才向远程服务器上报心跳。
命令详解
run — 标准运行（HTTP）
# 自定义端口与监听地址
xagent run --port 8080
xagent run --addr 127.0.0.1 --port 8080
# 可选：关联远程管理服务器（用于心跳上报，失败不阻断本地服务）
xagent run --server 192.168.1.100:9999 --port 9090
| 序号 | 参数 | 默认值 | 说明 |
|---|---|---|---|
| 1 | -s, --server | 空 | 远程管理服务器 host:port，可选；仅用于心跳上报 |
| 2 | -p, --port | 9090 | 本地监听端口 |
| 3 | --addr | 0.0.0.0 | 本地监听地址 |
| 4 | --https | 否 | 启用 HTTPS（内置 TLS） |
| 5 | --cert | 自动自签 | TLS 证书 PEM 路径 |
| 6 | --key | 自动自签 | TLS 私钥 PEM 路径 |
| 7 | -q, --silent | 否 | 静默模式：控制台无输出，日志写文件 |
| 8 | --log | xagent.log | 日志文件路径（--silent 时生效） |
资产盘点页登录后支持下载 PDF / Excel 与纯前端搜索：
提供 HTTPS 服务
# 使用内置自签证书（首次运行自动生成 xagent-cert.pem / xagent-key.pem）
xagent run --https --port 9443
# 使用自有证书覆盖自签
xagent run --https --cert /path/cert.pem --key /path/key.pem --port 9443
- 自签兜底：未指定
--cert/--key时，自动生成有效期 10 年的自签证书并缓存到当前目录，已存在则复用。 - 用户覆盖：指定
--cert/--key时优先加载用户证书。 - 访问
https://<本机IP>:9443，浏览器会提示证书不受信任（自签所致），选择继续即可。
静默模式
# 控制台无输出，日志写入 ./xagent.log
xagent run --silent
# 指定日志文件
xagent run --silent --log /var/log/xagent.log
静默模式下：
- 控制台不再输出启动信息与请求日志；
- 日志统一写入
--log指定文件（默认xagent.log）。
说明：
run --silent仅做"日志静默"。若需彻底驻守后台，请使用tray模式。
性能页按 cpu0/cpu1… 排序，最高利用率核心标注"最高"：
tray — 驻守 Windows 系统托盘
仅 Windows 桌面环境支持。启动后服务最小化到右下角系统托盘，托盘菜单提供打开界面 / 重启服务 / 退出。
# 默认托盘驻守（HTTP，端口 9090，日志写文件）
xagent tray
# HTTPS 托盘
xagent tray --https --port 9443
# 关联远程服务器
xagent tray --server 192.168.1.100:9999
- 托盘图标：使用项目 logo2 生成的标准 ICO（多尺寸 32/48/64）作为驻守任务栏图标。
- 打开界面：浏览器打开
http://127.0.0.1:<端口>。 - 退出：托盘菜单"退出"停止服务与进程。
- Linux / macOS 平台运行
tray会提示"仅支持 Windows"并退出。
托盘驻守效果（任务栏托盘区，XAgent 图标位于微信与输入法之间）：
托盘图标 特写（logo2 蓝色图标）：
export — 本地导出盘点信息
# 导出为 Excel（默认文件名 = 主机名-时间戳）
xagent export --type excel
# 指定文件名与类型
xagent export -o myhost -t json
xagent export -o myhost -t html
xagent export -o myhost -t txt
| 序号 | 参数 | 说明 |
|---|---|---|
| 1 | -o, --output | 文件名（不带扩展名）；缺省用"主机名 - 时间戳" |
| 2 | -t, --type | 格式：txt / excel / html / json；缺省 txt |
导出的文件（如 myhost-20261010T130636.json）生成在当前运行目录，涵盖全部资产板块：基本信息、BIOS、主板、操作系统、CPU、内存、插槽、磁盘、本地磁盘、显卡、声卡、网卡、输入设备、端口连接器、控制器、打印机、USB、安装软件。
print — 打印资产板块
xagent print all # 打印全部板块
xagent print basic # 仅基本信息
xagent print cpu # 仅 CPU
xagent print mem # 仅内存
xagent print disks # 仅磁盘
# ……其余板块见命令树
version
xagent version
管理口令说明
系统内置三级管理口令（登录页输入）：
| 序号 | 口令 | 用途 |
|---|---|---|
| 1 | itildesk1 | 一级：进入资产盘点（/inventory） |
| 2 | itildesk2 | 二级：进入性能（/performance） |
| 3 | itildesk3 | 三级：完整权限 |
独立运行（不带
--server）时程序自动写入默认口令缓存，保证可正常登录；关联远程服务器时由服务器下发 / 校验。
HTTPS 证书 说明
- 自签证书：
--https未指定证书时，自动生成xagent-cert.pem（证书）与xagent-key.pem（私钥），SAN 含localhost、127.0.0.1及本机局域网 IP。 - 用户证书：指定
--cert/--key后不再自签，直接加载用户证书。 - 证书有效期 10 年，已存在则复用；删除两个文件后重启会重新生成。
构建（双平台）
# Linux（无 CGO，产物 xagent_linux）
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o xagent_linux .
# Windows（产物 xagent.exe）
set CGO_ENABLED=0
go build -o xagent.exe .
注：
tray子命令仅在 Windows 编译进二进制（依赖 systray）；Linux 平台提供占位提示命令。
常见问题
| 序号 | 问题 | 排查与处置 |
|---|---|---|
| 1 | 启动后浏览器访问不了页面？ | 确认监听端口与地址。run 默认 0.0.0.0:9090，本机访问用 http://127.0.0.1:9090，局域网访问用 http://<本机IP>:9090，并放行防火墙对应端口 |
| 2 | 登录后进不去对应页面？ | 核对口令层级：资产盘点用 itildesk1，性能用 itildesk2。独立运行已内置默认口令，无需远程服务器 |
| 3 | HTTPS 提示证书不受信任？ | 自签证书所致，属正常现象。生产环境请使用 --cert/--key 指定受信任证书，或前置反向代理终止 TLS |
| 4 | 静默模式没看到日志？ | 静默模式日志写入 --log 指定文件（默认当前目录 xagent.log），不再打印到控制台 |
| 5 | 托盘模式在 Linux 无法使用？ | 托盘驻守为 Windows 专属能力。Linux 请使用 xagent run（可配 --silent）常驻运行 |