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

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

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

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

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

Для IIS используется модуль wsisapi.dll (ISAPI-расширение). Для Apache — wsap24.so или wsap22.so (в зависимости от версии Apache). Эти файлы устанавливаются вместе с платформой 1С:Предприятие, но требуют отдельной регистрации в веб-сервере.

Модули работают как посредники: принимают HTTP-запросы, конвертируют их в формат, понятный 1С, и передают обратно HTML-страницы, сформированные платформой. Без них связка «браузер — веб-сервер — 1С» не функционирует.

Проверка наличия модулей расширения

Перед установкой проверьте, действительно ли модули отсутствуют. Иногда они установлены, но неправильно зарегистрированы.

Проверка через Панель управления IIS

Откройте Диспетчер служб IIS (Win+R → inetmgr). В левой панели выберите сервер, справа откройте раздел Модули. Если модуль установлен, в списке будет запись 1C Enterprise 8.3 (номер версии может отличаться) с типом NativeModule.

Если записи нет — модуль не зарегистрирован. Если запись есть, но публикация базы всё равно не работает — проверьте путь к файлу wsisapi.dll в параметрах модуля. Он должен соответствовать реальному расположению файла.

Проверка через файловую систему

Модуль расширения для IIS находится в каталоге установки платформы 1С. Путь по умолчанию:

• C:\Program Files\1cv8\8.3.XX.XXXX\bin\wsisapi.dll — для 64-битной платформы
• C:\Program Files (x86)\1cv8\8.3.XX.XXXX\bin\wsisapi.dll — для 32-битной платформы

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

Проверка через конфигуратор 1С

Запустите конфигуратор 1С, откройте информационную базу. Перейдите в меню Администрирование → Публикация информационной базы. Если при попытке публикации появляется ошибка «Не установлены модули расширения веб-сервера» — компоненты действительно отсутствуют или повреждены.

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

Модули расширения устанавливаются вместе с платформой 1С:Предприятие, но требуют дополнительной настройки веб-сервера. Процесс различается для IIS и Apache — рассмотрим оба варианта.

Если модуль не появился в списке — выполните ручную регистрацию.

Настройка разрешений ISAPI и CGI

После регистрации модуля необходимо разрешить выполнение ISAPI-расширений в IIS. Без этого веб-сервер заблокирует запросы к 1С.

1. В Диспетчере служб IIS выберите сервер, откройте раздел Ограничения ISAPI и CGI.
2. Нажмите Добавить. В поле Путь укажите полный путь к wsisapi.dll.
3. В поле Описание введите 1C Enterprise Extension. Установите флажок Разрешить выполнение пути расширения.
4. Нажмите ОК и перезапустите IIS.

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

Для веб-сервера Apache используется модуль wsap24.so (Apache 2.4) или wsap22.so (Apache 2.2). Процесс установки отличается от IIS.

Диагностика ошибок установки

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

Ошибка «HTTP Error 404.2 – Not Found»

Возникает, когда IIS блокирует ISAPI-расширения на уровне сервера. Решение: добавьте wsisapi.dll в раздел Ограничения ISAPI и CGI (см. инструкцию выше). Убедитесь, что установлен флажок Разрешить выполнение.

Ошибка «HTTP Error 500 – Internal Server Error»

Указывает на проблему с самим модулем или его конфигурацией. Проверьте:

• Разрядность модуля совпадает с разрядностью пула приложений IIS (x86 или x64).
• Путь к wsisapi.dll в настройках модуля указан корректно.
• Файл wsisapi.dll не повреждён (переустановите платформу 1С).

Ошибка «Модуль не найден» при загрузке Apache

Apache не может найти файл wsap24.so. Проверьте:

• Путь в директиве LoadModule указан правильно (относительно каталога Apache).
• Файл модуля действительно скопирован в папку modules.
• Разрядность модуля соответствует разрядности Apache (32-бит или 64-бит).

Ошибка «Не удаётся загрузить библиотеку»

Возникает, если отсутствуют зависимые компоненты платформы 1С. Убедитесь, что установлены:

• Microsoft Visual C++ Redistributable (версия, соответствующая платформе 1С).
• Все компоненты платформы 1С:Предприятие (клиент-серверный вариант, технологическая платформа).

Частые проблемы и их решение

Проблема	Причина	Решение
Модуль установлен, но не отображается в IIS	Не выполнена регистрация в веб-сервере	Зарегистрируйте модуль вручную через Диспетчер IIS
Публикация базы завершается ошибкой 404.2	ISAPI-расширение заблокировано в ограничениях IIS	Добавьте wsisapi.dll в список разрешённых ISAPI
После обновления 1С модуль перестал работать	Путь к модулю в IIS указывает на старую версию	Обновите путь в настройках модуля на актуальную версию
Ошибка 500 при обращении к базе через браузер	Несоответствие разрядности модуля и пула приложений	Установите правильную разрядность пула (x86 или x64)
Apache не запускается после установки модуля	Неверный синтаксис в httpd.conf	Проверьте конфигурацию командой httpd -t, исправьте ошибки
Модуль установлен, но база не публикуется	Недостаточно прав у учётной записи пула приложений	Предоставьте пулу права на чтение каталога установки 1С

Настройка прав доступа для модуля

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

1. Откройте свойства каталога C:\Program Files\1cv8\ (или другого каталога установки платформы).
2. Перейдите на вкладку Безопасность, нажмите Изменить.
3. Добавьте учётную запись пула приложений (обычно IIS AppPool\DefaultAppPool или кастомное имя).
4. Предоставьте права Чтение и выполнение, Список содержимого папки, Чтение.
5. Нажмите ОК и перезапустите пул приложений в IIS.

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

