登录页面配置功能说明

功能概述

现在可以通过配置文件来控制小红书登录时获取Cookie的来源页面，支持两种选项：

creator: 创作者中心 (https://creator.xiaohongshu.com/login)
home: 小红书首页 (https://www.xiaohongshu.com)

配置方法

1. 修改配置文件

在 config.dev.yaml 或 config.prod.yaml 中找到 login 配置节：

# ========== 登录/绑定功能配置 ==========
login:
  headless: false  # 登录/绑定时的浏览器模式
  page: "creator"  # 登录页面类型: creator 或 home

将 page 的值修改为你想要的登录页面：

"creator": 使用创作者中心登录页
"home": 使用小红书首页登录

2. 重启服务

修改配置后需要重启Python后端服务使配置生效：

# Windows
cd backend
.\start.bat

# Linux
cd backend
./start.sh

API参数覆盖

即使配置了默认值，API请求仍然可以通过 login_page 参数临时覆盖配置：

// 发送验证码
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"
}

优先级说明

最高优先级: API请求中的 login_page 参数
默认值: 配置文件中的 login.page 配置
兜底值: 如果都未配置，默认使用 creator

测试验证

运行测试脚本验证配置是否正确：

cd backend
python test_login_page_config.py

配置影响范围

修改 login.page 配置会影响以下功能：

发送验证码接口 (/api/xhs/send-code)
登录接口 (/api/xhs/login)
浏览器池预热URL (根据配置自动调整)

注意事项

两个登录页面的HTML结构可能略有不同，如遇到问题请切换尝试
建议在开发环境先测试再应用到生产环境
配置修改后需要重启服务才能生效
如果API明确传入了 login_page 参数，会优先使用API参数而不是配置文件

示例场景

场景1：全局使用创作者中心

login:
  page: "creator"

不传API参数时，所有请求都使用创作者中心登录。

场景2：全局使用首页，但个别请求使用创作者中心

login:
  page: "home"

大部分请求使用首页，但特殊情况下API可以传 "login_page": "creator" 临时切换。

2.6 KiB Raw Blame History Unescape Escape