
BrowserBox v18.8.0
💚🇺🇸🗽Безопасный удаленный просмотр веб-страниц где угодно, как вам удобно.
BrowserBox от DOSAYGO
Безопасная, современная изоляция удалённого браузера (RBI) с бесклиентным опытом
🔐 НОВОЕ в v18.0.1 — Аутентификация по passkey на macOS: входите на сайты с настоящими passkey внутри вашего удалённого браузера.
Passkey создаются и хранятся в Secure Enclave вашего Mac и разблокируются с помощью Touch ID через
помощник BrowserBox Passkeys —
небольшое подписанное и нотаризованное приложение, которое BrowserBox предлагает скачать, когда сайт запрашивает passkey. Ваши ключи никогда не покидают ваше устройство.
💻 Попробуйте в вашем терминале — доступ к BrowserBox по SSH через KRNL:
ssh krnl.duetbrowser.com
Полноценная демонстрация браузера в текстовом режиме, без установки и без регистрации. Узнать больше о KRNL →
🇺🇸 НОВОСТИ — Издание для США (v17.7.6), выходит 4 июля 2026: наш самый стабильный BrowserBox на сегодняшний день.
Улучшенная стабильность стриминга при совместном размещении и высоких нагрузках, полное подавление невидимых запросов браузера, которые могли бы перехватить ввод,
управляемая политика браузера для каждого пользователя, инструментация кросс-доменных iframe (предпросмотр) для контейнеров и сайтов со строгой изоляцией — и стриминг 60 FPS, повторно проверенный от начала до конца.
🆕 АПРЕЛЬ 2026: Hyper-Frame — безлимитный iframe — уже доступен!
Встраивайте любой сайт, автоматизируйте удалённые браузеры и создавайте приложения «веб-в-вебе». Попробовать живую консоль →
Демо Windows 98½: Попробуйте BrowserBox с нашей ностальгической демонстрацией Windows 98½ — бесплатные 17-минутные сессии облачного браузера, без регистрации.
Облачный API: Покупайте минуты и создавайте облачные браузерные сессии по запросу через REST API.
Документация API · Цены · Живое демо · Hyper-Frame
С днём рождения, Америка Прекрасная 🎉🗽
BrowserBox — это платформа изоляции удалённого браузера (RBI). Она транслирует полноценный современный браузер любому клиенту — 60 FPS, низкая задержка — и работает на Windows, macOS, Linux и в контейнерах. BrowserBox — коммерческое программное обеспечение. Для любого использования, включая разработку и оценку, требуется действующая лицензия. BrowserBox не является открытым исходным кодом.
Кратко:
- Бесклиентная RBI — без плагинов, без загрузок для конечных пользователей
- Стриминг 60 FPS с реальной отзывчивостью
- Встраивается куда угодно через
<hyper-frame>(Hyper-Frame) или<browserbox-webview> - Облачный API для эфемерных сессий, без необходимости собственного хостинга
- Работает на Windows, macOS, Linux и в контейнерах, таких как Podman и LXC
- Управление политиками, DLP и рабочие процессы, удобные для аудита
Записи ASCIInema | Живое демо | Облачный API | Цены | Текущее руководство для клиентов PDF | Поддержка
Официальные сайты: BrowserBox, DOSAYGO, Hyper-Frame, CloudTabs
Уведомление: Устаревший исходный код удалён (март 2026)
Когда BrowserBox перешёл на модель распространения в виде бинарных файлов в конце 2025 года, мы сохранили устаревший исходный код в этом репозитории на шестимесячный период, чтобы дать существующим клиентам время на миграцию. Этот период теперь закончился, и весь устаревший исходный код был удалён.
Текущий исходный код BrowserBox является закрытым и проприетарным. Он значительно отличается от устаревшего кода, который ранее размещался здесь — более чем на 1 000 коммитов — с обширными исправлениями ошибок, усилением безопасности и улучшениями производительности, которые отсутствуют в устаревшей кодовой базе и любых её форках.
Устаревший исходный код всё ещё может быть виден в сторонних форках как историческая диковинка. Этот код не является открытым исходным кодом. Разрешение не предоставляется на использование этого исходного кода в ваших продуктах, на обучение AI-моделей или на повторную реализацию функциональности BrowserBox на его основе. Эти действия нарушают условия BrowserBox. См. LICENSE.md и TRADEMARK.md.
Текущий исходный код доступен клиентам выше порогового значения ACV в рамках комплексной проверки, по запросу. Свяжитесь с [email protected].
Содержание
- Почему BrowserBox?
- Ключевые преимущества
- Кто его использует
- Реальные сценарии использования
- Основные возможности
- Что нового
- Посмотрите в действии
- Поддерживаемые сетевые топологии
- Совместимость с платформами
- Установка
- Быстрый старт
- Документация
- GitHub Actions
- Облачный API
- Встраивание BrowserBox
- Продвинутое использование
- Соблюдение лицензии и конфиденциальность
- FAQ
- Лицензирование
- Поддержка
- О DOSAYGO
1. Почему BrowserBox?
Интернет по-настоящему опасен, и обычный просмотр переносит этот риск напрямую на вашу сеть и ваши конечные точки. BrowserBox переворачивает модель: браузер работает на сервере, который вы контролируете, а клиенты получают отрендеренный поток — так что вредоносное ПО, эксплойты и сомнительные сайты никогда не касаются устройств пользователей. Команды безопасности получают изоляцию, не воюя с пользователями из-за агентов на конечных точках. Разработчики SaaS могут встроить полноценный опыт просмотра в свои продукты без хрупкости headless-решений. Регулируемые организации получают встроенные аудиторские следы и средства контроля DLP.
- Сдерживание угроз: эксплойты браузера поражают сервер, а не конечную точку
- Настоящий бесклиентный доступ: любой современный браузер, ноль установок для конечных пользователей
- Встраиваемость: создавайте веб-продукты, включающие реальный, живой просмотр
- Готовность к автоматизации: настоящий браузер, а не headless-приближение
2. Ключевые преимущества
- Изоляция угроз: вредоносное ПО, эксплойты и плохие сайты поражают сервер — а не клиентские устройства
- Бесклиентность: работает в любом браузере, ноль установок для конечных пользователей
- Кроссплатформенность: Windows, macOS, Linux (Debian, Ubuntu, RHEL, CentOS, NixOS) и контейнеры, такие как LXC
- Плавный UX: рендеринг с низкой задержкой, 60 FPS
- Надёжный CLI и API для встраивания для разработчиков и интеграторов
3. Кто его использует
- Команды безопасности — изолируют риски просмотра от корпоративных конечных точек
- Разработчики и интеграторы SaaS — встраивают живые браузерные сессии в продукты
- IT и эксплуатация — получают доступ к внутренним веб-интерфейсам откуда угодно, без широкого сетевого доступа
- Автоматизация и QA — запускают реальные браузерные рабочие процессы без хрупкости headless-решений
- Регулируемые организации — здравоохранение, финансы, государственный сектор — где аудиторские следы и политики DLP не являются опцией
4. Реальные сценарии использования
Домашняя лаборатория: постоянно включённый jump-браузер
Если у вас есть Synology NAS или любой постоянно включённый домашний сервер, BrowserBox естественно вписывается как приватный jump-браузер для вашей локальной сети. Установите его один раз через CLI, и у вас появится транслируемая сессия Chrome, доступная с любого устройства — телефона, ноутбука, чего угодно под рукой — которая может немедленно получить доступ к панели администратора вашего роутера, IP-камерам, хабам умного дома, принтерам и любым другим внутренним веб-интерфейсам, которые обычно требуют нахождения в той же локальной сети.
Никакого лабиринта проброса портов. Никакого VPN только для проверки одного устройства. Вы открываете одну защищённую сессию BrowserBox, защищённую токеном, и всё за ней остаётся приватным. Запускайте большие загрузки, и они попадают прямо на диски NAS — без лишних переходов, без облачного посредника. Когда сайт выставляет капчу или антибот-стену, просто решите это визуально в удалённом браузере. Это ваша сеть. Вот как вы достигаете её чисто.
Корпоративный сектор: безопасный шлюз удалённого браузера
В корпоративной, государственной, медицинской и финансовой среде BrowserBox действует как безопасный браузерный шлюз, развёрнутый внутри защищённой сети. Команды, подрядчики и поставщики получают доступ к внутренним веб-приложениям, интранетам, панелям администратора и устаревшим системам — без установки программного обеспечения на свои устройства и без открытия широкого сетевого доступа к вашей инфраструктуре.
Администраторы контролируют копирование-вставку, загрузку и скачивание файлов, печать и ввод с клавиатуры для каждого пользователя или сессии. Политики DLP удерживают конфиденциальную информацию внутри изолированного браузера. Каждое действие поддаётся аудиту. Вредоносное ПО и эксплойты сдерживаются на стороне сервера. Управляете ли вы соответствием HIPAA, финансовым регулированием или требованиями государственной безопасности — средства контроля на месте, и они не прикручены как запоздалая мысль.
Одна и та же основная идея, два очень разных мира: держите браузер там, где вы можете за ним наблюдать, и транслируйте вид туда, где на самом деле находятся люди.
5. Основные возможности
- Бесклиентная RBI — доступ из любого современного браузера, установка не требуется для конечных пользователей
- Кроссплатформенность — Windows, macOS, Debian, Ubuntu, RHEL, Rocky Linux, CentOS, NixOS и контейнеры, такие как LXC
- CLI
bbx— управление установкой, лицензиями, пользователями, режимами запуска и туннелями из командной строки - API встраивания
<browserbox-webview>— вставьте живую браузерную сессию в любой веб-продукт - Облачный API — покупайте пакеты минут и запускайте эфемерные сессии через REST, без собственного хостинга
- Готовность к автоматизации — настоящий браузер; интеграции с Puppeteer и Playwright в разработке
- DLP, поддержка Tor, контроль доступа — применение политик встроено, а не прикручено
- Развёртывание в облаке в 1 клик — скоро
6. Что нового
- Значительно более широкая поддержка Windows (v18.9.0) —
bbxна Windows теперь имеет команды подключения и управления, которые раньше были только для Linux и macOS: туннели Cloudflare, onion-сервисы Tor, сети ZeroTier, входной шлюз nginx и устаревшие клиенты Windows 9x, а такжеrestart,logs,use-chrome,activateиvacancy. Каждый туннель устанавливает всё необходимое при первом использовании. См. что работает на Windows. - Аутентификация по passkey на macOS (v18.0.1) — входите на сайты с passkey изнутри вашего удалённого браузера. Помощник BrowserBox Passkeys (подписанный и нотаризованный) хранит ключи в Secure Enclave и разблокирует их с помощью Touch ID; BrowserBox автоматически предлагает загрузку, когда сайт запрашивает passkey.
- KRNL — BrowserBox по SSH — браузер в текстовом режиме в любом терминале:
ssh krnl.duetbrowser.com, чтобы попробовать бесплатно, или получите пакет KRNL. - Облачный API — покупайте пакеты минут на win9-5.com/pricing и создавайте эфемерные браузерные сессии через REST. Никакого сервера для управления.
- Демо Windows 98½ — бесплатные 17-минутные облачные сессии на win9-5.com/demo, без регистрации.
- Запись Flipbook — записывайте любую сессию просмотра как самодостаточный статический сайт-флипбук. Разверните на Cloudflare Pages одной командой.
- Система бинарных релизов — BrowserBox теперь поставляется как подписанный бинарный файл. Установка одной командой, обновление тем же способом.
- Стриминг 60 FPS — рендеринг в реальном времени с низкой задержкой для опыта просмотра, который действительно ощущается как браузер.
- Унифицированные точки установки —
browserbox.io/install.sh(Linux/macOS) иbrowserbox.io/install.ps1(Windows).
7. Посмотрите в действии
Безопасный веб-просмотр
Бесшовный просмотр PDF
Мощные DevTools
Полный набор функций браузера (загрузка файлов и т. д.)
8. Поддерживаемые сетевые топологии
BrowserBox неприхотлив к тому, как устроена ваша сеть. Находитесь ли вы за корпоративным NAT, маршрутизируете через Tor или запускаете туннель Cloudflare для быстрой демонстрации — он вписывается, не требуя от вас перестройки чего-либо. Доступ может быть браузерным по HTTPS/WSS/WebRTC или терминальным по SSH. Топология доступа по SSH обеспечивается опциональным дополнением KRNL BrowserBox, которое представляет удалённый браузер как интерактивный терминальный пользовательский интерфейс (TUI) в SSH-сессии с выделением PTY. KRNL доступен с BrowserBox как пакет BrowserBox + KRNL.
Таблица ниже охватывает поддерживаемые топологии — выберите то, что соответствует вашей ситуации.
| Топология | Описание | Публичный доступ? | Ключевые возможности и преимущества | Поддержка ОС (Ubuntu/macOS/Windows) | Для чего лучше всего |
|---|---|---|---|---|---|
| Только HTTP | Базовые незашифрованные HTTP-соединения для быстрого, лёгкого доступа. | Да (если открыт) | Простая настройка; идеально для внутреннего тестирования или демонстраций с низкими требованиями к безопасности. Поддерживает пользовательские порты (например, 8080, 9999, 11111) или стандартные (80). | ✅ / ✅ / ✅ | Быстрое прототипирование в доверенных сетях. |
| HTTP/WS | HTTP с поддержкой WebSocket для двунаправленной связи в реальном времени. | Да (если открыт) | Включает интерактивные приложения; сочетается с пользовательскими/стандартными портами для гибкости. | ✅ / ✅ / ✅ | Чат-приложения, живые обновления или инструменты совместной работы. |
| HTTPS/WSS/WebRTC | Защищённый HTTPS с WebSocket Secure и WebRTC для шифрованного однорангового медиастриминга. | Да (если открыт) | Сквозное шифрование; автоматическая работа с сертификатами; пользовательские/стандартные порты (443 по умолчанию). | ✅ / ✅ / ✅ | Видеозвонки, безопасный обмен файлами или совместная работа в реальном времени в продакшене. |
| Tor/HTTP | Onion-сервис Tor поверх HTTP для псевдонимного доступа. | Да (через .onion) | Высокая приватность; обходит цензуру; медленно, но надёжно. Требуется Tor Browser. | ✅ / ✅ / ✅ | Демонстрации с фокусом на приватность или ограниченные среды. |
| Tor/HTTPS | Защищённый onion-сервис Tor с шифрованием HTTPS. | Да (через .onion) | Добавляет TLS к Tor для дополнительной безопасности; надёжное прохождение NAT. | ✅ / ✅ / ✅ | Анонимный безопасный доступ в сценариях с высокими угрозами. |
| SSH / Интерактивный терминал (дополнение KRNL) | Терминальный доступ к BrowserBox через интерактивную SSH-сессию с TUI на базе PTY; графический браузер на клиенте не требуется. | Публичный или приватный (стандартный SSH) | Удалённый просмотр из SSH-клиента; попробуйте размещённое демо с ssh krnl.duetbrowser.com или приобретите пакет BrowserBox + KRNL. | ✅ / ✅ / ✅ | Bastion-хосты, jump-боксы, терминальные операции и ограниченные клиентские среды. |
| Проброс портов SSH, HTTP | Туннелирование HTTP-трафика через проброс портов на основе SSH. | Нет (приватный) | Безопасно, с низкой задержкой; перенаправляет на пользовательские/стандартные порты. Предстоящая автоматическая оркестрация сертификатов. | ✅ / ✅ / ✅ | Приватный доступ к домашней лаборатории или безопасная внутренняя маршрутизация. |
| Проброс портов SSH, HTTPS | Проброс SSH с HTTPS для шифрованных туннелей. | Нет (приватный) | Сочетает надёжность SSH с TLS; гибкие варианты портов. Нативные улучшения в разработке. | ✅ / ✅ / ✅ | Безопасные удалённые сессии корпоративного уровня. |
| Пользовательские порты | Определяемые пользователем порты (например, 8080, 9999, 11111) для любого протокола. | Варьируется | Полный контроль; избегает конфликтов; интегрируется со всеми топологиями. | ✅ / ✅ / ✅ | Индивидуальные настройки для специализированных приложений или хостов с несколькими сервисами. |
| Стандартные порты | Порты по умолчанию (например, 80 для HTTP, 443 для HTTPS) для бесшовной совместимости. | Варьируется | Plug-and-play; снижает накладные расходы на конфигурацию в стандартных средах. | ✅ / ✅ / ✅ | Быстрые развёртывания, соответствующие типовой инфраструктуре. |
| Туннель Cloudflare | HTTPS DNS-фасад с ретрансляцией портов через граничную сеть Cloudflare. | Да (*.trycloudflare.com) | Автоустановка; высокая надёжность; отличная производительность. Нативная поддержка bbx cf-run скоро. | ✅ / ✅ / ✅ | Быстрые публичные демонстрации с приватностью источника. |
| localhost.run | Обратный SSH-туннель с HTTPS-фасадом. | Да (http(s)://…lhr.life) | Без настройки; средняя надёжность; occasional interstitials. | ✅ / ✅ / ✅ | Бесплатные, простые ссылки для неформального обмена. |
| ngrok | Ретрансляция портов с HTTPS и токеном аутентификации для безопасного открытия. | Да (*.ngrok-free.app) | Высокая производительность; готовность к вебхукам; ограничения бесплатного уровня (1 туннель). Требуется токен. | ✅ / ✅ / ✅ | Демонстрации для обмена и тестирование вебхуков. |
| Pinggy | Ретрансляция портов с HTTPS; возможны interstitials. | Да (*.pinggy.io) | Приемлемая надёжность; нормальная производительность. | ✅ / ✅ / ℹ️ (Ограничено на Windows) | Экономичные вебхуки и демонстрации. |
| Tailscale | Оверлейная сеть для приватного доступа, подобного локальной сети. | Нет (приватный tailnet) | Очень высокая надёжность; низкая задержка. Проброс SSH; требуется токен. Менее стабильно на Windows/VPN. | ✅ / ✅ / ℹ️ (SSH не поддерживается вышестоящим проектом на Windows) | Приватная отладка и доступ для команды. |
| Tor | Onion-маршрутизация для псевдонимного, надёжного доступа. | Да (.onion) | Чрезвычайно надёжно (но медленно); приватность прежде всего. У нас уже есть bbx tor-run. | ✅ / ✅ / ✅ | Устойчивые к цензуре, анонимные развёртывания. |
| Tunnelmole | OSS-ретранслятор в стиле ngrok с HTTPS. | Да (https://…tunnelmole.net/.com) | Высокая надёжность; хорошая производительность; автоустановка. | ✅ / ✅ / ✅ | Демонстрации с открытым исходным кодом и простыми URL. |
| ZeroTier | Оверлейная сеть для однорангового приватного доступа. | Нет (приватная сеть) | Подобно локальной сети; очень высокая надёжность. Нативная поддержка bbx zt-run скоро. Требуются токены; клиент на устройстве доступа. | ✅ / ✅ / ✅ | Безопасные P2P-демонстрации в оверлеях. |
Заметки о гибкости и мощности:
- Терминальный доступ KRNL отличается от проброса портов SSH: KRNL предоставляет интерактивный TUI по SSH, тогда как проброс портов передаёт путь доступа HTTP(S) BrowserBox через приватный туннель.
- BrowserBox поддерживает смешивание и сочетание топологий — вы можете запустить HTTPS с туннелем Cloudflare на пользовательских портах или Tor поверх проброса SSH. Топология — ваша для композиции.
- CLI
bbxобрабатывает настройку туннелей, оркестрацию сертификатов и режимы запуска в одном месте, так что вам не нужно сшивать дюжину отдельных инструментов, чтобы получить работающее развёртывание.
9. Совместимость с платформамиBrowserBox работает там, где происходит реальная работа — вот текущая матрица поддержки.
| Платформа | Поддерживается | Иконка |
|---|---|---|
| Tails* | ❌ | |
| Windows & Windows Server | ✅ | |
| macOS | ✅ | |
| Debian | ✅ | |
| Ubuntu | ✅ | |
| CentOS Stream | ✅ | |
| RHEL | ✅ | |
| Rocky Linux | ✅ | |
| NixOS | ✅ | |
| LXC | ✅ | |
| Podman | ✅ | |
| Windows 9x† | ✅ |
[!NOTE] Запустите
bbx(илиbbx installв Windows), чтобы убедиться, что у вас последняя версия (v13+) со всеми исправлениями и функциями.
*Tails не поддерживается, поскольку Chrome не может быть установлен.
†Клиенты Windows 9x поддерживаются через команду bbx win9x-run, которая выводит ссылку для входа для устаревших клиентов (IE 5, IE 6, Netscape). Поддерживаемые клиентские ОС: Windows 95, 98, 2000, NT. Сервер по-прежнему должен работать на современной системе. Современные клиенты также могут использовать устаревшую конечную точку, но опыт, что понятно, будет ретро.
10. Установка
BrowserBox — коммерческое программное обеспечение. Для любого использования, включая разработку и оценку, требуется действующая лицензия. BrowserBox не является открытым исходным кодом. Начните 7-дневную платную оценку или приобретите лицензию.
Linux и macOS```bash
curl -fsSL https://browserbox.io/install.sh | bash
### Windows```powershell
irm https://browserbox.io/install.ps1 | iex
Для неинтерактивных полных установок задайте BBX_INSTALL_HOSTNAME и BBX_INSTALL_EMAIL. Устаревшие псевдонимы установки BBX_HOSTNAME, BBX_EMAIL и EMAIL по-прежнему поддерживаются для совместимости.
Что работает в Windows
Установка в Windows запускает один экземпляр BrowserBox на машину. Помимо настройки, запуска, остановки, статуса, лицензирования и политики, bbx в Windows предлагает:
| Команда | Что она делает |
|---|---|
bbx cf-start | Публичная ссылка HTTPS через быстрый туннель Cloudflare, без учётной записи Cloudflare |
bbx tor-start | Служба Tor onion, и просмотр маршрутизируется через Tor |
bbx zt-start --network-id <id> | BrowserBox, обслуживаемый в вашей частной сети ZeroTier |
bbx ng-start | nginx перед BrowserBox на порту 443 |
bbx win9x-start | Обычная ссылка HTTP для клиентов эпохи Windows 9x |
bbx restart | Перезапуск тем же способом, которым он был запущен в последний раз |
bbx logs | Состояние службы и журналы каждой службы и туннеля |
bbx use-chrome <version> | Закрепить сборку Chrome for Testing или установить стабильный Chrome |
bbx activate, bbx vacancy | Купить места и проверить доступность мест |
cloudflared, Tor, ZeroTier и nginx устанавливаются при первом запуске команды, которой они нужны, а не установщиком BrowserBox, поэтому базовая установка остаётся компактной. Для установки ZeroTier требуется PowerShell с повышенными правами.
Две вещи недоступны в Windows: звук и многопользовательские команды (bbx fleet, start-as, stop-user). Обе требуют лицензирования служб удалённых рабочих столов на каждое место в Windows Server.
Через npm```bash
npm i -g @browserbox/browserbox
---
## 11. Быстрый старт
Требуется ключ продукта. Получите его через [платную оценку](https://browserbox.io/evaluate) или [коммерческую / некоммерческую покупку](https://dosaygo.com/pricing.html).```bash
bbx install
bbx certify YOUR_PRODUCT_KEY
bbx setup
bbx run
12. Документация
13. GitHub Actions
Запустите BrowserBox напрямую на раннере GitHub Actions с помощью BrowserBox/browserbox-action.
-
Поддерживает
tunnel: none,cloudflareиtor -
По умолчанию использует минимальный размер раннера с
BBX_MINIMAL_MODE=true -
Отключает проверки обновлений во время запусков раннера с
BBX_NO_UPDATE=true -
Требует лицензионный ключ BrowserBox (платная оценка или покупка)```yaml jobs: browserbox: runs-on: ubuntu-latest steps: - name: Launch BrowserBox id: browserbox uses: BrowserBox/browserbox-action@v1 with: license-key: ${{ secrets.BROWSERBOX_LICENSE_KEY }} tunnel: cloudflare
- name: Print login link run: echo "${{ steps.browserbox.outputs.login-link }}"
---
## 14. Cloud API
Создавайте эфемерные браузерные сессии по требованию без собственного хостинга. Покупайте пакеты минут и управляйте сессиями через REST.```bash
curl -X POST https://win9-5.com/api/v1/sessions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"minutes": 15}'
Полная документация API: win9-5.com/api
15. Встраивание BrowserBox```html
Элемент `<browserbox-webview>` предоставляет API хоста сессии с пространствами имён для вкладок, страниц, захвата, дополнения, выделения и управления возможностями с политиками.
### Установка через npm
Встраиваемый элемент также опубликован как [`@browserbox/webview-element`](https://www.npmjs.com/package/@browserbox/webview-element) для использования в приложениях со сборкой:```bash
npm i @browserbox/webview-element
| -s | --server | Адрес сервера (по умолчанию: http://localhost:8080) |
| -t | --token | Токен аутентификации |
| -o | --output | Формат вывода: json, yaml, table (по умолчанию: table) |
| -v | --verbose | Подробный вывод |
| -q | --quiet | Тихий режим (без вывода) |
| -c | --config | Путь к файлу конфигурации |
| -h | --help | Показать справку |
| -V | --version | Показать версию |
Примеры
# Сканирование цели
scanner scan --target example.com
# Сканирование с пользовательским выводом
scanner scan --target example.com --output json
# Пакетное сканирование из файла
scanner batch --file targets.txt --output yaml
# Проверка состояния сервера
scanner status --server http://localhost:8080
# Показать справку
scanner --help
Конфигурация
Инструмент можно настроить с помощью файла конфигурации или переменных окружения.
Файл конфигурации
Создайте файл config.yaml:
server:
url: "http://localhost:8080"
token: "your-token-here"
timeout: 30
scan:
threads: 10
timeout: 5
user_agent: "Mozilla/5.0"
output:
format: "table"
verbose: false
Переменные окружения
| Переменная | Описание |
|---|---|
SCANNER_SERVER_URL | URL сервера |
SCANNER_TOKEN | Токен аутентификации |
SCANNER_OUTPUT_FORMAT | Формат вывода |
SCANNER_THREADS | Количество потоков |
SCANNER_TIMEOUT | Таймаут в секундах |
Установка
Из исходного кода
git clone https://github.com/example/scanner.git
cd scanner
make build
sudo make install
Через Docker
docker pull example/scanner:latest
docker run -it --rm example/scanner:latest --help
Бинарные файлы
Загрузите последнюю версию со страницы releases.
Использование
Базовое сканирование
scanner scan --target example.com
Сканирование нескольких целей
scanner scan --target example.com,test.com,localhost
Сканирование с файлом целей
scanner batch --file targets.txt
Пользовательские заголовки
scanner scan --target example.com --header "Authorization: Bearer token"
Прокси
scanner scan --target example.com --proxy http://127.0.0.1:8080
Вывод
Формат таблицы
+----------------+--------+----------+
| TARGET | STATUS | DETAILS |
+----------------+--------+----------+
| example.com | OK | 200 |
| test.com | FAIL | timeout |
+----------------+--------+----------+
Формат JSON
{
"results": [
{
"target": "example.com",
"status": "ok",
"details": "200"
}
]
}
Формат YAML
results:
- target: example.com
status: ok
details: "200"
Расширенное использование
Пользовательские модули
scanner scan --target example.com --module custom_module
Цепочка модулей
scanner scan --target example.com --module module1,module2,module3
Параллельное сканирование
scanner scan --target example.com --threads 20
Ограничение скорости
scanner scan --target example.com --rate-limit 10
Устранение неполадок
Распространённые проблемы
Проблема: Ошибка подключения к серверу
Решение: Убедитесь, что сервер запущен и доступен:
curl http://localhost:8080/health
Проблема: Ошибка аутентификации
Решение: Проверьте токен:
scanner status --token your-token
Проблема: Таймаут сканирования
Решение: Увеличьте таймаут:
scanner scan --target example.com --timeout 60
Режим отладки
scanner scan --target example.com --verbose --debug
Журналы
Журналы сохраняются в /var/log/scanner/:
tail -f /var/log/scanner/scanner.log
Участие в разработке
Мы приветствуем вклад в развитие проекта!
Сообщения об ошибках
Перед созданием сообщения об ошибке:
- Проверьте, не сообщалось ли уже об этой проблеме
- Соберите информацию о версии и окружении
- Приложите шаги для воспроизведения
Запросы на добавление функций
- Опишите предлагаемую функцию
- Объясните вариант использования
- Приведите примеры
Pull Request
- Форкните репозиторий
- Создайте ветку для функции (
git checkout -b feature/amazing-feature) - Зафиксируйте изменения (
git commit -m 'Add amazing feature') - Отправьте в ветку (
git push origin feature/amazing-feature) - Откройте Pull Request
Лицензия
Этот проект распространяется под лицензией MIT — подробности см. в файле LICENSE.
Благодарности
Контакты
- Автор: Your Name
- Email: [email protected]
- GitHub: @yourusername
Статус проекта
```js
import '@browserbox/webview-element';
---
## 16. Расширенное использование
- **Безопасный просмотр документов** — открывайте PDF-файлы и конфиденциальные файлы в удалённом браузере, никогда не загружая их на клиентское устройство (только Linux)
- **Удалённые DevTools** — щёлкните правой кнопкой мыши в любой сессии BrowserBox, чтобы получить доступ к полным Chrome DevTools, работающим в изолированной среде
- **Туннелирование Tor и SSH** — `bbx tor-run` для анонимного доступа через onion-маршрутизацию; перенаправление портов SSH для приватной внутренней маршрутизации с низкой задержкой
---
## 17. Запись флипбука
BrowserBox может записывать сессию просмотра как **флипбук** — автономный статический сайт из последовательных JPEG-кадров с интерактивным средством просмотра на JavaScript. Записи создаются непосредственно из внутреннего конвейера скринкаста с незначительными накладными расходами.
### Быстрый старт```bash
# Enable recording during setup
bbx setup --flipbook-record ~/my-recording --flipbook-description "Demo walkthrough"
# Run BrowserBox normally
bbx run
# Stop — frames are compiled into a flipbook site and optionally deployed
bbx stop
Как это работает
bbx setup --flipbook-record <dir>включает запись, записываяBBX_FLIPBOOK_DIRв конфигурацию BrowserBox.- Во время выполнения каждый кадр скринкаста сохраняется как пара JPEG + JSON-метаданные — нулевые накладные расходы, когда запись выключена (одна булева проверка на кадр).
- При
bbx stopвстроенная командаbrowserbox flipbook-generateкомпилирует необработанные кадры в полноценный статический сайт-флипбук. - Если доступен Cloudflare Wrangler, сайт автоматически развёртывается в Cloudflare Pages.
Вывод
Каждая запись создаёт директорию с меткой времени:``` ~/my-recording/ 2026-04-14T02-25-00-000Z--2026-04-14T02-30-00-000Z/ site/ index.html # self-contained viewer manifest.json # flipbook v1 manifest pages/ # sequential JPEG frames (000000.jpg, 000001.jpg, ...) assets/ # viewer.css, viewer.js, sw.js meta/ # provenance.json with full per-frame metadata
Несколько запусков в одну и ту же директорию создают отдельные подкаталоги с временными метками — каждый из них является автономным сайтом-флипбуком, который можно обслуживать любым статическим файловым сервером или развернуть на любой хостинговой платформе.
### Опции
| Флаг | Описание |
|------|-------------|
| `--flipbook-record <dir>` | Включить запись. Скомпилированные сайты-флипбуки записываются сюда. |
| `--flipbook-description <text>` | Необязательное описание, встраиваемое в манифест и метаданные происхождения. |
---
## 18. Соответствие лицензии и конфиденциальность
BrowserBox требует действующей лицензии для всех развёртываний — коммерческих, некоммерческих и оценочных. Данные об использовании собираются исключительно для соблюдения лицензионных требований и операционных целей; они никогда не продаются, никогда не передаются третьим лицам для маркетинга и никогда не используются для профилирования пользователей.
>[!IMPORTANT]
>Действующая лицензия разблокирует все функции, обеспечивает постоянную поддержку и гарантирует безопасное, соответствующее требованиям решение.
---
## 19. Часто задаваемые вопросы
**В: Могу ли я получить оценочную лицензию?**
Да. Зафиксируйте свою 7-дневную оценочную версию BrowserBox. Оплатите единовременный сбор в зависимости от количества мест ($20 за место с рабочей электронной почтой / $40 за место с бесплатными или анонимными почтовыми провайдерами), подтвердите свою личность через Stripe и получите лицензионный ключ по электронной почте. Никаких подписок. Пробный период заканчивается через 7 дней, обновление возможно в любое время. Стоимость оценочной версии вычитается из полной лицензии, если вы решите продолжить покупку. Все продажи окончательны — возврат средств не производится ни при каких обстоятельствах. [Начать 7-дневную платную оценку](https://browserbox.io/evaluate).
**В: Почему требуется лицензия?**
BrowserBox — это коммерческое программное обеспечение. Лицензия финансирует дальнейшую разработку, исследования в области безопасности и поддержку. Она также даёт вам легитимное, поддерживаемое развёртывание — а не форк старого кода, который разошёлся более чем на 1000 коммитов назад.
**В: Предлагаете ли вы бессрочные лицензии?**
Текущее лицензирование основано на подписке. Доступны корпоративные соглашения, включая бессрочные варианты — свяжитесь с [[email protected]](mailto:[email protected]).
**В: Как BrowserBox соотносится с другими решениями RBI?**
Большинство продуктов RBI работают только в облаке, дорого стоят при масштабировании или требуют проприетарных агентов на конечных устройствах. BrowserBox работает на вашей собственной инфраструктуре (или нашей через Cloud API), совместим с любым клиентским браузером и даёт вам реальный контроль над развёртыванием. Это также единственная платформа RBI с демо Windows 98½, если это вообще чего-то стоит.
**В: Что я получаю при покупке?**
Ключ продукта, активирующий `bbx`, доступ ко всем текущим бинарным файлам платформы, документации и каналам поддержки. Корпоративные клиенты, превышающие пороговый ACV, могут запросить доступ к исходному коду для комплексной проверки.
**В: Как я могу получить скидки за объём?**
Свяжитесь с [[email protected]](mailto:[email protected]) для получения информации об объёмных ценах, многолетних соглашениях и корпоративных условиях.
**В: Возможно, я использовал BrowserBox без лицензии. Как мне привести всё в соответствие?**
Обратитесь по адресу [[email protected]](mailto:[email protected]). Мы решаем вопросы соответствия напрямую и без лишней драмы — цель состоит в том, чтобы вы получили лицензию и поддержку, а не в том, чтобы создавать сложности.
---
## 20. Лицензирование
BrowserBox — это коммерческое программное обеспечение. Действующая лицензия требуется для **всех** видов использования, включая разработку и оценку. BrowserBox не является открытым исходным кодом.
- **Коммерческая:** От $119/пользователь/год. [Купить](https://dosaygo.com/commerce)
- **Некоммерческая:** $49/пользователь/год (некоммерческие организации, государственные учреждения). [Купить](https://dosaygo.com/noncommercial)
- **Оценочная:** 7-дневная платная оценочная лицензия (единовременный сбор за место с подтверждением личности через Stripe; сбор засчитывается в счёт полной лицензии при обновлении). Все продажи окончательны. [Начать 7-дневную платную оценку](https://browserbox.io/evaluate)
- **Корпоративная / Доступ к исходному коду:** [[email protected]](mailto:[email protected])
---
## 21. Поддержка
- **API и техническая:** [[email protected]](mailto:[email protected])
- **Общая:** [[email protected]](mailto:[email protected])
- **Продажи и лицензирование:** [[email protected]](mailto:[email protected])
---
## 22. О DOSAYGO
DOSAYGO — do, say, go — это три из самых универсальных человеческих глаголов, после «быть» (с которым ни одна компания не имеет права указывать вам, что делать). Мы небольшая команда, создающая программное обеспечение, которое уважает людей, использующих его. Наши продукты — это BrowserBox (изоляция удалённого браузера) и DiskerNet (офлайн-веб-архивы). Мы не занимаемся модными словечками. Мы выпускаем то, что работает. Найдите нас на [dosaygo.com](https://dosaygo.com).
---
<p align="center">
<strong>Готовы начать?</strong><br>
<a href="https://browserbox.io/evaluate">Начать 7-дневную платную оценку</a> · <a href="https://dosaygo.com/commerce">Коммерческая лицензия</a> · <a href="https://dosaygo.com/noncommercial">Некоммерческая лицензия</a> · <a href="mailto:[email protected]?subject=Demo">Запросить демо</a>
</p>
BrowserBox™ является © 2018-2026 DOSAYGO Corporation USA. Все права защищены.
[dosaygo.com](https://dosaygo.com) | [browserbox.io](https://browserbox.io) | [CloudTabs](https://browse.cloudtabs.net)