Публикация 1С через Apache: веб-клиент и HTTP-сервисы

Публикация информационной базы 1С через веб-сервер Apache открывает несколько сценариев использования:

• Веб-клиент — работа с 1С через браузер без установки платформы на клиентское устройство
• Тонкий клиент через интернет — подключение тонкого клиента к базе через HTTP/HTTPS
• HTTP-сервисы — REST API для интеграции с внешними системами (сайт, CRM, мобильные приложения)
• Web-сервисы (SOAP) — интеграция по протоколу SOAP

Веб-клиент особенно актуален для территориально распределённых компаний и удалённых сотрудников. Пользователю достаточно современного браузера — Chrome, Firefox или Edge. Установка дополнительного ПО не требуется.

В данной статье мы рассмотрим публикацию на связке Apache 2.4 + модуль веб-расширения 1С на платформе Linux (Ubuntu 22.04) и Windows Server 2019. Все примеры приведены для платформы 1С:Предприятие 8.3.24.

Для работы веб-клиента 1С на Linux необходимо установить платформу 1С, Apache и модуль веб-расширения.

Устанавливаем Apache:

sudo apt update
sudo apt install apache2 -y
sudo a2enmod ssl rewrite headers
sudo systemctl enable apache2

Устанавливаем серверные компоненты 1С из deb-пакетов:

# Скачайте пакеты с releases.1c.ru
sudo dpkg -i 1c-enterprise83-common_8.3.24.1548-1_amd64.deb
sudo dpkg -i 1c-enterprise83-ws_8.3.24.1548-1_amd64.deb
sudo apt install -f  # исправление зависимостей

Пакет 1c-enterprise83-ws устанавливает модуль Apache wsap24.so и утилиту публикации webinst. Проверяем наличие модуля:

ls -la /opt/1cv8/x86_64/8.3.24.1548/wsap24.so

Создаём симлинк для Apache:

cat > /etc/apache2/mods-available/1c.load <<EOF
LoadModule _1cws_module /opt/1cv8/x86_64/8.3.24.1548/wsap24.so
EOF

sudo a2enmod 1c
sudo systemctl restart apache2

На Windows Server публикация выполняется из конфигуратора 1С или через утилиту командной строки. Предварительно установите Apache 2.4 для Windows (например, сборку Apache Lounge).

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

1. Откройте базу в конфигураторе
2. Меню Администрирование → Публикация на веб-сервере
3. Укажите параметры:
   • Имя публикации: erp
   • Веб-сервер: Apache 2.4
   • Каталог: C:\inetpub\1c\erp
   • Поставьте галочки: «Публиковать веб-клиент», «Публиковать HTTP-сервисы»
4. Нажмите «Опубликовать»

Конфигуратор создаст файл default.vrd в указанном каталоге и добавит настройки в httpd.conf. Содержимое default.vrd:

<?xml version="1.0" encoding="UTF-8"?>
<point 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"
  base="/erp"
  ib="Srvr=&quot;srv-1c&quot;;Ref=&quot;erp&quot;;"
  enable="true">
  <ws enable="true"/>
  <httpServices publishByDefault="true">
    <service name="API_Exchange" enable="true" rootUrl="api"/>
  </httpServices>
</point>

Файл default.vrd — ключевой файл публикации. Именно его можно редактировать вручную для тонкой настройки без конфигуратора.

Для продакшен-среды обязательно настройте HTTPS. Использование HTTP допустимо только в изолированных сетях.

Получаем сертификат Let's Encrypt и настраиваем Apache:

sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d 1c.company.ru

Виртуальный хост Apache для 1С с HTTPS:

<VirtualHost *:443>
    ServerName 1c.company.ru
    DocumentRoot /var/www/1c

    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/1c.company.ru/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/1c.company.ru/privkey.pem

    # Публикация 1С
    Alias /erp /var/www/1c/erp
    <Directory /var/www/1c/erp>
        AllowOverride All
        Require all granted
    </Directory>

    # Ограничение по IP (опционально)
    <Location /erp>
        Require ip 10.0.0.0/8
        Require ip 192.168.0.0/16
        Require ip 203.0.113.50
    </Location>

    # Заголовки безопасности
    Header always set X-Frame-Options DENY
    Header always set X-Content-Type-Options nosniff
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

# Редирект HTTP → HTTPS
<VirtualHost *:80>
    ServerName 1c.company.ru
    Redirect permanent / https://1c.company.ru/
</VirtualHost>

HTTP-сервисы 1С позволяют создать REST API для обмена данными с внешними системами. После создания HTTP-сервиса в конфигураторе его нужно опубликовать.

В файле default.vrd раздел HTTP-сервисов:

<httpServices publishByDefault="false">
  <service name="API_Exchange"
    enable="true"
    rootUrl="api"
    reuseSessions="autouse"
    sessionMaxAge="60" />
  <service name="API_Catalog"
    enable="true"
    rootUrl="catalog" />
</httpServices>

После публикации HTTP-сервис доступен по URL:

https://1c.company.ru/erp/hs/api/v1/orders

Пример обращения к HTTP-сервису через curl:

# Получение списка заказов
curl -X GET "https://1c.company.ru/erp/hs/api/v1/orders?date=2026-04-01" \
  -H "Authorization: Basic $(echo -n 'APIUser:P@ssw0rd' | base64)" \
  -H "Content-Type: application/json"

# Создание документа
curl -X POST "https://1c.company.ru/erp/hs/api/v1/orders" \
  -H "Authorization: Basic $(echo -n 'APIUser:P@ssw0rd' | base64)" \
  -H "Content-Type: application/json" \
  -d '{"client": "ООО Компания", "items": [{"sku": "00001", "qty": 10}]}'

Важно: для HTTP-сервисов рекомендуется создать отдельного пользователя 1С с минимальными правами и отключённым интерактивным входом.

Веб-клиент 1С требует значительных ресурсов сервера. На каждого подключённого пользователя приходится отдельный серверный процесс. Основные параметры оптимизации:

При публикации 1С через Apache часто возникают характерные ошибки. Рассмотрим наиболее распространённые:

Ошибка «Сервер 1С:Предприятия не обнаружен»:

• Проверьте, загружен ли модуль: apache2ctl -M | grep 1cws
• Убедитесь, что путь к wsap24.so корректен
• Проверьте права доступа к каталогу публикации: chown -R www-data:www-data /var/www/1c/

Ошибка 403 Forbidden:

# Проверяем логи Apache
tail -f /var/log/apache2/error.log

# Часто причина — SELinux (на CentOS/RHEL)
sudo setsebool -P httpd_can_network_connect 1
sudo setsebool -P httpd_unified 1

Веб-клиент открывается, но зависает при входе:

• Проверьте доступность сервера 1С с машины Apache: telnet srv-1c 1541
• Убедитесь, что кластер 1С запущен: sudo systemctl status srv1cv83
• Проверьте файл default.vrd — строка подключения должна быть корректной

Медленная работа веб-клиента:

• Включите сжатие (mod_deflate)
• Убедитесь, что используется HTTPS/2: sudo a2enmod http2
• Увеличьте poolSize в default.vrd
• Проверьте, нет ли нехватки оперативной памяти: free -h