安装并配对 Tokios 连接器

Tokios 连接器是一款轻量级控制台应用，运行在模型所在机器上。它通过单个 WebSocket 连接拨入 Tokios，并将请求转发至本地模型——无需开放入站端口、无需公网 IP、无需更改防火墙规则。您可以在控制台的 Setup wizard 中使用一次性配对码完成安装和配对。基本流程无需手动编辑配置文件——在您批准设备后，连接器通过隧道安全地接收其令牌。

1. 获取配对码

在控制台的 Setup 标签页中，点击 Start pairing（步骤 1）。Tokios 会显示一个类似 TKS-XXXX-XXXX 的配对码，有效期约 15 分钟。请保持该标签页打开。

2. 安装并运行连接器

在模型所在机器上，运行控制台为您的操作系统显示的一行命令。

Windows
macOS
Linux

Windows 10 和 11（x64）。在 PowerShell 中执行：

irm https://tokios.com/downloads/install/windows | iex; tokios-install -Code 'TKS-XXXX-XXXX'

已经安装了 tokios-connector？跳过安装程序，直接传入配对码：

tokios-connector TKS-XXXX-XXXX

3. 批准设备

连接器拨出后会出现在控制台中。在 Setup 标签页（或 Connectors 标签页）中，approve 该设备。随后 Tokios 通过隧道传递连接器的令牌——令牌不会显示在屏幕上，也无需粘贴到文件中。

连接器仅发起出站连接，从不监听端口，因此防火墙无需配置任何入站规则。

连接成功后，注册您的模型并创建 API 密钥。

进阶：使用配置文件公开多个模型

要通过一个连接器提供多个模型服务，请使用定义各上游模型的 JSON 配置运行连接器，而非逐一配对单个模型。请参阅 Connector Config。

安装程序对机器的更改

安装目录。 连接器二进制文件及其 tokios-connector.json 共同存放在 ~/.tokios/connector（macOS 和 Linux）或 %LOCALAPPDATA%\Tokios\connector（Windows）中。传入 --dir / -InstallDir 可选择其他文件夹。
PATH。 在 macOS 和 Linux 上，安装程序将二进制文件符号链接到 ~/.local/bin，如果该目录不在您的 PATH 中，则追加 1 行标记为 # tokios-connector PATH 的内容到 shell 配置文件（.zshrc、.bashrc 或 .profile）。该行不会被重复添加，安装程序会打印其操作内容，且卸载时该行保留不动，因为其他工具可能也使用同一目录。如需撤销，请手动删除该行。在 Windows 上，安装程序将默认安装文件夹添加到用户 Path；tokios-install -Uninstall 会将其移除。传入 --no-path / -NoPath 可跳过以上所有操作。
无其他更改。 不安装系统服务，不需要 sudo，不修改防火墙规则。

在启动时运行连接器

安装程序在前台启动连接器，或使用 --detach / -Detach 在后台启动。两种方式均不会在重启后自动存活。要在重启后保持模型可达，请在平台的服务管理器下运行连接器。每个安装目录允许 1 个运行实例，因此请先停止已分离的进程：

kill $(cat ~/.tokios/connector/tokios-connector.pid)

Linux (systemd user service)
macOS (launchd)
Windows (Task Scheduler)

~/.config/systemd/user/tokios-connector.service

[Unit]
Description=Tokios connector
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=%h/.tokios/connector/tokios-connector --config %h/.tokios/connector/tokios-connector.json
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

systemctl --user daemon-reload
systemctl --user enable --now tokios-connector
loginctl enable-linger "$USER"   # start at boot even when you are not logged in
journalctl --user -u tokios-connector -f

~/Library/LaunchAgents/com.tokios.connector.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
  <key>Label</key><string>com.tokios.connector</string>
  <key>ProgramArguments</key><array>
    <string>/Users/YOU/.tokios/connector/tokios-connector</string>
    <string>--config</string>
    <string>/Users/YOU/.tokios/connector/tokios-connector.json</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
  <key>StandardOutPath</key><string>/Users/YOU/.tokios/connector/tokios-connector-stdout.log</string>
  <key>StandardErrorPath</key><string>/Users/YOU/.tokios/connector/tokios-connector-stderr.log</string>
</dict></plist>

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.tokios.connector.plist

将 YOU 替换为您的用户名；launchd 不会展开 ~。

Windows 服务安装程序已列入路线图。在此之前，登录任务可保持连接器为您的账户运行：

$bin = Join-Path $env:LOCALAPPDATA 'Tokios\connector\tokios-connector.exe'
$cfg = Join-Path $env:LOCALAPPDATA 'Tokios\connector\tokios-connector.json'
schtasks /Create /TN TokiosConnector /SC ONLOGON /RL LIMITED /TR "`"$bin`" --config `"$cfg`"" /F
schtasks /Run /TN TokiosConnector

连接器将配对信息保存在 tokios-connector.json 中，因此重启后服务启动时无需新的配对码即可重新连接。

入门

模型

概念

参考

安装并配对 Tokios 连接器

1. 获取配对码

2. 安装并运行连接器

3. 批准设备

进阶：使用配置文件公开多个模型

安装程序对机器的更改

在启动时运行连接器

​1. 获取配对码

​2. 安装并运行连接器

​3. 批准设备

​进阶：使用配置文件公开多个模型

​安装程序对机器的更改

​在启动时运行连接器

1. 获取配对码

2. 安装并运行连接器

3. 批准设备

进阶：使用配置文件公开多个模型

安装程序对机器的更改

在启动时运行连接器