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

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

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

Эта инструкция объясняет, как правильно установить модули расширения, настроить конфигурацию веб-сервера и устранить типовые ошибки подключения.

Как работают модули расширения 1С

Архитектура публикации 1С через веб-сервер состоит из четырёх компонентов:

• Веб-сервер (Apache или IIS) — принимает HTTP-запросы от браузеров и мобильных приложений
• Модуль расширения (wsap24.dll или mod_wsap24.so) — обрабатывает запросы к виртуальным директориям 1С
• Агент сервера ragent — диспетчер, который распределяет запросы между рабочими процессами
• Рабочие процессы rphost — выполняют код 1С:Предприятие

Модуль расширения загружается в адресное пространство веб-сервера при старте. Когда приходит запрос к виртуальной директории (например, http://server/accounting), модуль перехватывает его, сериализует в бинарный протокол и передаёт через TCP-порт 1540 агенту сервера. Агент выбирает свободный процесс rphost, отправляет ему запрос, получает ответ и возвращает его модулю. Модуль формирует HTTP-ответ и отдаёт его браузеру.

Для корректной работы необходимо:

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

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

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

Для высоконагруженных конфигураций выбирайте серверные процессоры с высокой тактовой частотой — 1С плохо масштабируется по ядрам из-за монопоточной природы бизнес-логики. Объём оперативной памяти рассчитывайте исходя из 1-2 ГБ на одновременного пользователя плюс 8 ГБ под операционную систему и веб-сервер.

Для баз данных SQL Server или PostgreSQL используйте отдельный сервер с быстрыми SSD-накопителями — производительность дисковой подсистемы критична для OLTP-нагрузок 1С.

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

IIS (Internet Information Services) — штатный веб-сервер Windows Server. Модуль расширения для IIS называется wsap24.dll, где 24 — версия протокола.

cd "C:Program Files1cv88.3.x.xxxxwswsisapi.dll"
regsvr32 wsisapi.dll

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

Apache HTTP Server широко используется на серверах Linux. Модуль расширения для Apache называется mod_wsap24.so.

После установки создайте виртуальную директорию в конфигурации Apache. Откройте /etc/apache2/sites-available/1c.conf (Ubuntu) или /etc/httpd/conf.d/1c.conf (CentOS) и добавьте:

<VirtualHost *:80>
    ServerName server.company.local

    Alias /accounting /var/www/1c/accounting
    <Directory /var/www/1c/accounting>
        Require all granted
    </Directory>
</VirtualHost>

Создайте директорию и настройте права:

sudo mkdir -p /var/www/1c/accounting
sudo chown www-data:www-data /var/www/1c/accounting
sudo systemctl reload apache2

Опубликуйте базу через Конфигуратор, указав путь /var/www/1c/accounting в параметрах публикации.

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

Ошибка «Не установлены модули расширения веб сервера»

Причина: Конфигуратор не находит файлы wsisapi.dll (IIS) или mod_wsap24.so (Apache) в каталоге установки платформы.

Решение:

• Проверьте, что модули расширения установлены: C:Program Files1cv88.3.x.xxxxwswsisapi.dll (Windows) или /opt/1cv8/x86_64/8.3.x.xxxx/ws/mod_wsap24.so (Linux)
• Версия модулей должна совпадать с версией платформы — переустановите модули из актуального дистрибутива
• Запустите установщик wssetup.exe от имени администратора и выберите «Восстановить»
• На Linux проверьте, что пакет 1c-enterprise-8.3-ws установлен: dpkg -l | grep 1c-enterprise

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

Причина: Веб-сервер не загружает модуль расширения при старте.

Решение для IIS:

1. Откройте диспетчер IIS и перейдите в «ISAPI и фильтры CGI»
2. Найдите запись wsisapi.dll — если её нет, добавьте вручную: путь C:Program Files1cv88.3.x.xxxxwswsisapi.dll, описание «1C Web Service Extension», разрешить выполнение
3. Перезапустите IIS: iisreset

Решение для Apache:

1. Проверьте наличие директивы LoadModule в конфигурации:

   grep -r "LoadModule wsap24_module" /etc/apache2/
   grep -r "LoadModule wsap24_module" /etc/httpd/

2. Если директивы нет, добавьте в /etc/apache2/mods-available/wsap24.load:

   LoadModule wsap24_module /opt/1cv8/x86_64/8.3.x.xxxx/ws/mod_wsap24.so

3. Включите модуль: sudo a2enmod wsap24
4. Перезапустите Apache: sudo systemctl restart apache2

Ошибка «Информационная база недоступна»

Причина: Агент сервера ragent не запущен или не может связаться с рабочими процессами.

Решение:

• Проверьте, что служба «1C:Enterprise Server Agent» запущена (Windows) или демон srv1cv8 активен (Linux): sudo systemctl status srv1cv8
• Проверьте доступность порта 1540: telnet localhost 1540 — если порт не отвечает, перезапустите агент
• Изучите журнал агента: C:ProgramData1C1cv8logs (Windows) или /var/log/1C (Linux) — ищите ошибки авторизации, прав доступа, переполнения пула процессов
• Увеличьте количество рабочих процессов в параметрах кластера: откройте Консоль кластера серверов, выберите кластер → «Настройка производительности» → увеличьте «Максимальное количество рабочих процессов»

Ошибка HTTP 500.0 Internal Server Error

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

Решение:

• Проверьте журнал событий Windows (раздел Application) — ошибки IIS содержат код исключения и адрес модуля
• Убедитесь, что пул приложений работает в режиме 64-bit: откройте диспетчер IIS → «Пулы приложений» → DefaultAppPool → «Дополнительные параметры» → установите «Разрешить 32-разрядные приложения» в False
• Проверьте права доступа: учётная запись пула приложений (по умолчанию IIS_IUSRS) должна иметь права чтения на директорию C:Program Files1cv8 и права записи на каталог публикации базы
• Переустановите модули расширения — скачайте актуальный дистрибутив с портала 1С и выполните чистую установку

Ошибка «Не удаётся подключиться к кластеру серверов»

Причина: Модуль расширения не может установить TCP-соединение с агентом сервера на порту 1540.

Решение:

• Проверьте настройки брандмауэра — разрешите входящие соединения на порты 1540-1541 (агент), 1560-1591 (рабочие процессы)
• На Linux проверьте SELinux: sudo setenforce 0 — если после этого заработало, добавьте политику разрешения:

  sudo setsebool -P httpd_can_network_connect 1

• Если кластер на удалённом сервере, проверьте сетевую доступность: telnet cluster-server 1540
• Проверьте параметры публикации в Конфигураторе: «Администрирование → Публикация информационной базы → Сервер 1С:Предприятие» должен содержать правильное имя или IP-адрес кластера

Ошибка «Не удаётся найти обработчик» в IIS

Эта ошибка появляется, если обработчик не зарегистрирован в IIS. Откройте диспетчер IIS и проверьте раздел «Сопоставления обработчиков». Если обработчика 1С нет, запустите webinst.exe повторно и выберите вариант «Восстановить регистрацию».

Если проблема сохраняется, проверьте права доступа к файлам модулей. Откройте свойства каталога C:Program Files1cv8, перейдите на вкладку «Безопасность» и убедитесь, что группа IIS_IUSRS имеет права на чтение и выполнение.

Ошибка «SELinux блокирует доступ» на Linux

Если на сервере включён SELinux, он может блокировать доступ Apache к модулям 1С. Проверьте статус SELinux командой:

sestatus

Если статус «Enforcing», добавьте разрешение для модулей:

sudo semanage fcontext -a -t httpd_modules_t "/opt/1cv8/x86_64/.*/apache24/mod_wsap_24.so"
sudo restorecon -v /opt/1cv8/x86_64/*/apache24/mod_wsap_24.so

После этого перезапустите Apache. Если проблема не решена, проверьте журнал аудита SELinux:

sudo ausearch -m avc -ts recent

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

После установки модулей расширения оптимизируйте параметры для повышения производительности.

Параметры пула рабочих процессов

Откройте Консоль кластера серверов, выберите рабочий сервер и настройте:

• Использование памяти: 50-70% от объёма ОЗУ сервера
• Максимальное количество рабочих процессов: количество ядер процессора × 2
• Память на один рабочий процесс: 500-1000 МБ (зависит от сложности конфигурации)
• Время жизни рабочего процесса: 3600 секунд (перезапуск процесса для освобождения памяти)

Настройки веб-сервера

Для IIS:

• Увеличьте лимит очереди запросов: applicationHost.config → <applicationPools> → queueLength="2000"
• Отключите переработку пула по расписанию: «Пулы приложений → Recycling → Disable all recycling options»
• Установите таймаут простоя в 0 (Idle Time-out): пул не будет останавливаться при отсутствии запросов

Для Apache:

• Используйте модуль mpm_worker или mpm_event вместо prefork:

  sudo a2dismod mpm_prefork
  sudo a2enmod mpm_event

• Увеличьте лимиты соединений в /etc/apache2/mods-available/mpm_event.conf:

  StartServers 5
  MinSpareThreads 75
  MaxSpareThreads 250
  ThreadLimit 64
  ThreadsPerChild 64
  MaxRequestWorkers 400
  MaxConnectionsPerChild 10000
  

• Включите сжатие для снижения трафика:

  sudo a2enmod deflate
  sudo systemctl restart apache2

Кэширование статического контента

Веб-клиент 1С загружает большое количество статики (JavaScript, CSS, изображения). Настройте кэширование в веб-сервере:

IIS: установите модуль «Кэширование HTTP» и в настройках сайта включите кэширование для типов файлов .js, .css, .png, .jpg — срок хранения 7 дней.

Apache: включите модуль mod_expires и добавьте в конфигурацию виртуального хоста:

<IfModule mod_expires.c>
    ExpiresActive On
    ExpiresByType text/css "access plus 7 days"
    ExpiresByType text/javascript "access plus 7 days"
    ExpiresByType image/png "access plus 30 days"
    ExpiresByType image/jpeg "access plus 30 days"
</IfModule>

Контроль работы модулей расширения

Для мониторинга используйте встроенные инструменты 1С и журналы веб-сервера.

Журнал технологического журнала 1С

Включите технологический журнал для диагностики проблем с модулями расширения:

1. Создайте файл logcfg.xml в каталоге C:ProgramData1C1cv8conf (Windows) или /var/log/1C (Linux)
2. Добавьте конфигурацию:

   <config xmlns="http://v8.1c.ru/v8/tech-log">
       <log location="C:ProgramData1C1cv8logs" history="24">
           <event>EXCP</event>
           <event>CONN</event>
           <event>CALL</event>
           <property name="all"/>
       </log>
   </config>
   

3. Перезапустите агент сервера

События CALL содержат информацию о запросах через модули расширения — метод HTTP, URI, время выполнения, размер ответа. События EXCP фиксируют исключения.

Счётчики производительности Windows

Добавьте в системный монитор счётчики:

• Процесс → % загруженности процессора → rphost — загрузка рабочих процессов 1С
• Процесс → Байтов исполняемого кода → w3wp — потребление памяти пулом IIS
• Веб-служба → Текущие подключения — количество активных HTTP-соединений

Если загрузка процессора rphost превышает 80%, увеличьте количество рабочих процессов или оптимизируйте код конфигурации. Если w3wp потребляет более 4 ГБ памяти, проверьте утечки памяти в модуле расширения — обновите платформу до актуального релиза.

Совместимость версий

Модули расширения привязаны к конкретной версии платформы 1С. Таблица совместимости:

При обновлении платформы переустановите модули расширения из нового дистрибутива. Смешивание версий (например, платформа 8.3.24 + модули 8.3.23) приводит к ошибкам «Несовместимая версия протокола» и сбоям при обработке запросов.

Для веб-серверов поддержка следующая:

• IIS: версии 7.5 (Windows Server 2008 R2) — 10.0 (Windows Server 2022)
• Apache: версии 2.4.x (2.2.x не поддерживается с платформы 8.3.20)

Обновление модулей при переходе на новую версию платформы

При обновлении платформы 1С:Предприятие 8.3 до новой версии модули расширения также нужно обновить. Старые модули могут быть несовместимы с новой версией.

На Linux выполните обновление пакетов:

sudo rpm -Uvh 1c-enterprise83-server-*.rpm 1c-enterprise83-ws-*.rpm

После обновления отредактируйте конфигурационный файл Apache /etc/httpd/conf.d/1c.conf и замените путь к модулю на актуальную версию. Перезапустите Apache.

На Windows Server запустите webinst.exe из каталога новой версии платформы. Выберите вариант «Обновить модули расширения» и следуйте инструкциям. После завершения перезапустите IIS через диспетчер служб или командой:

iisreset /restart

Проверьте работу веб-клиента. Если возникают ошибки, проверьте журнал событий Windows и лог-файлы 1С в каталоге C:Program Files1cv8srvinforeg_*.

Вопросы и ответы