К статье
Практический материал

Администрирование · 8 мин

Как опубликовать дистрибутив тонкого клиента 1С

Пошаговая инструкция: как опубликовать дистрибутив тонкого клиента 1С через веб-сервер Apache или IIS, настроить default.vrd и проверить загрузку клиента.

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

Механизм работает и на Apache, и на IIS: в файле публикации default.vrd указывается специальный элемент, описывающий, где лежат файлы дистрибутива и какие архитектуры доступны. Ниже разобраны подготовка файлов, синтаксис публикации, настройка прав доступа и проверка результата.

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

Что понадобится перед публикацией

Для работы потребуется веб-сервер (Apache 2.2/2.4 или IIS), установленные модули расширения веб-сервера 1С (wsap24.dll или аналог для вашей версии Apache) и сам дистрибутив тонкого клиента нужной версии платформы. Версия публикуемого дистрибутива должна совпадать с версией сервера 1С, иначе клиенты будут получать несовместимую платформу.

Убедитесь, что у учётной записи, под которой работает веб-сервер, есть права на чтение каталога с дистрибутивом. На Windows это обычно IIS_IUSRS или пользователь пула приложений, на Linux — пользователь www-data или apache в зависимости от дистрибутива.

Где взять файлы дистрибутива

Дистрибутив тонкого клиента находится в каталоге установки платформы или скачивается с портала 1С отдельным пакетом. Для публикации используются упакованные файлы — архивы и установочные пакеты для каждой поддерживаемой архитектуры: Windows 32/64, Linux, macOS.

Рекомендуется скопировать файлы дистрибутива в отдельный каталог, например C:\inetpub\1c-dist или /var/www/1c-dist, а не ссылаться на каталог установки платформы. Это упрощает обновление: при выходе новой версии вы заменяете файлы в одном месте, не трогая установленную платформу.

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

Самый простой способ — штатный диалог публикации. Откройте конфигуратор, перейдите в меню «Администрирование → Публикация на веб-сервере», выберите веб-сервер и задайте имя публикации. На вкладке параметров включите флажок «Публиковать дистрибутив тонкого клиента» и укажите каталог, куда вы скопировали файлы дистрибутива.

После нажатия «Опубликовать» конфигуратор сформирует файл default.vrd с нужным элементом и пропишет настройки в конфигурацию веб-сервера. Затем перезапустите веб-сервер, чтобы изменения вступили в силу.

Порядок действий
  1. 1
    Установите модули расширения веб-сервера 1С и убедитесь, что публикация базы работает
  2. 2
    Скопируйте файлы дистрибутива тонкого клиента в отдельный каталог, доступный веб-серверу
  3. 3
    Откройте «Администрирование → Публикация на веб-сервере» в конфигураторе
  4. 4
    Включите флажок «Публиковать дистрибутив тонкого клиента» и укажите каталог с файлами
  5. 5
    Нажмите «Опубликовать» и перезапустите веб-сервер (iisreset или systemctl restart apache2)
  6. 6
    Откройте в браузере адрес публикации и проверьте, что ссылка на скачивание клиента доступна

Ручная настройка default.vrd

Если вы редактируете публикацию вручную, добавьте в default.vrd элемент point с именем dist внутри элемента ws. Он задаёт базовый URL и каталог с дистрибутивом, а вложенные элементы описывают архитектуры.

xml
<point name="dist" alias="dist">
  <dist root="C:\inetpub\1c-dist">
    <arch name="win32" path="win32"/>
    <arch name="win64" path="win64"/>
  </dist>
</point>

Атрибут alias определяет относительный адрес, по которому будет доступен дистрибутив, например http://server/base/dist. Вложенные каталоги win32, win64 и другие должны физически существовать внутри корневого каталога и содержать соответствующие установочные файлы.

После правки файла вручную обязательно перезапустите веб-сервер и проверьте синтаксис XML: лишний или незакрытый тег приведёт к тому, что вся публикация перестанет работать, а не только раздача дистрибутива.

Настройка прав и особенности IIS и Apache

На IIS проверьте, что для каталога с дистрибутивом разрешено чтение и что MIME-типы установочных файлов не блокируются фильтрацией запросов. По умолчанию IIS может отклонять запросы к файлам с неизвестными расширениями — добавьте нужные MIME-типы в настройки сайта.

На Apache убедитесь, что директива каталога разрешает доступ (Require all granted для Apache 2.4) и что нет ограничений на скачивание исполняемых файлов. Также проверьте, что путь к каталогу не содержит кириллицы и пробелов — это частая причина ошибок доступа.

Контрольные точки

Как проверить результат

Открытие адреса публикации в браузере
Норма

Страница базы открывается, при отсутствии клиента предлагается скачивание

Тревожный признак

Ошибка 404 или 500 на всей публикации

Прямой запрос к /dist
Норма

Файл дистрибутива начинает скачиваться

Тревожный признак

403 Forbidden — проблема с правами на каталог

Версия скачанного клиента
Норма

Совпадает с версией сервера 1С

Тревожный признак

Клиент старее или новее сервера — обновите файлы дистрибутива

Обновление дистрибутива при смене версии платформы

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

Полезно выстроить регламент: обновление сервера, замена файлов дистрибутива и проверка скачивания выполняются одним шагом. Иначе пользователи получат клиент, который не сможет подключиться к обновлённому серверу.

Типичные ошибки
01
Указание каталога установки платформы вместо отдельного каталога — при обновлении платформы публикация ломается или раздаёт не те файлы
02
Отсутствие прав на чтение каталога у учётной записи веб-сервера — браузер получает 403 Forbidden
03
Версия дистрибутива не совпадает с версией сервера — клиент устанавливается, но не подключается
04
Забытый перезапуск веб-сервера после правки default.vrd — изменения не применяются
05
Кириллица или пробелы в пути к каталогу — ошибки доступа на отдельных конфигурациях веб-сервера

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

Можно ли опубликовать дистрибутив без публикации самой базы?

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

Почему браузер показывает 403 при попытке скачать дистрибутив?

Чаще всего у учётной записи веб-сервера нет прав на чтение каталога с файлами. Проверьте NTFS-права на Windows (пользователь пула приложений или IIS_IUSRS) или права пользователя apache/www-data на Linux. Вторая причина — блокировка исполняемых файлов настройками фильтрации запросов IIS.

Нужно ли публиковать дистрибутивы для всех архитектур?

Нет, достаточно тех платформ, с которых реально работают пользователи. Если все рабочие места — Windows 64-bit, можно ограничиться архитектурой win64. Лишние архитектуры не мешают, но занимают место и требуют обновления.

Как пользователь узнает, откуда скачивать клиент?

При открытии веб-клиента, если платформа не установлена или её версия не подходит, страница автоматически предложит ссылку на скачивание из опубликованного дистрибутива. Дополнительно можно сообщить пользователям прямой адрес вида http://сервер/имя_публикации/dist.

Что делать после обновления платформы на сервере?

Замените файлы в каталоге дистрибутива на файлы новой версии, сохранив структуру папок архитектур, и проверьте скачивание. Файл default.vrd править не нужно, если пути не изменились. Перезапуск веб-сервера после замены файлов обычно не требуется, но проверка скачивания обязательна.

Итог

Что важно запомнить

Дистрибутив тонкого клиента публикуется элементом dist в default.vrd или флажком в диалоге публикации конфигуратора. Используйте отдельный каталог для файлов, следите за совпадением версий клиента и сервера, проверяйте права доступа и перезапускайте веб-сервер после изменений.