banner
约 1,500 字
5 分钟

部署OmniRoute免费AI网关一键反代opencode实现tokens自由

摘要

OmniRoute 是一个支持 50 多家免费模型供应商的大模型 API 服务平台,其中 OpenCode 和 mimocode 免鉴权。本文介绍如何使用 Docker Compose 部署该服务。步骤包括登录设置密码、添加免鉴权提供商 OpenCode free、创建统一 API 密钥。使用时需解析域名,在 Agent 中配置自定义模型,接口地址为 `http://域名/V1`,模型名称为 `auto`。项目功能丰富,适合需要统一接口的开发者。

前言

玩大模型 API 的朋友,应该都遇到过"供应商太多、每个都要注册、每个鉴权方式还不一样"的麻烦。要是能有一个统一的入口,把所有供应商都接进去,用一套 API 就能随意切换调用,那该多省心。

OmniRoute 就是干这个的——它是一个大模型 API 服务平台(网关),可以添加各大模型供应商,统一用一套 API 接口访问,方便各种 AI 应用调用。

它最吸引我的一点是:内置了 50 多家免费平台,其中 opencode 和 mimocode 的免费 token 还是免鉴权的,用起来非常省事——不用注册、不用填一堆 Key。本文就记录一下怎么用 Docker 部署它,并重点演示如何反代免鉴权的 opencode,让 OpenCode 这类工具直接白嫖到可用的模型端点。

项目地址:https://github.com/diegosouzapw/OmniRoute

说明:OmniRoute 功能很多,本文只讲"反代免鉴权 opencode"这条最常用的路径。如果你想要更简单的方案,可以参考我之前介绍的 FreeLLMAPI 那篇。

部署

采用 docker compose 的方式部署,最省心。

新建一个 docker-compose.yml,内容如下:

纯文本
services:
  omniroute:
    image: diegosouzapw/omniroute:latest
    container_name: omniroute
    restart: unless-stopped
    stop_grace_period: 40s
    ports:
      - "20128:20128"
    volumes:
      - omniroute-data:/app/data

volumes:
  omniroute-data:

然后在 docker-compose.yml 所在目录执行:

纯文本
docker compose up -d

等镜像拉取并启动完成即可。

Docker 部署 OmniRoute

教程

第 1 步:访问管理页面并设置密码

部署完成后,浏览器访问:

纯文本
http://服务器ip:20128

首次登录时,平台会提示你先设置一个登录密码,设置好之后用它登录后台。

首次登录设置密码

第 2 步:添加"免鉴权"提供商

登录后台后,进入添加提供商的入口。重点关注**"免鉴权提供商"(也叫"无需凭证的开放端点")这一类——它们无需注册、立即就能用**,正是我们想要的。

添加免鉴权提供商

第 3 步:选择 OpenCode free

在免鉴权列表里,找到 OpenCode free(或 mimocode free),点进去添加。点 添加账号 后,平台会自动帮你生成一个 key,不用你手动填任何凭证。

选择 OpenCode free 并自动生成 key

这就是"免鉴权"的方便之处——不用注册、不用自己去申请 Key,平台全自动生成。

第 4 步:创建统一 API 密钥

添加完账号后,进入 API 管理,创建一个统一的 API 密钥。这个 key 就是你之后给各种 AI 应用用的"统一入口凭证"。

在 API 管理创建统一 API 密钥

使用

到这一步,网关就配好了。接下来是怎么让 OpenCode 这类 agent 用上它。

  • (推荐)给服务解析一个域名:为了方便长期使用,建议给这台服务器的 OmniRoute 服务绑定一个域名,免得老记 IP 和端口。

  • 在自己的 agent 里添加模型,选择"自定义模型"

  • 接口地址填写:http://服务器ip(或域名)/v1

  • 模型名称填写:auto

这样设置后,你的 agent 就会通过 OmniRoute 这个网关,自动路由到后端接好的(免鉴权的 opencode 等)模型上。

配置 agent 接入 OmniRoute 网关

常见问题与排错

1. 访问 http://ip:20128 打不开

  • 确认容器已启动(docker compose ps)。

  • 确认服务器防火墙/安全组放行了 20128 端口。

2. agent 连不上 / 报接口错误

  • 确认接口地址写的是 /v1(注意是 v1 小写),且 ip/域名能访问。

  • 确认统一 API key 填对了。

3. 想要更多供应商

  • OmniRoute 内置 50 多家免费平台,都可以在后台添加,不止 opencode。按需加即可。

我的结论

用下来,OmniRoute 这种"统一网关"的思路确实省心——把多个供应商收拢到一个入口,以后想换模型,后台加个供应商就行,agent 那边不用动。尤其它内置那么多免鉴权的免费平台,对想白嫖模型额度、又不想逐个注册申请 Key 的朋友非常友好。

不过它功能确实比较多,面板左侧的工具栏一眼看过去还挺唬人,要完全用好需要花点时间研究。如果你只是想要一个"简单、能用"的方案,不一定非要上 OmniRoute——像前面提到的 FreeLLMAPI 这类更轻量的方案可能更适合你。

但如果你玩得比较深、想在一个地方管理多个模型供应商,那 OmniRoute 值得一试,按上面的步骤十几分钟就能跑起来。

END