Документация · обновлено 6 сентября 2026

Подключите устройства.
Управляйте из кабинета.

CloudMob публикует локальные сайты, открывает доступ к выбранным папкам и связывает Android-устройства с кабинетом. Для компьютеров доступны Windows Agent 0.4.9 и Mac 0.5.0-beta.7; для координат и диктофона — CloudMob Android 1.4.2.

Опубликовать локальный сайт

Windows и macOS
  1. 01

    Войдите и создайте устройство

    Зарегистрируйтесь с подтверждением email или войдите в кабинет. Создайте отдельную карточку для каждого компьютера и скопируйте токен подключения. При обновлении приложения используйте существующее устройство.

  2. 02

    Установите Agent для своей системы

    Скачайте Windows 10/11 x64 или macOS 13+ для Intel и Apple Silicon. Mac пока выпускается как beta без Developer ID и нотариального заверения Apple; обновляется вручную заменой приложения.

  3. 03

    Добавьте токен и включите Agent

    Windows 0.4.9: откройте C:\ProgramData\CloudMob\cloudmob-agent.conf в Блокноте от имени администратора, вставьте токен после token= и сохраните. Откройте Agent, нажмите кнопку питания и подтвердите UAC.

    Mac: откройте «Настроить», вставьте токен и нажмите «Сохранить токен». Включите агент кнопкой питания и при запросе разрешите фоновую службу. Токен хранится в Связке ключей.

    Проверьте статус online в кабинете. Само сохранение токена ещё не означает подключение. Окно приложения должно оставаться открытым.

  4. 04

    Создайте публикацию

    Запустите локальный HTTP-сервис. В кабинете выберите компьютер, укажите адрес и порт, доступные с этого компьютера: например, 127.0.0.1:3000. Для обычного аккаунта имя выдаётся автоматически; владелец и администратор могут задать его вручную.

    localhost:3000https://boldly-bright-otter.cloudmob.ru

    По умолчанию выбран защищённый доступ. Публичный режим открывает сайт всем посетителям.

  5. 05

    Откройте выданный HTTPS-адрес

    Новые публикации подхватываются примерно за 5 секунд. Белый IP и проброс портов не нужны. Компьютер, Agent и локальный сервис должны работать; при выключении ресурса посетитель увидит страницу недоступности. После восстановления связи Agent восстанавливает туннель.

Доступ к сайту и токены компьютера

У защищённой публикации откройте «Настроить доступ» и добавьте зарегистрированных участников по email. Владелец имеет доступ всегда. Посетитель входит в CloudMob и подтверждает переход. Участника можно удалить, а активные сеансы — отозвать. Собственная авторизация локального сайта продолжает действовать, если она настроена.

В карточке компьютера раздел «Токены подключения» позволяет создать несколько именованных токенов и отзывать их отдельно. Новые токены можно повторно посмотреть после подтверждения паролем аккаунта. Старые токены, для которых доступен только хеш, восстановить нельзя: создайте дополнительный и проверьте подключение до отзыва прежнего.

Отзыв токена запрещает дальнейшую авторизацию, но не закрывает уже открытый туннель принудительно. Для немедленной остановки выключите Agent. Не передавайте токены, конфигурацию и пароли другим людям.

Локальные папки · Workspace

Файлы остаются на компьютере; кабинет передаёт Agent разрешённые операции. Это доступ к выбранной папке, а не синхронизация всего диска. Раздел обычному аккаунту включает администратор.

  1. В разделе «Локальные папки» выберите компьютер, задайте имя и создайте ресурс. Сначала используйте отдельную тестовую папку.
  2. На Mac во включённом Agent откройте настройки, вставьте UUID или код workspace.UUID, выберите папку и нажмите «Сохранить и проверить доступ». Подтвердите запрос macOS. Возможность записи включается локально.
  3. На Windows добавьте выданную кабинетом строку workspace.UUID=абсолютный путь в C:\ProgramData\CloudMob\cloudmob-agent.conf, заменив UUID и путь своими значениями. Для записи отдельно добавьте workspace.UUID.write=true. В интерфейсе Agent настройте учётную запись доступа к папке и перезапустите Agent.
  4. Дождитесь доступности папки в кабинете, проверьте чтение и только затем приглашайте участников по email.

Reader читает файлы; Contributor может создавать и изменять файлы, создавать папки и копировать; Editor дополнительно может перемещать файлы. Запись требует одновременно подходящей роли, локального разрешения и прав операционной системы. Перед заменой файла Agent сохраняет защитную версию; конфликт с локальным изменением требует заново прочитать файл.

