К статье
Практический материал

Администрирование · 11 мин

Какой Apache нужен для 1С: версии, разрядность и настройка

Какой Apache подходит для публикации 1С: требования к версии, разрядности и модулям. Настройка httpd.conf, типичные ошибки и проверка работы веб-клиента.

Для публикации информационных баз 1С на веб-сервере платформа 1С:Предприятие поддерживает ограниченный набор веб-серверов, и Apache HTTP Server — основной вариант для Windows и Linux. Ключевой момент: 1С работает с Apache только через собственный модуль расширения wsap (wsap24.dll или wsap24.so), который компилируется под конкретную версию Apache. Поэтому произвольная сборка Apache не подойдёт — нужна именно та ветка, под которую поставляется модуль в составе вашей платформы.

Практическое правило простое: используйте Apache ветки 2.4, потому что модуль wsap24 рассчитан именно на неё. Устаревшая ветка 2.2 (модуль wsap22) встречается только в старых версиях платформы и сегодня не должна применяться для новых развёртываний. Ветка 2.0 и тем более 1.3 платформой не поддерживаются.

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

Ниже разобрано, какая именно версия Apache нужна под разные сценарии, как выполнить публикацию, какие ошибки встречаются чаще всего и как проверить, что связка работает корректно.

Какие версии Apache поддерживает 1С

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

Apache 2.2 поддерживался старыми версиями платформы через модуль wsap22. Эта ветка давно не получает обновлений безопасности, поэтому использовать её для новых публикаций не следует, даже если старая база на ней ещё работает. При обновлении платформы планируйте и переезд на Apache 2.4.

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

Разрядность: 32 или 64 бита

Разрядность Apache и модуля wsap должна совпадать строго. Ошибка здесь — самая частая причина, когда Apache вообще не стартует после добавления директив 1С, а в логе появляется сообщение о невозможности загрузить модуль.

На Windows проще всего использовать 32-битный Apache с 32-битным модулем: такая связка исторически самая предсказуемая и работает даже на 64-битной ОС. Однако если у вас 64-битный сервер 1С и планируется высокая нагрузка через веб-сервер, логично ставить 64-битный Apache и 64-битный модуль.

На Linux обычно используют 64-битный Apache из репозитория дистрибутива и соответствующий 64-битный модуль платформы. Перед установкой проверьте разрядность командой httpd -V или apachectl -V — в выводе видна архитектура сборки.

Apache или IIS: что выбрать

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

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

Сравнение вариантов

Apache 2.4

Подходит для Windows и Linux, единая схема настройки, модуль wsap24 из состава платформы. Требует ручного контроля версии и разрядности.

IIS (Windows)

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

Файловая база без веб-сервера

Если веб-доступ не нужен, веб-сервер вообще не требуется — не усложняйте инфраструктуру без необходимости.

Как выполнить публикацию базы на Apache

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

После нажатия кнопки «Опубликовать» платформа создаст в указанном каталоге файл default.vrd с описанием публикации и добавит необходимые директивы в конфигурацию Apache (в httpd.conf или подключаемый файл). В Windows для записи в каталог Apache конфигуратор нужно запускать с правами администратора.

Альтернативный способ — утилита webinst из каталога платформы. Она выполняет ту же публикацию из командной строки и удобна для автоматизации: можно скриптом перепубликовать базу после обновления конфигурации.

Порядок публикации на Apache 2.4
  1. 1
    Установите Apache 2.4 нужной разрядности и убедитесь, что он запускается и отдаёт стартовую страницу.
  2. 2
    Установите платформу 1С той же разрядности — модуль wsap24 лежит в её каталоге bin.
  3. 3
    Откройте конфигуратор с правами администратора, выберите «Администрирование — Публикация на веб-сервере».
  4. 4
    Задайте имя публикации, каталог и нужные виды доступа, нажмите «Опубликовать».
  5. 5
    Перезапустите Apache, чтобы он подхватил изменения конфигурации.
  6. 6
    Откройте в браузере адрес вида http://сервер/имя_публикации и проверьте вход в базу.

Публикация клиент-серверной базы

Если база работает на сервере 1С:Предприятия, в файле default.vrd указывается строка подключения к кластеру, а не к файловому каталогу. При публикации через конфигуратор платформа подставит её автоматически, но при ручном редактировании default.vrd проверьте, что параметр ib содержит корректную строку вида Srvr="сервер";Ref="имя_базы".

Настройка httpd.conf вручную

Иногда автоматическая публикация недоступна — например, Apache на Linux, а конфигуратор на другой машине. Тогда директивы добавляют вручную. Минимальный набор: загрузка модуля, обработчик для виртуального пути и псевдоним каталога публикации.

