Справочник системных ошибок и решений

Windows Server, Active Directory, 1С:Предприятие, СУБД, Linux, Cisco, MikroTik, Asterisk.

⚠️ Важная информация Все материалы, инструкции, команды и скрипты на сайте предоставлены исключительно в ознакомительных целях. Их применение может повлиять на работу операционной системы, программного обеспечения, баз данных, сетевого оборудования и других компонентов инфраструктуры. Перед выполнением действий создайте резервную копию и по возможности протестируйте изменения в безопасной среде. Пользователь самостоятельно оценивает риски и несет ответственность за результат. При отсутствии необходимых знаний обратитесь к квалифицированному ИТ-специалисту.

1C_APACHE_PUBLISH_FAIL 1С:Предприятие и СУБД

Публикация баз 1С на веб-сервере Apache 2.4 в Linux и Windows

Обновлено: 26.08.2026 · Официальная документация ↗
  • Ошибка HTTP 500 Internal Server Error при переходе по ссылке опубликованной базы в браузере.
  • Ошибка Cannot load /opt/1cv8/.../wsap24.so into server при старте Apache.
  • Веб-клиент не открывается, возвращая белый экран или 404 Not Found.
  • Сбои работы мобильных приложений и HTTP-сервисов (OData, REST API) 1С.

1. Подготовка модулей веб-расширения 1С

При установке платформы 1С должен быть выбран компонент Модули расширения веб-сервера (Web Server Extensions). Он содержит библиотеку wsap24.so (Linux) или wsap24.dll (Windows).

2. Автоматическая публикация базы через утилиту `webinst`

# Синтаксис webinst в Linux:
sudo /opt/1cv8/x86_64/8.3.23.1865/webinst \
  -publish \
  -apache24 \
  -wsdir trade_base \
  -dir /var/www/trade_base/ \
  -connstr "Srvr=srv-1c.corp.local;Ref=trade_production;" \
  -confpath /etc/apache2/apache2.conf

В Windows:

"C:\Program Files\1cv8\8.3.23.1865\bin\webinst.exe" -publish -apache24 -wsdir trade_base -dir "C:\inetpub\wwwroot\trade_base" -connstr "Srvr=localhost;Ref=trade_production;" -confpath "C:\Apache24\conf\httpd.conf"

3. Ручная проверка файла конфигурации публикации `default.vrd`

В каталоге публикации (/var/www/trade_base/default.vrd) должен быть создан XML-дескриптор:

<?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="/trade_base"
       ib="Srvr=srv-1c.corp.local;Ref=trade_production;">
    <ws enable="true"/>
    <httpServices publishByDefault="true"/>
    <standardOData enable="true"/>
</point>

4. Настройка прав веб-сервера в Linux

# Назначение владельца каталога публикации (www-data для Ubuntu/Debian, apache для RHEL/Astra)
sudo chown -R www-data:www-data /var/www/trade_base/
sudo chmod 755 /var/www/trade_base/
sudo chmod 644 /var/www/trade_base/default.vrd

# Перезапуск веб-сервера
sudo systemctl restart apache2 || sudo systemctl restart httpd
💡 Практика специалистов: Пользователь веб-сервера (www-data/apache) должен иметь права на чтение каталогов платформы /opt/1cv8/ и доступ к файлам лицензий /var/1C/licenses, иначе веб-клиент вернет ошибку 'Не найдена лицензия' даже при живом кластере.

Частые вопросы (FAQ)

Какую версию Apache поддерживает платформа 1С:Предприятие 8.3?

Платформа поддерживает модуль wsap24 для веб-серверов Apache версий 2.4.x (как 32-bit, так и 64-bit в зависимости от разрядности установленной платформы).

Как включить поддержку REST API (OData) для опубликованной базы?

В файле default.vrd внутри корневого тега <point> добавьте элемент <standardOData enable="true"/> и перезапустите веб-сервер.

Почему возникает ошибка 'Cannot load wsap24.so: undefined symbol'?

Разрядность Apache не совпадает с разрядностью установленного модуля 1С (например, 64-битный Apache пытается загрузить 32-битный wsap24.so) или отсутствуют необходимые зависимости ядра Linux.

Где сохраняются ошибки веб-клиента при сбое подключения к 1С?

В стандартных журналах ошибок Apache: /var/log/apache2/error.log (Linux) или C:\Apache24\logs\error.log (Windows).

Полезные материалы
Рекомендуем