修復 Kopano 搜尋引擎 Python 服務崩潰問題

首先查看崩潰日誌，而不是搜尋索引。在傳統的 Kopano Core 伺服器上，搜尋引擎就是kopano-search服務本身。 Debian 原始碼套件將這一代產品描述為基於進程的索引器，建構於 python-kopano 之上。它連接到伺服器kopano-server，維護每個儲存位置的搜尋索引，並且可以選擇性地呼叫附件解析工具。請查看 Kopano Search 原始碼包。缺少 Python 模組、伺服器套接字不符、權限或磁碟空間問題，或附件解析器故障都可能導致不同的症狀。在確定故障原因之前重新啟動或刪除整個索引可能會掩蓋有用的線索，並增加工作。

本指南涵蓋執行經典kopano-search守護程式的安裝，包括較舊的 Kopano Core 軟體套件。目前可用於此服務的 Kopano 文件版本為 Kopano Core 8.0，而 Ubuntu 的存檔手冊頁則涵蓋了更早的軟體包版本，例如 8.7。在執行特定版本的指令之前，請確認您已安裝的 Kopano 版本及其本機手冊。 Kopano 雲端或容器部署可能使用不同的服務名稱和管理流程。

在進行任何更改之前，應該檢查哪些內容？

您需要擁有讀取 Kopano 日誌和配置的權限才能存取 shell。在編輯配置或修改索引檔案之前，請記錄軟體包版本並備份相關配置。請勿從其他伺服器複製索引路徑：不同軟體包版本的預設路徑和配置路徑可能有所不同。 Kopano 管理員手冊詳細介紹了/etc/kopano/search.cfg每個儲存的索引檔案、服務套接字和附件解析；手冊也警告不要在服務執行時更改索引檔案。 Kopano的搜尋配置部分是這些設定的主要參考。

1. 確認 kopano-search 是否真的崩潰

在使用 systemd 的系統上，檢查單元和最近的日誌條目：

sudo systemctl status kopano-search --no-pager
sudo journalctl -u kopano-search -b -n 100 --no-pager

尋找重複啟動嘗試、退出程式碼、Python 回溯資訊或特定的最終異常。回溯訊息的最後一行通常比第一行更有用，因為它會指出導致進程停止的錯誤。如果您的安裝使用較舊的 SysV 初始化腳本，請檢查sudo service kopano-search status並查看已設定的日誌檔案或系統日誌。服務可能會將日誌記錄到檔案或系統日誌中，具體取決於配置search.cfg，因此空日誌並不能證明沒有發生錯誤。

重啟前請儲存相關日誌。如果服務退出後 systemd 再次啟動它，你需要知道每次嘗試是否都失敗在同一階段，還是某個特定事件觸發了崩潰。

2. 檢查搜尋服務是否可以連接到 Kopano 伺服器

搜尋守護程序必須連接到正確的 Kopano 伺服器套接字。請檢查這兩個服務並比較它們配置的套接字值：

sudo systemctl status kopano-server --no-pager
sudo grep -E '^(server_socket|search_socket|search_enabled)[[:space:]]*='   /etc/kopano/server.cfg /etc/kopano/search.cfg

具體的密鑰集可能因版本而異。在經典的 Core 配置中，search_enabled = yes啟用全文搜尋server.cfg；search_socket並告知伺服器如何聯絡搜尋服務。搜尋服務的server_socket設定指向 Kopano 伺服器。不匹配、套接字缺失或伺服器停止運行都可能導致連線錯誤，這些錯誤看起來像是搜尋崩潰。當搜尋套接字不可用時，伺服器可以回退到直接資料庫搜索，但全文索引只有在搜尋服務恢復正常後才會恢復。

3. 將 Python 套件與 Kopano 建置進行匹配

kopano-search使用 Kopano 的 Python 綁定和原生 MAPI 元件。ImportError部分升級、軟體倉庫變更或手動安裝 Python 套件後，可能會出現缺少共用程式庫或模組載入錯誤。請記錄已安裝的軟體包以及已打包的可執行檔所使用的解釋器：

dpkg-query -W 'kopano-search' 'python*kopano*' 'python*mapi*' 2>/dev/null
p=$(command -v kopano-search) && head -n 1 "$p"

第二個命令僅在目前 shell 路徑中找到時才有效kopano-search。請將這些詳細資訊與您實際使用的 Kopano 軟體包集的儲存庫和安裝說明進行比較。如果伺服器是透過 RPM、容器或供應商設備管理的，請使用該平台的軟體包工具，而不是上述 Debian 命令。

