opsxcli: 🔧 运维瑞士军刀 | 一站式命令行工具集,opsxcli 是一个面向运维和开发的集成化命令行工具集,让运维工作更轻量、更高效。

代码拉取完成,页面将自动刷新

开源项目 > DevOps/运维/网管 > 网管工具 &&

扫描微信二维码支付

取消

支付完成

richgiteeai

Watch

不关注关注所有动态仅关注版本发行动态关注但不提醒动态

2 Star 4 Fork 3

opsx-tools/opsxcli

代码 Issues 0 Pull Requests 0 Wiki 统计流水线

服务

加入 Gitee

与超过 1400万开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)

免费加入

已有帐号? 立即登录

克隆/下载

HTTPS SSH SVN SVN+SSH 下载ZIP

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别,请执行以下命令完成配置

git config --global user.name userName 
git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时,需按下述提示完成 SSH 配置

1 生成 RSA 密钥

2 获取 RSA 公钥内容,并配置到 SSH公钥中

在 Gitee 上使用 SVN,请访问使用指南

使用 HTTPS 协议时,命令行会出现如下账号密码验证步骤。基于安全考虑,Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # 私人令牌

新建文件新建 Diagram 文件

新建子模块

上传文件

分支 1

标签 11

贡献代码

同步代码

创建 Pull Request

了解更多

对比差异通过 Pull Request 同步

同步更新到分支

通过 Pull Request 同步

将会在向当前分支创建一个 Pull
Request,合入后将完成同步

opsx fix(nc): PTY 模式设置 PS1 提示符和 TERM 环境变量 d4ec8e3

168 次提交

.claude

.github/workflows

Formula

cmd

docs

internal

plugins

.codecov.yml

.gitattributes

.gitignore

.golangci.yml

.goreleaser.yaml

AGENTS.md

ARCHITECTURE.md

CHANGELOG.md

CLAUDE.md

CONTRIBUTING.md

LICENSE

Makefile

PROJECT_EVALUATION.md

README.md

ROADMAP.md

TASTE.md

TDD_PLAN.md

build.sh

env.sh

go.mod

go.sum

install.sh

main.go

release.py

README

MIT

# 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**: 文本处理

<details>
<summary>📋 查看完整命令列表 (70+ 命令)</summary>

使用 `opsxcli <command> --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

</details>

## 快速安装

### 自动下载最新版本

```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
BINARY=$(tar tzf opsxcli-*.tar.gz | head -1)
chmod +x "$BINARY"
sudo mv "$BINARY" /usr/local/bin/opsxcli
```

**注意**: 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()"

# MySQL 性能分析(慢查询分析、锁等待检测、索引建议)
opsxcli mysql analyze -u root -p "password" -h localhost

# 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 # 仅慢查询分析
opsxcli redis analyze -h 127.0.0.1 --mode replication # 复制状态分析

# PostgreSQL 性能分析(活跃查询分析、锁等待检测、性能报告)
opsxcli psql analyze -h 127.0.0.1 -U postgres -d mydb
```

### 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

MIT License Copyright (c) 2024 opsxcli Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --- 重要说明: 1. 本软件仅供授权用户使用 2. 禁止将本软件用于任何非法用途 3. 禁止逆向工程、反编译或修改本软件 4. 商业使用需要获得授权许可