CLI 参考
所有命令与标志的详细说明。
运行 tmaegis <command> --help 可获取您所安装版本的权威说明。
全局标志
| 标志 | 含义 |
|---|---|
-c, --config | 配置文件路径（默认 config.yaml） |
-r, --rules-dir | 包含 YAML 规则的目录（默认 ./rules） |
--lang | 界面语言，BCP 47 标签，例如 en-US、vi 或 sr-Cyrl。默认：根据系统检测。 |
--ai-provider | 覆盖 AI 提供商：ollama、claude、openai 或 gemini |
--os-family | 覆盖检测到的操作系统系列，例如 ubuntu-24.04。* 会运行所有系列的规则。 |
tmaegis scan
审计系统。只读。
| 标志 | 含义 |
|---|---|
--auto-detect | 检测操作系统和已安装的软件，仅运行匹配的规则 |
-t, --target | 平台筛选，例如 linux、windows、postgres、aws（默认 all） |
-l, --level | CIS 配置级别，1 或 2（默认 1） |
-f, --format | text、json、jsonl、sarif、asff、csv、html、xlsx 或 pdf |
-o, --output | 将报告写入文件（xlsx 和 pdf 必须指定） |
--include-manual | 同时将人工复核建议以 SKIP 形式连同操作说明一并列出 |
--device-config | 审计导出的网络设备配置 |
--ai-analyze | 请 AI 提供商评估修复的影响 |
--plugin | 以逗号分隔的扫描后插件 |
--push-url | 将 JSON 报告发送到 tmaegis-server（令牌来自 TMAEGIS_SERVER_TOKEN） |
-q, --quiet | 不打印横幅 |
tmaegis apply
修复未通过的控制项。会先创建快照。
| 标志 | 含义 |
|---|---|
--auto-detect, -t, -l | 与 scan 相同的选择标志 |
--dry-run | 显示将要更改的内容，但不修改系统 |
--deadman-timeout | 自动回滚前等待确认的秒数（默认 60，0 表示禁用） |
--no-confirm | 跳过确认提示，适用于 CI |
--auto-rollback | 修复或其验证失败时自动回滚（默认开启） |
--terraform-out | 将针对云发现项提出的 Terraform 写入目录 |
tmaegis rollback
| 标志 | 含义 |
|---|---|
--list | 列出快照并退出 |
--id | 要恢复的快照（默认：最新的） |
其他命令
| 命令 | 含义 |
|---|---|
tmaegis discover [--json] | 显示检测到的操作系统和已安装的软件 |
tmaegis rules export [-o file] | 将规则目录导出为 JSON |
tmaegis plugin install|list | 管理插件 |
tmaegis lang | 列出支持的语言 |
退出码与 CI
使用 --format sarif 可将结果送入 GitHub 的 Security 标签页，使用 --no-confirm 可进行非交互式修复。您所用版本的退出码行为请查看 tmaegis scan --help。