После установки и настройки проверьте, что модуль работает корректно.

Тестирование через конфигуратор 1С

Запустите конфигуратор, откройте информационную базу. Перейдите в меню Администрирование → Публикация информационной базы. Укажите:

• Имя публикации — краткое имя базы для URL (например, test).
• Каталог виртуального приложения — физический путь, где IIS создаст веб-приложение.
• Веб-сервер — выберите IIS или Apache из списка.

Нажмите Опубликовать. Если ошибок нет — откройте браузер и введите адрес http://localhost/test (замените test на имя вашей публикации). Должна открыться форма входа в базу 1С.

Проверка через браузер

Откройте браузер и перейдите по адресу публикации. Если страница загружается и отображается интерфейс 1С — модуль работает. Если возникает ошибка 404, 500 или «Страница недоступна» — вернитесь к диагностике (см. раздел выше).

Проверка логов веб-сервера

Если публикация не работает, проверьте логи IIS или Apache. Для IIS логи находятся в C:\inetpub\logs\LogFiles\. Найдите файл с текущей датой и откройте его текстовым редактором. Ищите записи с кодами ошибок 404, 500 или 503 — они укажут на конкретную проблему.

Для Apache логи находятся в каталоге установки (обычно C:\Apache24\logs\). Файл error.log содержит сообщения об ошибках загрузки модуля или обработки запросов.

Особенности установки на Windows Server

При установке модулей на серверных версиях Windows учитывайте дополнительные требования.

Роль веб-сервера IIS

Убедитесь, что роль Веб-сервер (IIS) установлена и настроена. В Диспетчере серверов перейдите в Управление → Добавить роли и компоненты. В разделе Роли сервера отметьте Веб-сервер (IIS) и установите компоненты:

• Средства управления — консоль управления IIS.
• Общие функции HTTP — статические файлы, документы по умолчанию.
• Разработка приложений — расширения ISAPI, фильтры ISAPI.

Политики безопасности

На Windows Server действуют более строгие политики безопасности. После установки модуля проверьте:

• Брандмауэр Windows — разрешите входящие подключения на порт 80 (HTTP) или 443 (HTTPS).
• Контроль учётных записей (UAC) — выполняйте установку и регистрацию модуля с правами администратора.
• Права файловой системы — предоставьте пулу приложений IIS доступ к каталогу платформы 1С.

Обновление модулей при обновлении платформы 1С

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

Правильная последовательность обновления

1. Закройте все сеансы работы с информационными базами (клиенты, веб-клиенты, фоновые задания).
2. Остановите пулы приложений IIS, в которых опубликованы базы 1С.
3. Запустите установщик новой версии платформы 1С.
4. При выборе компонентов убедитесь, что отмечен пункт «Модули расширения веб-сервера».
5. Завершите установку, перезапустите IIS командой iisreset.
6. Откройте Диспетчер IIS, проверьте путь к wsisapi.dll в параметрах модуля — он должен указывать на новую версию.
7. Запустите пулы приложений, проверьте работу баз через браузер.

Использование нескольких версий платформы 1С

Если на сервере установлены несколько версий платформы 1С, каждая имеет собственный модуль расширения. IIS может зарегистрировать только один модуль с именем «1C Enterprise». При смене версии необходимо перерегистрировать модуль.

Переключение между версиями модулей

1. Откройте Диспетчер IIS, выберите сервер, перейдите в раздел Модули.
2. Найдите модуль 1C Enterprise, откройте его параметры.
3. Измените путь в поле Исполняемый файл на актуальную версию платформы.
4. Сохраните изменения, перезапустите IIS.

Альтернативный вариант — регистрировать модули с разными именами (например, 1C Enterprise 8.3.22 и 1C Enterprise 8.3.24), чтобы они не конфликтовали. В этом случае при публикации базы в конфигураторе указывайте нужный модуль.

Требования к серверному оборудованию

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

Минимальные требования

• Процессор: 4 ядра, 2.5 GHz (для 10-20 пользователей).
• Оперативная память: 8 GB (рекомендуется 16 GB для баз от 50 GB).
• Дисковая подсистема: SSD или RAID-массив с высокой скоростью чтения/записи.
• Сеть: 1 Gbps для локальной сети, качественный интернет-канал для удалённых пользователей.

Рекомендации по масштабированию

При росте числа пользователей увеличивайте ресурсы сервера:

• 50-100 пользователей: 8-16 ядер процессора, 32 GB ОЗУ, NVMe SSD.
• 100-200 пользователей: 16-24 ядра, 64 GB ОЗУ, отдельный сервер под SQL или PostgreSQL.
• Более 200 пользователей: кластер серверов 1С, балансировка нагрузки через несколько веб-серверов.

Для крупных инфраструктур используйте серверы с аппаратной избыточностью: резервные блоки питания, RAID-контроллеры, ECC-память. Это снижает риск простоев из-за отказа оборудования.

Настройка HTTPS для веб-публикации 1С

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

Установка SSL-сертификата в IIS

1. Получите SSL-сертификат (у коммерческого центра сертификации или бесплатный через Let's Encrypt).
2. Откройте Диспетчер IIS, выберите сервер, перейдите в раздел Сертификаты сервера.
3. Импортируйте сертификат (файл .pfx или .cer) и закрытый ключ.
4. Выберите сайт с публикацией 1С, в правой панели нажмите Привязки.
5. Добавьте привязку https, порт 443, выберите установленный сертификат.
6. Сохраните изменения и проверьте доступ к базе через https://.

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