GuJumpgate/docs/使用教程/分部分/01-相关项目地址与部署说明.md

第一部分：相关项目地址与部署说明

部分信息

• section_slug: project-and-deployment
• 适用主题: cpa、sub2api、项目地址、部署前提、部署环境
• 维护方式: 直接更新本文件

适用场景

• 需要拉取并部署 cpa 项目
• 需要拉取并部署 sub2api 项目
• 需要先确认项目地址和部署前提

准备内容

• 可以访问 GitHub
• 一个可用的本地目录或服务器目录
• 基础的 git 使用能力，或者可以手动下载压缩包
• 如果要部署 cpa，部署环境必须可以访问 OpenAI

操作步骤

第一步：确认项目地址

• cpa 项目地址：https://github.com/router-for-me/CLIProxyAPI
• sub2api 项目地址：https://github.com/Wei-Shaw/sub2api

先确认你本次要部署的是哪个项目，再决定后续拉取和配置范围。

第二步：拉取项目到本地

可以用 git clone 拉取，也可以直接下载压缩包后解压。 如果你准备后续持续更新，建议优先使用 git clone。

第三步：确认部署方式

本教程只负责把项目地址和部署前提说明清楚，不在这里展开完整部署命令。 项目拉取到本地后，可以再让 AI 结合当前环境继续完成部署。

第四步：确认 cpa 的环境要求

如果你部署的是 cpa，部署所在环境必须可以访问 OpenAI。 如果环境本身访问不到 OpenAI，后续认证流程可能会异常。

常见问题

为什么部署前要先分清 cpa 和 sub2api？

因为两者仓库不同、运行方式不同、后续配置项也不同。 如果一开始就搞混，后面让 AI 继续部署时很容易走错方向。

为什么认证看起来成功了，但没有生成认证文件？

常见原因是 cpa 部署环境无法访问 OpenAI。 这种情况下，前面看起来像是执行完成了，但关键结果并没有真正落盘。

注意事项

• 先确认本次目标项目，再继续部署
• 需要长期维护时，尽量用 git 拉取，而不是每次手动覆盖
• 部署 cpa 前，先确认环境确实能访问 OpenAI