91 lines
2.3 KiB
Markdown
91 lines
2.3 KiB
Markdown
# 数据库初始化工具使用说明
|
||
|
||
这个初始化工具用于自动配置MySQL数据库和Redis(可选)，创建所需的表结构，并更新配置文件。此工具适用于服务器端首次部署时的快速配置。
|
||
|
||
## 功能特点
|
||
|
||
1. 交互式配置MySQL数据库和用户
|
||
2. 自动创建所需的表结构
|
||
3. 可选配置Redis缓存
|
||
4. 自动更新config.yaml配置文件
|
||
5. 详细的操作日志
|
||
|
||
## 前置条件
|
||
|
||
1. 已安装MySQL/MariaDB服务
|
||
2. 已安装Redis服务(可选)
|
||
3. 知道MySQL root用户密码
|
||
4. 安装必要的Python依赖：`pip install -r requirements.txt`
|
||
|
||
## 使用方法
|
||
|
||
1. 安装必要的依赖
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
2. 运行初始化脚本
|
||
|
||
```bash
|
||
python init_database.py
|
||
```
|
||
|
||
3. 根据提示输入信息
|
||
- MySQL root用户名和密码
|
||
- 应用程序数据库和用户设置
|
||
- Redis配置(可选)
|
||
|
||
4. 初始化完成后，脚本会:
|
||
- 创建数据库和用户
|
||
- 设置适当的权限
|
||
- 创建必要的表结构
|
||
- 更新配置文件
|
||
|
||
## 配置选项说明
|
||
|
||
### MySQL配置
|
||
- **主机地址**: MySQL服务器地址，默认为`localhost`
|
||
- **端口**: MySQL服务端口，默认为`3306`
|
||
- **Root用户**: 有权限创建数据库和用户的MySQL管理员账号
|
||
- **数据库名**: 应用程序使用的数据库名，默认为`auto_cursor_reg`
|
||
- **应用用户名**: 应用程序使用的数据库用户，默认为`auto_cursor_reg`
|
||
|
||
### Redis配置
|
||
- **是否启用**: 是否使用Redis缓存
|
||
- **主机地址**: Redis服务器地址，默认为`127.0.0.1`
|
||
- **端口**: Redis服务端口，默认为`6379`
|
||
- **密码**: Redis认证密码(如果设置了)
|
||
- **数据库索引**: Redis数据库索引，默认为`0`
|
||
|
||
## 常见问题
|
||
|
||
1. **无法连接到MySQL**
|
||
- 确认MySQL服务已启动
|
||
- 验证root密码是否正确
|
||
- 检查防火墙设置
|
||
|
||
2. **无法连接到Redis**
|
||
- 确认Redis服务已启动
|
||
- 验证Redis密码是否正确
|
||
- 如不需要Redis可选择禁用
|
||
|
||
3. **权限问题**
|
||
- 确保使用的用户有创建数据库和用户的权限
|
||
|
||
4. **配置文件备份**
|
||
- 脚本会自动备份原始配置文件为`config.yaml.bak`
|
||
|
||
## 完成后的步骤
|
||
|
||
初始化完成后，您可以:
|
||
|
||
1. 导入邮箱账号:
|
||
```bash
|
||
python import_emails.py
|
||
```
|
||
|
||
2. 运行主程序:
|
||
```bash
|
||
python main.py
|
||
``` |