Когда Linux «не читает» русские буквы: как настроили обработку архивов в 1С:Документообороте

При внедрении Академической ГиперИнтеграции (АГИ) для 1С:Документооборота 3.0 у заказчика возникла проблема с загрузкой файлов из архивов «Диадока». Часть файлов не загружалась, а после распаковки вместо русских букв в их названиях отображались нечитаемые символы. Сервер 1С работал на Debian 12, а рабочие места пользователей — на Linux Mint.

Что должно было работать — и почему не работало
Старая схема, которая вдруг перестала работать
Решение: меняем инструмент и дорабатываем команду
Чек-лист для тех, кто столкнётся с похожей проблемой
Результат настройки

АГИ обеспечивает обмен данными между «Диадоком» и 1С:Документооборотом: автоматически создаёт документы и загружает присланные контрагентом файлы прямо в карточку документа. В обычном сценарии система получает архив, распаковывает его и сохраняет файлы с исходными названиями.

В этом проекте файлы не загружались в карточку документа.

А когда мы попробовали загрузить архив прямо из карточки документа, в папке появились файлы с нечитаемыми символами вместо названий. Ситуация выглядела так, будто система «забыла», как выглядят русские буквы.

Инфраструктурно проект был выстроен на Debian 12 (сервер) и Linux Mint (рабочие места пользователей). У нас уже был опыт работы с Linux-серверами, и раньше подобные задачи решались легко. Но здесь привычный подход дал сбой.

В предыдущих проектах для работы с архивами устанавливали архиватор unzip и задавали в 1С команду «unzip ’%1′ -d %2». Такая настройка работала, пока не встретились архивы с кодировкой CP866. Архиватор unzip некорректно распознавал имена файлов и превращал кириллицу в набор непонятных символов.

Ещё одна сложность заключалась в отладке: включить серверную отладку на Debian 12 — задача нетривиальная. К счастью, заказчик смог запустить её по протоколу HTTP, и это дало нам возможность глубже анализировать проблему.

После того как стало ясно, что проблема не в коде расширения, а в обработке кодировки архиватором, заказчик предложил использовать unar. Этот архиватор позволяет явно указать кодировку при распаковке.

Разработчик Академии Документооборота доработал логику в 1С, и команда приобрела следующий вид: «unar -e cp866 ’%1′ -o %2». После этого файлы начали загружаться корректно — с правильными названиями и без искажений.

Если вы работаете с загрузкой файлов из «Диадока» в 1С на Linux-сервере и сталкиваетесь с нечитаемыми именами файлов, проверьте следующие моменты:

• Установите подходящий архиватор. В нашем случае подошёл unar.

• Настройте права доступа к временной папке. У пользователя, под которым работает служба 1С, должны быть права на чтение и запись в каталоге /tmp/.

• Проверьте системную локаль сервера. Она должна поддерживать русский язык для корректной обработки кириллицы.

1. Скачайте ZIP-архив из «Диадока» по любому документу.

2. Распакуйте его на сервере 1С командой (с нужным архиватором) прямо в каталог /tmp/ — и обязательно под тем пользователем, от имени которого запущена служба 1С.

3. Проверьте, отображаются ли в названиях файлов русские буквы. Если да — настройки верны.

После перехода на unar и явного указания кодировки CP866 архивы стали распаковываться корректно, а файлы — загружаться в карточки документов с читаемыми названиями.

Эту настройку можно использовать, если на Linux-сервере архиватор unzip некорректно обрабатывает кириллические имена файлов из архивов «Диадока». Перед изменением команды следует проверить кодировку архива, права пользователя службы 1С на временный каталог и системную локаль сервера.