Инструкция по установке программного обеспечения «VPano» и порядок предоставления доступа

Программное обеспечение «VPano» предоставляется в двух формах: облачная версия (веб-платформа с клиент-серверной архитектурой, серверная часть эксплуатируется правообладателем, пользователю предоставляется удалённый доступ через сеть «Интернет» по адресу https://vpano.ru) и локальная версия (программа устанавливается на компьютеры организации и работает без подключения к сети «Интернет»).

При работе в облачной версии установка программы на рабочее место пользователя не требуется. Все функции — загрузка материалов, редактирование, публикация и просмотр туров — выполняются в веб-браузере; дистрибутивы, подключаемые модули браузера и клиентские приложения для этого не устанавливаются. Локальная версия, напротив, передаётся заказчику дистрибутивом и устанавливается на рабочие места — порядок установки, активации и обновления описан в разделе 14.

Документ описывает три независимых сценария:

• Сценарий A — предоставление доступа к платформе (разделы 3–9): регистрация, подтверждение учётной записи, выбор тарифа, активация доступа, подключение дополнительных клиентов.
• Сценарий B — установка автономного тура (разделы 10–13): размещение экспортированного пакета тура на веб-сервере заказчика, в том числе в закрытом контуре без доступа к серверам правообладателя.
• Сценарий В — установка локальной версии программы (раздел 14): получение и проверка дистрибутива, установка на рабочие места, активация файлом лицензии, обновление и удаление.

Требования к рабочему месту для локальной версии приведены отдельно в разделе 14.3.

• Устройство: персональный компьютер, ноутбук, планшет или смартфон.
• Операционная система: любая, поддерживающая современный веб-браузер, — Windows, Linux (включая отечественные дистрибутивы), macOS, Android, iOS.
• Браузер: Яндекс Браузер, Google Chrome, Mozilla Firefox, Microsoft Edge, Safari актуальных версий. Обязательна поддержка WebGL 2.0, JavaScript и файлов cookie.
• Оперативная память: от 4 ГБ для просмотра туров, от 8 ГБ для редактирования крупных проектов.
• Канал связи: от 5 Мбит/с; для загрузки панорам высокого разрешения рекомендуется от 20 Мбит/с.
• Протокол: HTTPS. Работа режима виртуальной реальности (WebXR) возможна только по защищённому соединению.
• Разрешение экрана: от 360 пикселей по ширине — интерфейс адаптивный.

1. Откройте страницу vpano.ru/register.
2. Заполните поля: имя, адрес личной страницы (используется в постоянных ссылках на туры), адрес электронной почты, пароль.
3. Пароль должен содержать не менее 10 символов, включая хотя бы одну букву и хотя бы одну цифру. Требования проверяются в момент ввода.
4. Подтвердите согласие на обработку персональных данных и ознакомление с Пользовательским соглашением и Политикой конфиденциальности.
5. Нажмите кнопку регистрации.

Альтернативно доступна регистрация и вход через российские сервисы авторизации Яндекс ID и VK ID — в этом случае пароль не задаётся, а адрес электронной почты передаётся сервисом авторизации с согласия пользователя.

1. После регистрации на указанный адрес отправляется письмо со ссылкой подтверждения.
2. Перейдите по ссылке из письма.
3. До подтверждения адреса вход в личный кабинет невозможен: система возвращает сообщение «Электронная почта не подтверждена».
4. Если письмо не пришло, повторную отправку можно запросить на странице входа; проверьте папку «Спам».

После подтверждения пользователь получает доступ к личному кабинету по адресу vpano.ru/dashboard на условиях базового (бесплатного) тарифа.

Дополнительно в разделе «Аккаунт» можно включить двухфакторную аутентификацию по одноразовым кодам (TOTP) и сохранить резервные коды восстановления.

Состав функций и количественные лимиты определяются тарифом. Актуальный перечень тарифов, их состав и стоимость опубликованы на странице vpano.ru/pricing; порядок приобретения подробно описан в документе «Информация о стоимости и порядке приобретения».

Вариант 1 — оплата банковской картой (физические лица, ИП, организации)

1. Откройте раздел «Тариф» в личном кабинете.
2. Выберите тариф и период подписки: 1, 3, 6 или 12 месяцев.
3. При наличии — введите промокод. Организации и ИП дополнительно указывают наименование и ИНН для включения реквизитов в кассовый чек.
4. Отметьте согласие с Публичной офертой и при необходимости включите автоматическое продление подписки (по умолчанию отключено).
5. Нажмите «Оплатить» — произойдёт переход на защищённую страницу платёжного сервиса. Данные банковской карты обрабатываются платёжным сервисом и правообладателю не передаются.

Вариант 2 — безналичная оплата по счёту (юридические лица и ИП)

1. В разделе «Тариф» выберите способ оплаты по счёту.
2. Укажите ИНН — реквизиты организации подставляются автоматически; при необходимости дополните банковские реквизиты, адрес электронной почты для счёта и идентификатор электронного документооборота.
3. Отправьте запрос. Счёт выставляется в течение 1 рабочего дня.
4. После поступления денежных средств тариф активируется; комплект документов (счёт, договор, акт) предоставляется в электронном виде.

• Доступ к функциям оплаченного тарифа в облачной версии активируется автоматически после подтверждения платежа. Отдельные действия со стороны пользователя не требуются, переустановка не выполняется. Порядок активации локальной версии — файлом лицензии — описан в разделе 14.5.
• Текущее состояние подписки, дата окончания оплаченного периода и история платежей отображаются в разделах «Тариф» и «Платежи».
• Уведомления об окончании оплаченного периода направляются на адрес электронной почты заблаговременно.
• По окончании оплаченного периода без продления проекты, превышающие лимиты бесплатного тарифа, переводятся в состояние ограниченного доступа; загруженные материалы сохраняются в течение установленного срока и восстанавливаются при возобновлении подписки.

1. Сотрудник самостоятельно регистрирует учётную запись (раздел 3).
2. Владелец проекта открывает страницу проекта в личном кабинете, вызывает меню ⚙ → «Настройки» и переходит на вкладку «Доступ».
3. Добавляет сотрудника по адресу электронной почты. Количество соавторов на проект ограничено тарифом.
4. Доступ отзывается в том же разделе; после отзыва сотрудник теряет права на проект немедленно.

Плагины для Cinema 4D и 3ds Max подключаются к учётной записи персональным токеном доступа.

1. В личном кабинете откройте раздел «Профиль» → блок «Токены для плагинов» и нажмите «Создать токен». Укажите название, область действия (все проекты или конкретный проект) и срок действия.
2. Скопируйте значение токена — оно отображается однократно в момент создания. При включённой двухфакторной аутентификации потребуется ввести одноразовый код.
3. Установите плагин по инструкции для Cinema 4D или 3ds Max и введите токен в окне подключения.
4. Токен можно отозвать в любой момент; фиксируется дата и факт его использования.

Установка плагина сводится к копированию каталога плагина в пользовательскую папку расширений соответствующего 3D-редактора и перезапуску программы. Плагины не являются обязательными: модель и панорамы можно загрузить через веб-интерфейс.

1. В редакторе панорам выберите действие «Подключить телефон» — на экране появится QR-код сопряжения с ограниченным сроком действия.
2. Отсканируйте код камерой смартфона и откройте предложенный адрес в браузере устройства.
3. Мобильный веб-клиент связывается с учётной записью, после чего панорамы со смартфона загружаются в выбранный проект.
4. Установка приложения из магазина приложений не требуется — используется веб-клиент.

Готовый тур можно выгрузить из платформы единым архивом и разместить на любом веб-сервере заказчика, в том числе во внутренней сети без доступа к сети «Интернет». Экспортированный тур автономен: он не обращается к серверам правообладателя и не требует наличия учётной записи для воспроизведения.

Выгрузка архива

1. Откройте страницу проекта в личном кабинете.
2. Нажмите значок ⚙ и выберите пункт «Настройки».
3. На вкладке «Основное» в блоке «Экспорт» нажмите «Экспорт 360°-тура (ZIP)» или «Экспорт 3D-тура (ZIP)» и подтвердите операцию.
4. Сервер собирает пакет и выдаёт одноразовую ссылку скачивания. Для больших проектов сборка занимает несколько минут — не закрывайте окно браузера.

Доступность экспорта определяется тарифом. Если функция недоступна, кнопка предлагает перейти к оплате.

Требования к серверу размещения

• Любой веб-сервер статических файлов: nginx, Apache HTTP Server, встроенные средства хостинга, объектное хранилище с раздачей по HTTP.
• Среда выполнения приложений, база данных и серверные модули не нужны.
• Рекомендуется настроить корректные MIME-типы для файлов .js, .json, .webp, .glb, .ktx2, .wasm — большинство серверов делает это по умолчанию.
• Для работы режима виртуальной реальности сайт должен обслуживаться по протоколу HTTPS.
• Дисковое пространство — по фактическому объёму архива (как правило, от нескольких десятков мегабайт до нескольких гигабайт в зависимости от количества панорам и выбранного разрешения).

Состав архива:

index.html      — страница тура (описание тура встроено в файл)
assets/         — скрипты, стили, шрифты, иконки просмотрщика
data/           — служебные данные тура
panos/          — панорамные изображения

1. Распакуйте архив.
2. Скопируйте содержимое (файл index.html и каталоги рядом с ним) в каталог веб-сервера, например /var/www/example.ru/tour/.
3. Откройте адрес каталога в браузере: https://example.ru/tour/.

Данные тура встроены непосредственно в index.html, поэтому пакет не обращается к сети за содержимым тура. При этом скрипты просмотрщика подключаются как модули ECMAScript, и браузер блокирует их при открытии файла напрямую с локального диска (протокол file://). Для просмотра пакета нужен веб-сервер — подойдёт любой локальный веб-сервер в сети заказчика; подключение к сети «Интернет» при этом не требуется.

Состав архива:

index.html      — страница тура
viewer/         — код просмотрщика (скрипты, стили, шрифты)
project/        — 3D-модель (GLB), панорамы, теги, настройки тура
.htaccess       — рекомендуемые заголовки кэширования (для Apache)

1. Распакуйте архив.
2. Скопируйте содержимое в каталог веб-сервера, например /var/www/example.ru/3d-tour/.
3. Убедитесь, что сервер отдаёт файлы каталогов viewer/ и project/ без ограничений по расширению.
4. Откройте адрес каталога в браузере: https://example.ru/3d-tour/.

После предоставления доступа или установки пакета проверьте:

• страница тура открывается, изображение панорамы отображается и вращается;
• работают переходы между сценами и список сцен;
• открываются информационные точки и панель мини-карты;
• для объёмного тура — выполняется перемещение по сцене нажатием на пол и загружается трёхмерная модель;
• работает полноэкранный режим;
• тур корректно отображается на смартфоне.

Локальная версия программы предназначена для работы на оборудовании организации без подключения к сети «Интернет». Раздел адресован службе информационных технологий заказчика: получение дистрибутива, его проверка, установка на рабочие места, активация, обновление и удаление. Поставляемая версия работает под управлением Windows (x64); сборка для отечественных дистрибутивов Linux выполняется по запросу, состав поставки и срок фиксируются в договоре.

14.1. Состав поставки и получение дистрибутива

Дистрибутив передаёт правообладатель в порядке, предусмотренном договором: на носителе, по защищённому каналу передачи файлов или через уполномоченного представителя заказчика. Публичная загрузка дистрибутива из сети «Интернет» не предусмотрена: программа не размещается в открытом доступе для скачивания. Доступ к дистрибутиву открывается после заключения договора и его оплаты — заказчик получает установочный файл с контрольной суммой и выданный на его организацию файл лицензии. Для проведения экспертизы дистрибутив и проверочный файл лицензии с ограниченным сроком действия предоставляются вне общего порядка возмездной поставки — по прямой ссылке, указанной в заявлении, без обращения к специалистам правообладателя. Для ознакомления дистрибутив и проверочный файл лицензии передаются правообладателем непосредственно.

Для организаций государственного сектора предусмотрена ознакомительная (демонстрационная) передача программы: по письменному запросу правообладатель передаёт дистрибутив и файл лицензии на одно рабочее место сроком действия 30 календарных дней для оценки программы перед закупкой. Ознакомительная лицензия предоставляется безвозмездно и не ограничивает состав функций программы; иные условия ознакомления — большее количество рабочих мест либо иной срок — согласуются с правообладателем отдельно. Порядок передачи тот же, что и при поставке по договору: публичная загрузка дистрибутива из сети «Интернет» не предусмотрена и в этом случае.

• vpano-setup-<версия>.exe — установщик программы (x64, русский интерфейс установки);
• SHA256SUMS.txt — контрольная сумма установщика;
• license.json — файл лицензии организации, выдаётся отдельно по договору;
• руководство пользователя и настоящая инструкция по установке.

Дистрибутив самодостаточен: он ничего не загружает из сети ни во время установки, ни при работе программы. Отдельные среды исполнения (.NET, Java, Visual C++ Redistributable) не требуются. Рекомендуется разместить установщик на внутреннем файловом ресурсе с ограниченным доступом на запись и выполнять установку рабочих мест с него.

14.2. Проверка подлинности дистрибутива

Контрольная сумма вычисляется при каждой сборке и поставляется в файле SHA256SUMS.txt вместе с установщиком; у каждой версии сумма своя. Проверка выполняется одной из команд:

Get-FileHash .\vpano-setup-<версия>.exe -Algorithm SHA256 | Format-List
certutil -hashfile vpano-setup-<версия>.exe SHA256

Полученное значение должно совпасть со значением из SHA256SUMS.txt (регистр букв значения не имеет). При несовпадении установку выполнять нельзя — файл повреждён при передаче или подменён, дистрибутив следует запросить повторно.

14.3. Требования к рабочему месту

• Операционная система: Windows 10 (64-разрядная) или Windows 11; только x64, 32-разрядной сборки нет.
• Оперативная память: не менее 4 ГБ, рекомендуется 8 ГБ.
• Свободное место: около 450 МБ для программы (в проводнике Windows отображается как ≈ 430 МБ); на время установки требуется ещё около 150 МБ. Папки туров занимают место дополнительно.
• Графика: достаточно встроенной, отдельная видеокарта не требуется. Обязательна поддержка WebGL 2.0 (OpenGL ES 3.0) — просмотр панорам построен на ней, режима работы через WebGL 1.0 нет. Если аппаратное ускорение недоступно (нет драйвера видеоадаптера, работа в терминальной сессии, ускорение отключено политикой), включается программная отрисовка: изображение будет получено, поворот панорамы станет заметно медленнее.
• Экран: не менее 1024×768 точек (минимальный размер окна программы — 1024×700 точек); рекомендуется 1920×1080.
• Права при установке: обычный пользователь при установке в профиль; права администратора нужны только при установке для всех пользователей компьютера.
• Доступ в сеть «Интернет»: не требуется. Дополнительное программное обеспечение не требуется.

14.4. Порядок установки на одно рабочее место

1. Скопировать установщик на рабочее место или запустить его с внутреннего сетевого ресурса.
2. Запустить установщик; интерфейс установки — русский. При необходимости изменить папку установки.
3. По умолчанию программа устанавливается для текущего пользователя, права администратора не требуются.
4. Установщик создаёт ярлык программы на рабочем столе и в меню «Пуск», связывает файлы .vpano с программой и добавляет запись в список установленных программ Windows.
5. После установки выполнить проверку из раздела 14.6 и установить лицензию по разделу 14.5.

Исполняемый файл называется vpano.exe — латиницей, специально для развёртывания сценариями. Настройки и лицензия в реестр Windows не записываются: в реестре присутствуют только штатные записи об установленной программе и о связи расширения файлов.

14.5. Активация файлом лицензии без подключения к сети

Лицензия представляет собой подписанный файл license.json, который правообладатель выдаёт по договору. Ключей активации, обращения к серверу лицензий и привязки к оборудованию нет; подпись проверяется внутри программы, сетевые обращения при этом не выполняются.

• Пользователем: на начальном экране нажать «Загрузить лицензию» и выбрать полученный файл — программа проверит подпись и поместит файл в каталог данных пользователя.
• Службой ИТ: скопировать license.json в каталог %APPDATA%\vpano\ профиля пользователя; программа прочитает файл при следующем запуске. Имя файла должно быть в точности license.json.
• Продление: новый файл лицензии кладётся на место прежнего либо загружается той же кнопкой; переустановка программы не требуется.
• Снятие лицензии с рабочего места: удалить файл license.json из каталога данных пользователя. Туры при этом остаются и доступны для открытия, просмотра и экспорта.

Число рабочих мест указано в файле лицензии, поскольку оно указано в договоре; программа его не проверяет — контроль количества установок остаётся организационной мерой на стороне лицензиата.

14.6. Проверка установки — режим --selftest

Команда vpano.exe --selftest выполняется без открытия окна и проверяет комплектность установки: версию программы и формат проекта, наличие шаблона просмотрщика, языковых пакетов и справки, работоспособность модуля обработки изображений, доступность каталога данных пользователя. Код возврата 0 — всё на месте, 1 — чего-то не хватает; в выводе перечислены проверенные пути. Вывод проверки удобно прикладывать к акту приёмки и к обращениям в техническую поддержку.

$p = Start-Process -FilePath "$env:LOCALAPPDATA\Programs\vpano\vpano.exe" `
     -ArgumentList "--selftest" -Wait -PassThru -RedirectStandardOutput "$env:TEMP\selftest.txt"
$p.ExitCode

14.7. Массовое развёртывание сценарием или групповой политикой

Установщик собран средствами NSIS и принимает стандартные ключи: /S — тихая установка без окон, /D=<путь> — папка установки (указывается последним и без кавычек, даже если путь содержит пробелы), /allusers — установка для всех пользователей компьютера (требует прав администратора), /currentuser — установка только для текущего пользователя (поведение по умолчанию).

\\fileserver\distr\vpano\vpano-setup-<версия>.exe /S
\\fileserver\distr\vpano\vpano-setup-<версия>.exe /S /allusers /D=C:\Program Files\vpano

• По умолчанию программа устанавливается в профиль пользователя, поэтому распространение через политику «Установка программ» (MSI) невозможно — применяются сценарий входа, средство управления рабочими местами или установка для всех пользователей ключом /allusers.
• Файл лицензии размещается в профиле каждого пользователя, который будет работать с программой.
• Установщик не перезагружает компьютер и не требует перезагрузки.
• При развёртывании через политики ограниченного использования программ (SRP, AppLocker) установщик и vpano.exe вносятся в правила по пути или по хэшу.

14.8. Обновление в закрытом контуре

Автоматического обновления нет: программа не обращается в сеть «Интернет» и не проверяет наличие новых версий. Новые версии распространяет служба информационных технологий организации по внутреннему каналу.

1. Получить новый дистрибутив и сверить его контрольную сумму (14.2).
2. Закрыть программу на рабочем месте.
3. Запустить новый установщик — он устанавливается поверх прежней версии в ту же папку; удалять прежнюю версию не нужно. Для тихого обновления применяются те же ключи, что и при установке.
4. Выполнить vpano.exe --selftest и убедиться, что показана новая версия и код возврата равен нулю.

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

14.9. Удаление программы

Удаление выполняется штатными средствами Windows («Параметры» → «Приложения») либо тихой командой удаления из папки установки. Удаляются программа и её файлы, ярлыки, связь расширения .vpano и запись в списке установленных программ.

Намеренно сохраняются туры пользователя, где бы они ни находились, и данные пользователя — файл лицензии, библиотека значков и медиафайлов, список недавних туров. Это сделано потому, что удаление программы в организации почти всегда является частью переустановки или переноса рабочего места. Полное удаление вместе с данными пользователя выполняется ключом --delete-app-data либо удалением каталога данных вручную; папки туров не затрагиваются ни в одном из вариантов.

14.10. Поведение по окончании срока действия лицензии

Лицензия может быть срочной (как правило, годовой) или бессрочной. За 30, 14 и 7 дней до окончания срока программа показывает предупреждение. По окончании срока данные не теряются и ничего не блокируется до оплаты:

• остаются доступными открытие тура, просмотр, экспорт готового тура и сохранение копии тура — без ограничения по времени;
• становятся недоступны создание тура, изменение сцен, точек перехода, этажей и настроек, загрузка панорам, значков и медиафайлов.

Для продления правообладатель выдаёт новый файл лицензии; он загружается той же кнопкой, переустановка программы не требуется.

14.11. Разграничение локальной и облачной версий

Формы поставки различаются составом функций. В локальной версии целенаправленно отсутствуют возможности, требующие серверной части и подключения к сети:

• нет учётной записи, входа, облачного хранилища и совместной работы нескольких пользователей;
• нет публикации тура в сети «Интернет» и встраивания на сторонний сайт — готовый тур выгружается папкой и размещается на веб-сервере организации;
• нет работы с трёхмерными моделями: объёмные 3D-туры создаются только в облачной версии;
• нет автоматического обновления через сеть «Интернет»;
• нет версии для операционных систем, отличных от Windows.

Готовый тур, собранный локальной версией, размещается на веб-сервере организации так же, как экспортированный пакет из облачной версии (разделы 10–11): открытие файла тура напрямую с диска браузером не поддерживается, доступ в сеть «Интернет» при этом не требуется. Посмотреть результат до размещения можно средством предварительного просмотра в самой программе.

• Облачная версия. Обновление серверной и клиентской частей выполняется правообладателем централизованно. Действия со стороны пользователя не требуются: при следующем открытии страницы браузер получает актуальную версию.
• Локальная версия. Обновление выполняется установкой нового дистрибутива поверх прежней версии силами службы информационных технологий организации; обращений в сеть «Интернет» программа не выполняет. Порядок описан в разделе 14.8.
• Перечень изменений публикуется в разделе «История обновлений».
• Ранее выгруженные автономные пакеты продолжают работать без изменений; для получения новой версии просмотрщика достаточно повторно выгрузить архив.
• Техническая поддержка: kontakt@vpano.ru, +7 (919) 498-96-98. Обращения принимаются также через форму обратной связи в личном кабинете.
• Пользовательская документация постоянно доступна по адресу vpano.ru/docs.