修正 Collabora Online “Socket 連線意外關閉”問題:WebSocket 和代理程式檢查
透過檢查 26.04 WebSocket 變更、代理程式路由、升級標頭、逾時、TLS 和日誌來修復 Collabora Online 套接字連線錯誤。
要在 Collabora Online 中對多種語言進行拼字檢查,設定雙方必須達成協議:伺服器必須提供並允許使用所需的字典,並且文件文字必須標記其實際使用的語言。僅啟用紅色底線並不能使 Collabora 可靠地識別混合語言文件中的每種語言。
範例:假設北區掃盲網路(Northside Literacy Network)正在同一個 Writer 文件中準備一份志工指南,其中包含英文說明和西班牙語家庭資源。這是一個虛構的範例,用於解釋步驟;它並不描述真實的組織或經過測試的 Collabora 部署。目標是使英文文本與英文字典進行校對,西班牙文文本與西班牙文字典進行校對,同時保持人名和專業術語易於核對。
Collabora Online 的編輯引擎運行在伺服器上。因此,在作者的筆記型電腦上安裝字典並不一定能將其添加到線上編輯器中。 Collabora 伺服器需要相應的寫作輔助字典,且其配置必須支援該語言。管理員可能需要進行此變更;文件編輯器通常無法透過瀏覽器安裝伺服器級語言資源。
使用者介面語言與文件校對語言是分開的。例如,將選單語言變更為西班牙語並不會自動標記檔案中的西班牙語段落,也不能保證伺服器擁有西班牙語拼字檢查字典。
在更改伺服器之前,請詢問管理員您使用的是哪種 Collabora 部署方式:CODE 容器、透過軟體套件安裝的 Collabora Online、託管服務,還是由其他平台提供的 Office 整合。配置的位置和持久性各不相同。對於託管服務,使用者可能需要服務提供者啟用字典,而不是自行編輯配置。
列出實際使用的書寫語言及其區域變體。例如,對於 Northside 的虛構指南,這可能包括美式英語和西班牙語。如果文件需要加拿大法語或巴西葡萄牙語,請盡可能使用匹配的變體,而不是假設所有區域詞典都可以互換。 Collabora 的語言代碼清單是伺服器設定細節;執行中的部署顯示的程式碼可能使用類似 `<language_name>` 的形式en_US,而文件介面可能顯示易於理解的語言名稱。
請將語言清單限制在使用者實際使用的語言範圍內。 Collabora 的配置說明中將其定義allowed_languages為寫作輔助工具支援的語言列表,並警告說,允許的語言過多可能會影響啟動效能。
在自行安裝的情況下,請確認已安裝每種語言的 Collabora/LibreOffice 語言字典軟體套件。軟體包名稱因發行版和 Collabora 版本而異,因此請查看適用於您作業系統的軟體包說明,而不要盲目複製 Ubuntu、Debian 或 RPM 軟體包名稱。如果缺少相應的字典模組,則選單中可能會出現某個語言環境,但沒有可用的拼字檢查器。
如果您使用的是官方的 CODE Docker 映像,請按照其目前的容器配置說明選擇字典。不要假設在應用程式本身環境中新增語言環境或在主機上安裝字典會自動更新正在執行的容器。請在容器部署定義中保留相關設置,以防止重新建立或鏡像更新時將其靜默刪除。
對於基於軟體包的部署,管理員可能需要使用安裝程式支援的語言程式碼更新設定allowed_languages。coolwsd.xml該值的簡化範例可能如下所示:
<allowed_languages>en_US es_ES</allowed_languages>
此程式碼片段僅用於展示清單;它並非完整的配置文件,不應替換文件中已有的屬性或部署特定的設定。對於 CODE 容器,請透過支援的 Docker 配置方法,針對確切的映像版本套用語言選擇。如果部署管理員會在重新啟動時丟棄臨時容器文件,請勿編輯該文件。
字典和允許清單更新後,請使用該安裝對應的服務流程重新啟動或重新部署 Collabora。檢查伺服器日誌或提供者的運作狀況視圖,查看是否有啟動錯誤。重啟成功僅表示基礎架構檢查完成;接下來,請驗證目標語言是否出現在編輯器的語言清單中,以及每種語言的範例字詞是否已正確選取。
在 Collabora Online Writer 中開啟文件。選擇需要不同校對語言的英文或西班牙文文本,然後使用「工具」選單中的語言指令。 Collabora 的 Writer 介面提供所選文字、段落或整個文件的語言選項;選單的具體措辭和位置可能因 Collabora 版本以及啟用的是選項卡式介面還是經典介面而有所不同。以 Northside 的範例為例,選擇英文說明並選擇英文,然後選擇西班牙文家庭資源段落並選擇西班牙文。
對於需要重複使用的文本,段落樣式通常比直接對每個段落進行重複格式化更易於維護。標題或正文樣式可以包含預期的語言,因此後續使用該樣式的段落將採用相同的校對語言。請先查看現有文件:文字可以從段落樣式繼承語言,也可以為特定字詞指定更具體的語言。
如果文件確實是多語言的,請勿選擇「整個文件」。這樣做會更改現有內容的整體語言,可能導致西班牙語部分被誤判為英語,反之亦然。同樣,預設文檔語言不能替代為文檔指定第二種語言。
如果「工具」>「自動拼字檢查」功能已關閉,請將其開啟。這樣,噹噹前文檔語言有可用的字典時,拼寫錯誤的單字會在您輸入時被標記出來。若要進行手動檢查,請選擇“工具”>“拼字檢查”,如果您的部署環境顯示的是“審閱”選項卡,請使用該選項卡,或按 F7 鍵(瀏覽器和平台支援此快捷鍵)。
當拼字對話方塊找到某個單字時,在接受建議之前,請先驗證該段落所指派的語言。即使字典發出警告,人名、組織名稱、地名、縮寫或外來語也可能是正確的。如果部署允許,請將可信任的常用字詞加入對應的使用者字典;不要僅為了清除下劃線而接受變更。
第一次檢查時,請使用簡短的測試稿,而不是直接編輯正式文件。在 Northside 的虛構指南中,在英語部分和西班牙語部分分別故意拼錯一個常用詞,並在每個部分都包含一個拼寫正確的詞。為每個段落指定語言,啟用自動檢查,並執行手動拼字檢查。預期結果是,拼字錯誤會被辨識出來(使用對應的字典),而正確的字不會被標記。之後刪除測試錯誤。
如果語言選單中缺少某種語言或沒有提供任何有用的建議,則問題可能出在伺服器端:字典未安裝、語言環境未被允許、新配置尚未套用,或者編輯器連接到的 Collabora 實例與管理員更改的實例不同。如果某種語言可用,但某個段落中的每個單字都被標記,請在更改伺服器軟體包之前檢查該段落的指定語言和段落樣式。
關閉並重新開啟文件後,也請檢查已儲存的文件。語言格式屬於文件內容,而拼字檢查下劃線可能是本機視圖設定。請確認語言分配仍然與正確的段落關聯,其他授權編輯也能看到相同的校對效果。
在託管的 Nextcloud、ownCloud 或其他託管整合中,平台團隊或服務提供者可能控制 Collabora 伺服器的配置。請提供管理員所需的語言程式碼、Collabora 版本或部署類型(如果已知),以及缺失語言的描述。請他們確認字典已安裝且該語言已獲準使用。僅請求更改預設文檔語言可能無法解決問題。
如果啟用了 LanguageTool 等外部語法服務,請將其視為與內建拼字檢查字典不同的獨立功能。 Collabora 將遠端語法檢查列為可設定服務;根據設定情況,文件文字可能會傳送至該服務。啟用遠端檢查器之前,請務必查看組織的隱私和資料處理要求。並非僅僅為了分配多種本地詞典語言,才需要使用遠端檢查器。
選單標籤和部署機制可能會因版本和整合而異。請查閱文檔,確認您所使用的 Collabora Online 版本和容器或軟體包是否與文檔完全一致。有用的參考資料包括Collabora 的文檔語言選擇指南、語言選項參考和拼字對話方塊參考。有關伺服器配置,請參閱Collabora Online SDK 手冊和官方 CODE Docker 配置指南。此處引用的指南和選單已於 2026 年 10 月 6 日進行核實;在更改生產服務之前,請務必根據您已安裝的版本進行驗證。
透過檢查 26.04 WebSocket 變更、代理程式路由、升級標頭、逾時、TLS 和日誌來修復 Collabora Online 套接字連線錯誤。
在 Collabora Online 中啟用多語言拼字檢查,方法是新增伺服器字典、允許語言程式碼、為文字指派語言以及測試混合語言文件。
使用 Calc 資料、命名影像佔位符和基本宏,建立可靠的 LibreOffice Writer 郵件合併,支援每筆記錄新增影像,並提供故障排除和驗證步驟。
透過檢查 WOPI、反向代理、TLS、DNS、WebSocket 和伺服器到伺服器的可及性,診斷並修復 Collabora Online 文件連線故障。
在 ONLYOFFICE Desktop Editors 中離線將 PDF 檔案轉換為可編輯的 DOCX 檔案。依照「另存為」步驟操作,檢查 PDF 檔案是否為掃描件,並檢查格式。
使用 Docker 或獨立主機將 Seafile 連接到 Collabora Online。比較部署方案的優缺點,配置 HTTPS 和 WOPI 設置,並驗證編輯功能。
診斷 LibreOffice Writer 檔案中影像較多時出現的打字、滾動和保存速度緩慢的問題。測試顯示設置,壓縮過大的圖片,並找出設定檔或硬體問題。
使用官方 Helm chart 在 Kubernetes 上部署 Collabora CODE。設定入口、TLS、WOPI 主機存取、金鑰、擴充和端對端檢查。
透過壓縮過大的照片、選擇合理的解析度和 JPEG 質量,並檢查已儲存的文件,在不犧牲幻燈片可讀性的前提下,縮小 LibreOffice Impress 簡報的大小。
在 Docker 中安裝 Collabora Online CODE,透過反向代理程式安全地發布,將其連接到 Nextcloud Office,並驗證基於瀏覽器的文件編輯。