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

При публикации информационной базы 1С в веб вы можете столкнуться с ошибкой «Модули расширения не установлены» или «Необходимо установить модули расширения web-сервера 1С Предприятие». Это значит, что веб-сервер не может взаимодействовать с платформой 1С. Статья поможет системным администраторам и специалистам по 1С устранить эту проблему на серверах под управлением Windows и Linux.

Модули расширения — это библиотеки, которые обеспечивают передачу HTTP-запросов от веб-сервера к серверу приложений 1С. Без них пользователи не смогут открыть базу через браузер. Установка занимает 10-15 минут и не требует перезагрузки сервера в большинстве случаев.

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

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

Для каждого веб-сервера существует свой тип модуля:

IIS (Internet Information Services) — использует модуль wsisapi.dll, который работает по протоколу ISAPI
Apache — использует модуль wsap24.so (для Apache 2.4) по протоколу FastCGI
nginx — работает напрямую с сервером приложений 1С через FastCGI без отдельного модуля

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

Причины появления ошибки

Ошибка «Модули расширения не установлены» возникает по нескольким причинам:

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

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

Где находятся файлы модулей расширения

Файлы модулей расширения устанавливаются вместе с платформой 1С:Предприятие. Расположение зависит от операционной системы и разрядности платформы.

Windows

На серверах под управлением Windows модули находятся в каталоге установки платформы. Путь по умолчанию:

64-разрядная платформа: C:\Program Files\1cv8\<версия>\bin\
32-разрядная платформа: C:\Program Files (x86)\1cv8\<версия>\bin\

Здесь находятся файлы:

wsisapi.dll — модуль для IIS
wsap24.dll — модуль для Apache 2.4 под Windows (используется редко)

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

Linux

На Linux-серверах модули расширения устанавливаются в системные каталоги:

/opt/1cv8/x86_64/<версия>/wsap24.so — для 64-разрядной платформы
/opt/1cv8/i386/<версия>/wsap24.so — для 32-разрядной платформы (устаревшая архитектура)

Модуль wsap24.so работает с Apache 2.4 через интерфейс FastCGI. Для nginx отдельный модуль не требуется — веб-сервер взаимодействует с сервером приложений 1С напрямую через FastCGI.

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

IIS (Internet Information Services) — стандартный веб-сервер Microsoft, который используется на Windows Server. Установка модуля wsisapi.dll выполняется в несколько этапов.

Шаг 1: Проверка наличия модуля

Откройте каталог установки платформы 1С, например C:\Program Files\1cv8\8.3.25.1257\bin\
Найдите файл wsisapi.dll — это модуль расширения для IIS
Если файла нет, переустановите платформу 1С:Предприятие с выбором компонента «Сервер 1С:Предприятия» — модули устанавливаются только вместе с серверной частью

Шаг 2: Копирование модуля в каталог веб-сервера

Создайте отдельный каталог для модулей 1С, например C:\inetpub\1c_modules\
Скопируйте файл wsisapi.dll в этот каталог
Убедитесь, что учётная запись пула приложений IIS (обычно IIS_IUSRS или ApplicationPoolIdentity) имеет права на чтение и выполнение файлов в этом каталоге

Шаг 3: Регистрация модуля в IIS

Откройте диспетчер IIS: Пуск → Администрирование → Internet Information Services (IIS) Manager
Выберите сервер в дереве слева, найдите раздел «Ограничения ISAPI и CGI»
Нажмите «Добавить» и укажите путь к файлу C:\inetpub\1c_modules\wsisapi.dll
Установите флажок «Разрешить выполнение пути расширения» и введите описание «1C Web Server Extension»

Шаг 4: Настройка виртуального каталога для информационной базы

В диспетчере IIS создайте новое приложение или виртуальный каталог, например /accounting
Укажите физический путь к каталогу, где будет находиться файл конфигурации, например C:\inetpub\wwwroot\accounting\
Создайте в этом каталоге пустой файл default.vrd — он служит маркером для модуля wsisapi.dll
Откройте раздел «Сопоставление обработчиков» для созданного приложения
Добавьте новое сопоставление модуля: путь запроса *.vrd, модуль IsapiModule, исполняемый файл C:\inetpub\1c_modules\wsisapi.dll

Шаг 5: Настройка публикации базы в 1С

Откройте консоль администрирования кластера серверов 1С (через rac.exe или веб-интерфейс)
Перейдите к информационной базе, выберите «Изменить» и откройте вкладку «Публикация»
Укажите имя публикации, например accounting, и сохраните изменения
Проверьте доступ по адресу http://<сервер>/accounting/ через браузер

