tokios-connector,即可在 https://api.tokios.com 处生成一个经过身份验证的访问端点,任何被你授权的人都能调用该端点,全程无需开放入站端口、无需改动路由器设置,也无需让他人直接访问服务器本身。
家庭实验室服务器的网络可达性问题
家庭实验室 GPU 服务器通常没有显示器,被安置在壁橱或机柜中,负责为局域网内的用户运行 Ollama、vLLM 或 llama.cpp。若想让局域网外的用户也能使用这些模型,则会遇到诸多阻碍:- 缺乏可绑定的公网 IP。 若你的 ISP 使用了运营商级 NAT 技术,那么根本不存在可供端口转发规则使用的唯一公网地址——具体原因可参阅 如何在 CGNAT 环境下提供本地大语言模型服务,该问题属于路由器层面的设置,普通用户无法自行解决。
- 即便具备条件也不愿直接公开服务。 若将运行环境绑定至
0.0.0.0并开放端口,该 GPU 服务器就会变成一个完全无身份验证的公开服务,任何知晓该端口的人都能向其发送请求。 - 共享访问权限意味着共享全部资源。 把 Tailscale 节点或开放端口的权限交给团队成员,就等于赋予他们与你相同的访问权限——包括其设备上的所有程序,系统并未提供针对个人的访问令牌,也无法单独限制某位用户的访问权限而不影响其他人。
在服务器上完成配置
1
在服务器上启动所需的运行环境
按照常规方式启动您的模型服务器,例如:或者让服务器继续监听默认的本地回环地址。在添加连接器之前,请先确认它能够响应自身提供的兼容 OpenAI 协议的
/v1 API。2
获取授权令牌并完成连接器配对
在 dashboard 控制台中,打开 Setup 选项卡并选择 Start pairing,即可获得一个一次性使用的授权令牌,其格式为 若您已安装 回到控制台 approve 该设备:在 Setup 或 Connectors 选项卡中操作。连接器的令牌(
TKS-XXXX-XXXX(有效期约为 15 分钟)。随后在服务器端执行相应命令即可。Linux
tokios-connector,则直接输入该授权令牌即可:ct-tok-…)在批准后会通过隧道下发——您永远不会在屏幕上看到它,也无需将其粘贴到任何文件中。3
将连接器指向您所需的上游模型服务
该连接器所指向的上游服务即指服务器上兼容 OpenAI 协议的运行时 API,而非对外公开的端口。各服务默认端口如下:Ollama 为
11434,llama.cpp 为 8080,vLLM 为 8000,LM Studio 为 1234,这些端口后均需添加 /v1。对于 Ollama,请指向其兼容 OpenAI 协议的 /v1 API,而非原生的 /api 接口。由于连接器仅向外发起连接,因此无需配置任何入站防火墙规则。4
为每个模型分别创建对应的部署配置
在 Models 选项卡中,将各个上游模型 ID(例如
llama3.1)映射为团队实际使用的公开部署名称,如 homelab-llama。客户端在发送请求时只需在 model 字段中填入此部署名称,而无需提供上游模型 ID。5
为每位团队成员分别生成专属的 API 密钥
在 Keys 选项卡中,针对每位团队成员或应用程序点击 Create key。将每个令牌的适用范围限定为特定的部署名称模式(以逗号分隔的通配符列表,
* 则表示全部),这样就能确保每位成员仅能访问您指定的模型。这些令牌属于 sk-tok-… 类型的承载令牌,仅在创建时显示一次,因此请务必在离开该页面前将其复制保存。同时提供多个模型的服务
如果您的设备运行多个模型,或同时在 Ollama、llama.cpp 和 vLLM 之间分流流量,请使用连接器配置文件,而不是单上游配对流程。在tokios-connector.json 中定义 Routes 和 Upstreams(位于 Connector 部分下)——每个后端对应一个 Upstream,各自带有自己的 BaseUrl(包含 /v1)——并通过 --config 传入该文件。有关如何在同一端点后面注册和切换生成的部署,请参阅模型路由。
随时随地调用该服务
为何整个团队仅需一个统一端点
- 服务器端绝不会开放任何入站端口。该连接器仅执行出站连接操作,因此团队成员无需配置 VPN 对等节点、SSH 隧道或指定
0.0.0.0端口即可访问服务器;即便处于 CGNAT 网络环境下此规则依然适用。 - 可单独吊销特定成员的令牌而不影响他人。由于每位用户均持有独立的
sk-tok-…令牌,在 Keys 页面中禁用或删除某成员的令牌后,该成员即刻失去访问权限,其余成员的令牌仍可正常使用。 - 更换模型时无需修改客户端配置。只需将某个部署名称关联至其他上游模型或后端服务,所有原本指向
homelab-llama的客户端程序与脚本均可继续正常运行。
后续操作指引
快速入门指南
本教程将指导您从零开始完成连接器配置、部署流程及 API 密钥生成全过程。
位于 CGNAT 背后的大语言模型
为何在家庭宽带环境下端口转发无法生效,以及该连接器是如何规避这一限制的。
连接器配置参考说明
借助
tokios-connector.json 即可在一台服务器上同时运行多个模型。模型路由机制
只需一个端点即可注册并切换多个不同的部署实例。