# opsxcli **Repository Path**: k8s-devops/opsxcli ## Basic Information - **Project Name**: opsxcli - **Description**: 一个集成了 MySQL、Redis、SSH、HTTP 请求等常用运维操作的命令行工具，在本地与远程服务器上高效执行命令。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 3 - **Created**: 2025-12-16 - **Last Updated**: 2026-04-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # opsxcli - 运维瑞士军刀 | 一站式命令行工具集 面向运维和开发的集成化命令行工具，**一条命令操作 MySQL、Redis、SSH、Docker、Kubernetes 等服务**。 ## ✨ 核心特性 - 🤖 **AI 运维助手**: 自然语言驱动，本地命令执行 + SSH 远程 + 文件传输 + 智能分析 - 🚀 **多合一工具**: 整合数据库、网络、系统、容器编排等 70+ 命令 - ⚡ **实时监控**: 网络和系统监控终端 UI 设计 - 📦 **网络工具**: 替代 iproute、net-tools 等常用包 - 🐳 **容器加速**: Docker 镜像自动加速、多源极速、断点续传 - ☸️ **K8s 集成**: kubectl 代理、服务发现、资源管理 - 🔧 **Builtin 内置**: 支持 70+ 常用 Linux 命令 ## 🛠️ 主要功能 ### 💾 数据库工具 - **mysql**: MySQL 交互式 Shell、命令执行、性能分析（慢查询分析、锁等待检测、死锁分析） - **psql**: PostgreSQL 数据库操作 - **redis**: Redis 单机/集群操作，内存分析，键空间诊断，慢查询分析 ### 🌐 网络工具 - **ssh**: SSH 连接、命令执行、文件传输、端口转发 - **ping**: 原生 ICMP/UDP/TCP 三模式 ping（自动选择、增强统计） - **traceroute**, **telnet**, **nc**: 连通性测试 - **ss**, **netstat**, **nmap**: 连接状态和端口扫描 - **ifconfig**, **route**, **ip**: 接口和路由管理 ### 🐳 Docker & Kubernetes - **docker pull**: 镜像拉取(自动加速、多源极速、断点续传) - **kubectl**: kubectl 命令行代理 - **consul**: K8s 服务发现并注册到 Consul - **kubernetes**: K8s 资源管理(YAML 生成、资源操作) ### 📊 实时监控 (TUI) - **sys**: 系统监控(CPU/内存/磁盘/进程) - **net**: 网络监控(流量/连接/状态统计) ### 🤖 AI 运维助手 - **agent**: 自然语言解决运维问题，支持本地/远程服务器操作 - 本地命令执行：grep/awk/sed/ps/df 等所有 Linux 工具 - SSH 远程执行：带安全审批和超时控制 - 文件传输：本地与远程服务器之间上传/下载 - 智能分析：自动提取关键信息、检测错误、生成摘要 - 会话管理：JSONL 存储，支持恢复、导出 Markdown ### 🖥️ 系统工具 - **ps**, **top**, **kill**, **free**, **df**: 进程和资源管理 - **tar**, **gzip**, **unzip**: 压缩和解压 ### 📁 文件操作 (Builtin 内置) - **ls**, **cat**, **grep**, **vi**, **vim**, **tree**: 文件查看 - **cp**, **mv**, **rm**, **mkdir**, **chmod**: 文件管理 - **awk**, **sed**: 文本处理
📋 查看完整命令列表 (70+ 命令) 使用 `opsxcli --help` 查看具体命令的帮助信息。 **文件操作**: ls, cat, grep, vi, vim, more, less, head, tail, cp, mv, rm, mkdir, rmdir, touch, tree, chmod, chown, ln, awk, sed **系统工具**: ps, top, kill, pstree, free, df, du, uname, hostname, whoami, id, mount, umount, date, sleep, watch **网络工具**: ssh, ping, traceroute, telnet, nc, ss, netstat, nmap, ftp, tftp, ifconfig, route, ip **压缩工具**: tar, gzip, unzip **服务端**: server (HTTP/WebSocket/gRPC) **AI 助手**: agent (自然语言运维) **实用工具**: wget, requests, upgrade
## 快速安装 ### 自动下载最新版本 ```bash # 使用 wget wget "https://gitee.com/opsx-tools/opsxcli/releases/download/latest/opsxcli-$(uname -s)-$(uname -m).tar.gz" # 或使用 curl curl -L -o opsxcli-$(uname -s)-$(uname -m).tar.gz \ "https://gitee.com/opsx-tools/opsxcli/releases/download/latest/opsxcli-$(uname -s)-$(uname -m).tar.gz" # 解压并安装 tar -xzf opsxcli-*.tar.gz chmod +x opsxcli sudo mv opsxcli /usr/local/bin/ ``` **注意**: Windows 用户请访问 [Releases 页面](https://gitee.com/opsx-tools/opsxcli/releases) 下载对应的 `.zip` 文件 ## 使用示例 ### 🤖 AI 运维助手 ```bash # 单次查询 — 直接提问 opsxcli agent "查看根目录磁盘使用情况" opsxcli agent "查找所有监听 80 端口的进程" opsxcli agent "SSH 到 192.168.1.100 查看 nginx 进程状态" # 交互模式 — 多轮对话 opsxcli agent -i # 指定 LLM 提供商 opsxcli agent -p deepseek "分析最近 Nginx 错误日志" # 安全模式 — 严格审批 opsxcli agent -s strict "重启远程服务器上的 mysql 服务" # 自动批准（仅测试环境） opsxcli agent -y "快速清理 /var/log 下 30 天前的日志" # 调试模式 — 查看工具调用详情 opsxcli agent -d "排查服务器高负载原因" # 后台任务模式 — 多任务并发 opsxcli agent -b # 会话管理 opsxcli agent --list-sessions # 列出历史会话 opsxcli agent --resume sess_xxx # 恢复指定会话 opsxcli agent --export sess_xxx > session.md # 导出为 Markdown ``` ### 数据库操作 ```bash # MySQL 交互式 shell opsxcli mysql -u root -h localhost -p # 执行 SQL opsxcli mysql -u root -p "password" -h localhost -e "SELECT VERSION()" # Redis 交互式 shell opsxcli redis -h 127.0.0.1 # Redis 集群连接 opsxcli redis -h 127.0.0.1 -p 6001 -c -a password # Redis 操作 opsxcli redis get mykey -h 127.0.0.1 opsxcli redis set mykey "myvalue" -h 127.0.0.1 # Redis 内存分析（诊断内存使用、键空间分布、慢查询） opsxcli redis analyze -h 127.0.0.1 -a password opsxcli redis analyze -h 127.0.0.1 --mode memory # 仅内存分析 opsxcli redis analyze -h 127.0.0.1 --mode keyspace # 仅键空间分析 opsxcli redis analyze -h 127.0.0.1 --mode slowlog # 仅慢查询分析 ``` ### SSH 远程操作 ```bash # 交互式登录 opsxcli ssh root@172.16.1.123 opsxcli ssh -i ~/.ssh/id_rsa root@opsx.vip -p55555 # 执行命令 opsxcli ssh root@172.16.1.123 "ls -la" # 上传/下载文件 opsxcli ssh put /local/file.txt root@172.16.1.123:/remote/file.txt opsxcli ssh get root@172.16.1.123:/remote/file.txt /local/file.txt # 端口转发 opsxcli ssh forward local 8080:localhost:80 root@172.16.1.123 ``` ### Docker 镜像加速 ```bash # 拉取单个镜像(自动加速) opsxcli docker pull nginx:latest # 并发拉取多个镜像 opsxcli docker pull nginx:latest redis:alpine mysql:8.0 # 自定义镜像源 opsxcli docker pull nginx:latest -r docker.aityp.com -r docker.1ms.run -c 5 ``` ### 系统监控 ```bash # 进入系统监控界面(2秒实时刷新) opsxcli sys # 快捷键: # Tab: 切换视图 (概览/CPU/内存/磁盘/进程) # C/M/D: 按 CPU/内存/磁盘IO 排序 # ↑↓: 选择进程 | q: 退出 # 网络监控界面 opsxcli net # Tab: 切换视图 (概览/连接/统计) # 显示实时速率、活跃连接TOP10、连接状态统计 ``` ### Kubernetes 服务管理 ```bash # 从 K8s 集群注册服务到 Consul opsxcli consul -s https://consul.example.com:8500 -m /actuator/prometheus # 清理失效实例 opsxcli consul -s https://consul.example.com:8500 --clean # kubectl 命令代理 opsxcli kubectl get pods opsxcli kubectl describe pod nginx-xxx ``` ### 原生 Ping（ICMP/UDP/TCP 三模式） ```bash # 自动模式（优先ICMP → UDP回退 → TCP兜底） opsxcli ping google.com # 指定探测模式 opsxcli ping google.com --mode icmp # 原生ICMP（需root/管理员权限） opsxcli ping google.com --mode udp # UDP ping（无需root） opsxcli ping google.com --mode tcp # TCP连接探测 # 指定次数和间隔 opsxcli ping google.com -c 10 -i 500ms # 输出增强统计（标准差、抖动） # 自动显示 min/avg/max/stddev/jitter 和丢包率 ``` ### 网络连接分析 ```bash # 查看所有 TCP/UDP 连接 opsxcli ss -tunap # TCP 状态统计 opsxcli ss -ant --stats # 目标地址 TOP 10 opsxcli ss -an --top 10 # TIME_WAIT 状态分析 opsxcli ss -tan --timewait ``` ## 📸 界面预览 ### 系统监控 (sys) ![系统监控界面](docs/sys.jpeg) ### 网络监控 (net) ![网络监控界面](docs/net.jpeg) ## 🔄 自动升级 保持工具始终最新: ```bash # 检查并升级到最新版本; 权限不够时请使用sudo opsxcli upgrade ``` 升级命令会自动: - 检测当前系统和架构 - 从 Gitee Releases 获取最新版本 - 下载并替换当前执行文件 - 保留所有配置和数据 ## 许可证 MIT License