Как поднять веб-сервер для 1С: установка, публикация и проверка

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

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

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

Как выбрать веб-сервер и вариант архитектуры

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

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

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

Установка IIS и компонентов платформы

На Windows Server или десктопной Windows откройте «Включение или отключение компонентов Windows» и включите IIS с обязательными подкомпонентами: службы WWW, средства управления, а в разделе «Разработка приложений» — расширения ISAPI и фильтры ISAPI (для IIS с CGI-модулем 1С также потребуется CGI). Без ISAPI-расширений модуль 1С не загрузится, и вы получите ошибку 500 при обращении к публикации.

Затем запустите установку платформы 1С из дистрибутива и в списке компонентов отметьте «Модули расширения веб-сервера». Если платформа уже установлена, запустите установщик повторно в режиме изменения и добавьте этот компонент. Устанавливайте ту же версию платформы, под которой работает сервер 1С или тонкий клиент пользователей, — смешение версий приводит к ошибкам несовместимости.

После установки проверьте, что IIS работает: откройте в браузере http://localhost — должна отобразиться стартовая страница IIS. Если страница не открывается, веб-сервер не запущен или порт 80 занят другим приложением; разберитесь с этим до публикации базы.

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

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

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

1. 1
   Установите IIS с компонентами ISAPI и перезапустите службу
2. 2
   Установите платформу 1С с компонентом «Модули расширения веб-сервера» нужной разрядности
3. 3
   Запустите конфигуратор от имени администратора, откройте «Администрирование → Публикация на веб-сервере»
4. 4
   Укажите имя публикации латиницей, выберите веб-сервер и нужные сервисы
5. 5
   Нажмите «Опубликовать» и откройте URL вида http://сервер/имя_публикации в браузере
6. 6
   Войдите под пользователем базы и проверьте основные операции

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

Публикация на Apache и ручная настройка

На Apache публикация делается через тот же диалог конфигуратора (он умеет править httpd.conf), но часто надёжнее настроить вручную. В конфигурационный файл Apache добавляется виртуальный каталог с подключением модуля расширения 1С — библиотеки wsap24.dll (имя зависит от версии Apache и разрядности) из каталога bin платформы, и указывается путь к файлу default.vrd.

Типовой фрагмент конфигурации выглядит так: загрузка модуля через LoadModule, затем блок Location с обработчиком 1С и путём к default.vrd. После правки обязательно перезапустите Apache — без перезапуска изменения не применятся.

LoadModule _1cws_module "C:/Program Files/1cv8/8.3.22.1750/bin/wsap24.dll"
Alias "/mybase" "C:/inetpub/mybase"
<Directory "C:/inetpub/mybase">
    AllowOverride None
    Require all granted
</Directory>
<Location "/mybase">
    SetHandler 1c-application
    ManagedApplicationDescriptor "C:/inetpub/mybase/default.vrd"
</Location>

На Linux логика та же: модуль расширения поставляется в виде .so-библиотеки, пути указываются в стиле Linux, а пользователь, под которым работает Apache, должен иметь права на чтение каталога публикации и default.vrd. Для файловой базы на Linux учтите, что процессу веб-сервера нужны права записи в каталог базы — это частая причина ошибок доступа.

Настройка доступа, пула приложений и HTTPS

Для IIS публикация работает в пуле приложений. Проверьте, что пул использует ту же разрядность, что и модуль 1С: если модуль 64-разрядный, в свойствах пула параметр «Разрешить 32-разрядные приложения» должен быть отключён. Удостоверение пула должно иметь доступ к кластеру 1С по сети и, для файловой базы, права на её каталог.

Анонимная проверка подлинности на уровне IIS обычно включена, а аутентификация пользователя выполняется уже на стороне 1С — по логину и паролю информационной базы или через аутентификацию ОС. Не отключайте анонимный доступ в IIS, если не настроили альтернативу: иначе браузер будет получать 401 ещё до того, как запрос дойдёт до 1С.

Для доступа из интернета настройте HTTPS: получите сертификат (внутренний CA, Let's Encrypt или коммерческий), привяжите его к сайту в IIS или настройте SSL в Apache и переключите пользователей на https-адрес. Передача логинов 1С по открытому HTTP вне локальной сети недопустима — учётные данные перехватываются элементарно.

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

Базовая проверка — открыть URL публикации в браузере с другого компьютера, а не только с самого сервера. Должна загрузиться страница входа веб-клиента с предложением выбрать пользователя и ввести пароль. Если используется тонкий клиент, проверьте подключение, указав в нём адрес вида http://сервер/публикация.

Если страница не открывается, диагностируйте по коду ошибки. Ошибка 404 — неверный URL или публикация не создана. Ошибка 500 — проблема с модулем расширения: разрядность, отсутствие ISAPI, повреждённый default.vrd. Ошибка 503 — пул приложений остановлен или падает при запуске. Ошибка «Информационная база не обнаружена» — веб-сервер не видит кластер 1С: проверьте сетевую доступность сервера 1С и правильность строки подключения в default.vrd.

Полезный инструмент — журналы. IIS пишет журналы запросов и ошибок, Apache — access.log и error.log, а технологический журнал 1С покажет, доходят ли запросы до платформы и на каком этапе возникает сбой. По связке этих трёх источников локализуется практически любая проблема публикации.

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