EnglishРусский中文

Урок 1. Namespace и командная работа#

Зачем это нужно#

Представьте: вы работаете в команде из трёх человек, и у вас один общий HAPI hub (сервер-хаб). Без специальных настроек все видят сессии друг друга — это неудобно и небезопасно. Namespace (пространство имён) решает эту проблему: каждый член команды получает свою изолированную «комнату» на одном и том же хабе.

Namespace (читается «неймспейс») — это как отдельная квартира в многоквартирном доме. Дом один (hub), но каждый жилец (разработчик) видит только свою квартиру.

Как это работает#

Хаб использует один общий токен доступа (CLI_API_TOKEN — секретный ключ для подключения). Каждый пользователь добавляет к этому токену своё имя через двоеточие — и получает изолированное пространство.

Вот что изолируется между namespace:

  • 🔒 Сессии (рабочие сеансы AI-агентов)
  • 🖥️ Машины (подключённые компьютеры)
  • 👤 Пользователи

Пошаговая настройка#

Шаг 1. Настройте хаб#

На сервере (хабе) укажите базовый токен без суффикса:

CLI_API_TOKEN="my-team-secret-token"

⚠️ Важно: токен на хабе НЕ должен содержать двоеточие. Если вы случайно добавите :что-то, хаб обрежет суффикс и выведет предупреждение.

Шаг 2. Раздайте токены команде#

Каждый участник получает токен с уникальным именем:

Участник Токен
Алиса my-team-secret-token:alice
Борис my-team-secret-token:boris
Вика my-team-secret-token:vika

Каждый прописывает свой токен в настройках HAPI:

# У Алисы на компьютере
CLI_API_TOKEN="my-team-secret-token:alice"

Шаг 3. Подключение через веб и Telegram#

При входе через веб-интерфейс или привязке Telegram используйте тот же токен с namespace:

my-team-secret-token:alice

Важные ограничения#

  1. Один компьютер — один namespace. Нельзя использовать один и тот же ID машины в разных namespace. Если нужно работать с несколькими namespace на одном компьютере — используйте отдельную папку HAPI_HOME для каждого:
# Для работы как alice
HAPI_HOME=~/.hapi-alice hapi

# Для работы как boris
HAPI_HOME=~/.hapi-boris hapi
  1. Переключение namespace. Перед сменой namespace на одной машине выполните выход:
hapi auth logout
  1. Удалённый запуск (remote spawn) тоже изолирован по namespace. Для нескольких namespace на одной машине запускайте отдельный runner (раннер — фоновый процесс для удалённых задач) для каждого.

Пример из жизни#

Команда из трёх фрилансеров арендует один VPS (виртуальный сервер). Каждый подключается со своего ноутбука:

VPS (hub) — токен: "freelance-team-2025"
  ├── Алиса (token: freelance-team-2025:alice) — видит только свои сессии
  ├── Борис (token: freelance-team-2025:boris) — видит только свои сессии
  └── Вика  (token: freelance-team-2025:vika)  — видит только свои сессии

Никто не мешает друг другу, данные изолированы, а платить нужно только за один сервер.

Итоги урока#

  • Namespace позволяет нескольким людям безопасно работать на одном хабе
  • Настройка проста: базовый токен + двоеточие + имя пользователя
  • Сессии, машины и пользователи полностью изолированы между namespace
  • Для работы с несколькими namespace на одном компьютере используйте отдельные HAPI_HOME