Скачать, установить и подключить роутинг-клиент

Когда нужен этот сценарий

Вы подключаете собственный сервер моделей как worker IAM.Router. Клиент — консольная программа iam-router-client: она получает задания от task-engine и вызывает настроенный сервер моделей. Архив содержит исполняемый файл, client.env.example, README.txt и VERSION.txt. Сервер моделей и веса устанавливаются отдельно.

Для отправки обычных запросов из приложения через OpenAI-совместимый API используйте ключ для приложения. Установка worker для этого не требуется.

Что подготовить

Доступ к разделу Клиенты и право создавать ключи для нужного Tenant ID. Если действие недоступно, попросите администратора выдать доступ или создать ключ.
Адрес task-engine в формате HOST:PORT, выданный оператором вашей установки, и доступ к нему из доверенной сети или VPN. https://app.iamrouter.ru/ и https://api.iamrouter.ru/v1 не являются gRPC-адресами worker. Значение localhost:9091 из примера подходит только при локальном task-engine.
Работающий сервер моделей. В примерах ниже используется уже установленный Ollama на http://127.0.0.1:11434; проверьте доступные модели командой ollama list.

В сборке 20261014-r1 соединение task-engine по gRPC не включает TLS. Оператор должен обеспечить доверенный канал; не выставляйте этот порт напрямую в интернет. Эти архивы не являются самостоятельным клиентом DLP или приложением с графическим интерфейсом. Сборка macOS не notarized, а Windows не имеет Authenticode-подписи: SHA256 проверяет целостность, но не заменяет подпись издателя. Если система или корпоративная политика запрещает запуск, обратитесь к администратору за согласованной поставкой.

Что нажимать на странице «Клиенты»

Откройте IAM.Router → Клиенты, войдите и выберите нужный тенант.
В блоке Скачать роутинг-клиент выберите ОС и архитектуру из таблицы ниже. Скачивание доступно независимо от наличия подключённых клиентов.
Нажмите SHA256, чтобы скачать SHA256SUMS. Ссылка Инструкция подключения открывает краткую инструкцию из той же версии сборки.
Нажмите Создать ключ. Заполните Tenant ID, задайте понятную Метку, при необходимости Срок действия; оставьте Строгие правила Secure/Router, если подключение должно соблюдать корпоративную политику.
Нажмите Создать и сохраните выданное значение в защищённом месте. Не публикуйте его на скриншотах, в переписке или в репозитории. После закрытия окна полного значения может не быть в списке.

**Страница «Клиенты»: скачивание сборок на staging; данные аккаунта и клиентов вне кадра**
2026-10-15 · Реальное приложение app.stage.iamrouter.ru, сборка 20261014-client-downloads-r1. Только публичные элементы скачивания; исходные пиксели не изменены.

Скриншот снят с реального staging приложения. Пользовательские данные и список worker не входят в кадр; кнопки соответствуют выпущенной сборке. Выделения — отдельные слои документации, исходные пиксели не изменены.

ОС и компьютер	Кнопка	Архив сборки 20261014-r1
macOS, Apple Silicon	Apple Silicon · ARM64	macOS ARM64
macOS, Intel	Intel · x64	macOS x64
Linux, x86_64	x64	Linux x64
Linux, aarch64 / ARM64	ARM64	Linux ARM64
Windows, x64	x64	Windows x64

Узнать архитектуру macOS/Linux можно командой uname -m; на Windows — Параметры → Система → О системе → Тип системы. Для Apple Silicon выбирайте ARM64, даже если отдельный терминал работает через Rosetta. Пакет Windows ARM64 в этой версии не опубликован.

Установка на macOS

Сохраните архив и SHA256SUMS в Загрузки. В Terminal:

cd ~/Downloads
shasum -a 256 iam-router-client-macos-arm64.tar.gz

Сравните полученный хеш со строкой с тем же именем файла в SHA256SUMS. При несовпадении не запускайте файл и скачайте его заново. Для Intel замените arm64 на x64 во всех командах этого подраздела.

tar -xzf iam-router-client-macos-arm64.tar.gz
cd iam-router-client-macos-arm64
cp client.env.example client.env
chmod 600 client.env

Отредактируйте client.env по примеру ниже, затем запустите клиент командой из раздела Настроить и запустить на macOS/Linux.

Установка на Linux

Сохраните файлы в каталог пользователя. Для x64:

cd ~/Downloads
sha256sum iam-router-client-linux-x64.tar.gz
tar -xzf iam-router-client-linux-x64.tar.gz
cd iam-router-client-linux-x64
cp client.env.example client.env
chmod 600 client.env

До распаковки и запуска сравните хеш архива с SHA256SUMS. Для ARM64 замените x64 на arm64. Права администратора для распаковки и foreground-запуска не нужны. Если файл потерял разрешение на исполнение, после проверки целостности выполните chmod u+x iam-router-client.

Настроить и запустить на macOS/Linux

Откройте client.env в редакторе. Замените два учебных значения на свой ключ и адрес от оператора; task-engine.example.invalid — заведомо нерабочий пример:

