109 lines
2.6 KiB
Markdown
109 lines
2.6 KiB
Markdown
|
# 登录页面配置功能说明
|
|||
|
|
|
|||
|
|
## 功能概述
|
|||
|
|
|
|||
|
|
现在可以通过配置文件来控制小红书登录时获取Cookie的来源页面，支持两种选项：
|
|||
|
|
- **creator**: 创作者中心 (https://creator.xiaohongshu.com/login)
|
|||
|
|
- **home**: 小红书首页 (https://www.xiaohongshu.com)
|
|||
|
|
|
|||
|
|
## 配置方法
|
|||
|
|
|
|||
|
|
### 1. 修改配置文件
|
|||
|
|
|
|||
|
|
在 `config.dev.yaml` 或 `config.prod.yaml` 中找到 `login` 配置节：
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
# ========== 登录/绑定功能配置 ==========
|
|||
|
|
login:
|
|||
|
|
headless: false # 登录/绑定时的浏览器模式
|
|||
|
|
page: "creator" # 登录页面类型: creator 或 home
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
将 `page` 的值修改为你想要的登录页面：
|
|||
|
|
- `"creator"`: 使用创作者中心登录页
|
|||
|
|
- `"home"`: 使用小红书首页登录
|
|||
|
|
|
|||
|
|
### 2. 重启服务
|
|||
|
|
|
|||
|
|
修改配置后需要重启Python后端服务使配置生效：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Windows
|
|||
|
|
cd backend
|
|||
|
|
.\start.bat
|
|||
|
|
|
|||
|
|
# Linux
|
|||
|
|
cd backend
|
|||
|
|
./start.sh
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## API参数覆盖
|
|||
|
|
|
|||
|
|
即使配置了默认值，API请求仍然可以通过 `login_page` 参数临时覆盖配置：
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
// 发送验证码
|
|||
|
|
POST /api/xhs/send-code
|
|||
|
|
{
|
|||
|
|
"phone": "13800138000",
|
|||
|
|
"country_code": "+86",
|
|||
|
|
"login_page": "home" // 可选，不传则使用配置文件默认值
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 登录
|
|||
|
|
POST /api/xhs/login
|
|||
|
|
{
|
|||
|
|
"phone": "13800138000",
|
|||
|
|
"code": "123456",
|
|||
|
|
"country_code": "+86",
|
|||
|
|
"login_page": "home", // 可选，不传则使用配置文件默认值
|
|||
|
|
"session_id": "xxx"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 优先级说明
|
|||
|
|
|
|||
|
|
1. **最高优先级**: API请求中的 `login_page` 参数
|
|||
|
|
2. **默认值**: 配置文件中的 `login.page` 配置
|
|||
|
|
3. **兜底值**: 如果都未配置，默认使用 `creator`
|
|||
|
|
|
|||
|
|
## 测试验证
|
|||
|
|
|
|||
|
|
运行测试脚本验证配置是否正确：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd backend
|
|||
|
|
python test_login_page_config.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 配置影响范围
|
|||
|
|
|
|||
|
|
修改 `login.page` 配置会影响以下功能：
|
|||
|
|
|
|||
|
|
1. **发送验证码接口** (`/api/xhs/send-code`)
|
|||
|
|
2. **登录接口** (`/api/xhs/login`)
|
|||
|
|
3. **浏览器池预热URL** (根据配置自动调整)
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. 两个登录页面的HTML结构可能略有不同，如遇到问题请切换尝试
|
|||
|
|
2. 建议在开发环境先测试再应用到生产环境
|
|||
|
|
3. 配置修改后需要重启服务才能生效
|
|||
|
|
4. 如果API明确传入了 `login_page` 参数，会优先使用API参数而不是配置文件
|
|||
|
|
|
|||
|
|
## 示例场景
|
|||
|
|
|
|||
|
|
### 场景1：全局使用创作者中心
|
|||
|
|
```yaml
|
|||
|
|
login:
|
|||
|
|
page: "creator"
|
|||
|
|
```
|
|||
|
|
不传API参数时，所有请求都使用创作者中心登录。
|
|||
|
|
|
|||
|
|
### 场景2：全局使用首页，但个别请求使用创作者中心
|
|||
|
|
```yaml
|
|||
|
|
login:
|
|||
|
|
page: "home"
|
|||
|
|
```
|
|||
|
|
大部分请求使用首页，但特殊情况下API可以传 `"login_page": "creator"` 临时切换。
|