После пересборки контейнер Collabora CODE может перезапуститься с настройками по умолчанию, или же сбой сервера может лишить вас рабочей копии его конфигурации. Создайте резервные копии активных файлов coolwsd.xmlи файлов развертывания, содержащих настройки. Восстановите их в том же постоянном источнике, затем проверьте файл и службу, прежде чем пользователи смогут продолжить редактирование.
Основной файл обычно находится в папке ` /etc/coolwsd/coolwsd.xml.`. Источник достоверной информации различается для установок пакетов, Docker и Helm, поэтому определите тип развертывания, прежде чем что-либо копировать.
При установке пакета проверьте файл hosts. В Docker проверьте файл внутри запущенного контейнера и убедитесь, что файл hosts или каталог смонтированы поверх него. Сохраните также значения Compose, ссылки на файлы окружения или значения Helm: параметры запуска, указанные там, не обязательно хранятся в формате XML.
sudo ls -l /etc/coolwsd/coolwsd.xml
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
docker exec collabora-code ls -l /etc/coolwsd/coolwsd.xml
Замените collabora-codeна фактическое имя вашего контейнера. В документации по конфигурации Collabora и Docker описаны эти пути развертывания, а в исходном Helm-чарте представлены настройки на уровне чарта. Ознакомьтесь с документацией для вашей версии; значения по умолчанию и поведение при развертывании могут различаться в зависимости от версии.
/etc/coolwsd/coolwsd.xml.Сохраните копию с указанием даты в защищенном каталоге. Настройки могут раскрыть разрешенные хосты WOPI, поведение прокси-сервера, пути к сертификатам или административные параметры. Относитесь к резервной копии как к конфиденциальным оперативным данным.
При установке пакета необходимо сохранить метаданные файлов:
sudo install -d -m 700 /var/backups/collabora/$(date +%F)
sudo cp -a /etc/coolwsd/coolwsd.xml \
/var/backups/collabora/$(date +%F)/coolwsd.xml
sudo stat /var/backups/collabora/$(date +%F)/coolwsd.xml
Для Docker скопируйте исполняемый файл из контейнера на хост:
mkdir -p ~/backups/collabora/$(date +%F)
docker cp collabora-code:/etc/coolwsd/coolwsd.xml \
~/backups/collabora/$(date +%F)/coolwsd.xml
chmod 600 ~/backups/collabora/$(date +%F)/coolwsd.xml
Если файл предоставляется через привязку монтирования, создайте резервную копию и исходного файла на стороне хоста; именно этот файл может перезаписать изменения, внесенные внутри контейнера, при перезапуске. Храните файл Compose и все связанные с ним .envфайлы в одном защищенном наборе резервных копий. Для Helm сохраните файл с точными значениями и идентификатор релиза, а также отдельно управляемые секреты или ConfigMaps, используя существующий процесс обработки секретов.
Запишите тег образа CODE или версию пакета, имя контейнера, источник монтирования и дату резервного копирования. Установка пакетов может использовать cp -aэти данные для сохранения метаданных. Права собственности на файлы контейнера могут отличаться от прав собственности на хосте, поэтому не следует предполагать, что владелец или режим хоста подойдут для каждой версии образа.
Для Compose определите, смонтирован ли файл или весь каталог в указанном месте /etc/coolwsd. Смонтированный каталог может скрывать файлы, поставляемые в образе; неполный каталог может сделать ожидаемые файлы недоступными. Создайте резервные копии всех файлов в смонтированном каталоге, от которых зависит CODE. Храните настройки среды отдельно и защищайте секреты.
В случае с Helm не стоит полагаться на редактирование сгенерированного пода: обновления могут создать его заново. Сохраняйте значения диаграммы и любые внешние Secret или ConfigMap. Диаграмма Collabora, работающая с исходным кодом, поддерживает содержимое конфигурации через значения, поэтому её заявленный источник может быть более авторитетным, чем копия из работающего пода.
Остановите CODE или воспользуйтесь окном обслуживания. Сохраните текущий файл перед его заменой. При установке пакета восстановите выбранную резервную копию, сохранив права доступа и режим, ожидаемые для этого пакета:
sudo systemctl stop coolwsd
sudo cp -a /etc/coolwsd/coolwsd.xml \
/etc/coolwsd/coolwsd.xml.before-restore
sudo cp /var/backups/collabora/2026-10-09/coolwsd.xml \
/etc/coolwsd/coolwsd.xml
sudo chown root:cool /etc/coolwsd/coolwsd.xml
sudo chmod 640 /etc/coolwsd/coolwsd.xml
sudo systemctl start coolwsd
Владелец и группа образца могут не совпадать с вашим пакетом. Проверьте существующий файл statи сохраните ожидаемые права собственности и режим, вместо того чтобы слепо применять значения образца. Для контейнера, смонтированного с помощью bind-mount, восстановите файл hosts и следуйте инструкциям по перезапуску или пересозданию Compose. Если конфигурация предоставляется пользовательским образом или значением Helm, обновите этот источник и выполните повторное развертывание; изменения, внесенные в одноразовый контейнер, не сохранятся.
Перед восстановлением после изменения основной версии проверьте конфигурацию. Параметры могут меняться между выпусками, поэтому сравните сохраненный файл с шаблоном целевой версии и примечаниями по миграции. Восстановление XML-файла не восстанавливает сертификаты, закрытые ключи, пользовательские шрифты или конфигурацию обратного прокси-сервера, если они не были сохранены отдельно.
Убедитесь, что файл существует, доступен для чтения службой и имеет корректный XML-формат. Если установлен, xmllintпроверяется синтаксис:
xmllint --noout /etc/coolwsd/coolwsd.xml
Это подтверждает только синтаксис XML; это не доказывает, что все параметры поддерживаются вашей версией кода. Проверьте журналы на наличие ошибок синтаксического анализа и убедитесь, что служба продолжает работать. Для контейнеров проверьте docker compose psпоследние журналы. Для пакетов проверьте systemctl status coolwsdсистемный журнал.
Наконец, откройте документ через обычный хост WOPI и убедитесь, что он загружается и сохраняется. Если CODE запускается, но документы не загружаются, сравните восстановленный список разрешенных серверов, имя внешнего хоста, параметры завершения TLS и настройки прокси с настройками развертывания. Если запуск не удается, откатитесь к копии до восстановления и сравните файлы, прежде чем пытаться снова.
Смонтируйте файлы шрифтов в Docker и системную панель Collabora, чтобы пользовательские шрифты отображались в редакторе и корректно отображались в документах.
Создайте резервную копию файла coolwsd.xml и его исходных файлов развертывания, безопасно восстановите их и проверьте код, прежде чем пользователи вернутся к редактированию.
Разрешите использование именно Nextcloud или другого источника WOPI в коде, затем проверьте список разрешенных активных хостов и сопоставьте его с ограничением Nextcloud по IP-адресу источника.
Проанализируйте соединения Collabora с браузером, WOPI и WebSocket, чтобы выяснить, почему документ не открывается, а затем примените исправление, соответствующее вашей настройке Nextcloud.
Разверните реплики Collabora CODE с помощью Helm, разместите каждый документ в отдельном поде с помощью привязки WOPI и проверьте входящий трафик, размещение узлов и редактирование в Nextcloud.
Проследите за ошибкой установления соединения между браузером и coolwsd, затем сопоставьте маршрут обратного прокси с вашей версией Collabora, включая изменение Apache в коде 26.04.
Обнаруживайте причины сбоев подтверждения WOPI в Collabora, такие как несоответствие ключей, устаревшие данные обнаружения, смещение времени или изменения URL-адресов прокси-сервера, — без ослабления проверки.
Сбросьте масштаб браузера, протестируйте чистую сессию и определите, когда меню с некорректным размером требует обновления сервера Collabora.
Разверните Collabora CODE с помощью Docker, безопасно подключите его к Nextcloud Office и проверьте корректность редактирования документов с помощью практических проверок WOPI и прокси-сервера.
Временно переведите coolwsd в режим отладки, зафиксируйте одну неудачную попытку открытия и используйте последовательность логов для разделения проблем, связанных с WebSocket, WOPI, прокси и контейнерами.
