# db-tools

**Repository Path**: xia5523/db-tools

## Basic Information

- **Project Name**: db-tools
- **Description**: 运行linux/mac运行的数据库管理工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-26
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Database Tools

统一数据库交互工具，支持 MySQL、ClickHouse、Redis。

## 功能特性

- ✅ 统一入口菜单
- ✅ 连接配置加密存储（主密码保护）
- ✅ 多环境连接管理
- ✅ 查询结果表格化展示
- ✅ 命令历史记录
- ✅ 自动重连机制
- ✅ 连接失败时支持重新输入密码

## 安装依赖

```bash
cd /data/db-tools
pip install -r requirements.txt
```

## 使用方法

```bash
# 启动
python /data/db-tools/db-cli.py

# 或添加 alias
echo 'alias db="/data/db-tools/db-cli.py"' >> ~/.bashrc
source ~/.bashrc

# 之后可以直接使用
db
```

## 首次使用

1. 运行后会提示设置主密码（用于加密保存的连接配置）
2. 选择数据库类型，输入连接信息
3. 测试连接成功后可选择保存
4. 下次启动时选择已保存的连接即可快速登录

## 交互命令

在 shell 中支持以下内置命令：

| 命令 | 说明 |
|------|------|
| `.help` | 显示帮助 |
| `.tables` | 显示所有表 |
| `.schema <table>` | 显示表结构 |
| `.info` | 显示连接信息 |
| `.reconnect` | 重新连接 |
| `.clear` | 清屏 |
| `.exit` | 退出 |

## 目录结构

```
/data/db-tools/
├── db-cli.py          # 主入口
├── config.py          # 配置
├── crypto.py          # 加密工具
├── connectors/        # 数据库连接器
│   ├── base.py
│   ├── mysql.py
│   ├── clickhouse.py
│   └── redis.py
├── profiles/          # 加密的连接配置
└── .history/          # 命令历史
```

## 安全说明

- 主密码使用 PBKDF2 派生密钥
- 连接配置使用 Fernet 对称加密存储
- 密码文件以 `.enc` 加密格式保存