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

## 部分信息

- `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`
