# redis

**Repository Path**: opsx-tools/redis

## Basic Information

- **Project Name**: redis
- **Description**: Redis 命令行客户端
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-13
- **Last Updated**: 2025-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# opsx-redis

Redis 命令行工具，支持单机和集群模式操作。

## 特性

- 🔑 **数据操作**: 支持 String、Hash、List、Set、Sorted Set 等数据类型
- 🚀 **高性能**: 连接池、连接复用
- 🌐 **集群支持**: 支持 Redis 集群模式
- 📊 **格式化输出**: 表格化显示数据
- 🎯 **易于使用**: 简洁的 CLI 接口
- 💬 **交互模式**: 支持交互式 Redis shell，支持命令自动补全和历史记录

## 安装

### 快速下载（推荐）

自动检测平台并下载最新版本：

```bash
# 使用 wget
wget "https://gitee.com/opsx-tools/redis/releases/download/latest/opsx-redis-$(uname -s)-$(uname -m).tar.gz"

# 或使用 curl
curl -L -o opsx-redis-$(uname -s)-$(uname -m).tar.gz \
  "https://gitee.com/opsx-tools/redis/releases/download/latest/opsx-redis-$(uname -s)-$(uname -m).tar.gz"
```

### 手动安装

```bash
# Linux/macOS
tar -xzf opsx-redis-*.tar.gz
chmod +x opsx-redis
sudo mv opsx-redis /usr/local/bin/

# Windows
# 解压 zip 文件后直接运行
```

## 编译

```bash
go build -o opsx-redis main.go
```

## 快速开始

### String 操作

```bash
# 获取键值
opsx-redis get mykey

# 设置键值
opsx-redis set mykey "myvalue"
opsx-redis set mykey "myvalue" -e 1h  # 设置过期时间

# 批量操作
opsx-redis mget key1 key2 key3
opsx-redis mset key1 "value1" key2 "value2"
```

### Hash 操作

```bash
# 获取字段值
opsx-redis hget myhash field1

# 设置字段值
opsx-redis hset myhash field1 "value1"

# 获取所有字段
opsx-redis hgetall myhash
```

### List 操作

```bash
# 从左侧推入
opsx-redis lpush mylist "item1"

# 从右侧推入
opsx-redis rpush mylist "item2"

# 获取列表范围
opsx-redis lrange mylist 0 -1
```

### Set 操作

```bash
# 添加成员
opsx-redis sadd myset "member1"

# 获取所有成员
opsx-redis smembers myset

# 检查成员是否存在
opsx-redis sismember myset "member1"
```

### Sorted Set 操作

```bash
# 添加成员（带分数）
opsx-redis zadd myzset 1.0 "member1"

# 获取排名范围
opsx-redis zrange myzset 0 -1

# 获取成员分数
opsx-redis zscore myzset "member1"
```

### 集群模式

```bash
# 使用 -c 或 --cluster 启用集群模式
opsx-redis -h 127.0.0.1 -p 7001 -c -a "password" get mykey

# 指定多个集群节点
opsx-redis get mykey --cluster --addrs "127.0.0.1:7001,127.0.0.1:7002"

# 在交互模式中执行集群命令
opsx-redis -h 127.0.0.1 -p 7001 -c -a "password"
127.0.0.1:7001> CLUSTER INFO
127.0.0.1:7001> CLUSTER NODES
127.0.0.1:7001> exit
```

### 交互模式

```bash
# 进入交互式 Redis shell（不加子命令时自动进入）
opsx-redis -h 127.0.0.1 -a password

# 在交互模式中：
# - 按 TAB 键自动补全 Redis 命令
# - 支持命令历史记录（上下箭头键）
# - 输入 'help' 查看帮助
# - 输入 'exit' 或 'quit' 退出

127.0.0.1:6379> GET mykey
"value"
127.0.0.1:6379> SET newkey "newvalue"
OK
127.0.0.1:6379> exit
Bye
```

## 命令参数

- `-h, --host`: Redis 主机地址（默认: 127.0.0.1）
- `-p, --port`: Redis 端口（默认: 6379）
- `-a, --password`: Redis 密码
- `-d, --db`: 数据库编号（默认: 0）
- `-e, --expire`: 过期时间（如: 1h, 30m, 60s）
- `-c, --cluster`: 是否使用集群模式
- `--addrs`: 集群地址列表

**注意**: 不加子命令时，会自动进入交互模式。

## 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件