Типовой фрагмент конфигурации выглядит так: директива LoadModule _1cws_module с путём к wsap24.so или wsap24.dll, затем блок <Location /имя_публикации> с директивой SetHandler 1c-application и ManagedApplicationDescriptor, указывающей на файл default.vrd. После правки обязателен перезапуск Apache.

apache
LoadModule _1cws_module "C:/Program Files/1cv8/8.3.x/bin/wsap24.dll"
Alias "/base1" "C:/inetpub/base1"
<Directory "C:/inetpub/base1">
    AllowOverride All
    Require all granted
</Directory>
<Location /base1>
    SetHandler 1c-application
    ManagedApplicationDescriptor "C:/inetpub/base1/default.vrd"
</Location>

Обратите внимание на слэши: в конфигурации Apache даже на Windows принято использовать прямые слэши в путях. Один обратный слэш или опечатка в пути к модулю — и Apache откажется стартовать.

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

Первый признак успешной публикации — открытие стартовой страницы веб-клиента по адресу публикации без ошибок 500 и 404. Если вместо интерфейса 1С вы видите ошибку сервера, смотрите error.log Apache: он находится в подкаталоге logs и содержит конкретную причину сбоя.

Типичные ошибки
01
Несовпадение разрядности Apache и модуля wsap — Apache не стартует, в логе ошибка загрузки библиотеки.
02
Модуль не обновлён после обновления платформы — веб-клиент работает нестабильно или падает с ошибками.
03
Публикация без прав администратора — директивы не записались в конфиг Apache, база недоступна по URL.
04
Опечатка в имени публикации или кириллица в URL — ошибка 404 при обращении.
05
Закрыт порт 80/443 на брандмауэре — с других машин сервер недоступен, хотя локально всё работает.
06
Не перезапущен Apache после правки конфигурации — старые настройки продолжают действовать.
Контрольные точки

Как проверить результат

Запуск Apache
Норма

Служба стартует без ошибок, error.log пуст или содержит только информационные записи

Тревожный признак

Служба падает, в логе ошибка загрузки wsap24

Открытие публикации в браузере
Норма

Загружается страница входа веб-клиента 1С

Тревожный признак

Ошибка 404, 500 или загрузка бинарного файла вместо страницы

Авторизация и работа
Норма

Вход под пользователем проходит, формы открываются, данные читаются

Тревожный признак

Бесконечная загрузка, ошибки связи с сервером 1С

Доступ с другого компьютера
Норма

База открывается по имени или IP сервера из сети

Тревожный признак

Страница доступна только локально — проверяйте брандмауэр и Listen в конфиге

Отдельный признак проблемы — браузер предлагает скачать файл вместо показа страницы. Это означает, что обработчик 1С не подключён и Apache отдаёт запрос как статику: проверяйте директиву SetHandler и загрузку модуля.

Безопасность и ограничения самостоятельной настройки

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

Не публикуйте базу с пустым паролем администратора и не открывайте веб-сервисы шире, чем требуется: в настройках публикации включайте только те механизмы, которые реально используются. Каждый опубликованный веб-сервис — потенциальная точка входа.

Итог

Что важно запомнить

Для 1С нужен Apache ветки 2.4 с модулем wsap24 из состава установленной платформы, разрядность сервера и модуля должна совпадать. Публикацию проще всего выполнить из конфигуратора, а результат проверять по error.log Apache и открытию веб-клиента в браузере. После обновления платформы не забывайте обновлять модуль и перепубликовывать базу.

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

Подойдёт ли Apache 2.2 для новой публикации 1С?

Технически старые версии платформы работали с Apache 2.2 через модуль wsap22, но эта ветка Apache не получает обновлений безопасности. Для новых развёртываний используйте Apache 2.4 и модуль wsap24, а существующие публикации на 2.2 планово переносите.

Где взять модуль wsap24?

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

Можно ли использовать 64-битный Apache с 32-битной платформой?

Нет. Разрядность Apache и модуля wsap должна совпадать, иначе модуль не загрузится. Либо ставьте 32-битный Apache с 32-битным модулем, либо 64-битную связку целиком.

Нужно ли перепубликовывать базу после обновления платформы?

Да, это рекомендуется. Обновление платформы меняет и модуль wsap24, и если Apache продолжает использовать старую библиотеку, возможны ошибки веб-клиента. Повторная публикация заменяет модуль и файл default.vrd на актуальные.

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

Да. Каждая база публикуется под своим именем и получает отдельный URL, каталог публикации и файл default.vrd. Один экземпляр Apache обслуживает любое количество публикаций, ограничение — только производительность сервера.

Что делать, если веб-клиент открывается, но формы работают с ошибками?

Чаще всего причина в рассинхронизации версий: модуль wsap от одной версии платформы, а база работает на другой. Проверьте версию платформы, обновите модуль из её каталога, перепубликуйте базу и перезапустите Apache. Также полезно очистить кэш браузера.