detachbox
Меню

Функции

Браузерный терминалРежим «Терминалы»УведомленияТелефон и голосТабло лимитовРотацияАгентыDockerПревью и файлыСнимкиVaultSSH

Сценарии

Ночные рефакторингиПараллельные агентыКонвейер PRАгентства и фрилансерыДолгие задачиАгенты с телефонаЛимиты командыСтуденты и инди-разработчикиDocker-сервисы
ДокументацияБезопасностьEnterpriseТарифыВойти
Запустить мой бокс
СтраницыАдреса превью и файлы по ссылке

Адреса превью и файлы по ссылке

Каждый сервер, который бокс запускает на 0.0.0.0, получает свой HTTPS-адрес: https://<port>-<box>.detachbox.dev. Сначала ссылки доступны только вам, а когда хотите поделиться, вы делаете порт публичным. У файлов на боксе есть второй адрес и ссылки, которые работают без входа.

Превью бокса shipyard: порты 3000, 5173 и 8080 открыты по своим HTTPS-адресам на detachbox.dev, порт 3000 открыт наружу, остальные доступны только владельцу.

Откройте dev-сервер в браузере

  1. Запустите сервер на 0.0.0.0 на любом порту от 1024 до 65535.
  2. Откройте https://<port>-<box>.detachbox.dev. Dev-сервер на порту 3000 бокса my-box открывается по адресу https://3000-my-box.detachbox.dev.

Частые команды, которые слушают 0.0.0.0:

npm run dev -- --host 0.0.0.0
vite --host 0.0.0.0
next dev -H 0.0.0.0
python3 -m http.server 3000
rails s -b 0.0.0.0
uvicorn app:app --host 0.0.0.0

HTTPS, websockets, горячая перезагрузка и server-sent events проходят через превью. Приложение видит каждый запрос как пришедший с localhost:<port>. Vite allowedHosts, Rails config.hosts, Django ALLOWED_HOSTS и dev-режим Next.js менять не нужно. Тело запроса — до 100 MB.

Агенты всё это знают. Общий AGENTS.md сообщает им адрес превью и правило 0.0.0.0, поэтому, когда сервер поднят, они дают вам ссылку. Страница, которую агент открывает на localhost:<port>, приходит в ваш браузер как адрес превью.

Что отдаёт бокс

Откройте бокс и выберите Превью. Там перечислены все порты, которые слушают, со ссылкой, кнопкой копирования и QR-кодом. Порты проверяются каждые 10 секунд.

Для сервера на localhost или 127.0.0.1 видно предупреждение: ссылка до него не достанет. Перезапустите его на 0.0.0.0.

Ссылка, которая ничего не нашла, показывает страницу detachbox вместо ошибки, например «В my-box никто не слушает порт 3000». Остановленный бокс тоже сообщает о себе.

Кто может открыть превью

Сначала ссылки приватные. Открыть их можете только вы, войдя в кабинет.

  • Первое открытие проходит через my.detachbox.com, чтобы убедиться, что это вы. После этого превью остаётся открытым в этом браузере 12 часов.
  • У каждого порта и каждого бокса свой пропуск. Открытие одного порта никогда не открывает другой.
  • Чтобы открыть приватное превью на телефоне, отсканируйте его QR-код. Телефон сначала войдёт в detachbox, затем откроет порт.

Поделитесь превью с клиентом

  1. На вкладке Превью найдите порт.
  2. В блоке Кто может открыть порт 3000 выберите Публичный.
  3. Прочитайте предупреждение в окне Сделать порт 3000 публичным? и нажмите Сделать публичным.
  4. Скопируйте ссылку и отправьте её.

Теперь любой со ссылкой видит, что отдаёт порт, без входа. Изменение вступает в силу в течение 5 секунд. Поисковикам запрещено индексировать публичные страницы, но ссылка расходится: чаты, скриншоты, история браузера.

Сделать порт снова приватным можно в любой момент. В течение 5 секунд ссылка снова открывается только вам. В боксе может быть до 20 публичных портов. Публичные порты сохраняют адреса, пока бокс остановлен. Сброс снова делает все порты приватными.

База данных или другой TCP-порт

Адреса превью передают только HTTP. Для Postgres, Redis или любого обычного TCP-порта сделайте проброс через SSH:

ssh -N -L 5432:localhost:5432 <box>@ssh.detachbox.com

Затем подключайтесь к localhost:5432 на своём компьютере.

Файлы бокса в браузере

У каждого бокса есть ещё адрес для файлов: https://files-<box>.detachbox.dev/<absolute path>. Он отдаёт любой файл, который может прочитать пользователь dev, размером до 1 GiB. Вход работает так же, как для превью.

  • Откройте отчёт о покрытии тестами или папку dist как сайт. Укажите в адресе папку с / на конце, и загрузится её index.html со всеми ресурсами по относительным путям.
  • HTML-отчёт с ресурсами рядом, например report.html плюс report_files/, открывается как папка.
  • Ресурсы по абсолютным путям, например /assets/app.js, не загружаются. Для сборки Vite задайте base: './'.

Кнопка Открыть страницей в просмотрщике файлов открывает HTML-файл по этому адресу. Просмотрщик описан в руководстве по терминалу.

Поделитесь файлом без входа

  1. Откройте файл из терминала: щёлкните по пути с ⌘ или Ctrl или коснитесь его на телефоне.
  2. В просмотрщике нажмите Поделиться ссылкой.
  3. В блоке Ссылка работает выберите 15 минут, 1 час, 1 день или 7 дней.
  4. Нажмите Создать ссылку, затем Скопировать ссылку.

Любой, у кого есть ссылка, может скачать этот файл, аккаунт не нужен. Когда срок выходит, ссылка перестаёт работать.

Ссылки на файлы

На вкладке Превью ваши ссылки собраны в блоке Файлы по ссылке. В каждой строке видно, когда ссылка истекает и сколько раз её открыли.

  • Нажмите Отозвать, чтобы закрыть ссылку. Она перестанет работать в течение 5 секунд.
  • В боксе может быть до 50 действующих ссылок. Отзовите ненужную, чтобы освободить место.
  • Сброс отзывает все ссылки бокса. Клон начинает без ссылок.

Подробнее об адресе для файлов и превью: /features/previews.