运维 CLI 套件 | 裕普智汇

产品概述

裕普智汇运维 CLI 套件是专为网络运维人员设计的命令行工具集，支持批量设备巡检、配置备份、日志收集等核心功能。通过简单的命令即可完成复杂的运维任务，大幅提升工作效率。支持 Cisco、Huawei、H3C、深信服、Juniper、Aruba 等主流品牌设备。

安装配置

下载 CLI 工具

从裕普智汇控制台"开发者中心"下载对应系统的 CLI 包，或使用包管理器安装。

配置认证信息

运行 yupu-cli config set api-key <your-api-key> 配置 API 访问密钥。

验证安装

运行 yupu-cli version 验证安装是否成功。

核心命令

yupu-cli scan批量设备安全巡检

-f, --file <path>- 设备列表文件路径

-t, --type <type>- 巡检类型: quick/full/security

-o, --output <path>- 报告输出路径

--parallel <n>- 并发巡检数量 (默认 5)

yupu-cli backup批量配置备份

-f, --file <path>- 设备列表文件路径

-o, --output <path>- 备份存储路径

--schedule <cron>- 定时备份 Cron 表达式

--retention <days>- 备份保留天数 (默认 30)

yupu-cli log日志收集与分析

-f, --file <path>- 设备列表文件路径

--start <time>- 收集开始时间

--end <time>- 收集结束时间

--keyword <word>- 日志关键词过滤

yupu-cli exec批量命令执行

-f, --file <path>- 设备列表文件路径

-c, --command <cmd>- 要执行的命令

--timeout <sec>- 命令超时时间 (默认 30)

设备列表文件

设备列表文件采用 YAML 格式，每行定义一个设备的基本信息。支持批量导入，方便日常管理。

devices:
  - host: 192.168.1.1
    type: cisco-switch
    port: 22
    username: admin
    password: ****  # 建议使用环境变量

  - host: 192.168.1.2
    type: huawei-router
    port: 22
    username: admin
    password: ****

使用示例

执行安全巡检

# 快速巡检所有设备
yupu-cli scan -f devices.yaml -t quick -o ./reports/

# 完整巡检并生成 PDF 报告
yupu-cli scan -f devices.yaml -t full --parallel 10 -o ./reports/full-scan.pdf

# 仅检查 Cisco 设备
yupu-cli scan -f devices.yaml -t security --filter "brand=cisco"

配置备份

# 立即备份所有设备
yupu-cli backup -f devices.yaml -o ./backups/

# 设置每日自动备份
yupu-cli backup -f devices.yaml --schedule "0 2 * * *" --retention 90

日志收集

# 收集过去 24 小时日志
yupu-cli log -f devices.yaml --start "24h ago" -o ./logs/

# 查找包含 error 的日志
yupu-cli log -f devices.yaml --keyword "error" --start "7d ago"

常见问题

CLI 工具支持哪些操作系统？

支持 Linux、macOS、Windows 系统，提供对应的安装包和 Docker 镜像。

设备密码如何安全存储？

建议使用环境变量或配置文件中的加密密码，CLI 工具支持与 HashiCorp Vault 集成。

巡检支持多少台设备并发？

默认支持 5 台并发，企业版可配置至 50 台并发。

如何查看命令执行进度？

添加 --verbose 参数可以看到详细的执行进度和日志输出。