Если настройка выполнена правильно, браузер откроет форму авторизации 1С. Если вместо неё появляется ошибка 500 или «Модули расширения не установлены», проверьте права доступа к файлу wsisapi.dll и правильность пути в сопоставлении обработчиков.

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

Apache — популярный веб-сервер для Linux. Модуль wsap24.so подключается через конфигурационные файлы и работает по протоколу FastCGI.

Шаг 1: Проверка установки платформы 1С

Убедитесь, что на сервере установлена серверная часть платформы 1С:Предприятие. Проверьте наличие каталога /opt/1cv8/x86_64/<версия>/
Найдите файл модуля расширения wsap24.so в каталоге установки
Если файла нет, переустановите серверную часть платформы с помощью установочного rpm или deb пакета

Шаг 2: Копирование модуля в каталог Apache

Скопируйте файл wsap24.so в каталог модулей Apache. Обычно это /usr/lib64/apache2/modules/ или /usr/lib/apache2/modules/ в зависимости от дистрибутива
Выполните команду: sudo cp /opt/1cv8/x86_64/8.3.25.1257/wsap24.so /usr/lib64/apache2/modules/
Установите права доступа: sudo chmod 755 /usr/lib64/apache2/modules/wsap24.so

Шаг 3: Подключение модуля в конфигурации Apache

Откройте файл конфигурации Apache. Путь зависит от дистрибутива: /etc/apache2/apache2.conf (Debian/Ubuntu) или /etc/httpd/conf/httpd.conf (RHEL/CentOS)
Добавьте строку загрузки модуля: LoadModule _1cws_module /usr/lib64/apache2/modules/wsap24.so
Создайте конфигурацию виртуального хоста или каталога для базы 1С

Шаг 4: Настройка виртуального каталога

Создайте файл конфигурации для базы, например /etc/apache2/conf.d/1c_accounting.conf
Добавьте в него блок настройки с указанием пути и параметров подключения к серверу приложений 1С
Укажите имя публикации базы, адрес и порт сервера приложений 1С (обычно localhost:1540)
Проверьте синтаксис конфигурации командой: sudo apachectl configtest
Перезапустите Apache: sudo systemctl restart apache2 или sudo systemctl restart httpd

Шаг 5: Настройка публикации в 1С

Откройте консоль администрирования кластера серверов 1С через утилиту rac или веб-интерфейс
Перейдите к настройкам информационной базы и укажите имя публикации, совпадающее с указанным в конфигурации Apache
Проверьте доступ к базе через браузер по адресу http://<сервер>/accounting/

Если после перезапуска Apache база не открывается, проверьте логи веб-сервера командой sudo tail -f /var/log/apache2/error.log или sudo tail -f /var/log/httpd/error_log. Частые ошибки — неправильный путь к модулю или отсутствие прав у процесса Apache на доступ к файлам платформы 1С.

Установка через встроенный мастер 1С

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

Запуск мастера на Windows

Откройте консоль администрирования сервера 1С через веб-интерфейс или десктопный клиент. Перейдите в раздел «Информационные базы», выберите нужную базу и нажмите кнопку «Настроить публикацию на веб-сервере». Мастер проверит наличие модулей расширения и предложит автоматически настроить IIS.

Утилита выполнит следующие действия:

Найдёт установленную версию IIS
Скопирует модуль wsisapi.dll в каталог C:\Program Files\1cv8\<версия>\bin\
Зарегистрирует модуль в списке разрешённых расширений ISAPI
Создаст виртуальный каталог с именем публикации
Настроит сопоставление обработчиков для файлов *.vrd

После завершения работы мастера база будет доступна по адресу http://<сервер>/<имя_публикации>/. Если мастер сообщает об ошибке, проверьте права учётной записи, от имени которой запущена консоль администрирования — она должна иметь права администратора на сервере.

Запуск мастера на Linux

На Linux-серверах мастер публикации работает через консольную утилиту webinst. Она входит в состав серверного дистрибутива платформы. Запустите утилиту командой:

sudo /opt/1cv8/x86_64/<версия>/webinst -apache24 -wsdir /opt/1cv8/x86_64/<версия> -dir /var/www/html/accounting -publish /accounting

Параметры команды:

-apache24 — тип веб-сервера (Apache 2.4)
-wsdir — каталог установки платформы 1С с модулем wsap24.so
-dir — физический путь к каталогу публикации
-publish — имя публикации в URL

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

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

