genspark2api Creation

以下是逆向 genspark API 的完整部署流程攻略.
https://github.com/deanxv/genspark2api

针对 Windows 环境，以及 PROXY_URL 的详细解释和配置，我们重新编写全部流程。

Windows 环境下的 Genspark2API 部署攻略（解决 ReCaptcha V3 和模型降智，不克隆仓库）

前提条件:

已经安装 Docker Desktop for Windows。 如果没有安装，请先下载并安装 Docker Desktop for Windows。确保 Docker Desktop 已经启动。
Windows Terminal (可选，但推荐)。 Windows Terminal 是一个更强大的命令行工具，比 Windows 自带的 cmd 或 PowerShell 更好用。你可以从 Microsoft Store 下载。
Genspark 账号和 Cookie。 需要注册 Genspark 账号，并从浏览器开发者工具中获取 Cookie。
一个文本编辑器。 例如 Notepad++ 或 VS Code。

步骤：

创建工作目录：
- 在你的 Windows 电脑上，创建一个用于存放 docker-compose.yml 文件的目录。例如，在 C:\genspark2api 目录下创建：
  - 在文件资源管理器中，创建一个名为 genspark2api 的文件夹，放在 C: 盘下。

创建 docker-compose.yml 文件 (genspark-playwright-proxy):

使用文本编辑器（例如 Notepad++），在 C:\genspark2api 目录下创建一个名为 docker-compose.yml 的文件，内容如下：

yaml

version: '3.4'

services:
  genspark-playwright-prxoy:
    image: deanxv/genspark-playwright-proxy:latest
    container_name: genspark-playwright-prxoy
    restart: always
    ports:
      - "7022:7022"
    volumes:
      - ./data:/app/genspark-playwright-prxoy/data
    environment:
      - PROXY_URL=http://account:pwd@ip:port  #  [可选] 推荐(住宅)动态代理,配置代理后过验证概率更高,但响应会变慢。
      - TZ=Asia/Shanghai

重要：
- PROXY_URL (可选但强烈推荐): 这就是我们稍后要详细解释的内容。如果暂时没有住宅代理，可以先注释掉这一行，或者将其留空。
- TZ: 设置时区为 America/Detroit。

启动 genspark-playwright-proxy 服务：
- 打开 Windows Terminal 或 PowerShell。
- 切换到 C:\genspark2api 目录：
  powershell
  1
  cd C:\genspark2api
- 运行以下命令：
  powershell
  1
  docker-compose up -d
- 这个命令会拉取 deanxv/genspark-playwright-proxy:latest 镜像，并启动一个名为 genspark-playwright-prxoy 的容器。
- 注意: Windows 下 Docker Desktop 可能会提示你共享 C 盘，你需要允许 Docker Desktop 访问 C 盘。
检查 genspark-playwright-proxy 服务是否正常运行：
- 在 Windows Terminal 或 PowerShell 中，运行以下命令查看容器状态：
  powershell
  1
  docker ps
- 确保 genspark-playwright-prxoy 容器的状态是 Up。
- 运行以下命令查看容器日志：
  powershell
  1
  docker logs genspark-playwright-prxoy
- 检查日志中是否有错误信息。如果没有错误信息，并且看到类似 “Server started at port 7022” 的信息，说明服务已经成功启动。

创建 docker-compose.yml 文件 (Genspark2API):

使用文本编辑器（例如 Notepad++），在 C:\genspark2api 目录下，覆盖之前的 docker-compose.yml 文件，内容如下：

yaml

version: '3.4'

services:
  genspark2api:
    image: deanxv/genspark2api:latest
    container_name: genspark2api
    restart: always
    ports:
      - "7055:7055"
    volumes:
      - ./data:/app/genspark2api/data
    environment:
      - GS_COOKIE=your_genspark_cookie  # 替换为你的 Genspark Cookie
      - API_SECRET=your_api_secret  # 可选，替换为你的 API 密钥
      - TZ=Asia/Shanghai
      - RECAPTCHA_PROXY_URL=http://127.0.0.1:7022  # 如果 genspark-playwright-proxy 和 Genspark2API 运行在同一台机器上
      # - RECAPTCHA_PROXY_URL=http://your_server_ip:7022  # 如果 genspark-playwright-proxy 运行在另一台机器上，替换为正确的 IP
      - AUTO_MODEL_CHAT_MAP_TYPE=1 #启用自动绑定模型到对话

重要：
- GS_COOKIE (必须): 将 your_genspark_cookie 替换为你的 Genspark Cookie。确保 Cookie 中包含 session_id。
- API_SECRET (可选): 如果需要 API 密钥验证，请将 your_api_secret 替换为你的 API 密钥。如果不需要，可以留空。
- RECAPTCHA_PROXY_URL (必须):
  - 如果 genspark-playwright-proxy 和 Genspark2API 运行在 同一台机器上（也就是你的 Windows 电脑），则设置为 http://127.0.0.1:7022。
  - 如果 genspark-playwright-proxy 运行在 另一台机器上，则将 http://your_server_ip:7022 替换为运行 genspark-playwright-proxy 服务的机器的 公网 IP 地址 和端口 7022。
- AUTO_MODEL_CHAT_MAP_TYPE (强烈建议): 设置为 1，启用自动绑定模型到对话，可以解决模型自动切换导致降智的问题。

