# Cursor自动化服务部署指南

本文档详细说明如何在新服务器上从零开始部署Cursor自动化服务，包括环境准备、数据库配置、服务启动等各个步骤。

## 系统要求

- **操作系统**: Linux (推荐Ubuntu/Debian)，也支持Windows和macOS
- **Python版本**: 3.7+
- **数据库**: MySQL 5.7+ 或 MariaDB 10+
- **缓存系统**: Redis 5+ (可选但推荐)
- **内存**: 至少2GB RAM
- **存储**: 至少1GB可用空间
- **网络**: 稳定的互联网连接

## 部署流程概述

1. 安装必要的系统依赖
2. 准备Python环境
3. 下载代码并安装依赖
4. 配置和初始化数据库
5. 导入邮箱账号
6. 启动服务
7. 设置为系统服务(可选)

## 详细部署步骤

### 1. 安装必要的系统依赖

#### Ubuntu/Debian系统:

```bash
# 更新系统包
sudo apt update

# 安装Python、MySQL和Redis
sudo apt install -y python3 python3-venv python3-full mysql-server redis-server

# 安装pip和开发库
sudo apt install -y python3-pip python3-dev default-libmysqlclient-dev build-essential
```

#### CentOS/RHEL系统:

```bash
# 安装Python
sudo yum install -y python3 python3-devel

# 安装MySQL
sudo yum install -y mariadb-server mariadb-devel

# 安装Redis
sudo yum install -y redis

# 启动服务
sudo systemctl start mariadb
sudo systemctl start redis
sudo systemctl enable mariadb
sudo systemctl enable redis
```

### 2. 准备Python环境

```bash
# 创建项目目录
mkdir -p /opt/cursor-service
cd /opt/cursor-service

sudo apt install python3-venv python3-full
# 创建并激活虚拟环境
python3 -m venv venv
source venv/bin/activate
```

### 3. 下载代码并安装依赖

```bash
# 下载代码(示例使用git，也可以直接上传文件)
git clone https://your-repo-url.git .
# 或者直接解压上传的zip文件

# 安装依赖
pip install -r requirements.txt
pip install cryptography  # 确保安装cryptography包
```

### 4. 配置和初始化数据库

我们提供了两种初始化数据库的方式：

#### 方式一：使用交互式设置向导(推荐)

```bash
# 修复可能的MySQL格式化问题
python fix_setup.py

# 运行设置向导
python setup_environment.py
```

设置向导将引导您完成：
- 配置服务器标识
- 设置MySQL数据库连接信息
- 配置Redis(可选)
- 创建数据库和表结构

#### 方式二：手动执行初始化脚本

```bash
# 直接运行数据库初始化脚本
python init_database.py
```

脚本会交互式地询问：
- MySQL root用户名和密码
- 应用数据库名和用户信息
- Redis配置(可选)

### 5. 导入邮箱账号

```bash
# 准备email.txt文件，格式为：
# email@example.com----密码----client_id----refresh_token

# 运行导入脚本
python import_emails.py
```

### 6. 启动服务

有多种方式可以启动服务：

#### 方式一：使用统一管理脚本(推荐)

```bash
# 启用并启动服务
python start.py --enable

# 或者直接启动(会根据数据库中的启用状态决定是否启动服务)
python start.py
```

#### 方式二：直接启动自动服务

```bash
# 直接启动自动化服务
python auto_cursor_service.py
```

#### 方式三：仅运行注册进程

```bash
# 仅启动注册进程
python main.py
```

### 7. 设置为系统服务(可选但推荐)

#### 创建系统服务文件:

```bash
sudo nano /etc/systemd/system/cursor-service.service
```

添加以下内容:

```ini
[Unit]
Description=Cursor Auto Registration Service
After=network.target mysql.service redis.service

[Service]
Type=simple
User=your_username
WorkingDirectory=/opt/cursor-service
ExecStart=/opt/cursor-service/venv/bin/python start.py
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
```

#### 启动并设置开机自启:

```bash
sudo systemctl daemon-reload
sudo systemctl start cursor-service
sudo systemctl enable cursor-service
```

## 管理服务

### 检查服务状态

```bash
# 查看服务状态
python start.py --status

# 如果设置为系统服务，可以使用
sudo systemctl status cursor-service
```

### 启用/禁用服务

```bash
# 启用服务
python start.py --enable

# 禁用服务
python start.py --disable
```

### 手动上传账号

```bash
python start.py --upload
```

## 数据库升级

如果您从旧版本升级，需要运行数据库升级脚本：

```bash
python upgrade_database.py
```

这会添加新的`extracted`字段和相关索引，以支持账号上传功能。

## 监控与故障排除

### 日志文件

主要日志文件：
- `auto_cursor_service.log` - 自动服务日志
- `upload_accounts.log` - 账号上传日志
- `register.log` - 注册进程日志

### 常见问题解决

1. **数据库连接失败**
   - 检查MySQL服务是否运行: `sudo systemctl status mysql`
   - 验证数据库用户名和密码是否正确

2. **Redis连接失败**
   - 检查Redis服务是否运行: `sudo systemctl status redis`
   - 如不需要Redis，可在config.yaml中设置`use_redis: false`

3. **服务无法启动**
   - 检查日志文件中的具体错误信息
   - 确保所有依赖包都已安装: `pip install -r requirements.txt`

4. **账号注册失败率高**
   - 检查网络连接和代理设置
   - 查看注册日志中的具体错误信息

5. **邮箱账号不足**
   - 手动导入更多邮箱账号: `python import_emails.py`
   - 检查API获取邮箱是否正常

## 备份与维护

建议定期备份数据库：

```bash
# MySQL备份
mysqldump -u [用户名] -p [数据库名] > backup_$(date +%Y%m%d).sql
```

## 安全考虑

1. 使用强密码保护数据库
2. 限制MySQL和Redis只接受本地连接
3. 保护config.yaml文件，不要泄露API密钥和数据库密码
4. 定期更新系统和依赖包

## 更新服务

更新服务代码后，请按以下步骤操作：

1. 停止服务: `python start.py --disable` 或 `sudo systemctl stop cursor-service`
2. 更新代码
3. 如有新的依赖，安装: `pip install -r requirements.txt`
4. 如有数据库结构变更，运行升级脚本: `python upgrade_database.py`
5. 重新启动服务: `python start.py --enable` 或 `sudo systemctl start cursor-service`