天翼云 CLI 工具 🚀
天翼云CLI工具 是功能强大的企业级命令行工具，帮助您轻松管理天翼云资源。支持云服务器(ECS)、监控告警、安全防护、Redis分布式缓存、弹性负载均衡(ELB)、容器引擎(CCE)、VPC网络、费用查询等核心功能。
English | 简体中文
🆚 与天翼云官方 CLI 的对比
天翼云官方已于 2026 年推出命令行工具（Go 实现，命令名同为 ctyun-cli）。
以下对比基于 官方 v0.3.0 实测（2026-09-20）：
| 维度 | 官方 CLI | ctyun-cli (本项目) |
|---|---|---|
| 实现 | Go，OpenAPI 自动生成 | Python，手工精编封装 |
| 规模 | 51 模块 / 3,650 命令 | 31 模块 / 1,048 命令（1,102+ API） |
| 命令风格 | API 名原样 ctyun-cli ecs ListEcsInstances |
动词式 ctyun-cli ecs list |
| 参数风格 | API 参数原名（--instanceIDList、--pageNo） |
人性化 kebab-case 命名 |
| 命令结构 | 扁平，一模块一长串 | 嵌套子命令组（vpc eip list） |
| 输出格式 | json / table | json / table / yaml |
| 配置 | ~/.ctyun-cli.yaml，环境变量 CTYUN_AK/SK |
~/.ctyun/config(INI)，多 profile，环境变量 CTYUN_ACCESS_KEY/SECRET_KEY |
| 特色能力 | --cli-query（JMESPath）、--body 透传 |
响应统一校验(800)、结果缓存、表格友好输出 |
能力差异
- 官方覆盖更全：弹性伸缩、资源编排、SD-WAN、备份(CSBS/VBS)、DRDS/SQLServer/MongoDB/ClickHouse、DTS、容器镜像(CRS)、CCEOne、MQTT/RabbitMQ/RocketMQ、内网DNS、VPCE 等
- 本项目独有：CFW 云防火墙(66)、CSSCN 云安全中心、CloudPC 云电脑、Security 安全卫士、Billing 账务增强、OceanFS/IMS 询价、MSE 云原生网关细化命令
定位
官方 CLI 走 API 直通路线（参数即文档，灵活但繁琐）；本项目走 开发者体验路线（贴近 AWS CLI 风格的高层封装，常用操作一行完成）。例如查询运行中的云主机：
- 官方：
ctyun-cli ecs ListEcsInstances --regionID xxx --state running - 本项目：
ctyun-cli --region cn-north-1 ecs list --state running
两者可共存（安装方式见下方⚠️说明），按需选用。
✨ 为什么选择天翼云 CLI？
- 🚀 高效便捷 - 一行命令完成云资源查询和管理，告别繁琐的控制台操作
- 🔐 安全可靠 - 企业级EOP签名认证，支持环境变量配置保护密钥安全
- 📊 功能全面 - 覆盖1,102+个API，支持31大服务模块
- 🎯 简单易用 - 清晰的命令结构，丰富的使用示例，5分钟快速上手
- 🔧 灵活配置 - 支持配置文件、环境变量等多种配置方式
- 📈 实时监控 - 完整的监控服务支持，包括指标查询、告警管理、Top-N统计
📦 安装
只需一条命令即可安装：
pip install ctyun-cli
验证安装成功：
ctyun-cli --help
⚠️ 与官方 CLI 同名共存
天翼云官方 CLI 的命令名同为 ctyun-cli，且其安装脚本默认写入 /usr/local/bin（优先级高于 pip 的 ~/.local/bin）。如果安装过官方 CLI，本工具的命令可能被其覆盖。
检测方法：
which -a ctyun-cli # 本工具在 ~/.local/bin 或 miniforge3/bin，官方在 /usr/local/bin
ctyun-cli --help 2>&1 | head -3 # 本工具显示"天翼云CLI工具"，官方显示"天翼云命令行工具 (CTYUN CLI)"
推荐共存方案（任选其一）：
- pipx 隔离安装（推荐）：
pipx install ctyun-cli
- 为官方 CLI 指定非 PATH 安装目录，让
ctyun-cli归本工具：sudo INSTALL_DIR=/opt/ctyun-official/bin sh install-cli.sh
- 为本工具设置别名：
alias ct='~/.local/bin/ctyun-cli'
⚡ 快速开始
完整参数说明请参阅：命令参考手册
第一步：配置认证信息
推荐使用环境变量方式（更安全）：
export CTYUN_ACCESS_KEY=your_access_key
export CTYUN_SECRET_KEY=your_secret_key
或使用命令行配置：
ctyun-cli configure \
--access-key your_access_key \
--secret-key your_secret_key \
--region cn-north-1
第二步：开始使用
# 查看所有可用命令
ctyun-cli --help
# 查看云服务器列表
ctyun-cli ecs list
# 查询账户余额
ctyun-cli billing balance
# 查看负载均衡器
ctyun-cli elb loadbalancer list
# 查看容器集群
ctyun-cli cce list-clusters
📊 功能概览
| 服务模块 | 命令数 | API数 | 核心功能 | 文档 |
|---|---|---|---|---|
| LTS (云日志服务) | 171 | 171 | 日志项目/单元、主机组、采集配置、检索、转储、加工、告警、仪表盘、快速查询 | - |
| CCE (容器引擎) | 102 | 103 | Kubernetes集群、节点池、工作负载、Pod/Service/Job、存储卷/PVC/Secret、巡检、任务管理、命名空间、V2查询API | 模块总览 |
| VPC (私有网络) | 102 | 104 | VPC/子网/路由表/安全组/EIP/NAT网关、对等连接、ACL、前缀列表、流日志、镜像流量、IPv6、网关路由、l2gw、HAVIP、DHCP、网络诊断、询价 | 模块总览 |
| Redis (分布式缓存) | 85 | 89 | 实例管理、监控(V1/V2/代理)、备份与策略、参数模板、账号、SSL、大热key/离线key分析、诊断任务、迁移任务、回收站、询价 | 模块总览 |
| Monitor (监控服务) | 82 | 84 | 监控数据、告警管理、Top-N统计、事件管理 | 模块总览 |
| CFW (云防火墙) | 66 | 66 | 防火墙管理、概览、资产、防护规则、黑白名单、地址簿、IPS、应用、告警、日志、报表、询价 | - |
| MSE (微服务引擎) | 48 | 48 | Nacos注册配置中心、Nacos服务/配置/命名空间管理、微服务实例、云原生API网关（实例/路由/服务/域名/ELB） | - |
| ECS (云服务器) | 46 | 76 | 实例管理、快照备份、密钥对、订单查询、资源池查询、云助手、宿主机、网卡、安全组 | 模块总览 |
| Aone (边缘安全加速平台) | 45 | 45 | 域名管理、证书管理、缓存刷新/预取、数据统计、安全防护（CC/WAF/DDoS） | - |
| APM (应用性能监控) | 44 | 44 | 元数据、应用管理、链路追踪、性能分析、用量统计、告警、通知、Webhook | - |
| ZOS (对象存储) | 39 | 39 | 桶管理、对象管理、IAM、标签操作 | - |
| IAM (身份访问管理) | 34 | 34 | 用户/用户组/权限/策略/委托/AK-SK/MFA/企业项目/身份供应商/敏感操作 | 模块总览 |
| ELB (弹性负载均衡) | 34 | 34 | 负载均衡器、目标组、后端主机、访问控制、证书、网关负载均衡 | 模块总览 |
| AIServer (AI服务器) | 19 | 20 | AI服务器实例管理 | - |
| CDA (云专线) | 19 | 21 | 专线网关、物理专线、VPC管理、健康检查、链路探测 | 模块总览 |
| CloudPC (云桌面) | 15 | 19 | 云桌面实例管理、询价 | - |
| Billing (计费查询) | 12 | 12 | 账单查询、费用分析、消费统计 | 模块总览 |
| Kafka (分布式消息服务) | 10 | 11 | 实例列表、节点状态、弹性IP、配置查询、标签、5类询价 | 模块总览 |
| CSSCN (云安全中心) | 10 | 11 | 资产查询、风险统计、漏洞、告警、病毒检测、配额 | - |
| CTMySQL (云数据库MySQL) | 9 | 9 | 实例查询、标签管理、监控、询价 | - |
| DPS (物理机) | 8 | 8 | 物理机管理 | - |
| Audit (云审计) | 8 | 8 | 事件查询、资源池管理、跟踪任务管理 | 模块总览 |
| EBS (弹性块存储) | 7 | 7 | 块存储管理、快照及快照策略 | 模块总览 |
| EMR (翼MapReduce) | 6 | 9 | 集群、节点组、Hive元数据管理 | 模块总览 |
| Security (安全卫士) | 6 | 13 | 安全扫描、漏洞管理、风险评估 | 模块总览 |
| SFS (弹性文件服务) | 3 | 3 | 弹性文件存储管理、询价 | - |
| OceanFS (海量文件服务) | 3 | 3 | 海量文件存储管理、询价 | - |
| CSS (云搜索服务) | 3 | 4 | OpenSearch/Elasticsearch/Logstash 实例管理 | 模块总览 |
| EC (云间高速) | 3 | 3 | 云间高速连接管理 | - |
| IMS (镜像服务) | 2 | 2 | 镜像查询、镜像详细信息 | 模块总览 |
| SWR (容器镜像服务) | 2 | 2 | 镜像实例列表、镜像仓库列表 | - |
| 总计 | 1,043 | 1,102 | 另有 configure 等 5 个工具命令，合计 1,048+ | 所有模块 |
📊 规模统计：71,000+行代码，1,102+个API，1,048+个命令，31大服务模块
📚 完整文档
📖 功能文档
🔧 专项指南
❓ 帮助支持
- 版本历史 - 详细的版本更新记录
- English README
🤝 技术支持
如果您在使用过程中遇到问题或有任何建议，欢迎：
- 📧 邮箱: popfrog@gmail.com
- 💬 Issues: 提交问题反馈
- 📖 文档: 查看完整文档获取帮助
📝 更新日志
最新版本: v1.32.1 (2026-09-20)
- 🚀 LTS 模块首批可用命令：
unit list-v1/unit get-index-v1/search logs-v1（日志检索，支持 SQL 分析语句与游标翻页）
v1.32.0 (2026-09-20)
- 🆕 新增 SWR（容器镜像服务）模块：镜像实例列表（
list-instances，支持全资源池查询）、镜像仓库列表（list-repositories）
v1.31.3 (2026-09-20)
- 🔒 安全加固：启用全量 TLS 证书校验、debug 日志认证头脱敏、凭据文件权限收紧（600/700），修复 APM 表格输出崩溃
v1.31.2 (2026-08-26)
- 🔧 Aone 模块响应解析修复：修复 CLI 误报"查询失败: success"问题（兼容 statusCode/code 两种响应结构），并修正 WAF/访问控制查询的参数命名
v1.31.1 (2026-08-21)
- 🔧 Redis 模块监控 API 修复：修复 4 个监控类 API 路径错误（404），并修正参数名、时间格式与签名编码，
monitor-items/monitor-history/clients恢复正常
v1.31.0 (2026-08-07)
- 🚀 CCE 模块新增 V2 查询 API：新增 10 个 V2 版本查询命令（升级类 6 个 + 全新类 4 个），与现有 V1.1 接口并存
v1.30.0 (2026-07-27)
- 🆕 新增 CFW（云防火墙）模块：涵盖防火墙管理、概览、资产、防护规则、黑白名单、地址簿、IPS、应用、告警、日志、报表、询价，共 66 个命令
v1.29.2 (2026-07-27)
- 🚀 MSE 模块新增云原生 API 网关管理：涵盖网关实例/路由/服务/域名/ELB 管理，共 18 个新命令
v1.29.1 (2026-07-27)
- 🚀 MSE 模块补充：新增 Nacos 命名空间/黑白名单/用户与角色/AKSK 认证管理，共 8 个新命令
v1.29.0 (2026-07-27)
- 🚀 MSE 模块大幅扩展：新增 Nacos 注册配置中心管理，涵盖实例管理（4个）、Nacos 服务管理（9个）、Nacos 配置管理（8个），共 21 个新命令
v1.28.1 (2026-07-24)
- 🔧 VPC 模块优化：
describe-eips命令新增--page/--page-size分页参数
v1.28.0 (2026-07-24)
- 🆕 新增 EC（云间高速）/ MSE（微服务引擎）模块 + 多模块询价 API 大幅扩展：VPC/CloudPC/Kafka/ECS/SFS/OceanFS 共新增 37 个询价命令
查看完整历史请参阅 CHANGELOG.md
📜 开源协议
本项目采用 MIT 协议 开源，欢迎使用和贡献。
作者：Y.FENG | 邮箱：popfrog@gmail.com
🚀 让天翼云资源管理更简单！立即安装体验！
安装命令: pip install ctyun-cli
1 maintainer
Metadata
1 maintainer
Release files for ctyun-cli 1.32.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ctyun_cli-1.32.1-py3-none-any.whl | Python 3 | none | any | Details |
Release files / ctyun_cli-1.32.1-py3-none-any.whl
| Download URL | ctyun_cli-1.32.1-py3-none-any.whl |
|---|---|
| Size | 426.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2cbdbff07239ce3293b24fad6e4e114bd4f375591f9539e137731eb35f74b1eb
|
|
BLAKE2b-256 checksum How to use checksums |
82d281a31cf20bc37a9eb2fa8249128779138351b41327d924597e547ee52e99
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
