保存现有功能增加域名和添加时间关联

2025-04-02 10:45:19 +08:00
parent 5919b7e657
commit 9d00c0b58e
4 changed files with 785 additions and 9 deletions
--- a/DEPLOYMENT_README.md
+++ b/DEPLOYMENT_README.md
@@ -0,0 +1,283 @@
+# 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
+
+# 创建并激活虚拟环境
+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`