tokios-connector.json 設定リファレンス

Tokios コネクターは JSON 設定ファイルから設定値を読み込みます。--config を使ってファイルを指定し、起動時にはコマンドラインフラグで任意の設定を上書き可能です。コネクターは環境変数を一切参照せず、ここで定義したアップストリームモデルIDのみに通信を転送します — ゲートウェイから与えられた URL には決して接続しません。

作成したコネクターに対して Tokios コンソールから発行されるのが ConnectorId と Token です。APIキーは一度きりしか表示されないため、設定ファイルに貼り付けて安全な場所に保管してください。

Precedence:CLI flags›TOKIOS_* env vars›tokios-connector.json›defaults

設定ファイルの構造

最小限の設定では、認証情報を記載した Connector セクションとローカルアップストリームモデルIDがひとつだけ存在します。

tokios-connector.json

{
  "Connector": {
    "ConnectorId": "con_your_connector_id",
    "Token": "ct-your-connector-token",
    "Models": ["gemma4:e4b"],
    "Upstream": {
      "BaseUrl": "http://127.0.0.1:11434/v1"
    }
  }
}

そのファイルを指定してコネクターを起動します：

tokios-connector --config tokios-connector.json

`Connector` 項目の説明

string

必須

managed by pairingrestart requiredコンソール上で割り当てられたコネクターの ID（例：con_...）。これにより Tokios ゲートウェイが該当コネクターを識別します。

string

必須

managed by pairingsecret — redacted in logsコネクター作成時に発行される APIキー（例：ct-...）で、ご自身のテナントに紐付けられています。コンソール上では一度きりしか表示されません。

string

コネクターが接続する wss:// ゲートウェイエンドポイントです。通常はホストされている Tokios ゲートウェイがデフォルト値となるため、特に指定する必要はありません。（自己ホスト型デプロイの場合は自身のサーバーを指定します。例：wss://your-server/connector/connect）

integer

デフォルト:"8"

コネクターが一度に転送できる進行中リクエストの最大数です。この上限を超えるリクエストは 503 connector_busy エラーと共に拒否され、空きスロットが生まれるまで受け付けられません。

コネクターがどのようなサービスを提供するかを定義します

二つの形状のうち 一つだけ を選択してください。両方を指定するとエラーとなります。 シングルアップストリーム — 一つのローカルサーバーが一つ以上のアップストリームモデルIDを処理します

tokios-connector.json

"Connector": {
  "ConnectorId": "con_...",
  "Token": "ct-...",
  "Models": ["gemma4:e4b"],
  "Upstream": { "BaseUrl": "http://127.0.0.1:11434/v1" }
}

マルチプルアップストリーム — 異なるアップストリームモデルIDをそれぞれ別のローカルサーバーへ振り分けます

tokios-connector.json

"Connector": {
  "ConnectorId": "con_...",
  "Token": "ct-...",
  "Routes": [
    { "Model": "gemma4:e4b",    "UpstreamId": "ollama" },
    { "Model": "qwen2.5-coder", "UpstreamId": "lmstudio" }
  ],
  "Upstreams": {
    "ollama":   { "BaseUrl": "http://127.0.0.1:11434/v1" },
    "lmstudio": { "BaseUrl": "http://127.0.0.1:1234/v1" }
  }
}

The ids in Models / Routes[].Model are the model ids your local server uses — what you’d send it directly (e.g. gemma4:e4b in Ollama). You expose one under a public API name (e.g. gemma-tunnel) by registering a deployment in the console; that public name is what clients send in the "model" field, and the gateway rewrites it to the upstream id before forwarding it down the tunnel. See Model Routing.

アップストリーム設定項目

各アップストリーム — つまり単一の Upstream または Upstreams 内の各エントリ — は以下を受け付けます

string

必須

requiredモデルサーバーのベースURLで、必ず /v1 部分を含めて指定してください（例：http://127.0.0.1:11434/v1）。コネクターはここにリクエストパス（/chat/completions）を付加します。サーバー側はOpenAI互換のチャット完了APIを提供する必要があります。バックエンドもご参照ください。

string[]