Доступны дерево папок, поиск по имени и чтение UTF-8 текста до 256 КиБ за просмотр. В кабинете есть переключатель скрытых файлов. Предпросмотр JPEG, PNG, GIF, WebP и PDF до 4 МиБ требует Agent с поддержкой этой функции — сейчас это Mac beta.7. Windows stable 0.4.9 этой возможности ещё не получил. HTML и SVG не открываются как встроенная страница.

Проверка корня папки на Mac не гарантирует права на каждый вложенный файл. Если доступ запрещён, проверьте системные разрешения, повторно сохраните настройку или выключите и включите Agent. Не подключайте системные папки, пароли и ключи.

Android: координаты и диктофон

  1. Установите CloudMob 1.4.2 для Android 8.0+. При обновлении устанавливайте APK поверх прежней версии, чтобы сохранить внутренние записи.
  2. Создайте телефон в кабинете и введите одноразовый код в приложении. Выдайте разрешения для нужных функций и явно запустите службу.
  3. Смотрите последнюю координату на карте и меняйте частоту передачи в приложении или кабинете. История маршрута не сохраняется; фоновая работа видна в уведомлении Android.
  4. Диктофон можно запускать, приостанавливать, продолжать и останавливать на телефоне или из кабинета при работающей службе и разрешении микрофона. Настройки загрузки на сервер и локального хранения независимы. Сохранённые записи можно прослушивать, скачивать, экспортировать и удалять.

Для команд из кабинета телефону нужен интернет. Энергосбережение Android может ограничить фон. Отдельный публичный сайт телефона пока не предоставляется.

CloudMob SMS Gateway

SMS Gateway — отдельное Android-приложение для отправки и приёма SMS через SIM телефона. APK CloudMob с координатами и диктофоном не заменяет шлюз. Возможность и лимиты SMS назначает администратор аккаунта.

  1. В кабинете откройте «SMS-шлюзы», создайте шлюз и введите выданный одноразовый код в SMS Gateway. Код действует 15 минут.
  2. Разрешите необходимые функции Android, выберите SIM для отправки и запустите шлюз. В карточке видны последняя связь и доступность выбранной SIM.
  3. Отправляйте SMS из кабинета и следите за результатом. Сообщение сначала попадает в очередь; отмена возможна до передачи телефону. «Отправлено» и «Доставлено» — разные состояния; неизвестный итог не означает успешную доставку.
  4. Откройте всю историю для поиска по номеру, тексту, шлюзу, направлению, статусу и датам. При отключении шлюза его ключи отзываются, а история сохраняется.

Локальный HTTPS-интерфейс и Wi-Fi API включаются на телефоне и доступны из его сети. Для API создайте отдельное подключение с минимально нужными правами. Облачное OAuth-подключение работает через CloudMob: телефон и приложение могут находиться в разных сетях.

SMS оплачиваются по тарифу SIM-карты. Для отправки нужны работающий шлюз, связь оператора, доступная SIM и не исчерпанные лимиты.

Интеграции и OAuth-приложения

В «Интеграциях» два списка: «Подключённые приложения» показывает, кому вы выдали доступ, а «Мои OAuth-приложения» — клиентов, созданных вами как разработчиком. Подключённое приложение не обязано присутствовать в обоих списках.

  1. Разработчик создаёт OAuth-приложение, указывает точные HTTPS callback-адреса и необходимые права. Для серверного приложения выбирается confidential; public — для клиента, который не способен хранить секрет. PKCE S256 обязателен для обоих типов.
  2. Секрет confidential-клиента показывается при создании: сохраните его на backend. Потерянный секрет можно ротировать; прежнее значение сразу перестаёт работать.
  3. Пользователь начинает подключение во внешнем приложении, входит в CloudMob, выбирает SMS-шлюз и подтверждает права. Доступ отображается в «Подключённых приложениях» и карточке шлюза.
  4. Backend автоматически обновляет короткий access token и сохраняет новое значение refresh token после каждого обновления. Подключение действует до отзыва. Пользователь может отключить его в кабинете.

Самостоятельная регистрация клиента уже доступна; мастер автоматической настройки входа для произвольного сайта пока не реализован. Токены и секреты должны храниться на backend, не в адресах страниц или браузерном хранилище.

Доступность разделов и лимиты

Для обычного аккаунта по умолчанию доступны два компьютера, один Android-телефон, три HTTP-публикации на компьютер и одна локальная папка после включения функции. Администратор может изменить квоты и доступ к отдельным функциям; действующие ограничения видны в кабинете. Лимиты SMS задаются отдельно.

Управление профилем, смена и восстановление пароля, а также завершение остальных сеансов доступны в кабинете. Для регистрации и восстановления нужен доступ к указанному email.