Как настроить Apache для работы с 1С 8.3

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

Для связки Apache и 1С используется модуль веб-расширения, который поставляется вместе с платформой. Платформа поддерживает Apache версий 2.2 и 2.4; наиболее предсказуемо работа связки на Apache 2.4 под Windows или Linux. Важно: разрядность Apache должна совпадать с разрядностью используемых компонентов — для 64-битного Apache нужен 64-битный модуль веб-расширения.

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

Что понадобится перед началом работы

Перед настройкой убедитесь, что у вас есть: дистрибутив платформы 1С:Предприятие 8.3, дистрибутив Apache 2.4 (для Windows удобны готовые сборки, например Apache Lounge), права администратора на сервере и доступ к информационной базе. Если база клиент-серверная (MS SQL, PostgreSQL), сервер 1С должен быть уже настроен и работоспособен — Apache лишь предоставляет веб-доступ, а не заменяет кластер серверов.

Определите разрядность будущей связки заранее. 64-битный Apache требует 64-битного модуля веб-расширения (wsap24.dll для Windows). Смешение разрядностей — самая частая причина ошибки «модуль не загружается» при старте Apache.

Установка и первичная настройка Apache 2.4

На Windows распакуйте дистрибутив Apache, например в C:\Apache24. Откройте файл conf\httpd.conf и проверьте директиву ServerRoot — она должна указывать на реальный путь установки. Затем зарегистрируйте Apache как службу командой из каталога bin:

httpd.exe -k install
httpd.exe -k start

Проверьте установку, открыв в браузере адрес http://localhost. Если видна стартовая страница Apache («It works!»), веб-сервер работает. Если служба не стартует, смотрите лог logs\error.log — чаще всего причина в занятом порту 80 (например, его занимает IIS или Skype) или в неверном пути в ServerRoot.

На Linux Apache ставится из репозитория (apt install apache2 для Debian/Ubuntu). Учтите, что в Linux модули 1С подключаются по тому же принципу, но пути и права отличаются, а модуль называется wsap24.so.

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

Публикация выполняется из конфигуратора: откройте базу, перейдите в меню Администрирование → Публикация на веб-сервере. Укажите имя публикации (латиницей, без пробелов — оно станет частью URL), выберите веб-сервер Apache 2.4 и каталог публикации, например C:\Apache24\htdocs\base1c.

После нажатия «Опубликовать» конфигуратор создаст в указанном каталоге файл default.vrd и предложит автоматически внести изменения в httpd.conf. Автоматическая настройка требует прав администратора; если конфигуратор не смог записать изменения, добавьте строки вручную.

Ручная настройка сводится к добавлению в httpd.conf блока, который загружает модуль веб-расширения и связывает URL с каталогом публикации:

LoadModule _1cws_module "C:/Program Files/1cv8/8.3.22.1709/bin/wsap24.dll"
Alias /base1c "C:/Apache24/htdocs/base1c"
<Directory "C:/Apache24/htdocs/base1c">
AllowOverride All
Options None
Require all granted
SetHandler 1c-application
ManagedApplicationDescriptor "C:/Apache24/htdocs/base1c/default.vrd"
</Directory>

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

httpd.exe -k restart

Содержимое файла default.vrd

Файл default.vrd описывает параметры подключения веб-приложения к информационной базе. Для файловой базы в нём указывается строка подключения с путём к каталогу базы, для клиент-серверной — адрес сервера 1С и имя базы в кластере. Пример для клиент-серверного варианта:

<point name="base1c"
ib="Srvr="server1c";Ref="trade_base";"/>

Через атрибуты point можно включать публикацию веб-сервисов, HTTP-сервисов и стандартного интерфейса OData — соответствующие флаги задаются и в диалоге публикации конфигуратора. Если меняете default.vrd вручную, сохраняйте файл в кодировке UTF-8, иначе возможны ошибки разбора.

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

Служба Apache работает от имени системной учётной записи (по умолчанию LocalSystem). Этой учётной записи нужны права на чтение каталога публикации, а для файловой базы — полный доступ к её каталогу. Если база файловая и лежит на сетевом ресурсе, лучше запускать службу Apache от имени отдельной учётной записи с доступом к сетевой папке.

Типичные ошибки и их признаки:

• Ошибка 500 при обращении к базе — чаще всего не загружен модуль wsap24.dll (проверьте error.log Apache и разрядность) или неверный путь в ManagedApplicationDescriptor.
• Ошибка 403 Forbidden — нет прав у службы Apache на каталог публикации или не задано Require all granted в блоке Directory.
• Ошибка 404 — неверный Alias или имя публикации в URL не совпадает с указанным при публикации (регистр символов в URL значения не имеет, но написание — имеет).
• «Информационная база не обнаружена» — ошибка в строке подключения в default.vrd: неверное имя сервера, базы или база не существует в кластере.

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

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

Дополнительно проверьте работу с другого компьютера в сети, а не только локально: так выявляются проблемы с брандмауэром (порт 80 должен быть открыт для входящих) и с разрешением имени сервера в DNS. Если планируется внешний доступ, следующий шаг — настройка HTTPS: выпуск сертификата и включение модуля mod_ssl в Apache.

Особенности для Linux и альтернативные варианты

На Linux принцип тот же: модуль wsap24.so подключается в конфигурации Apache, публикация создаётся конфигуратором или вручную через default.vrd. Дополнительно нужно выдать права пользователю, от имени которого работает Apache (обычно www-data или apache), на каталог публикации и, при файловом варианте, на каталог базы. Проверяйте также контексты SELinux — он нередко блокирует доступ веб-сервера к файлам вне стандартных каталогов.

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

Часто задаваемые вопросы