1С: как установить модули расширения веб-сервера

Модули расширения веб-сервера в 1С — это компоненты, которые позволяют веб-серверу (IIS или Apache) обрабатывать запросы к информационным базам. Без них невозможна публикация базы на веб-сервере: пользователи не смогут работать через браузер или тонкий клиент по протоколу HTTP, а также не будут функционировать веб-сервисы и HTTP-сервисы, описанные в конфигурации.

Установка модулей расширения выполняется с того же дистрибутива платформы 1С:Предприятие, что и основные компоненты, но этот пункт часто пропускают при выборочной установке. В результате при публикации базы возникают ошибки вида «404 Not Found», «500 Internal Server Error» или сообщение о том, что модуль обработки запросов не найден.

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

Когда нужны модули расширения веб-сервера

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

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

Подготовка: что проверить перед установкой

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

Также проверьте разрядность. Если веб-сервер работает в 64-битном режиме, нужны 64-битные модули расширения. Для IIS это определяется настройкой пула приложений (Enable 32-Bit Applications), для Apache — разрядностью самого веб-сервера. Несовпадение разрядности приводит к ошибке загрузки модуля.

Для IIS заранее установите компоненты Windows: сам IIS, а также «Расширения ISAPI» и «Фильтры ISAPI» (для классического режима) либо CGI. Без них публикация завершится ошибкой или база будет недоступна.

Установка модулей расширения в Windows

Запустите установщик платформы 1С:Предприятие (setup.exe из дистрибутива) и выберите изменение существующей установки либо новую установку. В списке компонентов отметьте пункт «Модули расширения веб-сервера» (в английском интерфейсе — Web server extension modules) и завершите установку.

После установки в каталоге платформы (обычно C:\Program Files\1cv8\<номер версии>\bin) появятся файлы модулей: wsisapi.dll для IIS и wsap24.dll (или wsap22.dll для старых версий Apache 2.2) для Apache. Их наличие — признак того, что компонент установлен.

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

1. 1
   Запустите setup.exe из дистрибутива платформы той же версии, что использует база
2. 2
   Выберите «Изменить» существующую установку или новую установку
3. 3
   Отметьте компонент «Модули расширения веб-сервера»
4. 4
   Завершите установку и проверьте наличие wsisapi.dll в каталоге bin платформы
5. 5
   Перезапустите веб-сервер (iisreset или перезапуск Apache)

Публикация базы через конфигуратор

После установки модулей базу нужно опубликовать. Откройте конфигуратор под пользователем с правами администратора и перейдите в меню «Администрирование» → «Публикация на веб-сервере». Укажите имя публикации (латиницей, без пробелов), тип веб-сервера (IIS или Apache) и каталог, где будет создан файл default.vrd.

На вкладках диалога отметьте, что именно публикуется: тонкий и веб-клиент, веб-сервисы, HTTP-сервисы, OData. Публиковать лишнее не стоит — каждый открытый интерфейс расширяет поверхность атаки. После нажатия «Опубликовать» конфигуратор создаст виртуальный каталог и настройки веб-сервера.

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

Настройка Apache вручную

Для Apache публикация обычно выполняется утилитой webinst из каталога bin платформы, либо вручную редактированием httpd.conf. Утилита автоматически добавляет нужные строки в конфигурацию и создаёт каталог публикации.

При ручной настройке в httpd.conf добавляется загрузка модуля и секция Location с указанием пути к default.vrd. Типовой фрагмент выглядит так:

LoadModule _1cws_module "C:/Program Files/1cv8/8.3.22.1750/bin/wsap24.dll"
Alias "/mybase" "C:/inetpub/mybase"
<Location "/mybase">
    SetHandler 1c-application
    ManagedApplicationDescriptor "C:/inetpub/mybase/default.vrd"
</Location>

После правки конфигурации Apache обязательно перезапустите службу — изменения подхватываются только при перезапуске. Проверьте синтаксис командой httpd -t (или apachectl configtest в Linux), чтобы не уронить веб-сервер из-за опечатки.

Проверка результата

Откройте в браузере адрес вида http://имя-сервера/имя-публикации. Если всё настроено верно, загрузится страница входа веб-клиента или стартовая страница со ссылками на клиенты. Ошибка 404 означает, что публикация не создана или адрес указан неверно; ошибка 500 указывает на проблему с загрузкой модуля — чаще всего разрядность или отсутствие компонента.

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

Типичные ошибки и ограничения

Самая распространённая ошибка — установка модулей от другой версии платформы. Публикация, созданная под 8.3.22, не заработает с модулями от 8.3.18: либо перепубликуйте базу под нужную версию, либо доустановите модули нужной версии.

Вторая частая проблема — права доступа. Для файловых баз учётная запись пула IIS или службы Apache должна иметь полный доступ к каталогу базы. Для клиент-серверных баз проверьте, что в default.vrd корректно указаны имя сервера 1С и имя базы в кластере.

Учтите ограничение: веб-клиент требует, чтобы на сервере были установлены и лицензии платформы были доступны (для файловых баз — программная лицензия активируется на веб-сервере). Также помните, что 32-битный Apache не загрузит 64-битный модуль и наоборот.

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