Архітектура

Загальний потік

За замовчуванням (локальний tmux + тунель):

Код

Browser (phone)
  |
  | HTTPS
  v
Cloudflare Quick Tunnel
  |
  | HTTP/WS
  v
Local Termbridge server
  |
  | PTY
  v
Tmux session

Прямий режим пісочниці (Daytona, без тунелю):

Код

Browser (phone)
  |
  | HTTPS
  v
Daytona preview link
  |
  | HTTP/WS
  v
Termbridge server (sandbox)
  |
  | PTY
  v
Tmux session (sandbox)

Коли задано --no-tunnel, Termbridge пропускає Cloudflare і використовує наданий вами публічний URL.

Запускає сервер HTTP, який обслуговує ресурси UI.
Запускає сервер WebSocket для вводу-виводу термінала.
Створює один або кілька сеансів tmux (або псевдотерміналів Daytona).
Видає одноразові токени для отримання доступу.
Запускає тунель і стежить за ним, якщо його ввімкнено (нині Cloudflare).
У прямому режимі пісочниці запускає Termbridge усередині пісочниці та очікує на посилання для доступу URL.

Бекенд tmux: використовує node-pty для підключення до tmux і передавання натискань клавіш та виводу.
Бекенд Daytona: використовує псевдотермінали Daytona у пісочниці.
Встановлює TERM=xterm-256color і COLORTERM=truecolor для повної підтримки кольорів.
Для tmux вимикає рядок стану tmux, щоб не захаращувати UI.

Одноразовий токен виводиться як URL і кодується у QR коді.
GET /__tb/s/:token отримує токен і встановлює сеансовий cookie.
Для з’єднань WebSocket потрібні дійсний сеансовий cookie та CSRF-токен.
CSRF-токен отримується через GET /__tb/api/csrf і передається як параметр запиту WebSocket.

Коли передано --proxy <port>:

Захист від CSRF: для оновлення WebSocket потрібен CSRF-токен, що запобігає перехопленню між сайтами.
Обмеження розміру вводу: тіло HTTP до 64KB, повідомлення WebSocket до 1MB, введення в термінал до 64KB на повідомлення.
Обмеження частоти запитів: ліміти для отримання токена та з’єднань WebSocket на IP.

Усі маршрути розміщуються за префіксом /__tb/, щоб уникнути конфліктів із проксійованими застосунками:

GET /__tb/healthz — перевірка працездатності
GET /__tb/s/:token — отримання токена → cookie → перенаправлення
GET /__tb/api/terminals — список терміналів
GET /__tb/api/csrf — отримання CSRF-токена для WebSocket
GET /__tb/api/config — отримання конфігурації (proxyPort, devProxyUrl)
POST /__tb/api/terminals — створення нового сеансу tmux
GET /__tb/app/* — резервний маршрут SPA
WS /__tb/ws/terminal/:terminalId?csrf=<token> — потокове передавання вводу-виводу термінала

Коли режим проксі ввімкнено:

GET / — перенаправляє до проксійованого застосунку (або /__tb/app, якщо вимкнено)
* /* — проксіюється до цільового застосунку

Клієнт → сервер:

JSON

{ "type": "input", "data": "ls -la" }
{ "type": "resize", "cols": 120, "rows": 32 }
{ "type": "control", "key": "ctrl_c" }

Сервер → клієнт:

JSON

{ "type": "output", "data": "..." }
{ "type": "status", "state": "connected" }