Передавайте свой терминал
Termbridge запускает локальный сервер, прокладывает к нему туннель через Cloudflare и передает сеанс tmux в любой браузер.
npx termbridgeПоследний выпуск 0.3.13 MIT Node 20+, tmux, cloudflared
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"
# Then attach Termbridge to it
termbridge --session claudeНа практике
Запустите на компьютере, затем откройте терминал на другом устройстве.
С ноутбука на телефон
npx termbridge запускает локальный сервер, сеанс tmux и туннель Cloudflare, а затем выводит код QR с одноразовой ссылкой для входа.
После сканирования кода токен используется для создания сеанса cookie. Добавьте --proxy 5173, чтобы открыть сервер разработки в режиме предварительного просмотра рядом с терминалом.
npx termbridge# Start your Vite app first
cd my-app && npm run dev # runs on port 5173
# Then start Termbridge with proxy
termbridge --proxy 5173Готов к мобильным устройствам
Отсканируйте код QR и откройте терминал в браузере на телефоне.
Полноценный терминал
tmux + node-pty передают настоящий PTY в xterm.js с поддержкой цветов и TUI.
Туннель Cloudflare
Quick Tunnel открывает доступ к локальному серверу без перенаправления портов.
Вход по токену
Ссылка QR содержит одноразовый токен, действительный в течение 90 секунд. После его использования устанавливается защищенная флагами HttpOnly и Secure сессионная cookie; также выполняются проверки CSRF, а лимит составляет 5 использований в минуту. Сеансы не истекают.
Несколько сеансов
Один сервер может размещать несколько сеансов tmux с переключением в приложении.
Одна команда
Команда npx termbridge запускает сервер, туннель Cloudflare и код QR. Требуются Node 20+, tmux и cloudflared на macOS или Linux; Windows не поддерживается.
Сначала CLI
Создан как инструмент для работы прежде всего в терминале: показывает состояние TTY и вывод QR.
Передача через QR
При каждом запуске выводится код QR с одноразовой ссылкой для входа. Отсканируйте его на устройстве, которое хотите использовать.
Предпросмотр сервера разработки
Проксируйте локальное приложение Vite и просматривайте его рядом с терминалом.
Поддержка HMR
Проксирование WebSocket позволяет Hot Module Replacement в Vite продолжать работать.
Переключение представлений
Переключайтесь между терминалом и предварительным просмотром через панель «Представления» внизу.
Полный цикл разработки
Выполняйте команды в терминале и следите за обновлением приложения в реальном времени.
Почему Termbridge
Без перенаправления портов и VPN
Быстрый туннель Cloudflare без учетной записи предоставляет локальному серверу общедоступный адрес HTTPS URL. Для подключения с другого устройства достаточно браузера.
Полноэкранные программы работают
node-pty подключается к tmux и сообщает о цветном терминале 256, поэтому TUI-приложения, такие как htop и vim, работают так же, как локально.
Сеансы продолжают работать после отключения
Ctrl+C закрывает туннель и сервер, но оставляет сеансы tmux работающими. Запустите снова с параметром --session, чтобы подключиться к уже существующему сеансу.
Работает на вашем компьютере
Сервер, WebSocket и реестр терминалов работают на вашем компьютере и по умолчанию прослушивают 127.0.0.1. У Termbridge нет собственного серверного компонента.
Сравнение с
Другие способы получить доступ к терминалу с другого устройства и отличия Termbridge.
| Инструмент | Подходит для | Отличия от Termbridge |
|---|---|---|
| ttyd | Подходит дляttyd предоставляет доступ к любым командам через веб, поддерживает ввод CJK и IME, передачу файлов через ZMODEM и trzsz, изображения Sixel, SSL и базовую аутентификацию. Работает на macOS, Linux, BSD-системах, OpenWrt и Windows. | Отличия от TermbridgeTermbridge добавляет туннель, одноразовую ссылку для входа QR и панель управления на телефоне, а также сохраняет оболочку в tmux, чтобы она пережила перезапуск. Создан для macOS и Linux. |
| sshx | Подходит дляsshx позволяет поделиться терминалом с кем угодно одной командой на бесконечном холсте, где участники видят курсоры друг друга. Поддерживаются сквозное шифрование и двоичные файлы для Linux, macOS и Windows. | Отличия от TermbridgeTermbridge предназначен для доступа к собственному терминалу: при каждом запуске создается одноразовая ссылка для входа, а трафик идет через туннель Cloudflare к серверу на вашем компьютере. |
| Tailscale SSH | Подходит дляTailscale SSH берет на себя аутентификацию и авторизацию подключений SSH в вашей tailnet; трафик шифруется через WireGuard с помощью ключей узлов, а подключиться можно с любого устройства с Tailscale. | Отличия от TermbridgeДля Termbridge не нужны клиент и частная сеть на другом устройстве. Он предоставляет общедоступный адрес URL и код QR, а терминал открывается в браузере. |
Источники, отмечено
Вопросы и ответы
Краткие ответы из документации Termbridge.
В режиме по умолчанию он проходит через туннель Quick Tunnel Cloudflare по пути к серверу Termbridge на вашем компьютере. У Termbridge нет собственного серверного компонента. В изолированном режиме Daytona терминал работает в песочнице вашей учетной записи Daytona, а в прямом режиме там же работает сервер, и вы подключаетесь по ссылке предварительного просмотра Daytona.
Ссылка QR содержит одноразовый токен, действительный в течение 90 секунд. После его использования устанавливается сессионная cookie HttpOnly; для подключений терминала по WebSocket также нужен токен CSRF. Не передавайте код QR или URL людям, которым не доверяете.
Да. Установите TERMBRIDGE_SESSIONS=3, чтобы запустить три сеанса tmux, а затем переключайтесь между ними с помощью переключателя терминалов в приложении.
Официально не поддерживается. Termbridge создан для macOS и Linux. Возможно, он работает с WSL, но это не проверено.
Пока нет. Cloudflare — единственный поддерживаемый поставщик туннелей. Можно использовать именованный туннель Cloudflare со своим именем узла, отключить туннель и указать собственный общедоступный адрес URL или использовать прямой режим Daytona.
В локальном режиме соединение работает, пока запущен Termbridge, и закрывается, когда компьютер переходит в спящий режим или завершается работа Termbridge. Сеансы tmux продолжают работать: вы можете снова запустить Termbridge, отсканировать новый код QR и подключиться с параметром --session. В прямом режиме Daytona сервер работает внутри песочницы.
Установите Node 20+, tmux и cloudflared, запустите npx termbridge и отсканируйте код QR, чтобы открыть терминал в браузере на телефоне.