請勿透過執行sudo pip install系統 Python 來修復已打包的 Kopano 伺服器。 Python-MAPI 包含原生元件，將其與不相關的 Python 套件混合使用可能會導致解釋器找到不相容的模組。請從相同可信任軟體倉庫恢復或重新安裝相符的 Kopano 軟體包，然後重新啟動服務並重新檢查日誌。如果機器的作業系統版本發生了升級，請在嘗試重新安裝軟體包之前，請確認 Kopano 軟體倉庫支援該作業系統/Python 組合。

4. 檢查權限、可用空間和附件解析狀況

讀取已配置的index_path、、和附件解析器設定。確認檔案系統有可用空間log_file，並且服務帳戶可以寫入配置預期的位置。例如：tmp_path/etc/kopano/search.cfg

df -h /var/lib/kopano /var/log
sudo namei -l /var/lib/kopano/search

將範例索引目錄替換為您自己配置中的值。諸如「權限被拒絕」、「空間不足」或臨時檔案建立失敗之類的錯誤表明是儲存存取問題，而不是 Python 程式崩潰。請使用伺服器文件中記錄的軟體包預設值來恢復預期的擁有者和權限；切勿/var/lib/kopano在未驗證其他服務是否使用該目錄的情況下遞歸更改所有目錄的所有權。

如果回溯或計時資訊指向附件提取，請檢查index_attachments = yes並檢查index_attachment_parser解析器資料庫及其呼叫的外部實用程式。 Kopano 手冊解釋說，附件內容由配置的腳本轉換為文本，並且可以設定附件大小、記憶體和 CPU 限制。作為診斷方法，您可以臨時設置index_attachments = no，重新啟動服務，然後查看崩潰是否停止。這將停用對附件內容的搜索，但不會停用郵件正文索引。如果故障消失，請先修復特定的解析器或依賴項，然後再重新啟用附件索引。

5. 僅當日誌指向索引損壞時，才重建受影響的儲存索引。

當服務啟動正常，但在開啟或更新某個商店的索引時反覆失敗，或 Kopano 日誌顯示該特定索引已損壞時，重新索引是合適的。但它並非解決 Python 導入錯誤、套接字不匹配或磁碟空間已滿等問題的首選方案。

kopano-searchKopano 的管理員手冊建議在刪除單一儲存的索引檔案之前停止操作。手冊中也提到索引目錄中存在一個狀態文件，因此不要為了例行修復而刪除整個目錄或所有使用者索引。請先備份相關的索引文件，並確認使用者或儲存的身份和路徑。如果您的本機man kopano-search文件中提供了該--reindex選項，請優先使用其軟體包支援的語法來重建單一儲存；不同歸檔版本的選項格式可能有所不同。例如，Ubuntu Focal 手冊中記錄了一個針對特定目標的重新索引選項，並指出守護程式必須已在執行。

大規模重建可能會消耗磁碟和 CPU 資源，並且在索引更新期間搜尋結果可能不完整。如果您不確定哪個儲存檔案受到影響，請在刪除任何內容之前停止操作，並收集服務日誌、軟體包版本以及配置訊息，index_path以便聯繫 Kopano 管理員或支援管道。

6. 重新啟動並驗證結果

排除故障原因後，只需重啟搜尋服務即可：

sudo systemctl restart kopano-search
sudo systemctl status kopano-search --no-pager
sudo journalctl -u kopano-search -b -n 50 --no-pager

對於 SysV 安裝，請使用該軟體包文件中記錄的服務命令。確認進程保持活動狀態，相同的回溯資訊不再重複出現，初始索引完成後搜尋套接字出現。 Kopano 指出，套接字可能要等到初始索引建置完成後才會建立。測試一次普通的郵件搜索，如果啟用了附件索引，則僅在解析器修復後才測試一個已知的附件。

快速診斷指南

最可靠的修復方法是根據日誌中的錯誤進行操作：修復 Python 導入失敗的包環境，恢復連接失敗的正確套接字，修復訪問和提取錯誤中的特定路徑或解析器，並且僅當證據表明索引數據損壞時才重新索引。現有的 Kopano 手冊涵蓋的是較舊的核心版本，因此請將其與軟體包本身的手冊結合使用，而不是假設每個當前部署都使用相同的服務管理員或選項語法。