任意のホスト制限設定です。空欄（デフォルト）の場合、コネクターは BaseUrl に記載されたホストをそのまま信頼します。ローカルおよびリモートアップストリームには追加設定は不要です。値を指定した場合、BaseUrl に列挙されたホストのみが許可されます。これにより、別の場所を指す BaseUrl の変更が起きても起動時にエラーとなり、トラフィックやアップストリームの ApiKey が意図せず新ホストへ送信される事態を防げます。

string[]

コネクターが転送可能なリクエストパスの一覧です。デフォルト値は ["/chat/completions"] です。

ネットワーク内の別マシン上にあるモデルへアクセスする場合、BaseUrl にそのマシンのアドレスを指定します（例：http://192.168.1.50:11434/v1）。特別な許可設定は不要です。コネクターは自身の設定ファイルに記載されたホストのみへ転送し、ゲートウェイから与えられたURLへは送信しません。古い設定ファイルには AllowLan が残っている場合もありますが、コネクターはこれを無視します。

リモートのアップストリームへの認証処理

ローカルサーバーではなくホスティングされているOpenAI互換プロバイダーへリクエストを転送する場合、BaseUrlをそのプロバイダーのエンドポイントに指定し、アップストリーム用の認証情報を入力する。

string

アップストリームリクエスト内に挿入されるキー値。

string

デフォルト:"Authorization"

キーが送信される際のヘッダー名。Anthropic形式のプロバイダー向けにはx-api-key、Azure OpenAI向けにはapi-keyを使用する。

string

デフォルト:"Bearer "

キー値の前に付加される接頭辞。生のキー形式を利用する場合は空文字列に設定する（例：x-api-key、api-key）。

object

すべてのアップストリームリクエストに付加される静的ヘッダー群。

object

アップストリームURLに追加される静的なクエリパラメータ群（例：Azure OpenAIのapi-version）。

コマンドラインフラグの一覧

フラグ名	各フラグの説明内容
`--config <path>`	設定ファイルのパス。相対パスが指定された場合は現在ディレクトリから上位ディレクトリへ順に探索し、次に実行ファイルと同じディレクトリも調査する。省略時はコネクターが`appsettings.json`を探す。存在しないファイルを指定した場合はエラーとなる。
`--version`	コネクターのバージョン情報を出力して終了する。別名として`--ver`や`-v`も使用可能。

任意の設定値は、完全なキーパスを指定することでコマンドライン上でも上書き可能です。

tokios-connector --config tokios-connector.json --Logging:LogLevel:Default=Debug

There is no --log-level flag. Set verbosity through the Logging section (below) or the --Logging:LogLevel:Default=... override shown above.

ログ記録

このコネクターは常にコンソールにログを出力します。詳細度の調整や日次ログファイルの有効化は、最上位レベルにある Logging セクションで行えます。このセクションは Connector と同階層に位置します：

tokios-connector.json

{
  "Logging": {
    "LogLevel": { "Default": "Information" },
    "Directory": "logs",
    "RetainedDays": 7
  },
  "Connector": {
    "ConnectorId": "con_...",
    "Token": "ct-...",
    "Models": ["gemma4:e4b"],
    "Upstream": { "BaseUrl": "http://127.0.0.1:11434/v1" }
  }
}

string

デフォルト:"Information"

詳細度のレベルは Trace、Debug、Information、Warning、Error から選択可能です。トラブルシューティング時には Debug に設定することでリクエストごとのルーティング情報や cid、アップストリームモデルIDの詳細も記録されます。

string

このディレクトリ内で日次ローテーションされるログファイルを有効化します（存在しなければ自動生成）。空欄（デフォルト）の場合はコンソール出力のみとなります。相対パスはコネクター実行ファイルの位置を基準に解釈されるため、ダブルクリックで起動した場合でもログの保存先が一定に保たれます。

integer

デフォルト:"14"

保持する日次ログファイルの数です。

これにより logs/tokios-connector-YYYYMMDD.log が書き込まれます。

完全な設定例

macOS
Linux
Windows

設定パス：~/Library/Application Support/tokios/tokios-connector.json

