111
This commit is contained in:
parent
5f293ab440
commit
22aa869a75
@ -1,287 +1,325 @@
|
|||||||
# Hapi 进阶配置：Cloudflare 优选 IP 高速穿透
|
# Hapi 进阶配置：Cloudflare 优选 IP 高速穿透
|
||||||
|
|
||||||
**没有公网 IP？使用 Cloudflare 优选 IP，打造高速内网穿透通道**
|
**没有公网 IP？使用 Cloudflare 优选 IP，打造高速内网穿透通道**
|
||||||
|
|
||||||
> **适用场景**：已配置 Cloudflare Tunnel，但访问速度慢、延迟高
|
> **适用场景** ：已配置 Cloudflare Tunnel，但访问速度慢、延迟高 **解决方案** ：利用 Cloudflare for SaaS + 优选 IP 服务，绕过拥堵节点 **前置要求** ：已完成 [Hapi 基础配置](</apps/hapi>)，拥有两个域名
|
||||||
> **解决方案**：利用 Cloudflare for SaaS + 优选 IP 服务，绕过拥堵节点
|
|
||||||
> **前置要求**：已完成 [Hapi 基础配置](/apps/hapi)，并拥有两个域名
|
|
||||||
|
|
||||||
## 📺 视频教程
|
## 📺 视频教程
|
||||||
|
|
||||||
推荐先观看视频：[没有公网 IP？Cloudflare 优选 IP，高速内网穿透 - 哔哩哔哩](https://www.bilibili.com/video/BV1PPy6YzE5C)
|
推荐观看
|
||||||
|
|
||||||
视频完整演示了配置过程，建议先看一遍再上手操作。
|
[没有公网IP？cloudflare优选IP，高速内网穿透 - 哔哩哔哩](<https://www.bilibili.com/video/BV1PPy6YzE5C>)
|
||||||
|
|
||||||
## 🎯 你正在解决什么问题
|
视频详细演示了完整的配置过程，强烈建议先观看视频再进行操作。
|
||||||
|
|
||||||
### 默认 Tunnel 的痛点
|
## 🎯 你正在解决什么问题？
|
||||||
|
|
||||||
直接用 Cloudflare Tunnel 绑定域名时常见以下问题：
|
### 默认 Tunnel 的痛点
|
||||||
|
|
||||||
- ❌ Cloudflare 分配的 Anycast IP 在国内可能被绕路（绕到美国、欧洲）
|
当你直接使用 Cloudflare Tunnel 绑定域名时：
|
||||||
- ❌ 运营商 QoS 限速，访问速度慢
|
|
||||||
- ❌ 延迟高达数百毫秒，严重影响使用体验
|
|
||||||
|
|
||||||
|
* ❌ Cloudflare 分配的 Anycast IP 在国内可能被绕路（绕到美国、欧洲）
|
||||||
|
* ❌ 运营商 QoS 限速，访问速度慢
|
||||||
|
* ❌ 延迟高达几百毫秒，严重影响使用体验
|
||||||
|
|
||||||
### 优选 IP 方案的优势
|
|
||||||
|
|
||||||
通过本教程的配置，可以做到：
|
### 优选 IP 方案的优势
|
||||||
|
|
||||||
- ✅ 强制流量走对国内网络友好的节点（香港、新加坡等）
|
通过本教程的配置：
|
||||||
- ✅ 大幅提升访问速度，延迟降至几十毫秒
|
|
||||||
- ✅ 完全免费，利用 Cloudflare 企业级功能
|
|
||||||
- ✅ 稳定性高，自动切换最优路由
|
|
||||||
|
|
||||||
|
* ✅ 强制流量走对国内网络友好的节点（香港、新加坡等）
|
||||||
|
* ✅ 大幅提升访问速度，延迟降低到几十毫秒
|
||||||
|
* ✅ 完全免费，利用 Cloudflare 企业级功能
|
||||||
|
* ✅ 稳定性高，自动切换最优路由
|
||||||
|
|
||||||
> 🚀 **速度提升对比**
|
|
||||||
> 从两张对比图可以看到，优选 IP 后访问延迟从数百毫秒降到几十毫秒，页面加载也更顺畅。
|
|
||||||
|
|
||||||
## 🔍 原理解析
|
🚀 速度提升对比
|
||||||
|
|
||||||
### 流量走向链路
|
从上面两张图可以看到，优选 IP 后访问速度得到了**显著提升** ，延迟从几百毫秒降低到几十毫秒，页面加载也更加流畅！
|
||||||
|
|
||||||
当用户访问你的域名时，流量按以下路径流转：
|
## 🔍 原理解析
|
||||||
|
|
||||||
```
|
### 流量走向链路
|
||||||
用户浏览器
|
|
||||||
↓
|
|
||||||
DNS 解析：hapi.justdo.xin
|
|
||||||
↓
|
|
||||||
CNAME → cdn.ttdk.fun
|
|
||||||
↓
|
|
||||||
CNAME → isp.qzz.io（优选 IP 调度器）
|
|
||||||
↓
|
|
||||||
返回最优 Cloudflare IP（根据用户运营商）
|
|
||||||
↓
|
|
||||||
Cloudflare 边缘节点（通过 Host Header 识别）
|
|
||||||
↓
|
|
||||||
SaaS 路由：hapi.justdo.xin → hapi.ttdk.fun
|
|
||||||
↓
|
|
||||||
Cloudflare Tunnel（加密隧道）
|
|
||||||
↓
|
|
||||||
你的本地服务器 localhost:3006
|
|
||||||
```
|
|
||||||
|
|
||||||
> 💡 **提示**
|
当用户访问你的域名时，流量是这样流转的：
|
||||||
> [isp.qzz.io](https://isp.qzz.io/) 在这里充当"智能交警"，根据你的网络环境自动选择最优路线。
|
|
||||||
|
|
||||||
|
用户浏览器
|
||||||
|
↓
|
||||||
|
DNS 解析：hapi.justdo.xin
|
||||||
|
↓
|
||||||
|
CNAME → cdn.ttdk.fun
|
||||||
|
↓
|
||||||
|
CNAME → isp.qzz.io（优选 IP 调度器）
|
||||||
|
↓
|
||||||
|
返回最优 Cloudflare IP（根据用户运营商）
|
||||||
|
↓
|
||||||
|
Cloudflare 边缘节点（通过 Host Header 识别）
|
||||||
|
↓
|
||||||
|
SaaS 路由：hapi.justdo.xin → hapi.ttdk.fun
|
||||||
|
↓
|
||||||
|
Cloudflare Tunnel（加密隧道）
|
||||||
|
↓
|
||||||
|
你的本地服务器 localhost:3006
|
||||||
|
|
||||||
### 核心技术要点
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
5
|
||||||
|
6
|
||||||
|
7
|
||||||
|
8
|
||||||
|
9
|
||||||
|
10
|
||||||
|
11
|
||||||
|
12
|
||||||
|
13
|
||||||
|
14
|
||||||
|
15
|
||||||
|
16
|
||||||
|
17
|
||||||
|
|
||||||
1. **优选 IP 调度器**：[isp.qzz.io](https://isp.qzz.io/) 会根据用户的运营商（电信/联通/移动），返回当前速度最快、延迟最低的 Cloudflare 官方 CDN 节点 IP。
|
💡 提示
|
||||||
2. **Cloudflare for SaaS**：通过 Custom Hostnames 功能把"访问域名"和"隧道域名"解耦，实现"走优选 IP 进隧道"。
|
|
||||||
3. **DNS 链式解析**：通过 CNAME 链把用户请求引导到优选 IP，同时保持 Cloudflare 对域名的正确识别。
|
|
||||||
|
|
||||||
> 💡 **关于优选 IP 调度器**
|
[isp.qzz.io](<https://isp.qzz.io/>) 在这里充当"智能交警"的角色，根据你的网络环境自动选择最优路线。
|
||||||
> [isp.qzz.io](https://isp.qzz.io/) 是社区维护的 Cloudflare 优选 IP 调度服务，会自动测速并返回对当前网络环境最优的 Cloudflare CDN 节点。访问该网站可查看更多说明。
|
|
||||||
|
|
||||||
## 🛠️ 配置步骤
|
### 核心技术要点
|
||||||
|
|
||||||
### 前置准备
|
1. **优选 IP 调度器** ：[isp.qzz.io](<https://isp.qzz.io/>) 会根据用户的网络环境（电信/联通/移动），返回当前速度最快、延迟最低的 Cloudflare 官方 CDN 节点 IP
|
||||||
|
|
||||||
|
2. **Cloudflare for SaaS** ：通过 Custom Hostnames 功能，把"访问域名"和"隧道域名"解耦，实现"走优选 IP 进隧道"
|
||||||
|
|
||||||
|
3. **DNS 链式解析** ：通过 CNAME 链，把用户请求引导到优选 IP，同时保持 Cloudflare 对域名的正确识别
|
||||||
|
|
||||||
|
💡 关于优选 IP 调度器
|
||||||
|
|
||||||
|
[isp.qzz.io](<https://isp.qzz.io/>) 是一个社区维护的 Cloudflare 优选 IP 调度服务，它会自动测速并返回对你当前网络环境最优的 Cloudflare CDN 节点。访问该网站可以查看更多信息和使用说明。
|
||||||
|
|
||||||
|
## 🛠️ 配置步骤
|
||||||
|
|
||||||
|
### 前置准备
|
||||||
|
|
||||||
你需要准备：
|
你需要准备：
|
||||||
|
|
||||||
1. **主力域名**：用于展示给用户访问（例如：`hapi.justdo.xin`）
|
1. **主力域名** ：用于展示给用户访问（例如：`hapi.justdo.xin`）
|
||||||
2. **辅助域名**：用于承载 Cloudflare Tunnel（例如：`ttdk.fun`）
|
2. **辅助域名** ：用于承载 Cloudflare Tunnel（例如：`ttdk.fun`）
|
||||||
3. 两个域名都需要托管在 Cloudflare
|
3. 两个域名都需要托管在 Cloudflare
|
||||||
|
|
||||||
> ⚠️ **重要说明**
|
⚠️ 重要说明
|
||||||
> - 主力域名和辅助域名**不能是同一个域名**
|
|
||||||
> - 辅助域名需要是你自己拥有的，不能用别人的
|
|
||||||
> - 两个域名都必须在 Cloudflare 上管理
|
|
||||||
|
|
||||||
### 第一步：配置 Cloudflare Tunnel（辅助域名）
|
* 主力域名和辅助域名**不能是同一个域名**
|
||||||
|
* 辅助域名需要是你自己拥有的，不能用别人的
|
||||||
|
* 两个域名都必须在 Cloudflare 上管理
|
||||||
|
|
||||||
|
### 第一步：配置 Cloudflare Tunnel（辅助域名）
|
||||||
|
|
||||||
在辅助域名（例如 `ttdk.fun`）上设置 Tunnel：
|
在辅助域名（例如 `ttdk.fun`）上设置 Tunnel：
|
||||||
|
|
||||||
1. 登录 Cloudflare，选择辅助域名
|
1. 登录 Cloudflare，选择辅助域名
|
||||||
2. 进入 **Zero Trust → Access → Tunnels**
|
2. 进入 **Zero Trust → Access → Tunnels**
|
||||||
3. 创建隧道并安装 cloudflared
|
3. 创建隧道并安装 cloudflared
|
||||||
4. 配置公共主机名：
|
4. 配置公共主机名：
|
||||||
- **子域名**：`hapi`
|
* **子域名** ：`hapi`
|
||||||
- **域名**：`ttdk.fun`
|
* **域名** ：`ttdk.fun`
|
||||||
- **服务**：`http://localhost:3006`
|
* **服务** ：`http://localhost:3006`
|
||||||
|
|
||||||
完成后，你应该可以通过 `hapi.ttdk.fun` 访问 Hapi 服务。
|
完成后你应该能通过 `hapi.ttdk.fun` 访问你的 Hapi 服务。
|
||||||
|
|
||||||
### 第二步：启用 Cloudflare for SaaS（辅助域名）
|
### 第二步：启用 Cloudflare for SaaS（辅助域名）
|
||||||
|
|
||||||
在辅助域名（`ttdk.fun`）上启用 SaaS 功能：
|
在辅助域名（`ttdk.fun`）上启用 SaaS 功能：
|
||||||
|
|
||||||
1. 进入 Cloudflare 控制台
|
1. 进入 Cloudflare 控制台
|
||||||
2. 选择 `ttdk.fun` 域名
|
2. 选择 `ttdk.fun` 域名
|
||||||
3. 进入 **SSL/TLS → Custom Hostnames**
|
3. 进入 **SSL/TLS → Custom Hostnames**
|
||||||
4. 点击 **Add Custom Hostname**
|
4. 点击 **Add Custom Hostname**
|
||||||
5. 填写：
|
5. 填写：
|
||||||
- **Custom Hostname**：`hapi.justdo.xin`（主力域名）
|
* **Custom Hostname** ：`hapi.justdo.xin`（主力域名）
|
||||||
- **Wildcard**：不勾选
|
* **Wildcard** ：不勾选
|
||||||
6. 点击 **Add Custom Hostname**
|
6. 点击 **Add Custom Hostname**
|
||||||
|
|
||||||
> 💡 **提示**
|
💡 提示
|
||||||
> 添加后会生成 2 条 TXT 验证记录，先保留页面，下一步会用到。
|
|
||||||
|
|
||||||
### 第三步：配置 DNS 解析（主力域名）
|
添加后会生成 2 条 TXT 验证记录，先不着急配置，继续下一步。
|
||||||
|
|
||||||
在主力域名（`justdo.xin`）的 DNS 设置中添加以下记录。
|
### 第三步：配置 DNS 解析（主力域名）
|
||||||
|
|
||||||
#### 3.1 添加 SSL 验证记录
|
在主力域名（`justdo.xin`）的 DNS 设置中添加以下记录：
|
||||||
|
|
||||||
把第二步生成的 2 条 TXT 记录添加到主力域名的 DNS：
|
#### 3.1 添加 SSL 验证记录
|
||||||
|
|
||||||
| 类型 | 名称 | 内容 | 代理状态 |
|
从第二步中复制 Cloudflare 生成的 2 条 TXT 记录，添加到主力域名的 DNS：
|
||||||
| --- | --- | --- | --- |
|
|
||||||
| TXT | `_acme-challenge.hapi` | `xxxxxxxxxx`（从 SaaS 页面复制） | 仅限 DNS |
|
|
||||||
| TXT | `_acme-challenge.hapi` | `yyyyyyyyyy`（从 SaaS 页面复制） | 仅限 DNS |
|
|
||||||
|
|
||||||
#### 3.2 添加 CNAME 记录
|
类型| 名称| 内容| 代理状态
|
||||||
|
---|---|---|---
|
||||||
|
TXT| `_acme-challenge.hapi`| `xxxxxxxxxx`（从 SaaS 页面复制）| 仅限 DNS
|
||||||
|
TXT| `_acme-challenge.hapi`| `yyyyyyyyyy`（从 SaaS 页面复制）| 仅限 DNS
|
||||||
|
|
||||||
|
#### 3.2 添加 CNAME 记录
|
||||||
|
|
||||||
| 类型 | 名称 | 目标 | 代理状态 |
|
类型| 名称| 目标| 代理状态
|
||||||
| --- | --- | --- | --- |
|
---|---|---|---
|
||||||
| CNAME | `cdn` | `isp.qzz.io` | 仅限 DNS ⚠️ |
|
CNAME| `cdn`| `isp.qzz.io`| 仅限 DNS ⚠️
|
||||||
| CNAME | `hapi` | `cdn.justdo.xin` | 仅限 DNS ⚠️ |
|
CNAME| `hapi`| `cdn.justdo.xin`| 仅限 DNS ⚠️
|
||||||
|
|
||||||
|
🚨 关键配置
|
||||||
|
|
||||||
> 🚨 **关键配置**
|
**必须关闭小黄云（代理状态设为 "仅限 DNS"）！**
|
||||||
> **必须关闭小黄云（代理状态设为「仅限 DNS」）**。
|
|
||||||
> 一旦开启代理，会导致 DNS 解析链中断，无法触发优选 IP。
|
|
||||||
|
|
||||||
### 第四步：配置回退源（辅助域名）
|
如果开启代理，会导致 DNS 解析链中断，无法触发优选 IP。
|
||||||
|
|
||||||
|
### 第四步：配置回退源（辅助域名）
|
||||||
|
|
||||||
在辅助域名（`ttdk.fun`）的 DNS 设置中：
|
在辅助域名（`ttdk.fun`）的 DNS 设置中：
|
||||||
|
|
||||||
| 类型 | 名称 | 目标 | 代理状态 |
|
类型| 名称| 目标| 代理状态
|
||||||
| --- | --- | --- | --- |
|
---|---|---|---
|
||||||
| CNAME | `hapi` | `[你的隧道ID].cfargotunnel.com` | 已代理 ✅ |
|
CNAME| `hapi`| `[你的隧道ID].cfargotunnel.com`| 已代理 ✅
|
||||||
|
|
||||||
|
💡 提示
|
||||||
|
|
||||||
> 💡 **提示**
|
这条记录通常在创建 Tunnel 时自动生成。确保小黄云是**开启** 状态（已代理）。
|
||||||
> 这条记录通常在创建 Tunnel 时会自动生成。请确保小黄云为**开启**状态（已代理）。
|
|
||||||
|
|
||||||
### 第五步：等待 SSL 证书生效
|
### 第五步：等待 SSL 证书生效
|
||||||
|
|
||||||
1. 回到辅助域名的 **SSL/TLS → Custom Hostnames** 页面
|
1. 回到辅助域名的 **SSL/TLS → Custom Hostnames** 页面
|
||||||
2. 查看 `hapi.justdo.xin` 的状态
|
2. 查看 `hapi.justdo.xin` 的状态
|
||||||
3. 等待几分钟，状态变为 **Active（有效）** 即配置成功
|
3. 等待几分钟，状态变为 **Active（有效）** 即表示配置成功
|
||||||
|
|
||||||
> ⏳ **耐心等待**
|
⏳ 耐心等待
|
||||||
> SSL 证书签发通常需要 5-15 分钟。如超过 30 分钟仍未生效，请检查 TXT 记录是否正确添加。
|
|
||||||
|
|
||||||
## ✅ 验证配置
|
SSL 证书签发通常需要 5-15 分钟，请耐心等待。如果超过 30 分钟仍未生效，检查 TXT 记录是否正确添加。
|
||||||
|
|
||||||
### 测试访问
|
## ✅ 验证配置
|
||||||
|
|
||||||
在浏览器中访问 `https://hapi.justdo.xin`，能正常打开 Hapi 界面即表示配置成功。
|
### 测试访问
|
||||||
|
|
||||||
### 测试速度提升
|
在浏览器中访问：`https://hapi.justdo.xin`
|
||||||
|
|
||||||
使用 ping 或测速工具对比延迟。
|
如果能正常打开 Hapi 界面，说明配置成功！
|
||||||
|
|
||||||
**优化前**：
|
### 测试速度提升
|
||||||
|
|
||||||
```bash
|
使用 ping 或测速工具对比：
|
||||||
ping hapi.ttdk.fun
|
|
||||||
# 延迟通常 200-500ms
|
|
||||||
```
|
|
||||||
|
|
||||||
**优化后**：
|
**优化前** ：
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
ping hapi.justdo.xin
|
|
||||||
# 延迟通常 20-100ms
|
|
||||||
```
|
ping hapi.ttdk.fun
|
||||||
|
# 延迟通常 200-500ms
|
||||||
|
|
||||||
## 🎓 角色分配总结
|
1
|
||||||
|
2
|
||||||
|
|
||||||
| 角色 | 域名示例 | 作用 |
|
**优化后** ：
|
||||||
| --- | --- | --- |
|
|
||||||
| **主力域名** | `hapi.justdo.xin` | 最终展示给用户访问的地址 |
|
|
||||||
| **辅助域名** | `hapi.ttdk.fun` | 承载 Tunnel 的「回退源」，用户不直接感知 |
|
|
||||||
| **优选 IP 调度器** | [isp.qzz.io](https://isp.qzz.io/) | 像「交警」，告诉流量走哪条不堵的路 |
|
|
||||||
| **中转域名** | `cdn.justdo.xin` | 作为跳板，把主力域名引向优选 IP 池 |
|
|
||||||
|
|
||||||
## 🔧 故障排查
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
ping hapi.justdo.xin
|
||||||
|
# 延迟通常 20-100ms
|
||||||
|
|
||||||
### SSL 证书一直显示 Pending
|
1
|
||||||
|
2
|
||||||
|
|
||||||
**可能原因**：
|
## 🎓 角色分配总结
|
||||||
|
|
||||||
- TXT 记录添加错误或未生效
|
角色| 域名示例| 作用
|
||||||
- DNS 传播尚未完成
|
---|---|---
|
||||||
|
**主力域名**| `hapi.justdo.xin`| 你最终展示给用户访问的地址
|
||||||
|
**辅助域名**| `hapi.ttdk.fun`| 承载 Tunnel 的"回退源"，用户不直接感知
|
||||||
|
**优选 IP 调度器**| [isp.qzz.io](<https://isp.qzz.io/>)| 像"交警"，告诉流量该走哪条不堵的路
|
||||||
|
**中转域名**| `cdn.justdo.xin`| 作为跳板，把主力域名引向优选 IP 池
|
||||||
|
|
||||||
|
## 🔧 故障排查
|
||||||
|
|
||||||
**解决方法**：
|
### SSL 证书一直显示 Pending？
|
||||||
|
|
||||||
1. 使用 [DNS 检查工具](https://dnschecker.org/) 验证 TXT 记录
|
**可能原因** ：
|
||||||
2. 等待 DNS 全球传播（最长 24 小时）
|
|
||||||
3. 必要时重新添加 Custom Hostname
|
|
||||||
|
|
||||||
### 访问显示 526 错误
|
* TXT 记录添加错误或未生效
|
||||||
|
* DNS 传播未完成
|
||||||
|
|
||||||
**可能原因**：
|
**解决方法** ：
|
||||||
|
|
||||||
- 辅助域名的 `hapi` 记录未开启代理（小黄云）
|
1. 使用 [DNS 检查工具](<https://dnschecker.org/>) 验证 TXT 记录
|
||||||
- Tunnel 未正确配置
|
2. 等待 DNS 全球传播（最多 24 小时）
|
||||||
|
3. 重新添加 Custom Hostname
|
||||||
|
|
||||||
**解决方法**：
|
### 访问显示 526 错误？
|
||||||
|
|
||||||
1. 确认 `hapi.ttdk.fun` 的小黄云为**开启**状态
|
**可能原因** ：
|
||||||
2. 检查 Tunnel 是否正常运行
|
|
||||||
|
|
||||||
### 访问仍然很慢
|
* 辅助域名的 `hapi` 记录未开启代理（小黄云）
|
||||||
|
* Tunnel 未正确配置
|
||||||
|
|
||||||
**可能原因**：
|
**解决方法** ：
|
||||||
|
|
||||||
- 主力域名的 CNAME 记录开启了代理
|
1. 确保 `hapi.ttdk.fun` 的小黄云是**开启** 状态
|
||||||
- DNS 解析链断裂
|
2. 检查 Tunnel 是否正常运行
|
||||||
|
|
||||||
**解决方法**：
|
### 访问仍然很慢？
|
||||||
|
|
||||||
1. 确认 `hapi.justdo.xin` 与 `cdn.justdo.xin` 的小黄云均为**关闭**状态
|
**可能原因** ：
|
||||||
2. 使用 `nslookup` 检查 DNS 解析链是否完整
|
|
||||||
|
|
||||||
## 🚀 进阶优化
|
* 主力域名的 CNAME 记录开启了代理
|
||||||
|
* DNS 解析链断裂
|
||||||
|
|
||||||
### 自建优选 IP 服务
|
**解决方法** ：
|
||||||
|
|
||||||
如果你追求更稳定的体验，可以：
|
1. 确保 `hapi.justdo.xin` 和 `cdn.justdo.xin` 的小黄云都是**关闭** 状态
|
||||||
|
2. 使用 `nslookup` 检查 DNS 解析链是否完整
|
||||||
|
|
||||||
1. 使用 CloudflareSpeedTest 工具本地测速
|
## 🚀 进阶优化
|
||||||
2. 手动选择最优 IP
|
|
||||||
3. 创建自己的优选域名，替代 `isp.qzz.io`
|
|
||||||
|
|
||||||
### 多运营商优化
|
### 自建优选 IP 服务
|
||||||
|
|
||||||
|
如果你追求极致稳定，可以：
|
||||||
|
|
||||||
|
1. 使用 CloudflareSpeedTest 工具本地测速
|
||||||
|
2. 手动选择最优 IP
|
||||||
|
3. 创建自己的优选域名，替代 `isp.qzz.io`
|
||||||
|
|
||||||
|
### 多运营商优化
|
||||||
|
|
||||||
可以针对不同运营商配置不同的优选路径：
|
可以针对不同运营商配置不同的优选路径：
|
||||||
|
|
||||||
- 电信用户：`cdn-ct.yourdomain.com`
|
* 电信用户：`cdn-ct.yourdomain.com`
|
||||||
- 联通用户：`cdn-cu.yourdomain.com`
|
* 联通用户：`cdn-cu.yourdomain.com`
|
||||||
- 移动用户：`cdn-cm.yourdomain.com`
|
* 移动用户：`cdn-cm.yourdomain.com`
|
||||||
|
|
||||||
通过 DNS 智能解析（GeoDNS），根据用户运营商返回不同的 CNAME 记录。
|
通过 DNS 智能解析（GeoDNS），根据用户运营商返回不同的 CNAME 记录。
|
||||||
|
|
||||||
## 📚 相关资源
|
## 📚 相关资源
|
||||||
|
|
||||||
- [Cloudflare for SaaS 官方文档](https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/)
|
* [Cloudflare for SaaS 官方文档](<https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/>)
|
||||||
- [Cloudflare Tunnel 文档](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/)
|
* [Cloudflare Tunnel 文档](<https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/>)
|
||||||
- [isp.qzz.io - 优选 IP 调度器](https://isp.qzz.io/)
|
* [isp.qzz.io - 优选 IP 调度器](<https://isp.qzz.io/>)
|
||||||
- [视频教程：Cloudflare 优选 IP 配置](https://www.bilibili.com/video/BV1PPy6YzE5C)
|
* [视频教程：cloudflare优选IP配置](<https://www.bilibili.com/video/BV1PPy6YzE5C>)
|
||||||
|
|
||||||
## ⚠️ 安全提醒
|
## ⚠️ 安全提醒
|
||||||
|
|
||||||
1. 不要泄露 Tunnel 令牌
|
1. 不要泄露你的 Tunnel 令牌
|
||||||
2. 定期检查 Custom Hostnames 配置
|
2. 定期检查 Custom Hostnames 配置
|
||||||
3. [isp.qzz.io](https://isp.qzz.io/) 是社区维护的优选 IP 服务，可靠但非官方，必要时可自建
|
3. [isp.qzz.io](<https://isp.qzz.io/>) 是社区维护的优选 IP 服务，虽然可靠但非官方服务，你也可以选择自建优选服务
|
||||||
4. 建议配合 Cloudflare Access 限制访问来源
|
4. 建议配合 Cloudflare Access 限制访问来源
|
||||||
|
|
||||||
## 💡 总结
|
## 💡 总结
|
||||||
|
|
||||||
通过这套配置，你可以做到：
|
通过这套配置，你：
|
||||||
|
|
||||||
- ✅ 不花一分钱
|
* ✅ 不花一分钱
|
||||||
- ✅ 利用 Cloudflare 企业级 SaaS 功能
|
* ✅ 利用 Cloudflare 企业级 SaaS 功能
|
||||||
- ✅ 把原本数百毫秒延迟的内网穿透优化到接近直连的体验
|
* ✅ 把原本几百毫秒延迟的内网穿透，优化到接近直连的体验
|
||||||
- ✅ 打造一条「高速内网穿透通道」
|
* ✅ 打造了一条"高速内网穿透通道"
|
||||||
|
|
||||||
这是目前免费方案中，提升 Cloudflare 内网穿透速度的**天花板级别配置**。
|
这就是目前免费方案中，提升 Cloudflare 内网穿透速度的**天花板级别配置** ！
|
||||||
|
|
||||||
---
|
* * *
|
||||||
|
|
||||||
**下一步**：配置完成后，你就可以在任何地方高速访问 Hapi 服务了 🎉
|
**下一步** ：配置完成后，你可以愉快地在任何地方高速访问你的 Hapi 服务了！🎉
|
||||||
|
|||||||
121
apps/opencode.md
121
apps/opencode.md
@ -1,98 +1,103 @@
|
|||||||
# OpenCode 配置指南
|
# OpenCode 配置指南
|
||||||
|
|
||||||
**开源 AI 编程助手，终端中的智能编码伙伴**
|
**开源 AI 编程助手，终端中的智能编码伙伴**
|
||||||
|
|
||||||
## 📋 简介
|
📋 简介
|
||||||
|
|
||||||
OpenCode 是一款开源的 AI 编程助手，可在终端、IDE 或桌面环境中辅助编写、调试和改进代码。支持原生终端 TUI 界面、多会话并行、75+ 模型提供商接入，是命令行开发者的理想工具。
|
OpenCode 是一款开源的 AI 编程助手，可在终端、IDE 或桌面环境中辅助编写、调试和改进代码。支持原生终端 TUI 界面、多会话并行、75+ 模型提供商接入，是命令行开发者的理想工具。
|
||||||
|
|
||||||
## 🔗 相关链接
|
## 🔗 相关链接
|
||||||
|
|
||||||
| 资源 | 地址 |
|
资源| 地址
|
||||||
| --- | --- |
|
---|---
|
||||||
| OpenCode 项目 | <https://github.com/opencode-ai/opencode> |
|
OpenCode 项目| <https://github.com/opencode-ai/opencode>
|
||||||
| oneinai 控制台 | <https://api.oneinai.com/console/token> |
|
|
||||||
|
## ✨ 功能特点
|
||||||
|
|
||||||
## ✨ 功能特点
|
* ✅ **原生终端 TUI** ：专为命令行开发者设计，高效流畅
|
||||||
|
* ✅ **智能 LSP 加载** ：自动加载正确的语言服务器，提升上下文理解
|
||||||
|
* ✅ **多会话并行** ：支持多个会话同时运行，互不干扰
|
||||||
|
* ✅ **会话链接共享** ：可分享会话链接给他人协作
|
||||||
|
* ✅ **75+ 模型支持** ：支持多种模型提供商，包括本地模型
|
||||||
|
* ✅ **多平台支持** ：终端 CLI、桌面应用（Beta）、IDE 扩展
|
||||||
|
|
||||||
- ✅ **原生终端 TUI**：专为命令行开发者设计，高效流畅
|
## 🛠️ 安装与配置
|
||||||
- ✅ **智能 LSP 加载**：自动加载正确的语言服务器，提升上下文理解
|
|
||||||
- ✅ **多会话并行**：支持多个会话同时运行，互不干扰
|
|
||||||
- ✅ **会话链接共享**：可分享会话链接给他人协作
|
|
||||||
- ✅ **75+ 模型支持**：支持多种模型提供商，包括本地模型
|
|
||||||
- ✅ **多平台支持**：终端 CLI、桌面应用（Beta）、IDE 扩展
|
|
||||||
|
|
||||||
## 🛠️ 安装与配置
|
### 第一步：安装 OpenCode
|
||||||
|
|
||||||
### 第一步：安装 OpenCode
|
|
||||||
|
|
||||||
打开终端，运行以下命令全局安装 OpenCode：
|
打开终端，运行以下命令全局安装 OpenCode：
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
npm install -g opencode-ai
|
|
||||||
```
|
|
||||||
|
npm install -g opencode-ai
|
||||||
|
|
||||||
|
1
|
||||||
|
|
||||||
安装完成后，在终端输入 `opencode` 命令，若出现 TUI 界面则安装成功。
|
安装完成后，在终端输入 `opencode` 命令，若出现 TUI 界面则安装成功。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### 第二步：安装 CC-Switch
|
### 第二步：安装 CC-Switch
|
||||||
|
|
||||||
查看 [CC-Switch 配置工具](/tools/cc-switch) 文档，下载并安装 CC-Switch 到本地。
|
查看 [CC-Switch 配置工具](</tools/cc-switch>) 文档，下载并安装 CC-Switch 到本地。
|
||||||
|
|
||||||
### 第三步：添加 oneinai 供应商
|
### 第三步：添加 IkunCode 供应商
|
||||||
|
|
||||||
**1. 选择配置项**
|
**1\. 选择配置项**
|
||||||
|
|
||||||
打开 CC-Switch，上方配置项选择 `OpenCode`，然后点击 **添加供应商** 按钮。
|
打开 CC-Switch，上方配置项选择 `OpenCode`，然后点击 **添加供应商** 按钮。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**2. 填写供应商信息**
|
**2\. 填写供应商信息**
|
||||||
|
|
||||||
按以下说明配置各项参数：
|
按以下说明配置各项参数：
|
||||||
|
|
||||||
| 配置项 | 说明 |
|
配置项| 说明
|
||||||
| --- | --- |
|
---|---
|
||||||
| **预设供应商** | 选择 `oneinai` |
|
**预设供应商**| 选择 `IkunCode`
|
||||||
| **供应商标识** | 自定义名称，如 `oneinai-Claude` |
|
**供应商标识**| 自定义名称，如 `IkunCode-Claude`
|
||||||
| **接口格式** | Claude 模型选 `Anthropic`；GPT 模型选 `OpenAI`；Gemini 模型选 `Google (Gemini)` |
|
**接口格式**| Claude 模型选 `Anthropic`；GPT 模型选 `OpenAI`；Gemini 模型选 `Google (Gemini)`
|
||||||
| **API Key** | 填入你在 [oneinai 控制台](https://api.oneinai.com/console/token) 创建的 Key |
|
**API Key**| 填入你在 [IkunCode 控制台](<https://api.oneinai.com/console/token>) 创建的 Key
|
||||||
| **额外选项** | 填写 `{"setCacheKey":true}` |
|
**额外选项**| 填写 `{"setCacheKey":true}`
|
||||||
|
|
||||||
|
💡 支持的分组
|
||||||
|
|
||||||
> 💡 **支持的分组**
|
根据你需要的模型类型，选择正确分组的 API Key：
|
||||||
> 根据你需要的模型类型，选择对应分组的 API Key：
|
|
||||||
>
|
|
||||||
> - **Claude 系列**：只允许逆向分组
|
|
||||||
> - **GPT 系列**：Codex 分组
|
|
||||||
> - **Gemini 系列**：Gemini 分组
|
|
||||||
>
|
|
||||||
> 请在[创建专属 Key](/guide/create-key) 时选择对应分组。
|
|
||||||
|
|
||||||
## ✅ 验证配置
|
|
||||||
|
|
||||||
1. 重新打开终端，输入 `opencode` 运行
|
* **Claude 系列** ：只允许逆向分组
|
||||||
2. 输入 `/models` 命令，检查配置的渠道是否出现在模型列表中
|
* **GPT 系列** ：Codex 分组
|
||||||
3. 如果能看到你添加的模型，说明配置成功
|
* **Gemini 系列** ：Gemini 分组
|
||||||
|
|
||||||
|
请在 [创建专属 Key](</guide/create-key>) 时选择对应分组。
|
||||||
|
|
||||||
开始愉快地编码吧 🎉
|
## ✅ 验证配置
|
||||||
|
|
||||||
|
1. 重新打开终端，输入 `opencode` 运行
|
||||||
|
2. 输入 `/models` 命令，检查配置的渠道是否出现在模型列表中
|
||||||
|
3. 如果能看到你添加的模型，说明配置成功
|
||||||
|
|
||||||
## ❓ 常见问题
|
|
||||||
|
|
||||||
### 安装时提示 npm 未找到？
|
开始愉快地编码吧！🎉
|
||||||
|
|
||||||
请先安装 Node.js 环境，参考 [Node.js 环境安装](/node/windows) 文档。
|
|
||||||
|
|
||||||
### 模型列表中看不到配置的渠道？
|
## 常见问题
|
||||||
|
|
||||||
- 确认 CC-Switch 中已正确保存配置
|
### 安装时提示 npm 未找到？
|
||||||
- 重启终端后再次运行 `opencode`
|
|
||||||
- 检查 API Key 是否填写正确
|
|
||||||
|
|
||||||
### 更多问题
|
请先安装 Node.js 环境，参考 [Node.js 环境安装](</node/windows>) 文档。
|
||||||
|
|
||||||
请查看 [FAQ](/support/faq) 或联系[售后支持](/support/after-sales)。
|
### 模型列表中看不到配置的渠道？
|
||||||
|
|
||||||
|
* 确认 CC-Switch 中已正确保存配置
|
||||||
|
* 重启终端后再次运行 `opencode`
|
||||||
|
* 检查 API Key 是否填写正确
|
||||||
|
|
||||||
|
### 更多问题
|
||||||
|
|
||||||
|
请查看 [FAQ](</support/faq>) 或联系[售后支持](</support/after-sales>)。
|
||||||
|
|||||||
510
deploy/codex.md
510
deploy/codex.md
@ -1,283 +1,393 @@
|
|||||||
# CodeX 部署指南
|
# CodeX 部署指南
|
||||||
|
|
||||||
**企业级 AI 编码助手 - 完整部署手册**
|
**企业级 AI 编码助手 - 完整部署手册**
|
||||||
|
|
||||||
| 资源 | 地址 |
|
资源| 地址
|
||||||
| --- | --- |
|
---|---
|
||||||
| 官方文档 | [developers.openai.com/codex](https://developers.openai.com/codex/) |
|
官方文档| [developers.openai.com/codex](<https://developers.openai.com/codex/>)
|
||||||
| oneinai 控制台 | <https://api.oneinai.com/console/token> |
|
|
||||||
|
📋 前置要求
|
||||||
|
|
||||||
> 📋 **前置要求**
|
请先完成 [Node.js 环境安装](</node/windows>) 和 [CC-Switch 工具安装](</tools/cc-switch>)。
|
||||||
> 请先完成 [Node.js 环境安装](/node/windows) 和 [CC-Switch 工具安装](/tools/cc-switch)。
|
|
||||||
|
|
||||||
## 🎯 快速导航
|
## 🎯 快速导航
|
||||||
|
|
||||||
CodeX 是基于 GPT-5 架构的智能编程助手，为开发者提供卓越的代码生成与优化能力。
|
CodeX 是基于 GPT-5 架构的下一代智能编程助手，为开发者提供卓越的代码生成与优化能力。
|
||||||
|
|
||||||
**部署路径**：系统环境配置 ➜ CLI 工具安装 ➜ API 集成 ➜ 开发环境就绪
|
**部署路径** ：系统环境配置 ➜ CLI 工具安装 ➜ API 集成 ➜ 开发环境就绪
|
||||||
|
|
||||||
## 🚀 使用 CC-Switch 快速配置（推荐）
|
## 🚀 使用 CC-Switch 快速配置（推荐）
|
||||||
|
|
||||||
> ⚠️ **前置条件**
|
⚠️ 前置条件
|
||||||
> 使用 CC-Switch 配置 CodeX 之前，请确保已通过 npm 全局安装 CodeX 工具：
|
|
||||||
>
|
|
||||||
> ```bash
|
|
||||||
> npm install -g @openai/codex@latest
|
|
||||||
> ```
|
|
||||||
>
|
|
||||||
> 验证安装：`codex --version`
|
|
||||||
|
|
||||||
推荐使用 [CC-Switch 快速配置工具](/tools/cc-switch) 进行图形化配置，简单快捷无需命令行操作。
|
使用 CC-Switch 配置 CodeX 之前，请确保已通过 npm 全局安装 CodeX 工具：
|
||||||
|
|
||||||
### 配置步骤
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
npm install -g @openai/codex@latest
|
||||||
|
|
||||||
**1. 启动 CC-Switch 并切换到 Codex 标签**
|
1
|
||||||
|
|
||||||
1. 打开 CC-Switch 应用程序
|
验证安装：`codex --version`
|
||||||
2. 点击顶部的「Codex」标签页
|
|
||||||
3. 点击右上角橙色「+」按钮添加新配置
|
推荐使用 [CC-Switch 快速配置工具](</tools/cc-switch>) 进行图形化配置，简单快捷无需命令行操作。
|
||||||
|
|
||||||
|
### 配置步骤
|
||||||
|
|
||||||
|
**1\. 启动 CC-Switch 并切换到 Codex 标签**
|
||||||
|
|
||||||
|
1. 打开 CC-Switch 应用程序
|
||||||
|
2. 点击顶部的「Codex」标签页
|
||||||
|
3. 点击右上角橙色「+」按钮添加新配置
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**2. 填写 CodeX 提供商配置**
|
**2\. 填写 CodeX 提供商配置**
|
||||||
|
|
||||||
| 配置项 | 说明 |
|
1. **提供商名称** ：自定义名称（如「IkunCoding」）
|
||||||
| --- | --- |
|
2. **Base URL** ：输入 `https://api.oneinai.com/v1`
|
||||||
| **提供商名称** | 自定义名称，如「oneinai」 |
|
3. **API Key** ：粘贴您从 IkunCode 平台获取的 CodeX 专用令牌（codex令牌组）
|
||||||
| **Base URL** | `https://api.oneinai.com/v1` |
|
4. **Model** ：选择 `gpt-5.4`（书写文档时最新模型为 5.4）
|
||||||
| **API Key** | 在 [oneinai 控制台](https://api.oneinai.com/console/token) 创建的 CodeX 专用令牌（codex 令牌组） |
|
5. **其他配置** ：根据需求调整推理强度、网络访问等参数
|
||||||
| **Model** | `gpt-5.4`（撰写文档时最新模型为 5.4） |
|
6. 点击「保存」按钮
|
||||||
| **其他配置** | 根据需求调整推理强度、网络访问等参数 |
|
|
||||||
|
|
||||||
填写完成后点击「保存」按钮。
|
|
||||||
|
|
||||||
|
💡 提示
|
||||||
|
|
||||||
|
|
||||||
> 💡 **提示**
|
* CC-Switch 会自动创建 `~/.codex/config.toml` 和 `auth.json` 文件
|
||||||
> - CC-Switch 会自动创建 `~/.codex/config.toml` 和 `auth.json` 文件
|
* 可以添加多个提供商配置，随时切换
|
||||||
> - 可以添加多个提供商配置，随时切换
|
* 切换配置后，关闭并重启 CodeX 即可生效
|
||||||
> - 切换配置后，关闭并重启 CodeX 即可生效
|
|
||||||
|
|
||||||
**3. 启用配置并使用**
|
**3\. 启用配置并使用**
|
||||||
|
|
||||||
1. 在配置列表中找到刚创建的「oneinai」配置
|
1. 在配置列表中找到刚创建的「IkunCoding」配置
|
||||||
2. 点击配置右侧的「当前使用」按钮
|
2. 点击配置右侧的「当前使用」按钮
|
||||||
3. 配置会被标记为「当前使用」状态（绿色标签）
|
3. 配置会被标记为「当前使用」状态（绿色标签）
|
||||||
4. 重启 CodeX，新配置即可生效
|
4. 重启 CodeX，新配置即可生效
|
||||||
|
|
||||||
**4. 系统托盘快速切换**
|
**4\. 系统托盘快速切换**
|
||||||
|
|
||||||
CC-Switch 支持通过系统托盘快速切换 CodeX 配置：
|
CC-Switch 支持通过系统托盘快速切换 CodeX 配置：
|
||||||
|
|
||||||
- 右键点击系统托盘中的 CC-Switch 图标
|
* 右键点击系统托盘中的 CC-Switch 图标
|
||||||
- 在菜单中选择 Codex 分类
|
* 在菜单中选择 Codex 分类
|
||||||
- 直接选择要切换到的配置
|
* 直接选择要切换到的配置
|
||||||
- 配置立即生效，无需打开主界面
|
* 配置立即生效，无需打开主界面
|
||||||
|
|
||||||
> ⚠️ **注意事项**
|
⚠️ 注意事项
|
||||||
> - 务必在 oneinai 平台创建「codex」令牌组的专用密钥
|
|
||||||
> - CodeX 令牌与 Claude Code 令牌不通用
|
|
||||||
> - 切换配置后需要重启 CodeX 才能生效
|
|
||||||
> - 可在 CC-Switch 中测试 API 端点速度
|
|
||||||
|
|
||||||
## ⌨️ 手动命令行配置
|
* 务必从 IkunCode 平台创建「codex」令牌组的专用密钥
|
||||||
|
* CodeX 令牌与 Claude Code 令牌不通用
|
||||||
|
* 切换配置后需要重启 CodeX 才能生效
|
||||||
|
* 可在 CC-Switch 中测试 API 端点速度
|
||||||
|
|
||||||
如果你不使用 CC-Switch，可以按照以下步骤手动配置 CodeX。
|
## ⌨️ 手动命令行配置
|
||||||
|
|
||||||
### 🖥️ Windows 平台
|
如果您不使用 CC-Switch，可以按照以下步骤手动配置 CodeX。
|
||||||
|
|
||||||
#### 第一步：部署 CodeX 命令行工具
|
### 🖥️ Windows 平台
|
||||||
|
|
||||||
|
#### 第一步：部署 CodeX 命令行工具
|
||||||
|
|
||||||
以管理员权限启动命令提示符或 PowerShell，执行：
|
以管理员权限启动命令提示符或 PowerShell，执行：
|
||||||
|
|
||||||
```powershell
|
powershell
|
||||||
npm install -g @openai/codex@latest
|
|
||||||
codex --version
|
|
||||||
```
|
npm install -g @openai/codex@latest
|
||||||
|
codex --version
|
||||||
|
|
||||||
#### 第二步：集成 oneinai API 服务
|
1
|
||||||
|
2
|
||||||
|
|
||||||
**获取专属 API 凭证**：
|
#### 第二步：集成 IkunCoding API 服务
|
||||||
|
|
||||||
1. 访问 [oneinai 控制台](https://api.oneinai.com/console/token)
|
**获取专属 API 凭证** ：
|
||||||
2. 完成账户注册或登录
|
|
||||||
3. 进入「API 密钥管理」模块
|
|
||||||
4. 创建新密钥时务必选择「codex」令牌组
|
|
||||||
5. 安全保存生成的 API Key
|
|
||||||
|
|
||||||
> 🔐 **安全提醒**
|
1. 访问 IkunCoding 开发者控制台
|
||||||
> CodeX 要求使用独立的令牌组配置，与 Claude Code 令牌体系完全隔离。
|
2. 完成账户注册或执行登录操作
|
||||||
|
3. 导航至「API 密钥管理」模块
|
||||||
|
4. 创建新密钥时，务必选择「codex」令牌组
|
||||||
|
5. 安全保存生成的 API Key
|
||||||
|
|
||||||
**构建配置目录结构**：
|
🔐 安全提醒
|
||||||
|
|
||||||
```powershell
|
CodeX 要求使用独立的令牌组配置，与 Claude Code 令牌体系完全隔离。
|
||||||
mkdir $env:USERPROFILE\.codex
|
|
||||||
cd $env:USERPROFILE\.codex
|
|
||||||
```
|
|
||||||
|
|
||||||
**编写配置文件 `config.toml`**：
|
**构建配置目录结构** ：
|
||||||
|
|
||||||
```toml
|
powershell
|
||||||
model_provider = "oneinai"
|
|
||||||
model = "gpt-5.4"
|
|
||||||
model_reasoning_effort = "xhigh"
|
mkdir %USERPROFILE%\\.codex
|
||||||
disable_response_storage = true
|
cd %USERPROFILE%\\.codex
|
||||||
approval_policy = "on-request"
|
|
||||||
sandbox_mode = "danger-full-access"
|
|
||||||
model_supports_reasoning_summaries = true
|
|
||||||
|
|
||||||
[model_providers.oneinai]
|
1
|
||||||
name = "oneinai"
|
2
|
||||||
base_url = "https://api.oneinai.com/v1"
|
|
||||||
wire_api = "responses"
|
|
||||||
requires_openai_auth = true
|
|
||||||
```
|
|
||||||
|
|
||||||
**编写认证文件 `auth.json`**：
|
**编写配置文件：config.toml**
|
||||||
|
|
||||||
```json
|
toml
|
||||||
{
|
|
||||||
"OPENAI_API_KEY": "此处粘贴你的 CodeX 专用令牌"
|
|
||||||
}
|
model_provider = "IkunCoding"
|
||||||
```
|
model = "gpt-5.4"
|
||||||
|
model_reasoning_effort = "xhigh"
|
||||||
|
disable_response_storage = true
|
||||||
|
approval_policy = "on-request"
|
||||||
|
sandbox_mode = "danger-full-access"
|
||||||
|
model_supports_reasoning_summaries = true
|
||||||
|
|
||||||
|
[model_providers.IkunCoding]
|
||||||
|
name = "ikun"
|
||||||
|
base_url = "https://api.oneinai.com/v1"
|
||||||
|
wire_api = "responses"
|
||||||
|
requires_openai_auth = true
|
||||||
|
|
||||||
#### 第三步：初始化工作空间
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
5
|
||||||
|
6
|
||||||
|
7
|
||||||
|
8
|
||||||
|
9
|
||||||
|
10
|
||||||
|
11
|
||||||
|
12
|
||||||
|
13
|
||||||
|
|
||||||
```powershell
|
**编写认证文件：auth.json**
|
||||||
mkdir my-codex-project
|
|
||||||
cd my-codex-project
|
|
||||||
codex
|
|
||||||
```
|
|
||||||
|
|
||||||
### 🍏 macOS 平台
|
json
|
||||||
|
|
||||||
|
|
||||||
|
{
|
||||||
|
"OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"
|
||||||
|
}
|
||||||
|
|
||||||
#### 部署 CodeX 工具
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
|
||||||
```bash
|
#### 第三步：初始化工作空间
|
||||||
npm install -g @openai/codex@latest
|
|
||||||
codex --version
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 集成 API 服务
|
powershell
|
||||||
|
|
||||||
|
|
||||||
|
mkdir my-codex-project
|
||||||
|
cd my-codex-project
|
||||||
|
codex
|
||||||
|
|
||||||
**构建配置目录**：
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
|
||||||
```bash
|
### 🍏 macOS 平台
|
||||||
mkdir -p ~/.codex
|
|
||||||
cd ~/.codex
|
|
||||||
```
|
|
||||||
|
|
||||||
**编写 `config.toml` 配置**：
|
#### 部署 CodeX 工具
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
cat > config.toml << 'EOF'
|
|
||||||
model_provider = "oneinai"
|
|
||||||
model = "gpt-5.4"
|
npm install -g @openai/codex@latest
|
||||||
model_reasoning_effort = "xhigh"
|
codex --version
|
||||||
disable_response_storage = true
|
|
||||||
approval_policy = "on-request"
|
|
||||||
sandbox_mode = "danger-full-access"
|
|
||||||
model_supports_reasoning_summaries = true
|
|
||||||
|
|
||||||
[model_providers.oneinai]
|
1
|
||||||
name = "oneinai"
|
2
|
||||||
base_url = "https://api.oneinai.com/v1"
|
|
||||||
wire_api = "responses"
|
|
||||||
requires_openai_auth = true
|
|
||||||
EOF
|
|
||||||
```
|
|
||||||
|
|
||||||
**编写 `auth.json` 认证配置**：
|
#### 集成 API 服务
|
||||||
|
|
||||||
```bash
|
**构建配置目录** ：
|
||||||
cat > auth.json << 'EOF'
|
|
||||||
{
|
|
||||||
"OPENAI_API_KEY": "此处粘贴你的 CodeX 专用令牌"
|
|
||||||
}
|
|
||||||
EOF
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 初始化工作空间
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
mkdir -p ~/.codex
|
||||||
|
cd ~/.codex
|
||||||
|
|
||||||
```bash
|
1
|
||||||
mkdir my-codex-project
|
2
|
||||||
cd my-codex-project
|
|
||||||
codex
|
|
||||||
```
|
|
||||||
|
|
||||||
### 🐧 Linux 平台
|
**编写 config.toml 配置** ：
|
||||||
|
|
||||||
#### 部署 CodeX 工具
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
cat > config.toml << 'EOF'
|
||||||
|
model_provider = "IkunCoding"
|
||||||
|
model = "gpt-5.4"
|
||||||
|
model_reasoning_effort = "xhigh"
|
||||||
|
disable_response_storage = true
|
||||||
|
approval_policy = "on-request"
|
||||||
|
sandbox_mode = "danger-full-access"
|
||||||
|
model_supports_reasoning_summaries = true
|
||||||
|
|
||||||
|
[model_providers.IkunCoding]
|
||||||
|
name = "ikun"
|
||||||
|
base_url = "https://api.oneinai.com/v1"
|
||||||
|
wire_api = "responses"
|
||||||
|
requires_openai_auth = true
|
||||||
|
EOF
|
||||||
|
|
||||||
```bash
|
1
|
||||||
sudo npm install -g @openai/codex@latest
|
2
|
||||||
codex --version
|
3
|
||||||
```
|
4
|
||||||
|
5
|
||||||
|
6
|
||||||
|
7
|
||||||
|
8
|
||||||
|
9
|
||||||
|
10
|
||||||
|
11
|
||||||
|
12
|
||||||
|
13
|
||||||
|
14
|
||||||
|
15
|
||||||
|
|
||||||
#### 集成 API 服务
|
**编写 auth.json 认证配置** ：
|
||||||
|
|
||||||
**构建配置目录**：
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
cat > auth.json << 'EOF'
|
||||||
|
{
|
||||||
|
"OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"
|
||||||
|
}
|
||||||
|
EOF
|
||||||
|
|
||||||
```bash
|
1
|
||||||
mkdir -p ~/.codex
|
2
|
||||||
cd ~/.codex
|
3
|
||||||
```
|
4
|
||||||
|
5
|
||||||
|
|
||||||
**编写 `config.toml` 配置**：
|
#### 初始化工作空间
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
cat > config.toml << 'EOF'
|
|
||||||
model_provider = "oneinai"
|
|
||||||
model = "gpt-5.4"
|
mkdir my-codex-project
|
||||||
model_reasoning_effort = "xhigh"
|
cd my-codex-project
|
||||||
disable_response_storage = true
|
codex
|
||||||
approval_policy = "on-request"
|
|
||||||
sandbox_mode = "danger-full-access"
|
|
||||||
model_supports_reasoning_summaries = true
|
|
||||||
|
|
||||||
[model_providers.oneinai]
|
1
|
||||||
name = "oneinai"
|
2
|
||||||
base_url = "https://api.oneinai.com/v1"
|
3
|
||||||
wire_api = "responses"
|
|
||||||
requires_openai_auth = true
|
|
||||||
EOF
|
|
||||||
```
|
|
||||||
|
|
||||||
**编写 `auth.json` 认证配置**：
|
### 🐧 Linux 平台
|
||||||
|
|
||||||
```bash
|
#### 部署 CodeX 工具
|
||||||
cat > auth.json << 'EOF'
|
|
||||||
{
|
|
||||||
"OPENAI_API_KEY": "此处粘贴你的 CodeX 专用令牌"
|
|
||||||
}
|
|
||||||
EOF
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 初始化工作空间
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
sudo npm install -g @openai/codex@latest
|
||||||
|
codex --version
|
||||||
|
|
||||||
```bash
|
1
|
||||||
mkdir my-codex-project
|
2
|
||||||
cd my-codex-project
|
|
||||||
codex
|
|
||||||
```
|
|
||||||
|
|
||||||
## ❓ 常见问题
|
#### 集成 API 服务
|
||||||
|
|
||||||
### CodeX 和 Claude Code 的令牌不通用？
|
**构建配置目录** ：
|
||||||
|
|
||||||
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
mkdir -p ~/.codex
|
||||||
|
cd ~/.codex
|
||||||
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
|
||||||
|
**编写 config.toml 配置** ：
|
||||||
|
|
||||||
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
cat > config.toml << 'EOF'
|
||||||
|
model_provider = "IkunCoding"
|
||||||
|
model = "gpt-5.4"
|
||||||
|
model_reasoning_effort = "xhigh"
|
||||||
|
disable_response_storage = true
|
||||||
|
approval_policy = "on-request"
|
||||||
|
sandbox_mode = "danger-full-access"
|
||||||
|
model_supports_reasoning_summaries = true
|
||||||
|
|
||||||
|
[model_providers.IkunCoding]
|
||||||
|
name = "ikun"
|
||||||
|
base_url = "https://api.oneinai.com/v1"
|
||||||
|
wire_api = "responses"
|
||||||
|
requires_openai_auth = true
|
||||||
|
EOF
|
||||||
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
5
|
||||||
|
6
|
||||||
|
7
|
||||||
|
8
|
||||||
|
9
|
||||||
|
10
|
||||||
|
11
|
||||||
|
12
|
||||||
|
13
|
||||||
|
14
|
||||||
|
15
|
||||||
|
|
||||||
|
**编写 auth.json 认证配置** ：
|
||||||
|
|
||||||
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
cat > auth.json << 'EOF'
|
||||||
|
{
|
||||||
|
"OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"
|
||||||
|
}
|
||||||
|
EOF
|
||||||
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
5
|
||||||
|
|
||||||
|
#### 初始化工作空间
|
||||||
|
|
||||||
|
bash
|
||||||
|
|
||||||
|
|
||||||
|
mkdir my-codex-project
|
||||||
|
cd my-codex-project
|
||||||
|
codex
|
||||||
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
|
||||||
|
## 常见问题
|
||||||
|
|
||||||
|
### CodeX 和 Claude Code 的令牌不通用？
|
||||||
|
|
||||||
是的，两者使用不同的令牌组：
|
是的，两者使用不同的令牌组：
|
||||||
|
|
||||||
- Claude Code：使用 Claude Code 令牌组
|
* Claude Code: 使用 Claude Code 令牌组
|
||||||
- CodeX：使用 `codex` 令牌组
|
* CodeX: 使用 "codex" 令牌组
|
||||||
|
|
||||||
请在 oneinai 平台创建对应的专用令牌。
|
请在 IkunCode 平台创建对应的专用令牌。
|
||||||
|
|
||||||
### 配置文件放在哪里？
|
### 配置文件放在哪里？
|
||||||
|
|
||||||
- Windows：`%USERPROFILE%\.codex\`
|
* Windows: `%USERPROFILE%\\.codex\\`
|
||||||
- macOS / Linux：`~/.codex/`
|
* macOS/Linux: `~/.codex/`
|
||||||
|
|
||||||
### 更多问题
|
### 更多问题
|
||||||
|
|
||||||
请查看 [FAQ](/support/faq) 或联系[售后支持](/support/after-sales)。
|
请查看 [FAQ](</support/faq>) 或联系[售后支持](</support/after-sales>)。
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user