AUTH_TOKEN='REPLACE_WITH_YOUR_KEY'
TASK_ENGINE_GRPC_ADDR=task-engine.example.invalid:9091
TASK_ENGINE_URL=
CLIENT_NAME=workstation-router
CLIENT_TAGS=iamrouter,local
PARALLEL_WORKERS=1
OLLAMA_ENABLED=true
OLLAMA_URL=http://127.0.0.1:11434
BRAINLM_ENABLED=false
VLLM_ENABLED=false
AVAILABLE_MODELS=

При пустом AVAILABLE_MODELS клиент получает список моделей из Ollama. Не указывайте несуществующую модель: объявленный список должен соответствовать реально работающему серверу. Пустой TASK_ENGINE_URL в этом примере исключает случайное использование локального HTTP-адреса; оператор может выдать отдельную HTTP-конфигурацию.

Из каталога распакованного клиента загрузите переменные и запустите процесс:

set -a
. ./client.env
set +a
./iam-router-client

Файл client.env сам по себе автоматически не загружается. Не закрывайте терминал во время работы; Ctrl+C завершает клиент. Для постоянной службы используйте согласованную с оператором конфигурацию supervisor/systemd/launchd, сохраняя ключ вне командной строки и журнала.

Установка и запуск на Windows

В PowerShell из каталога скачивания проверьте хеш и сравните его с SHA256SUMS:

Get-FileHash .\iam-router-client-windows-x64.zip -Algorithm SHA256
Expand-Archive -Path .\iam-router-client-windows-x64.zip -DestinationPath .\router-client
Set-Location .\router-client\iam-router-client-windows-x64

Раскрытый архив содержит iam-router-client.exe. В том же окне задайте настройки; значения ключа и task-engine — учебные placeholders, их нужно заменить:

$env:AUTH_TOKEN = "REPLACE_WITH_YOUR_KEY"
$env:TASK_ENGINE_GRPC_ADDR = "task-engine.example.invalid:9091"
$env:TASK_ENGINE_URL = ""
$env:CLIENT_NAME = "windows-router"
$env:CLIENT_TAGS = "iamrouter,local"
$env:PARALLEL_WORKERS = "1"
$env:OLLAMA_ENABLED = "true"
$env:OLLAMA_URL = "http://127.0.0.1:11434"
$env:BRAINLM_ENABLED = "false"
$env:VLLM_ENABLED = "false"
$env:AVAILABLE_MODELS = ""
.\iam-router-client.exe

Эти переменные действуют в текущем процессе PowerShell. Ctrl+C останавливает worker. Не сохраняйте секрет в общедоступном .ps1; используйте принятый в организации способ работы с секретами. Нативный запуск Windows не входит в подтверждённую квалификацию этой сборки: опубликованный x64 архив и его SHA256 проверены, а полный сценарий на Windows должен подтвердить оператор установки.

Как проверить подключение

Оставьте процесс запущенным, вернитесь в Клиенты и нажмите Обновить.
Найдите заданное CLIENT_NAME. Проверьте статус онлайн, Активен, число Потоков и свежий Последний heartbeat.
Нажмите кнопку Модели клиента с иконкой кубов на карточке. Проверьте, что объявлены нужные модели и что они действительно доступны локальному серверу.
Попросите оператора направить безопасное учебное задание на эту модель/worker. Найдите запись в История запросов → Задачи клиентов и сопоставьте время и идентификатор. Обычный запрос Router может обслужить другой провайдер: присутствие карточки или API-ключа не доказывает выполнение конкретным worker.

**Сборки macOS, Linux и Windows на мобильном экране staging**
2026-10-15 · Реальное приложение app.stage.iamrouter.ru, сборка 20261014-client-downloads-r1. Только публичные элементы скачивания; исходные пиксели не изменены.

Если не получилось

Симптом	Что проверить
`AUTH_TOKEN environment variable is required`	На macOS/Linux загрузите `client.env` командами `set -a` / `. ./client.env` / `set +a`; на Windows задайте `$env:AUTH_TOKEN` в том же окне.
Unauthorized / 401	Tenant ID, срок действия, отзыв и разрешение ключа на worker; оператор должен подтвердить доступ task-engine. Вход через IAM.Identity не заменяет `AUTH_TOKEN`.
Connection refused / timeout / Unavailable	Адрес `HOST:PORT`, VPN, firewall и доступность task-engine. Адрес консоли HTTPS и локальное значение по умолчанию не подходят для удалённого worker.
Карточка есть, но офлайн	Клиент продолжает работать, получает heartbeat и имеет сеть. Перезапуск терминала требует повторной загрузки переменных.
Онлайн, но нет модели / задания не выполняются	`OLLAMA_URL`, `ollama list`, настройки провайдера, разрешённая маршрутизация и точное имя модели.
Неверная архитектура / запрет запуска ОС	Выберите правильную сборку. Не обходите корпоративную политику: согласуйте подписанную поставку с администратором.

При смене ключа обновите защищённую конфигурацию и перезапустите worker. При выводе из эксплуатации остановите процесс и отдельно отзовите ключ в Ключи доступа: удаление карточки или выключение Активен не означает отзыв секрета.

Раздел «Клиенты» · Создать API-ключ · Проверить маршрут