После установки модулей расширения проверьте их работу. Откройте браузер и перейдите по адресу публикации информационной базы, например http://server.company.local/accounting/. Если всё настроено правильно, вы увидите форму авторизации 1С:Предприятие с полями для ввода имени пользователя и пароля.

Если вместо формы авторизации появляется ошибка, проверьте следующие моменты:

Ошибка 404 (страница не найдена) — неправильно указано имя публикации в настройках базы или виртуальный каталог не создан в веб-сервере
Ошибка 500 (внутренняя ошибка сервера) — модуль расширения не может обратиться к серверу приложений 1С, проверьте права доступа и работу службы rphost
Ошибка «Модули расширения не установлены» — файл модуля отсутствует или не зарегистрирован в конфигурации веб-сервера
Пустая страница или загрузка файла *.vrd — сопоставление обработчиков настроено неправильно, веб-сервер не передаёт запросы модулю

Для диагностики проблем используйте логи веб-сервера и технологический журнал 1С. В логах IIS ищите записи с кодом ошибки и путём к модулю wsisapi.dll. В технологическом журнале 1С проверяйте события с типом VRSREQUEST — они показывают, приходят ли запросы от веб-сервера к серверу приложений.

Типичные ошибки при установке

Недостаточно прав для выполнения модуля

Веб-сервер запускает модули расширения от имени специальной учётной записи с ограниченными правами. В IIS это обычно ApplicationPoolIdentity или IIS_IUSRS, в Apache — www-data или apache. Если эта учётная запись не имеет прав на чтение и выполнение файла модуля, появится ошибка доступа.

Решение для IIS: откройте свойства файла wsisapi.dll, перейдите на вкладку «Безопасность» и добавьте учётную запись IIS_IUSRS с правами «Чтение и выполнение». Также проверьте права на родительский каталог — они должны наследоваться.

Решение для Apache: выполните команду sudo chmod 755 /usr/lib64/apache2/modules/wsap24.so и убедитесь, что владелец файла — root, а группа — root или apache. Проверьте контекст безопасности SELinux командой ls -Z — файл должен иметь контекст httpd_modules_t.

Модуль не зарегистрирован в списке разрешённых ISAPI

IIS блокирует выполнение расширений ISAPI и CGI по умолчанию. Если модуль wsisapi.dll не добавлен в список разрешённых, при обращении к базе появится ошибка 404.3 с текстом «This type of page you have requested is not served because it has been explicitly forbidden».

Решение: откройте диспетчер IIS, выберите сервер на верхнем уровне и найдите раздел «Ограничения ISAPI и CGI». Проверьте, есть ли в списке запись для wsisapi.dll. Если её нет, добавьте вручную через кнопку «Добавить», укажите полный путь к файлу и установите флажок «Разрешить выполнение пути расширения».

Несовместимость версий модуля и платформы

Модули расширения привязаны к конкретной версии платформы 1С. Если на сервере установлено несколько версий (например, 8.3.20 и 8.3.25), а база работает на версии 8.3.25, но модуль скопирован из каталога 8.3.20, возникнет ошибка «Неверная версия модуля расширения».

Решение: проверьте версию платформы, на которой работает информационная база, через консоль администрирования кластера. Скопируйте модуль wsisapi.dll или wsap24.so из каталога установки этой же версии. Путь к файлу должен содержать номер версии, например C:\Program Files\1cv8\8.3.25.1257\bin\wsisapi.dll.

Не запущен сервер приложений 1С

Модуль расширения передаёт запросы серверу приложений 1С через локальную сеть или IPC. Если служба rphost не запущена или кластер серверов недоступен, браузер покажет ошибку «Сервер временно недоступен» или таймаут подключения.

Решение для Windows: откройте диспетчер служб (services.msc) и проверьте состояние службы «1C:Enterprise 8.3 Server Agent». Она должна быть запущена и работать в автоматическом режиме. Если служба остановлена, запустите её вручную.

Решение для Linux: выполните команду sudo systemctl status srv1cv83, чтобы проверить состояние службы сервера приложений. Если служба не запущена, выполните sudo systemctl start srv1cv83. Проверьте логи службы командой sudo journalctl -u srv1cv83 -n 50.

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

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

Параметр	До 10 пользователей	10-50 пользователей	50-100 пользователей
Процессор	4 ядра 2.4 ГГц	8 ядер 2.8 ГГц	16 ядер 3.0 ГГц
Оперативная память	8 ГБ	16 ГБ	32 ГБ
Дисковая подсистема	SATA SSD 240 ГБ	NVMe SSD 480 ГБ	RAID 10 на NVMe SSD
Сетевой интерфейс	1 Гбит/с	1 Гбит/с	10 Гбит/с

