Веб-расширение 1С 8.3: как установить и опубликовать базу

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

Процедура состоит из трёх этапов: установка компонентов веб-расширения с дистрибутива платформы, настройка самого веб-сервера и публикация информационной базы через конфигуратор. Каждый этап имеет свои требования к правам, разрядности и версиям, нарушение которых приводит к типовым ошибкам вроде «404», «500» или «Ошибка HTTP при обращении к серверу».

Ниже разобран полный порядок действий для Windows с IIS и для Apache, а также способы проверить результат и исправить частые проблемы. Инструкция подходит для файловых и клиент-серверных баз, различия указаны отдельно.

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

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

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

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

Требования и подготовка перед установкой

Перед установкой проверьте несколько условий, иначе столкнётесь с ошибками уже на этапе публикации. Во-первых, на машине должен быть установлен и запущен веб-сервер: IIS (компонент Windows) или Apache 2.2/2.4. Во-вторых, разрядность веб-расширения должна совпадать с разрядностью веб-сервера: 64-битный модуль не загрузится в 32-битный пул приложений IIS и наоборот.

Для IIS убедитесь, что включены компоненты: «Службы IIS» → «Службы Интернета» → «Расширения ISAPI» и «Фильтры ISAPI», а также «Статическое содержимое». Для Apache заранее скачайте дистрибутив нужной версии — 1С официально поддерживает Apache 2.2 и 2.4; с другими версиями модуль может не загрузиться.

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

Установка компонентов веб-расширения

Веб-расширение ставится из того же дистрибутива, что и платформа 1С. Запустите setup.exe от имени администратора, выберите режим «Изменение», если платформа уже установлена, или полную установку для новой машины.

В списке компонентов отметьте «Модули расширения веб-сервера» (в английском интерфейсе — Web server extension modules). Если нужен только веб-доступ без толстого клиента, остальные клиентские компоненты можно не ставить — это сэкономит место и упростит обновления.

После завершения установки проверьте наличие файлов модуля. Для 64-разрядной платформы они располагаются в каталоге вида C:\Program Files\1cv8\8.3.хх.хххх\bin\ — там должны быть wsisapi.dll (для IIS) и wsap24.so/wsap22.dll (для Apache).

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

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

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

В диалоге укажите имя публикации — оно станет частью URL (например, «BuhBase» даст адрес http://сервер/BuhBase). Выберите веб-сервер (IIS или Apache), каталог для размещения файла default.vrd и отметьте нужные виды клиентов: веб-клиент, тонкий клиент, веб-сервисы. Нажмите «Опубликовать».

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

Файл default.vrd

Результат публикации — файл default.vrd в указанном каталоге. Это XML-описание, связывающее публикацию с конкретной базой: в нём прописана строка подключения (ib=...) и параметры точек входа. При необходимости файл можно редактировать вручную, например чтобы добавить публикацию веб-сервиса или изменить пул подключений.

<?xml version="1.0" encoding="UTF-8"?>
<point name="BuhBase" ib="Srvr=SERVER;Ref=BUH;" ...>
  <ws pointEnableCommon="false"/>
</point>

Настройка IIS вручную и типовые параметры

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

Проверьте пул приложений: для 64-разрядного веб-расширения параметр «Enable 32-Bit Applications» должен быть выключен, для 32-разрядного — включён. Режим управляемого конвейера обычно «Classic» либо «Integrated» — зависит от версии платформы, при ошибках попробуйте сменить режим.

В разделе «Сопоставления обработчиков» (Handler Mappings) приложения добавьте сопоставление для пути «*» с исполняемым файлом wsisapi.dll из каталога bin нужной версии платформы. Также убедитесь, что в «Ограничениях ISAPI и CGI» на уровне сервера модуль разрешён.

Публикация на Apache

Для Apache установите веб-сервер версии 2.2 или 2.4, проверьте, что служба запускается. Затем выполните публикацию из конфигуратора, выбрав тип веб-сервера Apache — конфигуратор сам допишет нужные строки в httpd.conf и предложит перезапуск.

Ручная настройка сводится к трём директивам в httpd.conf: LoadModule для подключения модуля wsap24.so (или wsap22.dll для Apache 2.2), блок <Location> с именем публикации и SetHandler 1cws-process, а также путь к каталогу с default.vrd. После правок выполните перезапуск Apache командой или через службы Windows.

Частая проблема — Apache не стартует после добавления модуля. Почти всегда причина в несовпадении разрядности (32-битный Apache и 64-битный модуль) или в неподдерживаемой версии Apache. Смотрите журнал ошибок Apache в каталоге logs — там будет причина отказа загрузки модуля.

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

После публикации откройте в браузере адрес вида http://localhost/ИмяПубликации с самого сервера. Признак успеха — загрузка страницы веб-клиента 1С с окном авторизации. Затем проверьте доступ с другой машины сети, подставив имя или IP сервера вместо localhost.

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

Обновление и удаление публикации

При обновлении платформы 1С веб-расширение обновляется вместе с ней, но публикации продолжают ссылаться на старый модуль. После каждого обновления выполните публикацию заново из конфигуратора новой версии (кнопка «Опубликовать» поверх существующей публикации) — это обновит привязку к wsisapi.dll или модулю Apache.

Для удаления публикации используйте тот же диалог конфигуратора с кнопкой «Удалить» либо удалите виртуальный каталог в IIS вместе с каталогом default.vrd. В Apache удалите соответствующие директивы из httpd.conf и перезапустите службу.

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