Утилита для публикации мобильных приложений и информационных баз в 1С

Утилита для публикации информационных баз и мобильных приложений 1С на веб-сервере называется webinst (полное имя исполняемого файла — webinst.exe в Windows и webinst в Linux). Она входит в состав платформы «1С:Предприятие» и устанавливается вместе с компонентой «Модули расширения веб-сервера». Именно webinst регистрирует расширение веб-сервера и создаёт файл публикации default.vrd, который описывает, какие базы, веб-сервисы и мобильные приложения доступны через HTTP.

Помимо утилиты командной строки, та же задача решается интерактивно: в конфигураторе 1С есть пункт меню «Администрирование → Публикация на веб-сервере». Этот диалог по сути является графической оболочкой над теми же механизмами — он формирует каталог публикации, файл default.vrd и настройки виртуального каталога веб-сервера. Для мобильных приложений используется отдельный пункт — публикация мобильного клиента, при которой веб-сервер начинает раздавать дистрибутив и обеспечивать работу мобильного приложения с базой.

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

Что такое webinst и где она находится

Webinst — консольная утилита, поставляемая в каталоге bin установленной версии платформы 1С. Типовой путь в Windows выглядит примерно так: C:\Program Files\1cv8\<номер версии>\bin\webinst.exe. В Linux утилита располагается в каталоге установки платформы, обычно /opt/1cv8/x86_64/<версия>/.

Утилита работает только при наличии установленных модулей расширения веб-сервера — этот компонент выбирается при установке платформы. Если при установке 1С компонент был пропущен, webinst либо отсутствует, либо не сможет зарегистрировать расширение, и публикацию придётся начинать с доустановки компонентов.

Поддерживаются два веб-сервера: Apache и IIS. Для каждого из них у webinst есть свой ключ, потому что механизм регистрации расширения и структура конфигурационных файлов у серверов различаются.

Интерактивная публикация через конфигуратор

Самый распространённый способ — публикация из конфигуратора. Откройте нужную базу в режиме конфигуратора и выберите «Администрирование → Публикация на веб-сервере». В диалоге укажите имя публикации (оно станет частью URL), каталог, где будет размещён файл default.vrd, и тип веб-сервера.

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

После нажатия кнопки «Опубликовать» конфигуратор создаёт каталог, записывает default.vrd и регистрирует виртуальный каталог на веб-сервере. Проверка результата — открыть в браузере адрес вида http://сервер/имя_публикации: должна открыться стартовая страница 1С или запуститься веб-клиент.

1. 1
   Убедитесь, что веб-сервер (Apache или IIS) установлен и запущен, а модули расширения веб-сервера 1С установлены
2. 2
   Откройте базу в конфигураторе и выберите «Администрирование → Публикация на веб-сервере»
3. 3
   Задайте имя публикации, каталог и тип веб-сервера, отметьте нужные сервисы
4. 4
   Нажмите «Опубликовать» и дождитесь сообщения об успешной публикации
5. 5
   Проверьте доступ по адресу http://сервер/имя_публикации в браузере и с мобильного устройства

Публикация из командной строки через webinst

Автоматизация удобна при развёртывании на нескольких серверах или в скриптах установки. Webinst вызывается с ключом -publish, указанием типа веб-сервера, имени публикации и пути к базе.

webinst -publish -apache24 -wsname mybase -dir "C:\inetpub\mybase" -connstr "Srvr=server1;Ref=trade;" -confpath "C:\Program Files\Apache24\conf\httpd.conf"

Ключ -wsname задаёт имя виртуального каталога, -dir — физический каталог публикации, -connstr — строку соединения с информационной базой (серверную или файловую). Для IIS вместо -apache24 используется ключ -iis, и путь к конфигурационному файлу не требуется.

Для удаления публикации служит ключ -delete с теми же параметрами имени и веб-сервера. Полный список ключей выводится запуском webinst без параметров или с ключом справки.

Публикация мобильного приложения

Мобильное приложение 1С публикуется на том же веб-сервере, что и основная база, либо отдельным виртуальным каталогом. В конфигураторе для этого предусмотрен механизм публикации мобильного клиента: платформа выкладывает в каталог публикации дистрибутив мобильного приложения и файл описания, по которому мобильная платформа находит базу и обновления.

Практический сценарий выглядит так: собранное мобильное приложение (или мобильный клиент) при первом запуске обращается по указанному URL, скачивает конфигурацию и далее работает с базой через опубликованные сервисы. Если в публикации не включены нужные веб-сервисы или HTTP-сервисы, мобильное приложение подключится, но часть функций будет недоступна.

Учтите, что мобильные устройства обычно находятся вне локальной сети, поэтому сервер публикации должен быть доступен извне — с корректным именем, открытым портом и желательно с TLS-сертификатом. Работа по открытому HTTP без шифрования означает передачу логинов и данных в открытом виде.

Проверка результата и типичные проблемы

Базовая проверка — обращение к URL публикации из браузера. Если вместо стартовой страницы 1С появляется ошибка 404, виртуальный каталог не зарегистрирован или неверно указано имя. Ошибка 500 чаще всего означает, что модуль расширения веб-сервера не загружен: проверьте, что версия модуля совпадает с версией платформы и что разрядность модуля соответствует веб-серверу.

Отдельный класс проблем — права доступа. Учётная запись, под которой работает веб-сервер, должна иметь чтение каталога публикации и доступ к файловой базе, если используется файловый режим. Для клиент-серверного режима проверяйте строку соединения: сервер 1С должен быть доступен с машины веб-сервера.

Когда какой способ выбрать

Для разовой публикации тестовой или рабочей базы проще и нагляднее диалог в конфигураторе: все параметры видны, а ошибки показываются сразу. Webinst оправдана при автоматизации: скрипты развёртывания, обновление публикаций на нескольких серверах, интеграция в процессы доставки конфигураций.

Ручное редактирование default.vrd используют, когда нужно включить или отключить отдельные сервисы без перепубликации. После правки файла изменения подхватываются веб-сервером, но синтаксис XML должен оставаться корректным — перед правкой делайте копию файла.

Частые вопросы