1. 首页
  2. 参考
  3. CLI 命令

CLI 命令参考

本页内容 命令总览 run — 运行服务 service — 系统服务管理 init — 初始化 user — 应急账号 ip — 应急解封 cert — 证书管理 环境变量

命令总览

Qidun 启盾 - 主机安全监控平台 v1.2.17 用法: qidun <命令> [参数] 运行模式: run 前台/守护运行 (--role main|guard --data-dir DIR --port N) service install|uninstall|start|stop|status 注册/管理系统服务 init 初始化(生成随机管理员密码) version 版本 应急管理(本机直连, 不依赖面板): user show | set-password -p <新密码> [--data-dir DIR] 查看/应急改密 ip list | unblock <ID> 查看/解封 IP(需设置 QIDUN_USER/QIDUN_PASS 环境变量) cert ca | client -o out.p12 | reset | info | check 证书管理/导出客户端证书/校验本机证书

run — 运行服务

参数默认说明
--rolemainmain（529 全部模块）/ guard（530 守卫 + 蜜罐）
--data-dir平台默认数据目录（Win C:\ProgramData\Qidun / Linux /var/lib/qidun）
--port不覆盖临时覆盖服务端口（>0 时经环境变量传给进程）
.\qidun.exe run --role main --data-dir D:\qidun\data --port 529 ./qidun run --role guard --data-dir /var/lib/qidun

service — 系统服务管理

qidun service install # 注册 qidun-main + qidun-guard 并立即启动（幂等，可重复执行） qidun service install guard # 只装守卫 qidun service uninstall [guard] # 卸载（默认两个，先停后删） qidun service start|stop [main|guard] # 默认操作 qidun-main qidun service status # 同时显示两个服务状态
  • Linux 安装后需手动 systemctl enable qidun-main qidun-guard 开机自启。
  • 卸载务必走本命令；手动 sc delete 后进程不退出，需 taskkill /f /im qidun.exe。

init — 初始化

.\qidun.exe init # 首次：创建 admin + 16 位随机密码 .\qidun.exe init --data-dir D:\x # 指定数据目录 # 已初始化：提示已存在；未修改过的初始密码会再次显示

user — 应急账号

.\qidun.exe user show .\qidun.exe user set-password -p "NewP@ss123" .\qidun.exe user set-password -p "NewP@ss123" --data-dir D:\qidun\data
  • 改密至少 8 位；成功后作废全部 token、清空初始密码记录。
  • user show 使用默认数据目录（不支持 --data-dir，需要时用 init 或 QIDUN_DATA_DIR）。

ip — 应急解封

# Windows $env:QIDUN_USER="admin"; $env:QIDUN_PASS="xxx"; .\qidun.exe ip list $env:QIDUN_USER="admin"; $env:QIDUN_PASS="xxx"; .\qidun.exe ip unblock 3 # Linux QIDUN_USER=admin QIDUN_PASS=xxx ./qidun ip list QIDUN_USER=admin QIDUN_PASS=xxx ./qidun ip unblock 3

cert — 证书管理

子命令说明
cert ca打印 CA 公钥路径与分发提示
cert client -o <p12> [-name CN] [-days N]签发客户端证书导出 PKCS#12；随机 16 位密码写入同名 .txt（0600）；days 上限 3650
cert info显示 ca / server / client-local 证书的颁发对象与有效期
cert check校验本机（当前用户）是否已导入 CA 受信根 + 可用客户端证书，Windows 下逐项 ✅ / ❌
cert reset删除 certs 目录，下次启动整套重建（应急；旧客户端证书全部失效）

环境变量

变量用途
QIDUN_USER / QIDUN_PASSip 等命令的 API 登录凭据
QIDUN_ADDRAPI 地址（默认 https://127.0.0.1:529）
QIDUN_DATA_DIRcert 命令 / CLI TLS 客户端的数据目录
QIDUN_TLS_CA / QIDUN_TLS_CERT / QIDUN_TLS_KEY覆盖 CLI 使用的 CA / 客户端证书路径
QIDUN_PORT_OVERRIDErun --port 的内部传递机制（一般无需手设）
相关：安装部署（服务安装实操）· 证书与首次登录（cert client 完整流程）· 升级与维护（应急场景汇总）
上一页 告警参考
下一页 配置项
Qidun 启盾 v1.2.17 · 离线静态文档 · 界面基于 KuoqiUI · 返回首页