Если вы планируете развернуть инфраструктуру 1С на оборудовании Dell, обратите внимание на серверы для 1С — готовые конфигурации с протестированной совместимостью. Для высоконагруженных баз данных SQL или PostgreSQL подойдут серверы для баз данных с повышенным объёмом памяти и производительными дисковыми массивами.

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

Для таких сценариев подойдут rack-серверы Dell PowerEdge с возможностью установки в стандартную 19-дюймовую стойку. Они обеспечивают высокую плотность размещения, надёжную систему охлаждения и удобство обслуживания в серверной комнате.

Настройка производительности и отказоустойчивости

После установки модулей расширения оптимизируйте параметры веб-сервера для повышения производительности. В IIS настройте пул приложений: увеличьте максимальное количество рабочих процессов до числа ядер процессора, отключите автоматическую остановку при простое и установите интервал перезапуска 1440 минут (один раз в сутки).

В Apache настройте модуль mpm_worker или mpm_event для обработки большого количества одновременных соединений. Увеличьте параметры MaxRequestWorkers и ThreadsPerChild в зависимости от доступной оперативной памяти. Включите сжатие ответов через mod_deflate, чтобы снизить объём передаваемых данных и ускорить загрузку интерфейса 1С в браузере.

Для обеспечения отказоустойчивости используйте балансировщик нагрузки перед веб-серверами. Установите два или более сервера с модулями расширения и настройте распределение запросов через nginx, HAProxy или аппаратный балансировщик. Это позволит продолжить работу пользователей при выходе из строя одного из серверов.

Настройте мониторинг доступности веб-публикации через внешние системы (Zabbix, Prometheus, Nagios). Отслеживайте время отклика, количество ошибок 500 и загрузку процессора на серверах. При превышении пороговых значений система оповестит администраторов и поможет выявить проблемы до того, как они повлияют на пользователей.

Безопасность веб-публикации 1С

Публикация информационной базы в интернете требует дополнительных мер безопасности. Используйте HTTPS вместо HTTP для шифрования трафика между браузером пользователя и веб-сервером. Установите SSL-сертификат от доверенного центра сертификации или бесплатный сертификат Let's Encrypt.

Настройте фильтрацию IP-адресов на уровне веб-сервера или межсетевого экрана. Разрешите доступ к базе только с адресов офисной сети или VPN. Это защитит от попыток несанкционированного доступа из внешних сетей.

Включите двухфакторную аутентификацию для пользователей с повышенными правами (администраторы, бухгалтеры с доступом к финансовым данным). Платформа 1С поддерживает интеграцию с внешними системами аутентификации через LDAP или OAuth.

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

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

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

Можно ли использовать один модуль расширения для нескольких баз?

Да, один установленный модуль wsisapi.dll или wsap24.so обслуживает все информационные базы на сервере. Для каждой базы создаётся отдельный виртуальный каталог с уникальным именем публикации, но все они используют один и тот же файл модуля. Это упрощает обслуживание — при обновлении платформы 1С достаточно заменить один файл модуля, и все базы начнут использовать новую версию.

Что делать, если после обновления платформы 1С база перестала открываться через браузер?

После обновления платформы модуль расширения может остаться старой версии. Скопируйте новый модуль wsisapi.dll или wsap24.so из каталога установки обновлённой платформы и замените им старый файл в каталоге веб-сервера. Перезапустите IIS командой iisreset или Apache командой sudo systemctl restart apache2. Проверьте доступ к базе через браузер — ошибка должна исчезнуть.

Как опубликовать базу 1С через nginx?

Для nginx не требуется отдельный модуль расширения. Веб-сервер взаимодействует с сервером приложений 1С напрямую через протокол FastCGI. В конфигурации nginx создайте блок location с директивой fastcgi_pass, указывающей на адрес и порт сервера 1С (обычно localhost:1540). Настройте передачу заголовков и параметров запроса через директивы fastcgi_param. Перезапустите nginx и проверьте доступ к базе. Этот способ работает быстрее, чем модули для IIS и Apache, особенно при большом количестве одновременных запросов.

Нужно ли перезагружать сервер после установки модулей расширения?

Перезагрузка сервера не требуется. Достаточно перезапустить веб-сервер: для IIS выполните команду iisreset, для Apache — sudo systemctl restart apache2 или sudo systemctl restart httpd. Это применит изменения в конфигурации и загрузит модуль расширения в память. Перезагрузка сервера нужна только в редких случаях, например при обновлении операционной системы или изменении сетевых настроек.