Подключите Seafile и Collabora, используя правильный URL-адрес WOPI.
Обеспечьте безопасное редактирование документов в Seafile, настроив URL-адрес обнаружения Collabora, HTTPS и доступ WOPI для вашей системы.
Восстановить функции копирования и вставки между Collabora и настольными приложениями.
Начните с тестирования с использованием обычного текста и клавиатуры: скопируйте текст из локального приложения, щелкните внутри документа Collabora и нажмите клавишу Enter Ctrl+V(или Command+Vна macOS). Чтобы скопировать текст, выделите его в Collabora, нажмите Enter Ctrl+Cили Enter Command+C, а затем вставьте в локальное приложение. Если сочетания клавиш работают, но вставка с панели инструментов или щелчка правой кнопкой мыши не работает, вероятная проблема — это путь к разрешению буфера обмена браузера. Если сочетания клавиш тоже не работают, проверьте оба направления и убедитесь, что Collabora не встроена в другой сайт.
Перед изменением настроек оцените причину неисправности.
Системный буфер обмена — это общий буфер, который передает данные между приложениями. Collabora Online работает внутри браузера, поэтому копирование данных за его пределы также проходит через правила безопасности браузера.
- Откройте простой локальный текстовый редактор и скопируйте одно короткое предложение, не содержащее конфиденциальной информации. В Collabora щелкните в теле документа и используйте сочетание клавиш для вставки.
- Теперь скопируйте короткое предложение из документа Collabora и вставьте его в локальный редактор.
- Наконец, выполните копирование и вставку между двумя локальными приложениями. Если и этот последний тест не пройден, сначала устраните неполадки в операционной системе или буфере обмена удаленного рабочего стола; Collabora — не единственное приложение, которое может быть затронуто.
Для первого теста используйте обычный текст. Изображения, таблицы, диапазоны электронных таблиц и форматированный текст могут использовать разные форматы буфера обмена, поэтому тест с обычным текстом позволяет отделить проблемы с базовым доступом от проблем с преобразованием формата.
Попробуйте сначала воспользоваться клавиатурой браузера.
Щелкните область редактирования документа, чтобы она оказалась в фокусе. Используйте системное сочетание клавиш, а не панель инструментов редактора или контекстное меню браузера. В Windows и Linux используйте Ctrl+Cи Ctrl+V; в macOS используйте Command+Cи Command+V. Когда в сообщении Collabora говорится, что браузер имеет ограниченный доступ к буферу обмена и предлагает использовать сочетания клавиш, следуйте этой инструкции. Действие клавиатуры напрямую связано с жестом пользователя и может работать даже в том случае, если действие меню, вызывающее асинхронный API буфера обмена, заблокировано.
Если это не так, убедитесь, что документ доступен для редактирования, курсор находится в документе, а не в поле поиска или на панели инструментов, и исходный текст действительно выделен. Закройте и откройте документ один раз после изменения прав доступа; устаревший редактор может сохранять предыдущую политику.
Сначала убедитесь, что получен обычный текст. Затем протестируйте необходимый расширенный контент; шрифты, формулы, изображения и форматы ячеек могут передаваться не идентично. Используйте функцию «Специальная вставка», если она доступна в месте назначения.
Разрешите доступ к буферу обмена в браузере.
Современный API буфера обмена ограничен защищенными контекстами, обычно HTTPS, и браузеры могут запрашивать у пользователя разрешение или действие. В Chrome или Edge откройте информацию о сайте рядом с адресом, откройте настройки сайта и установите для буфера обмена значение « Разрешить» для доверенного сайта, если такое разрешение доступно. Если при выборе «Вставить» появляется запрос в браузере, разрешите его только для того офисного сервиса, которому вы доверяете. Перезагрузите документ и повторите проверку двустороннего ввода текста.
Метки разрешений буфера обмена и их поведение различаются в зависимости от браузера. Некоторые браузеры используют жест пользователя или кратковременное приглашение к вставке вместо постоянного разрешения. Управляемый браузер также может применять политику, которая отменяет ваш выбор; если управление заблокировано или разрешение запрещено политикой, попросите администратора браузера проверить правило для офисного сайта. Используйте HTTPS для доступа к сайту: предоставление разрешения не превращает небезопасный источник в безопасный контекст.
Если Collabora находится внутри iframe, проверьте интеграцию.
iframe — это веб-страница, встроенная в другую страницу. Во многих развертываниях Collabora используется iframe, чтобы хост-платформа могла отображать редактор. В браузерах на основе Chromium для кросс-доменного фрейма может потребоваться, чтобы встраиваемая страница делегировала доступ к буферу обмена. В руководстве по SDK Collabora описан этот атрибут iframe для запроса разрешения на доступ к буферу обмена:
<iframe allow="clipboard-read *; clipboard-write *">
Это настройка интеграции, которая создает фрейм, а не настройка Docker на сервере Collabora. Если вы обслуживаете основное приложение, проверьте фактический iframe редактора в инструментах разработчика браузера и убедитесь, что Permissions-Policyзаголовок ответа родительской страницы не блокирует clipboard-readили clipboard-write. Ограничительная политика родительского элемента может по-прежнему запрещать доступ, даже если у iframe есть allowатрибут. Делегируйте доступ только к тому фрейму Collabora, который необходим вашим пользователям; не предоставляйте широкий доступ к буферу обмена для несвязанного встроенного контента.
Если вы используете размещенный Nextcloud, обучающую платформу или портал документов и не можете редактировать разметку фрейма или заголовки ответа, отправьте администратору браузер и его версию, укажите, какой способ не сработал, работают ли сочетания клавиш и любые ошибки в консоли, связанные с буфером обмена. Возможно, им потребуется обновить интеграцию. Изменение сетевых портов CODE или перезапуск контейнера не предоставит браузеру разрешение на использование iframe.
Используйте симптом, чтобы выбрать следующую проверку.
| Что вы наблюдаете | Что проверить дальше |
|---|---|
Функция вставки с панели инструментов не работает, но Ctrl+Vработает. | Воспользуйтесь сочетанием клавиш или предоставьте запрошенному браузеру разрешение на доступ к буферу обмена для доверенного сайта. |
| Не удается только скопировать данные из Collabora на рабочий стол. | Проверьте ограничения на копирование или права на запись в браузере; убедитесь, что копируется только выделенный текст. |
| Не удается выполнить только вставку данных с рабочего стола в Collabora. | Проверьте разрешение браузера на вставку, фокус в документе и наличие у хост-фрейма прав на чтение. |
| В консоли отображается сообщение: «API буфера обмена заблокирован политикой разрешений». | Встроенная страница или заголовок ответа блокируют доступ. Владелец интеграции должен внести необходимые изменения. |
| Обычный текст работает, а расширенный контент — нет. | Сравните поддерживаемые форматы буфера обмена и параметры вставки целевого приложения; возможно, это ограничение, связанное с точностью форматирования, а не с полным сбоем буфера обмена. |
Подтвердите результат
После изменения разрешений или интеграции откройте документ заново и повторите оба теста с обычным текстом: сначала локальное приложение в Collabora, затем Collabora в локальное приложение. Убедитесь, что текст отображается в нужном месте, затем протестируйте конкретный расширенный контент, на который вы полагаетесь. Если после изменения работает только меню, проверьте также маршрут клавиатуры; если работают только сочетания клавиш, значит, основной путь к буферу обмена пригоден для использования, но асинхронный путь к разрешению браузера может быть по-прежнему заблокирован.
Правила безопасности, регулирующие доступ к буферу обмена браузера, см. в справочнике MDN по API буфера обмена . Для получения информации о настройках разрешений сайтов в Chrome используйте справку в настройках сайтов Chrome . Владельцы интеграций могут ознакомиться с документацией Collabora по расширенной интеграции , чтобы узнать о требованиях к разрешению на доступ к буферу обмена в iframe.
Восстановить функции копирования и вставки между Collabora и настольными приложениями.
Проверьте буфер обмена системы, настройте разрешения браузера и определите, когда для встроенной интеграции Collabora требуется изменение политики iframe.
Сделайте пользовательские шрифты доступными в Docker-контейнере Collabora CODE.
Смонтируйте файлы шрифтов в Docker и системную панель Collabora, чтобы пользовательские шрифты отображались в редакторе и корректно отображались в документах.
Восстановите настройки кода Collabora без потери изменений развертывания.
Создайте резервную копию файла coolwsd.xml и его исходных файлов развертывания, безопасно восстановите их и проверьте код, прежде чем пользователи вернутся к редактированию.
Исправьте проверку хоста WOPI в CODE, сопоставив источник хоста.
Разрешите использование именно Nextcloud или другого источника WOPI в коде, затем проверьте список разрешенных активных хостов и сопоставьте его с ограничением Nextcloud по IP-адресу источника.
Исправлена ошибка Collabora «Ну, это неловко».
Проанализируйте соединения Collabora с браузером, WOPI и WebSocket, чтобы выяснить, почему документ не открывается, а затем примените исправление, соответствующее вашей настройке Nextcloud.
Запуск Collabora Online на узлах Kubernetes
Разверните реплики Collabora CODE с помощью Helm, разместите каждый документ в отдельном поде с помощью привязки WOPI и проверьте входящий трафик, размещение узлов и редактирование в Nextcloud.
Восстановите WebSocket-соединение Collabora через прокси-сервер.
Проследите за ошибкой установления соединения между браузером и coolwsd, затем сопоставьте маршрут обратного прокси с вашей версией Collabora, включая изменение Apache в коде 26.04.
Устранение ошибок подтверждения WOPI путем проверки ключей, обнаружения и URL-адресов.
Обнаруживайте причины сбоев подтверждения WOPI в Collabora, такие как несоответствие ключей, устаревшие данные обнаружения, смещение времени или изменения URL-адресов прокси-сервера, — без ослабления проверки.
Исправлена ошибка отображения выпадающего списка размеров шрифта в Collabora Online.
Сбросьте масштаб браузера, протестируйте чистую сессию и определите, когда меню с некорректным размером требует обновления сервера Collabora.