本文作者：猫猫摸大鱼 原文地址：[https://iloli.love/archives/1771694850291](https://iloli.love/archives/1771694850291)

## 1\. 前言

本文隶属于 OpenClaw龙虾系列教程文章，建议按顺序阅读 ，可以访问OpenClaw龙虾系列教程文章目录 [https://iloli.love/archives/1766849996690](https://iloli.love/archives/1766849996690) 查看其它文章，本文也可单独作为 sub2api 搭建教程文章阅读

本文基于sub2api v0.1.84版本，Github地址为 [https://github.com/Wei-Shaw/sub2api](https://github.com/Wei-Shaw/sub2api)

sub2api 能够将 GeminiCLI ， ClaudeCode 等转换为不仅限于原客户端使用的API，从而供给OpenCode或其它客户端使用

搭建完才发现，当前版本的sub2api不能提供标准的OpenAI API，可用于OpenCode等，但我不知道能否用于OpenClaw

该项目有更多玩法，本文只赘述其中一部分，其他请自行探索

本系列教程全程使用腾讯云轻量应用服务器，可以参加腾讯云OpenClaw专属活动进行购买，新客68/年起，老客99/年起

活动链接 [https://cloud.tencent.com/act/pro/lighthouse-moltbot](https://cloud.tencent.com/act/pro/lighthouse-moltbot) （无AFF） [http://to.iloli.love/openclaw](http://to.iloli.love/openclaw) （有AFF）

**就算不买也强烈推荐使用有 快照 功能的厂商的服务器进行搭建，并且一定要经常打快照，不要问为什么，血的教训，血的教训，血的教训**

![](https://developer.qcloudimg.com/http-save/yehe-6836203/60b08ef91e51368369d9ff558e9e52c9.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/ba2a648b4c4685a3d349162f347e789f.png)

## 2\. 搭建

首先选择一个目录，本文中使用的是`/data/sub2api`

运行 `mkdir -p /data/sub2api && touch /data/sub2api/compose.yaml` ，创建docker compose文件

![](https://developer.qcloudimg.com/http-save/yehe-6836203/ab3117329344a9fd549c4e46894d4660.png)

复制以下docker compose 配置（8080端口太常见容易被占用所以这里我改成了6780，可自行修改为其它端口）

```yaml
services:
  # ================= 主程序 =================
  sub2api:
    image: weishaw/sub2api:latest
    container_name: sub2api
    restart: unless-stopped
    ports:
      - "6780:8080"
    volumes:
      - ./data/sub2api:/app/data # 挂载到当前目录的 data/sub2api
    environment:
      - AUTO_SETUP=true # 开启自动初始化
      - TZ=Asia/Shanghai # 设置时区
      - SERVER_MODE=release # 运行模式
      - DATABASE_HOST=postgres
      - DATABASE_PORT=5432
      - DATABASE_USER=sub2api # 默认数据库用户
      - DATABASE_PASSWORD=sub2api_password # 默认数据库密码
      - DATABASE_DBNAME=sub2api # 默认数据库名
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - REDIS_PASSWORD=redis_password # 默认 Redis 密码
      - ADMIN_EMAIL=admin@sub2api.local # 默认管理员账号
      - ADMIN_PASSWORD=admin123456 # 默认管理员密码
      - JWT_SECRET= # 固定 JWT 密钥
      - TOTP_ENCRYPTION_KEY= # 固定 2FA 密钥
      - SECURITY_URL_ALLOWLIST_ENABLED=false # 禁用白名单检查
      - SECURITY_URL_ALLOWLIST_ALLOW_INSECURE_HTTP=true # 允许 HTTP URL（⚠️ 不安全）
    depends_on:
      postgres: { condition: service_healthy }
      redis: { condition: service_healthy }
    networks:
      - sub2api-network

  # ================= 数据库 (PostgreSQL) =================
  postgres:
    image: postgres:18-alpine
    container_name: sub2api-postgres
    restart: unless-stopped
    volumes:
      - ./data/postgres:/var/lib/postgresql/data # 挂载到当前目录的 data/postgres
    environment:
      - POSTGRES_USER=sub2api
      - POSTGRES_PASSWORD=sub2api_password
      - POSTGRES_DB=sub2api
      - PGDATA=/var/lib/postgresql/data 
      - TZ=Asia/Shanghai
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U sub2api -d sub2api"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - sub2api-network

  # ================= 缓存 (Redis) =================
  redis:
    image: redis:8-alpine
    container_name: sub2api-redis
    restart: unless-stopped
    volumes:
      - ./data/redis:/data # 挂载到当前目录的 data/redis
    command: ["redis-server", "--requirepass", "redis_password", "--appendonly", "yes"]
    environment:
      - REDISCLI_AUTH=redis_password
      - TZ=Asia/Shanghai
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - sub2api-network

networks:
  sub2api-network:
    driver: bridge
```

粘贴到刚刚新建的 compose.yaml 里，可选修改数据库信息，**请务必修改账号密码**

JWT密钥 和 2FA密钥 如果需要请自行生成（作用分别为）

如果使用HTTPS并且在意安全性，请删除 禁用白名单检查 和 允许HTTP URL 两项环境变量

如果只使用HTTP不使用HTTPS的话，这两个则似乎需要保留

![](https://developer.qcloudimg.com/http-save/yehe-6836203/b8805e8f76c27f0136b4f1b5a7e7186a.png)

如果在上面修改了数据库信息，别忘了这里也要同步修改；如果没有修改则忽略此处

![](https://developer.qcloudimg.com/http-save/yehe-6836203/91dd55f1c1ea8032d77294272806e7d6.png)

修改好后运行如下命令 `cd /data/sub2api && docker compose up -d` ，创建容器，如图即为成功

![](https://developer.qcloudimg.com/http-save/yehe-6836203/1d95326c340a4b1e506347b96eff9c46.png)

## 3\. 配置

访问 服务器IP:6780 （如果你修改了端口则替换为你的端口），进入主页，点击登录

![](https://developer.qcloudimg.com/http-save/yehe-6836203/519feaab9982425731ea5461eb349b4c.png)

输入你在前面配置的账号密码，登录

![](https://developer.qcloudimg.com/http-save/yehe-6836203/0406d727c9e1a3ba70d4b5feb245d40a.png)

可以看到sub2api已经给出了配置向导，可以根据向导进行配置，也可以跟着我的教程走

![](https://developer.qcloudimg.com/http-save/yehe-6836203/6019b55a0132ba561520ec4383c5f1f8.png)

点击 分组管理 ，点击创建分组（不同的平台需要创建不同分组）

![](https://developer.qcloudimg.com/http-save/yehe-6836203/3f67bd5390f1d40a2fa8da36731492e8.png)

本文以对接Codex作为教程，其它大同小异，请自行研究

输入名称，平台选择OpenAI，点击创建

![](https://developer.qcloudimg.com/http-save/yehe-6836203/841d06ceb7ada432d8b9a347c3cb46d6.png)

这里可以看见我们已经创建好的分组

![](https://developer.qcloudimg.com/http-save/yehe-6836203/61106f2baadb35c7678173bac2220f8d.png)

点击账号管理，点击添加账号

![](https://developer.qcloudimg.com/http-save/yehe-6836203/42a3a5721529a746e0251dea5207296f.png)

填写名称，平台选择OpenAI，账号类型选择OAuth

![](https://developer.qcloudimg.com/http-save/yehe-6836203/81dad655e314abad820390a668805bc1.png)

注意要下拉勾选前面创建的分组 点击下一步

![](https://developer.qcloudimg.com/http-save/yehe-6836203/19a0faafd36ac4e9a9dbc73f99130486.png)

点击生成授权链接

![](https://developer.qcloudimg.com/http-save/yehe-6836203/135ee939db2818ff17fd69593601aa19.png)

可以看到生成的授权链接，复制到浏览器打开它

![](https://developer.qcloudimg.com/http-save/yehe-6836203/6eedeba8f565b88f723aa5703eb26681.png)

接下来按照提示登录

![](https://developer.qcloudimg.com/http-save/yehe-6836203/5480fefddeed9e2296c873c9555207dc.png)

登录后显示无法访问此网站，为正常现象，将网址栏的内容全部复制

![](https://developer.qcloudimg.com/http-save/yehe-6836203/42c1530551ab018b8fae3c1613beb621.png)

粘贴到如图所示位置，点击完成授权

![](https://developer.qcloudimg.com/http-save/yehe-6836203/8dc31a4899dfbbcb81e1ee2a5a129420.png)

可以看到我们刚刚添加的账号

![](https://developer.qcloudimg.com/http-save/yehe-6836203/5cfa30c902ffac87f35174c6d2fcc0c2.png)

接下来点击 API 密钥，点击创建密钥

![](https://developer.qcloudimg.com/http-save/yehe-6836203/b37a3df1d1a57093119475d49e69205c.png)

填写名称，分组勾选我们之前创建的分组，点击创建

![](https://developer.qcloudimg.com/http-save/yehe-6836203/b4f1a796d44ab75cad80888e6b1d6274.png)

可以看到我们刚刚创建的 API 密钥

![](https://developer.qcloudimg.com/http-save/yehe-6836203/1851f66bf9d6cf5f160d846219def13b.png)

## 4\. 使用

到此已经完成，可以使用该密钥了，BaseURL 即为你的服务器IP:项目端口，点击上图中的使用密钥 可以看到相关配置，这个项目不能提供标准的OpenAI API ，似乎只能给 OpenCode 使用，这里就不过多赘述了

本文作者：猫猫摸大鱼 原文地址：https://iloli.love/archives/1771694850291

基于docker搭建sub2api图文教程

该教程详细介绍了如何基于 Docker 搭建 sub2api 项目。sub2api 能够将 GeminiCLI 和 ClaudeCode 等工具转换为可供 OpenCode 等客户端使用的 API。

腾云先锋（TDP）成员

云计算

开发工具

后端

Sub2API搭建教程：详细指导如何将GeminiCLI、ClaudeCode转换为API接口，包含Docker部署、数据库配置及API密钥生成步骤。基于v0.1.84版本，适合OpenCode等客户端使用，提供完整YAML配置示例和操作指南。

轻量应用服务器

PostgreSQL

数据库

服务器

容器

Redis

OAuth

2026新春采购季

tencentdb-catalog

4核4G3M云服务器 新用户低至38元/年！

腾讯云数据库特惠，新用户首单0.5折起


postgres

lighthouse

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

基于docker搭建sub2api图文教程-腾讯云开发者社区-腾讯云

基于docker搭建sub2api图文教程

基于docker搭建sub2api图文教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