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

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

Для IIS используется ISAPI-модуль wsisapi.dll, для Apache — собственный модуль веб-сервера 1С (например, wsap24.so или wsap24.dll в зависимости от версии Apache). Оба входят в состав дистрибутива платформы, но ставятся отдельным пунктом установщика. Ниже разобран полный порядок: от проверки разрядности до публикации базы и диагностики типовых сбоев.

Что такое модуль расширения веб-сервера и когда он нужен

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

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

Проверка требований перед установкой

Перед установкой убедитесь, что сам веб-сервер уже развёрнут. Для IIS это означает, что роль «Веб-сервер (IIS)» добавлена в Windows, причём включены компоненты ISAPI-расширения и фильтры ISAPI — без них wsisapi.dll не заработает. Для Apache нужна установленная и запущенная служба Apache версии, совместимой с модулем 1С (платформа поставляет модули под конкретные версии Apache, обычно 2.2 и 2.4).

Ключевое требование — совпадение разрядности. 32-битный модуль не загрузится в 64-битный Apache и наоборот. Для IIS разрядность определяется настройкой пула приложений «Enable 32-Bit Applications»: если пул 64-битный, нужен 64-битный модуль. Узнать разрядность Apache можно в документации к дистрибутиву или по каталогу установки.

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

Установка модуля расширения из дистрибутива платформы

Модуль входит в состав дистрибутива 1С:Предприятия, но по умолчанию при типовой установке может быть не выбран. Запустите setup.exe из каталога дистрибутива той же версии платформы, которая используется на сервере. Если платформа уже установлена, установщик предложит режим «Изменить» — выберите его.

В дереве компонентов найдите пункт «Модуль расширения веб-сервера» (в английском интерфейсе — Web server extension module) и установите для него вариант «Данный компонент будет установлен на локальный жесткий диск». Завершите установку. Файлы модуля размещаются в каталоге платформы, обычно C:\Program Files\1cv8\<версия>\bin\ — там появятся wsisapi.dll и модули для Apache.

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

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

Настройка IIS для работы с модулем

Для IIS установки модуля недостаточно — веб-серверу нужно разрешить выполнение ISAPI-расширений. Откройте диспетчер служб IIS, выберите сервер и проверьте, что в компонентах Windows включены «Расширения ISAPI» и «Фильтры ISAPI» (раздел «Разработка приложений» в мастере добавления ролей). Если их не было — добавьте и перезапустите IIS.

При публикации из конфигуратора 1С большинство настроек создаётся автоматически: виртуальный каталог, сопоставление обработчика для wsisapi.dll, права на каталог. Если публикацию настраиваете вручную, потребуется добавить сопоставление модуля (Module Mapping) для пути * с указанием на wsisapi.dll и разрешить выполнение ISAPI-модуля в разделе «Ограничения ISAPI и CGI».

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

Настройка Apache для работы с модулем

Для Apache модуль подключается директивой LoadModule в файле httpd.conf. Путь к модулю зависит от версии Apache и платформы. Пример для Apache 2.4 на Windows:

LoadModule _1cws_module "C:/Program Files/1cv8/8.3.22.1750/bin/wsap24.dll"

Кроме загрузки модуля, в httpd.conf или в отдельном файле публикации описывается сама база: директивы Alias на виртуальный путь и блок Location с обработчиком 1С. Впрочем, публикация через конфигуратор формирует эти настройки автоматически — вручную править httpd.conf обычно приходится только при нестандартных сценариях.

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

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

Самый надёжный способ опубликовать базу — встроенный механизм конфигуратора. Откройте конфигуратор от имени администратора (это важно: без повышенных прав конфигуратор не сможет записать настройки в IIS или httpd.conf), перейдите в меню «Администрирование → Публикация на веб-сервере».

В диалоге укажите имя публикации (латиницей, без пробелов — оно станет частью URL), тип веб-сервера, каталог публикации и отметьте нужные варианты доступа: тонкий и веб-клиент, HTTP-сервисы, OData. Нажмите «Опубликовать». Если модуль расширения установлен корректно, публикация завершится без ошибок, и база станет доступна по адресу вида http://сервер/имя_публикации.

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

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

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

Ошибка 404 означает, что виртуальный каталог не создан или URL набран неверно. Ошибка 500 при обращении к IIS чаще всего говорит о несовпадении разрядности модуля и пула приложений либо о том, что ISAPI-расширение не разрешено. Ошибка 403 — о нехватке прав на каталог публикации. В Apache ошибки загрузки модуля видны в журнале error.log ещё на этапе старта службы.

Ограничения и безопасность

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

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

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