{
  "Connector": {
    "ConnectorId": "<generated-during-pairing>",
    "Token": "<generated-during-pairing>",
    "Models": ["gemma4:e4b"],
    "Upstream": {
      "BaseUrl": "http://127.0.0.1:11434/v1"
    }
  }
}

設定ファイルのパス: /etc/tokios/tokios-connector.json

{
  "Connector": {
    "ConnectorId": "<generated-during-pairing>",
    "Token": "<generated-during-pairing>",
    "Models": ["gemma4:e4b"],
    "Upstream": {
      "BaseUrl": "http://127.0.0.1:11434/v1"
    }
  }
}

設定ファイルのパス: %APPDATA%\tokios\tokios-connector.json

{
  "Connector": {
    "ConnectorId": "<generated-during-pairing>",
    "Token": "<generated-during-pairing>",
    "Models": ["gemma4:e4b"],
    "Upstream": {
      "BaseUrl": "http://127.0.0.1:11434/v1"
    }
  }
}

バックグラウンドサービスとして実行する

開発用途であればターミナルウィンドウ上で実行しても問題ありません。常時稼働させる場合はコネクターをシステムサービスとして起動しておくことで、再起動時にも自動的に再開されます。

macOS (launchd)
Linux (systemd)
Windows (サービス)

Create a plist file at ~/Library/LaunchAgents/com.tokios.connector.plist:

~/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>/usr/local/bin/tokios-connector</string>
    <string>--config</string>
    <string>/etc/tokios/tokios-connector.json</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>StandardOutPath</key>
  <string>/var/log/tokios-connector.log</string>
  <key>StandardErrorPath</key>
  <string>/var/log/tokios-connector.log</string>
</dict>
</plist>

サービスを読み込み、起動します:

launchctl load ~/Library/LaunchAgents/com.tokios.connector.plist
launchctl start com.tokios.connector

Create a unit file at /etc/systemd/system/tokios-connector.service:

/etc/systemd/system/tokios-connector.service

[Unit]
Description=Tokios Connector
After=network.target

[Service]
ExecStart=/usr/local/bin/tokios-connector --config /etc/tokios/tokios-connector.json
Restart=always
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

サービスを有効化し、起動します:

sudo systemctl daemon-reload
sudo systemctl enable tokios-connector
sudo systemctl start tokios-connector

On Windows, use NSSM (Non-Sucking Service Manager) or Task Scheduler to run the connector as a background service.NSSMの利用方法:

nssm install TokiosConnector "C:\Program Files\Tokios\tokios-connector.exe"
nssm set TokiosConnector AppParameters "--config C:\ProgramData\Tokios\tokios-connector.json"
nssm set TokiosConnector Start SERVICE_AUTO_START
nssm start TokiosConnector

タスクスケジューラーの利用方法:新規タスクを作成し、トリガーをAt startupに設定します。次にアクション先をtokios-connector.exeに指定し、引数として--config <path>を入力します。さらにRun whether user is logged on or notを有効化すればバックグラウンドで継続的に動作します。

コード	意味
E1401	無効または無効化されたコネクターのトークン
E1404	未知のアップストリームモデルを指し示すルート
E1502	Upstream unreachable — check `BaseUrl` includes `/v1`

はじめに

モデル

概念

リファレンス

tokios-connector.json 設定リファレンス

設定ファイルの構造

`Connector` 項目の説明

コネクターがどのようなサービスを提供するかを定義します

アップストリーム設定項目

リモートのアップストリームへの認証処理

コマンドラインフラグの一覧

ログ記録

完全な設定例

バックグラウンドサービスとして実行する

関連するエラー

​設定ファイルの構造

​Connector 項目の説明

​コネクターがどのようなサービスを提供するかを定義します

​アップストリーム設定項目

​リモートのアップストリームへの認証処理

​コマンドラインフラグの一覧

​ログ記録

​完全な設定例

​バックグラウンドサービスとして実行する

​関連するエラー

設定ファイルの構造

`Connector` 項目の説明

コネクターがどのようなサービスを提供するかを定義します

アップストリーム設定項目

リモートのアップストリームへの認証処理

コマンドラインフラグの一覧

ログ記録

完全な設定例

バックグラウンドサービスとして実行する

関連するエラー