修正 Collabora Online 在本機應用程式之間複製貼上的問題

如果桌面應用程式中的複製貼上功能正常，但在這些應用程式與 Collabora Online 之間複製貼上卻失敗，這並非一定是作業系統剪貼簿本身出了問題。問題可能出在瀏覽器標籤頁、瀏覽器權限被阻止、嵌入式 Collabora 框架無法存取剪貼簿 API，或是貼上的內容類型。一個有效的解決方法是，您可以從本機應用程式複製一小段文字到 Collabora 文件中，然後複製出來，並確認格式和圖片是否也保留了下來。

請按以下順序進行檢查。首先檢查純文字和鍵盤快速鍵，然後檢查瀏覽器權限以及貴組織嵌入 Collabora 的方式。這樣可以區分工作站問題和整合問題，而無需不必要地更改伺服器設定。

剪貼簿內容能否在其他本機應用程式之間使用？

首先確認來源應用程式和目標應用程式可以在 Collabora 之外交換剪貼簿資料。從本機文字編輯器複製一句簡短的非敏感語句，然後將其貼上到另一個本機應用程式。之後反向複製貼上。如果此操作失敗，請先排查作業系統、遠端桌面會話、虛擬機器或剪貼簿管理器的問題。 Collabora 無法讀取從未到達設備剪貼簿的內容。

如果您使用的是遠端桌面、虛擬桌面或執行在遠端電腦上的瀏覽器，請檢查該工作階段是否啟用了剪貼簿共用。遠端會話中兩個應用程式之間的成功複製並不總是意味著文字可以在遠端會話和您的實體電腦之間傳輸。請測試雙向傳輸，並記錄傳輸停止的位置。

當 Collabora 獲得焦點時，鍵盤快速鍵是否有效？

開啟文檔，點選要貼上的文字或儲存格，然後使用作業系統提供的快速鍵：Windows 或 Linux 系統下按 `Ctrl+Shift+C`，Ctrl+CmacOS系統下按 `Ctrl+Shift+C`。為了進行簡單的測試，可以從本機應用程式複製純文本，例如「clipboard check 123」。避免從圖片、大型表格或帶有樣式的內容開始複製。Ctrl+VCommand+CCommand+V

Collabora Online 在瀏覽器中運行，因此編輯器必須在文件區域處於活動狀態時才能接收到按鍵操作。如果焦點位於瀏覽器網址列、搜尋框或其他頁面控件，則快捷鍵會作用於該控件。請在文件內按一下一次，然後重試。在 Calc 中，請確認目標儲存格或公式欄已獲得焦點；在 Writer 中，請將插入點置於文件正文中。

此外，還要比較工具列或上下文功能表中的「貼上」命令與鍵盤快速鍵。瀏覽器剪貼簿規則可能會阻止網頁按需讀取系統剪貼簿。 Collabora 的專案歷史記錄顯示，即使使用鍵盤快速鍵也能Ctrl+V正常運作，「貼上」選單仍然會提示使用快捷鍵。如果快速鍵有效且選單命令無效，請記錄此差異；這表示問題出在瀏覽器剪貼簿存取上，而不是系統剪貼簿。

Collabora Online是否透過HTTPS開放？

對於現代瀏覽器剪貼簿 API，頁面通常需要在安全性上下文中執行。請檢查網址列是否顯示您組織受信任的 HTTPS 位址，以及瀏覽器是否會報告憑證警告。 Mozilla 的剪貼簿 API 文件解釋說，對系統剪貼簿的讀寫存取僅限於安全上下文，並且可能還需要使用者啟動或瀏覽器權限。

如果您的 Collabora 部署位於反向代理程式之後，使用者可能會看到 HTTPS 頁面，但代理伺服器之間的連線可能會使用其他協定。請勿僅根據瀏覽器顯示的情況變更代理程式或 Collabora 的 TLS 設定。請管理員對照官方部署說明驗證外部 URL、TLS 終止方式和轉送方案。如果公共頁面已使用 HTTPS，且僅有一個整合失敗，請繼續進行框架和權限檢查。

瀏覽器是否阻止了此網站的剪貼簿存取權限？

檢查瀏覽器的網站權限，確定 Collabora 顯示的確切來源。在基於 Chromium 的瀏覽器中，使用網址列旁的網站資訊或設定控件，或在瀏覽器設定中搜尋「剪貼簿」。如果網站設定為“封鎖”，請僅針對受信任的文件網站變更權限，並且僅當您的組織允許使用剪貼簿時才進行變更。更改權限後，重新載入文檔，並使用純文字再次進行測試。

某些瀏覽器版本僅在頁面要求存取使用者操作期間才會顯示提示。僅當您確認網站及其貼上操作意圖時才接受提示。 Firefox 和 Safari 提供的 Chromium 剪貼簿權限控制選項不同，它們的提示或行為也可能有所差異。剪貼簿切換開關缺失並不表示瀏覽器有缺陷；請測試支援的鍵盤快速鍵並查看目前瀏覽器本身的權限管理介面。

Collabora 在 Collabora Online 24.04 中引入了一種新的直接剪貼簿存取方式。在瀏覽器支援相關 API 且使用者已授予存取權限的情況下，此方式可以簡化一些貼上操作。但這並不意味著每個部署或瀏覽器都會顯示相同的提示，也不能保證富文本、圖像和電子表格的貼上效果完全相同。在請求管理員升級之前，請先查看您已部署的 Collabora 版本和官方發行說明。