启动 Genspark2API 服务：
- 在 Windows Terminal 或 PowerShell 中，确保你仍然在 C:\genspark2api 目录下。
- 运行以下命令：
  powershell
  1
  docker-compose up -d
- 由于 docker-compose.yml 文件被覆盖，这个命令会先停止之前的 genspark-playwright-prxoy 服务，然后再拉取 deanxv/genspark2api:latest 镜像，并启动一个名为 genspark2api 的容器。
检查 Genspark2API 服务是否正常运行：
- 在 Windows Terminal 或 PowerShell 中，运行以下命令查看容器状态：
  powershell
  1
  docker ps
- 确保 genspark2api 容器的状态是 Up 和 genspark-playwright-prxoy 容器的状态是 Up。
- 运行以下命令查看容器日志：
  powershell
  1
  docker logs genspark2api
- 检查日志中是否有错误信息。如果没有错误信息，并且看到类似 “Genspark2API server started on port 7055” 的信息，说明服务已经成功启动。
测试 API：
- 使用你选择的集成方式 (NextChat 或 One-API)，配置 Genspark2API 的地址 (例如 http://localhost:7055 或 http://127.0.0.1:7055) 和 API 密钥 (如果在 docker-compose.yml 中设置了 API_SECRET)，然后进行测试。注意, windows 本机测试需要使用 http://localhost:7055 或 http://127.0.0.1:7055。

详解 PROXY_URL (住宅代理):

为什么需要 PROXY_URL (住宅代理)？
- ReCaptcha V3 验证需要： ReCaptcha V3 验证会检测你的 IP 地址。如果你的 IP 地址被认为是数据中心 IP 或者其他可疑 IP，ReCaptcha V3 会认为你可能是机器人，从而降低你的分数，导致模型降智。
- 住宅代理： 住宅代理使用真实的家庭宽带 IP 地址，这些 IP 地址更不容易被 ReCaptcha V3 识别为机器人，从而提高你通过验证的概率。
什么是住宅代理？
- 真实的 IP 地址： 住宅代理 IP 地址是从真实的家庭宽带用户那里获得的，而不是从数据中心。
- 更低的风险： 因为是真实的家庭 IP 地址，所以更不容易被识别为代理，更不容易被封禁。
如何获取住宅代理？
- 付费服务： 有很多公司提供住宅代理服务，例如：
  - IProyal: 在文档中提到过，是一个相对知名的住宅代理提供商。
  - Bright Data (原 Luminati): 另一个知名的住宅代理提供商。
  - Soax: 也是一个提供住宅代理服务的公司。
- 选择代理服务商： 选择代理服务商时，需要考虑价格、速度、稳定性和 IP 地址质量。
PROXY_URL 的格式：
- PROXY_URL=http://用户名:密码@IP地址:端口
- http:// 或 https://: 代理协议，通常使用 http://。
- 用户名:密码: 你的代理账户的用户名和密码。有些代理服务不需要用户名和密码，可以省略。
- @: 用户名和密码与 IP 地址之间的分隔符。
- IP地址: 代理服务器的 IP 地址。
- :: IP 地址与端口号之间的分隔符。
- 端口号: 代理服务器的端口号。
例子：
- 假设你从 IProyal 购买了一个住宅代理，用户名是 myuser，密码是 mypassword，IP 地址是 123.45.67.89，端口号是 1234，那么你的 PROXY_URL 应该是：
  Code
  1
  PROXY_URL=http://myuser:mypassword@123.45.67.89:1234
如何配置 PROXY_URL？
- 将上面构造好的 PROXY_URL 字符串，替换到 docker-compose.yml 文件中 genspark-playwright-prxoy 服务的 environment 部分。

注意事项 (Windows 特别注意):

Docker Desktop 资源占用： Docker Desktop 会占用大量的系统资源 (CPU、内存)，如果你的电脑配置不高，可能会影响性能。
文件共享： 确保 Docker Desktop 已经配置了文件共享，允许访问你存放 docker-compose.yml 文件的目录。
端口冲突： 如果 7022 或 7055 端口被其他程序占用，你需要修改 docker-compose.yml 文件中的 ports 配置。
防火墙： 确保 Windows 防火墙允许 Docker Desktop 访问网络。
换行符： 在编辑 docker-compose.yml 文件时，确保使用正确的换行符 (LF)，而不是 Windows 默认的 CRLF。 Notepad++ 可以在 “编辑” -> “文档格式转换” 中设置换行符。

总结：

Windows 环境下的部署流程与 Linux 类似，但需要注意一些 Windows 特有的问题，例如文件共享、端口冲突、防火墙和换行符。 PROXY_URL 是一个非常重要的配置，使用住宅代理可以有效提高通过 ReCaptcha V3 验证的概率，从而避免模型降智。

记住，关键步骤包括：

安装 Docker Desktop for Windows。
创建 docker-compose.yml 文件，并正确配置 GS_COOKIE、RECAPTCHA_PROXY_URL、AUTO_MODEL_CHAT_MAP_TYPE 和 PROXY_URL (如果使用住宅代理)。
启动 genspark-playwright-proxy 和 Genspark2API 服务。
检查服务是否正常运行，并测试 API。

希望这个更详细的 Windows 攻略能够帮助你成功部署 Genspark2API 并解决相关问题。