Как опубликовать базу 1С на Linux

Публикация базы 1С на Linux-сервере позволяет открыть доступ к информационной базе через браузер или тонкий клиент по протоколу HTTP(S), без установки платформы на каждом рабочем месте. Чаще всего для этого используется связка «веб-сервер Apache + модуль расширения веб-сервера 1С (wsap)», а сама база при этом может лежать как в файловом варианте, так и на сервере СУБД (PostgreSQL, MS SQL) или на кластере серверов 1С.

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

Инструкция ориентирована на распространённые дистрибутивы (Debian/Ubuntu, CentOS/Red Hat-подобные системы). Названия пакетов и пути могут отличаться в зависимости от дистрибутива, но общая логика одинакова.

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

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

Также понадобятся: установленный веб-сервер Apache 2.4 (рекомендуемый вариант для Linux), права root или sudo на сервере и сама информационная база — файловая (каталог с файлом 1Cv8.1CD) либо клиент-серверная (строка подключения к СУБД или кластеру 1С).

Проверьте, что на сервере достаточно места под платформу и базу, а брандмауэр пропускает трафик на порт 80 (или 443 для HTTPS). Для доступа извне по HTTPS дополнительно потребуется TLS-сертификат.

Установка платформы 1С и веб-сервера Apache

Дистрибутив платформы для Linux распространяется в виде deb- или rpm-пакетов. Для Debian/Ubuntu установка выполняется командой dpkg, для rpm-систем — через rpm или yum/dnf. Если GUI не нужен, достаточно серверных компонентов и компонента «Модули расширения веб-сервера».

sudo dpkg -i 1c-enterprise-<em>-server_</em>.deb 1c-enterprise-<em>-ws_</em>.deb
sudo apt install apache2
sudo a2enmod env alias

После установки убедитесь, что каталог платформы появился в /opt/1cv8 (типовой путь) и в нём есть подкаталоги с версией платформы. Модуль расширения веб-сервера обычно находится по пути вида /opt/1cv8/x86_64/<версия>/wsap24.so.

Apache должен запускаться и отвечать на запросы до подключения модуля 1С. Проверьте это командой systemctl status apache2 (или httpd в rpm-системах) и открытием стартовой страницы веб-сервера в браузере.

Подключение модуля расширения 1С к Apache

Модуль wsap24.so подключается директивой LoadModule в конфигурации Apache. В Debian-подобных системах удобно создать отдельный файл в /etc/apache2/mods-available и активировать его, в rpm-системах — добавить строку в conf.d.

LoadModule _1cws_module "/opt/1cv8/x86_64/8.3.22.1750/wsap24.so"

Обратите внимание: путь содержит конкретную версию платформы. После обновления платформы путь придётся скорректировать, иначе Apache не запустится. Проверить корректность конфигурации можно командой apachectl configtest — она должна вернуть «Syntax OK» до перезапуска службы.

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

Создание каталога публикации и файла default.vrd

Публикация базы описывается файлом default.vrd — это XML-файл, в котором указаны имя публикации, тип подключения и параметры базы. Каталог публикации создаётся вручную, например /var/www/1c/base1, и в него помещается default.vrd.

Для файловой базы минимальное содержимое файла выглядит так: элемент point с атрибутом name (имя публикации в URL) и элемент ws, а внутри — строка подключения вида File="путь_к_каталогу_базы". Для клиент-серверной базы вместо File указываются Srvr и Ref (сервер и имя базы в кластере) либо параметры подключения к СУБД.

<?xml version="1.0" encoding="UTF-8"?>
<point name="base1" xmlns="http://v8.1c.ru/8.2/virtual-resource-system" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ws pointEnableCommon="false"/>
  <debug enable="false"/>
</point>

Строку подключения удобнее задавать прямо в конфигурации Apache директивой ManagedApplicationDescriptor, указывающей на default.vrd, а параметры базы — через директиву SetEnv или внутри самого vrd-файла. Альтернатива — использовать утилиту webinst из состава платформы: она автоматически создаёт каталог, файл default.vrd и фрагмент конфигурации Apache.

1. 1
   Запустите webinst с ключом -publish и укажите имя публикации, каталог и строку подключения к базе
2. 2
   Проверьте, что в каталоге появился default.vrd, а в конфигурации Apache — секция с Alias и ManagedApplicationDescriptor
3. 3
   Перезапустите Apache командой systemctl restart apache2
4. 4
   Откройте в браузере http://сервер/имя_публикации и убедитесь, что загружается окно входа в базу

Права доступа и безопасность

Пользователь, от имени которого работает Apache (обычно www-data или apache), должен иметь чтение и запись в каталог файловой базы и чтение каталога публикации. Недостаток прав — самая частая причина ошибок «Ошибка доступа к файлу» и пустой страницы вместо базы.

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

Также не размещайте каталог файловой базы внутри корня веб-сервера, доступного для прямой выгрузки файлов: иначе файл 1Cv8.1CD теоретически может быть скачан напрямую при ошибке конфигурации. Каталог базы должен лежать вне DocumentRoot.

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

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

Альтернативные способы публикации

Помимо Apache, базу можно публиковать через IIS (только на Windows), а для Linux-окружений иногда применяют связку с reverse proxy на Nginx перед Apache: Nginx принимает HTTPS-соединения и проксирует их на Apache с модулем 1С. Это удобно, когда нужно терминировать TLS и балансировать нагрузку.

Для небольших команд в локальной сети достаточно базовой схемы Apache + модуль расширения. Чем больше пользователей и чем выше требования к доступности, тем сильнее оправдан переход на клиент-серверную архитектуру и разнесение компонентов по разным машинам.

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