Collabora 是否嵌入在其他應用程式中？

如果 Collabora 在入口網站、學習平台或文件共享產品中打開，宿主應用程式可能會將其嵌入到跨域 iframe 中。在 Chromium 瀏覽器中，iframe 的剪貼簿存取權限取決於瀏覽器的權限策略以及使用者的瀏覽器權限。嵌入頁面可能需要將權限委託clipboard-read給clipboard-writeCollabora 來源。使用者無法透過重複更改瀏覽器權限來修復缺少的 iframe 策略。

請主機整合管理員檢查實際的 iframe 和回應Permissions-Policy頭。 iframe 的allow屬性應該只授予受信任的 Collabora 來源所需的剪貼簿功能，且父回應策略必須允許該來源。不要使用範圍很廣的通配符允許清單作為捷徑。具體的來源取決於您的部署，即使 iframe 本身聲明了允許，父策略仍然可能阻止存取。

當 Collabora 在其直接 URL 上可以正常運作，但在主機入口網站內卻出現故障，或同一入口網站上的使用者在 Chromium 瀏覽器中持續遇到問題時，此診斷尤其重要。請向管理員提供瀏覽器名稱和版本、主機和 Collabora 來源、問題是否影響複製、貼上或兩者都受影響，以及任何提及剪貼簿存取或權限策略的瀏覽器控制台訊息。在共享螢幕截圖或日誌之前，請刪除文件內容和帳戶詳細資訊。

純文字格式能否正常顯示，而圖片格式會失效？

如果貼上一段簡短的文字樣本可以正常貼上，但貼上富文本、電子表格區域或圖像卻不行，則表示基本的剪貼簿路徑沒有問題。剩下的問題可能是資料格式相容性或瀏覽器清理機制。瀏覽器和應用程式可以交換多種剪貼簿格式，但它們對每個樣式、公式、物件或圖像的保留方式並不相同。瀏覽器也可能出於安全考慮對 HTML 進行清理。

使用滿足您需求的最簡格式。對於文本，請嘗試使用「選擇性貼上」或「貼上時不顯示格式」（如果您的 Collabora 介面支援此選項）。對於表格，請先測試一小部分內容，並確認行和列是否正確顯示在預期的儲存格中。對於影像，請先將其貼上到另一個支援影像處理的本機應用程式中，以確認影像是否實際存在於系統剪貼簿中。貼上文字後圖像消失並不意味著剪貼簿訪問完全失效。

什麼時候應該測試其他瀏覽器或申請更新？

在測試完本機應用程式、HTTPS、捷徑和網站權限後，請在貴組織支援的另一個瀏覽器中重複相同的純文字測試。使用相同的設備、帳戶、文件和來源文本，以確保比較結果的有效性。如果一個瀏覽器可以正常工作而另一個瀏覽器則不行，請報告確切的瀏覽器版本以及是否已嵌入 Collabora。如果所有瀏覽器僅在一個宿主應用程式中出現故障，請專注於檢查其整合策略。如果故障是在更新後出現的，請將 Collabora、宿主應用程式和瀏覽器的版本與上次已知的正常工作配置進行比較。

不要以為清除所有瀏覽器資料、停用安全功能或升級某個元件就能解決所有問題。這些步驟可能會移除有用的網站狀態或引入其他相容性問題。建議僅在進行簡短的診斷測試時才使用隱私窗口，並避免停用組織所需的擴充功能。 Collabora 的支援論壇記錄了一個與整合相關的剪貼簿問題報告，該問題涉及主機 iframe 和 Chromium 瀏覽器；後續討論中介紹了一種自訂的主機端修復方案。請將此類報告視為針對特定網站進行診斷的重要性範例，而不是證明相同錯誤會影響所有安裝的證據。

成功的修復方案是什麼樣的？

• 從本機應用程式複製的純文字會顯示在 Collabora 中預期的遊標或儲存格。
• 從 Collabora 複製的文字可以貼上回本機應用程式。
• 重新載入文件並以正常工作流程開啟後，相同的測試也能正常運作。
• 任何剩餘的格式或影像遺失都僅限於這些格式，並且被理解為相容性問題。
• 如果嵌入，結果會在實際入口網站內確認，而不僅僅是在 Collabora 的直接 URL 上確認。

如果經過這些檢查後，基本文字測試仍然失敗，請將測試結果、瀏覽器和 Collabora 版本、文件是否嵌入以及完整的錯誤訊息傳送給管理員。這些資訊有助於區分問題出在工作站剪貼簿、瀏覽器限制、iframe 策略問題或版本特定的缺陷。瀏覽器剪貼簿 API 的設計本身就具有安全邊界，因此，要獲得正確的結果，可能需要經過批准的整合更改，而不是用戶端的開關操作。

來源：Collabora Online 24.04 發行說明；Mozilla MDN 剪貼簿 API 安全性與瀏覽器行為；Mozilla MDN 剪貼簿讀取文件；Collabora Online 常見問題；Collabora Online 支援論壇：嵌入式 Moodle 剪貼簿報告。