107 lines
2.6 KiB
Markdown
107 lines
2.6 KiB
Markdown
# Cursor注册工具 - MySQL & Redis支持
|
||
|
||
本文档说明了如何将Cursor注册工具从SQLite数据库迁移到MySQL数据库，并可选地启用Redis缓存以提高性能。
|
||
|
||
## 变更内容
|
||
|
||
1. 数据库后端从SQLite更换为MySQL
|
||
2. 可选启用Redis缓存
|
||
3. 提供数据迁移脚本
|
||
4. 优化数据库查询性能
|
||
5. 增加数据库连接池管理
|
||
|
||
## 前置要求
|
||
|
||
1. Python 3.7+
|
||
2. MySQL/MariaDB 服务器
|
||
3. Redis服务器 (可选)
|
||
4. 安装依赖：`pip install -r requirements.txt`
|
||
|
||
## 配置说明
|
||
|
||
在`config.yaml`中添加了MySQL和Redis相关配置：
|
||
|
||
```yaml
|
||
# 数据库配置
|
||
database:
|
||
# SQLite配置（兼容旧版本）
|
||
path: "cursor.db"
|
||
pool_size: 10
|
||
|
||
# MySQL配置
|
||
host: "localhost"
|
||
port: 3306
|
||
username: "root"
|
||
password: ""
|
||
database: "cursor_register"
|
||
|
||
# 是否使用Redis缓存
|
||
use_redis: true
|
||
|
||
# Redis配置（可选，当use_redis为true时生效）
|
||
redis:
|
||
host: "127.0.0.1"
|
||
port: 6379
|
||
password: ""
|
||
db: 0
|
||
```
|
||
|
||
## 数据迁移步骤
|
||
|
||
1. 确保MySQL服务器已启动，并已创建好数据库
|
||
2. 更新`config.yaml`配置文件，设置正确的数据库连接信息
|
||
3. 运行迁移脚本：`python migrate_db.py`
|
||
4. 迁移脚本会自动创建表结构并将旧数据导入MySQL
|
||
|
||
## 使用Redis缓存
|
||
|
||
若要启用Redis缓存以提高性能：
|
||
|
||
1. 安装Redis服务器：
|
||
- Windows: 使用WSL或[Windows版Redis](https://github.com/microsoftarchive/redis/releases)
|
||
- Linux: `sudo apt install redis-server` (Ubuntu) 或 `sudo yum install redis` (CentOS)
|
||
- macOS: `brew install redis`
|
||
|
||
2. 在`config.yaml`中设置`use_redis: true`并配置Redis连接信息
|
||
3. 确保安装了`aioredis`包：`pip install aioredis>=2.0.0`
|
||
|
||
## 常见问题
|
||
|
||
1. **无法连接到MySQL**
|
||
- 确认MySQL服务已启动
|
||
- 检查用户名和密码是否正确
|
||
- 确认数据库是否已创建
|
||
- 检查防火墙设置
|
||
|
||
2. **无法连接到Redis**
|
||
- 确认Redis服务已启动
|
||
- 检查端口和密码设置
|
||
- 如不需要Redis，可设置`use_redis: false`
|
||
|
||
3. **迁移失败**
|
||
- 检查原SQLite数据库文件是否存在且有效
|
||
- 确认MySQL用户有创建表和写入数据的权限
|
||
|
||
## 性能调优
|
||
|
||
1. 优化MySQL配置：
|
||
```ini
|
||
[mysqld]
|
||
innodb_buffer_pool_size = 128M
|
||
innodb_log_file_size = 32M
|
||
max_connections = 100
|
||
```
|
||
|
||
2. 优化Redis配置：
|
||
```
|
||
maxmemory 128mb
|
||
maxmemory-policy allkeys-lru
|
||
```
|
||
|
||
3. 优化连接池大小：根据并发需要调整`pool_size`参数
|
||
|
||
## 注意事项
|
||
|
||
- 请确保定期备份MySQL数据库
|
||
- Redis仅用于缓存，断电或重启会丢失缓存数据
|
||
- 如在多机部署，需确保时区配置一致 |