Как установить и настроить Apache для 1С

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

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

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

Когда Apache нужен для 1С и какую версию выбрать

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

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

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

Установка Apache 2.4 на Windows

Официальный сайт Apache не поставляет готовых Windows-сборок, поэтому дистрибутив скачивается с одного из рекомендованных проектом зеркал (например, Apache Lounge). Скачайте архив с 64-битной версией Apache 2.4 и распакуйте его, например, в C:\Apache24. Путь без пробелов и кириллицы упростит дальнейшую настройку.

Перед установкой службы убедитесь, что порт 80 не занят другим приложением (Skype, IIS, другой веб-сервер). Проверить занятость можно командой netstat -ano | findstr :80. Если порт занят, либо остановите конфликтующую службу, либо измените порт Apache в файле conf\httpd.conf в директиве Listen.

Установка службы выполняется из командной строки, запущенной от имени администратора. После установки службу можно запустить и проверить, открыв в браузере адрес http://localhost — должна отобразиться стартовая страница Apache.

cd C:\Apache24\bin
httpd.exe -k install -n "Apache2.4"
httpd.exe -k start -n "Apache2.4"

Установка Apache на Linux

На Debian/Ubuntu Apache ставится из репозитория командой apt install apache2, на CentOS/RHEL — yum install httpd. После установки проверьте статус службы: systemctl status apache2 (или httpd). Конфигурация располагается в /etc/apache2 или /etc/httpd соответственно.

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

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

После установки файл модуля появится в каталоге платформы: для Windows это C:\Program Files\1cv8\<версия>\bin\wsap24.dll, для Linux — /opt/1cv8/x86_64/<версия>/wsap24.so. Именно к этому файлу Apache обращается при обработке запросов к опубликованной базе.

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

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

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

Конфигуратор при публикации делает две вещи: создаёт в указанном каталоге файл default.vrd с параметрами подключения к базе и дописывает в httpd.conf директивы загрузки модуля wsap24 и обработчика для каталога публикации. Если конфигуратор не смог изменить httpd.conf (не хватило прав), придётся добавить строки вручную.

LoadModule _1cws_module "C:/Program Files/1cv8/8.3.24.1548/bin/wsap24.dll"
Alias "/mybase" "C:/inetpub/mybase"
<Directory "C:/inetpub/mybase">
  AllowOverride All
  Require all granted
</Directory>

Обратите внимание: путь к модулю в примере условный — указывайте реальный путь к установленной у вас версии платформы. После любого изменения httpd.conf службу Apache нужно перезапустить, иначе изменения не вступят в силу.

Проверка работоспособности публикации

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

Для файловой базы критично, чтобы учётная запись, под которой работает Apache, имела полный доступ к каталогу базы — чтение и запись. На Windows служба по умолчанию работает под системной учётной записью, и если база лежит на сетевом ресурсе, доступа может не быть. Решение — запустить службу под доменной учётной записью с нужными правами или перенести базу на локальный диск сервера.

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

Отдельного внимания заслуживает диагностика через журналы. Основной источник информации — файл error.log в каталоге logs Apache: туда пишутся ошибки загрузки модуля, обращения к публикации и проблемы прав доступа. Прежде чем менять настройки наугад, прочитайте последние строки этого журнала — в большинстве случаев причина указана там прямо.

Ограничения и меры безопасности

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

Публикация базы через HTTP без шифрования передаёт логины, пароли и данные открытым текстом. Если доступ нужен извне локальной сети, обязательно настройте HTTPS с сертификатом и ограничьте доступ по IP или через VPN. Также не публикуйте базу с пустыми паролями пользователей и отключите публикацию веб-сервисов, которые фактически не используются, — каждый опубликованный сервис расширяет поверхность атаки.

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