配置 GroupDocs.Search Java 網路的分散式搜尋

在當今以數據為驅動的世界，configure distributed search 對於處理海量文件集合同時保持低回應時間至關重要。本教程將指導您設置一個穩健的 GroupDocs.Search for Java 網路，展示如何在多個節點上部署搜尋、將文件加入索引，以及配置 TCP 設定以確保可靠的通信。完成後，您將擁有可投入生產的可擴展搜尋解決方案，並清楚了解為何此架構優於單節點設定。

快速解答

• What is configure distributed search? 這是將多個獨立搜尋節點連結起來，使其共同建立索引並回應查詢的過程，提供更高的吞吐量與容錯能力。
• How many nodes are recommended? 通常 3‑5 個節點可為大多數企業工作負載提供性能與容錯的良好平衡。
• Do I need a license? 是的——在生產環境使用 GroupDocs.Search 需要臨時或正式授權。
• Which ports should I use? 請選擇伺服器上未被佔用的埠；範例使用 49136‑49139，但任何可用的埠範圍皆可。
• Can I add new documents after deployment? 當然可以——您可以隨時add documents to index，而無需重新啟動網路。

什麼是 configure distributed search？

配置分散式搜尋架構意味著將多個獨立的搜尋節點連結起來，使其共同分擔索引工作並集體回應查詢。這可減少單一機器的負載，提升吞吐量與可靠性，並提供內建的冗餘以實現容錯。

為何使用 GroupDocs.Search for Java？

GroupDocs.Search for Java 提供高效能索引（在現代硬體上可達每秒 1 GB）以及可擴展架構，支援超過 10 個節點的叢集。它原生支援超過 50 種文件格式——包括 PDF、DOCX、XLSX、PPTX 以及電子郵件檔案——讓您無需額外轉換器即可索引幾乎所有商業內容。內建的 TcpSettings 類別讓您微調延遲、吞吐量與 keep‑alive 間隔，確保即使跨資料中心邊界也能保持可靠的節點間通信。TcpSettings 用於配置節點之間的低層 TCP 通訊參數。

前置條件

必要的函式庫與相依性

您需要 GroupDocs.Search for Java 版本 25.4 或更新版本。請確保開發環境已安裝 Java。

環境設定需求

• Java Development Kit (JDK) 11 或更新版本。
• 如 IntelliJ IDEA 或 Eclipse 等 IDE，以便於專案管理。

知識前置條件

具備基本的 Java 程式設計技能以及對網路配置的基本了解，將有助於您順利完成以下步驟。

設定 GroupDocs.Search for Java

要開始使用，請將 GroupDocs.Search for Java 加入您的專案。您可以透過 Maven 或直接下載函式庫來完成。

Maven 設定
在您的 pom.xml 檔案中加入以下儲存庫與相依性設定：

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/search/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-search</artifactId>
        <version>25.4</version>
    </dependency>
</dependencies>

直接下載
或者，從 GroupDocs.Search for Java releases 下載最新版本。

取得授權

要完整使用 GroupDocs.Search，您可以取得臨時授權或購買正式授權。請前往 GroupDocs’s licensing page 了解如何取得免費試用或正式授權。您亦可使用相同的 GroupDocs licensing page 以達成相同目的。

基本初始化與設定

讓我們在您的 Java 應用程式中初始化 GroupDocs.Search：

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Create an index in the specified folder
        Index index = new Index("YOUR_INDEX_DIRECTORY");

        // Add documents to the index
        index.add("YOUR_DOCUMENT_DIRECTORY");
    }
}

實作指南

在本節中，我們將指導您如何使用 GroupDocs.Search for Java 配置與部署搜尋網路。

如何使用 GroupDocs.Search 配置分散式搜尋？

載入網路配置、定義基礎路徑，並在幾行程式碼中設定 TCP 參數。此直接回答模式在任何詳細說明之前，先展示必要的步驟。

首先，建立 SearchNetworkConfig 物件，指定共享的基礎目錄，並為每個節點分配不同的 TCP 埠。SearchNetworkConfig 定義分散式搜尋叢集的設定，例如基礎目錄與節點埠。接著，實例化 TcpSettings——此類別控制 socket 超時、緩衝區大小與 keep‑alive 行為。最後，呼叫 NetworkManager.deploy(config) 以啟動叢集。NetworkManager 負責叢集中搜尋節點的部署與管理。

配置網路

TcpSettings 類別是所有節點之間 TCP 級別通信的配置中心。它允許您設定連線超時、讀寫緩衝區大小，以及是否使用 Nagle 演算法。

Configuration configuration = ConfiguringSearchNetwork.configure("YOUR_DOCUMENT_DIRECTORY", 49136);

部署節點

透過提供唯一識別碼與先前定義的配置來部署每個節點。部署程序會自動將節點註冊至叢集，開啟監聽 socket，並啟動背景索引執行緒。

public static SearchNetworkNode[] deploy(String basePath, int basePort, Configuration configuration) {
    // Define timeouts for sending and receiving data over the network.
    int sendTimeout = 3000;
    int receiveTimeout = 3000;

    // Create and start three nodes that can run on separate servers or together.
    SearchNetworkNode node1 = new SearchNetworkNode(
        1,
        basePath + "Node1",
        new TcpSettings(basePort + 1, sendTimeout, receiveTimeout)
    );
    node1.start();

    SearchNetworkNode node2 = new SearchNetworkNode(
        2,
        basePath + "Node2",
        new TcpSettings(basePort + 2, sendTimeout, receiveTimeout)
    );
    node2.start();

    SearchNetworkNode node3 = new SearchNetworkNode(
        3,
        basePath + "Node3",
        new TcpSettings(basePort + 3, sendTimeout, receiveTimeout)
    );
    node3.start();

    // Create and configure the main configuration node.
    SearchNetworkNode node0 = new SearchNetworkNode(
        0,
        basePath + "Node0",
        new TcpSettings(basePort, sendTimeout, receiveTimeout),
        new ConsoleLogger(),
        configuration
    );

    // Add an event handler to notify when the configuration is complete.
    node0.getEvents().ConfigurationCompleted.add(new EventHandler() {
        @Override
        public void invoke(Object s, EventArgs e) {
            // Event handling logic here (e.g., logging)
        }
    });

    // Configure all nodes in the network using the main configuration node.
    node0.configureAllNodes();

    // Start the search network by launching all configured nodes.
    node0.start();

    // Return an array of all deployed nodes.
    return new SearchNetworkNode[] {node0, node1, node2, node3};
}

常見問題與解決方案

• Directory Access Errors – 確保每個節點的基礎目錄存在，且 Java 程序具有讀寫權限。
• Port Conflicts – 確認所選埠（例如 49136‑49139）未被其他服務佔用；您可以執行 netstat -an 進行檢查。
• Timeouts on Slow Networks – 若在高延遲環境中頻繁斷線，請增加 TcpSettings.setConnectionTimeout()。
• Index Corruption – 定期備份索引資料夾，並啟用 NetworkManager.enableAutoRecovery() 以自動重建受損的分片。

實務應用

部署分散式搜尋網路在多種情境下皆有益處：

1. Large‑Scale Enterprise Systems – 索引數百萬份合約、政策與報告，同時保持次秒級的查詢回應。
2. Content Management Platforms – 為成千上萬同時搜尋多媒體資產的使用者提供服務，且不會產生瓶頸。
3. E‑commerce Websites – 加速在包含數百萬 SKU 的目錄上進行商品搜尋與分面導覽。

效能考量

為了讓您的 configure distributed search 環境高效運作：

• Index Size Management – GroupDocs.Search 能處理超過 100 GB 的索引；但仍需監控磁碟 I/O，並考慮將大型集合分片至多個節點。
• Resource Tuning – 根據工作負載套用 Java 記憶體調校旗標（-Xmx8g -Xms4g），並為高吞吐量網路調整 TcpSettings.setReadBufferSize()。
• Health Monitoring – 使用內建的 NetworkHealthMonitor 追蹤每個節點的 CPU、記憶體與網路延遲，並為您設定的閾值設置警報。

結論

透過本教程，您已學會如何configure distributed search 並部署可擴展的 GroupDocs.Search Java 網路。此解決方案能顯著提升應用程式搜尋功能的速度與可靠性，特別是在處理大型且多樣化的文件集合時。

後續步驟

探索進階功能，如自訂分析器、同義詞處理與即時索引，以進一步優化搜尋體驗。您亦可將網路與 RESTful API 層整合，將搜尋功能提供給外部客戶端。

行動呼籲

立即在您的專案中實作此強大解決方案，親身體驗效能提升！

常見問答

Q: What is GroupDocs.Search for Java?
A: GroupDocs.Search for Java 是一個高效能函式庫，可在超過 50 種文件格式中建立索引與搜尋文字，為 Java 應用程式提供快速、可擴展的全文搜尋。

Q: How do I obtain a temporary license for GroupDocs.Search?
A: 前往 GroupDocs’s licensing page 申請免費試用或購買正式授權以供生產使用。

Q: Can I add new documents after the network is deployed?
A: 是的，您可以隨時使用 IndexManager.addDocument() 方法add documents to index；變更會自動在叢集間傳播。IndexManager.addDocument() 會將新文件加入索引，並在網路中傳播。

Q: What are common pitfalls when configuring nodes?
A: 常見問題包括基礎路徑不匹配、埠衝突以及檔案系統權限不足。請再次檢查每個節點的配置，確保所有目錄皆可存取。

Q: Does the network support real‑time indexing?
A: 當然。GroupDocs.Search 提供即時索引 API，能立即讓新加入的文件在所有節點上可搜尋，且無需停機。

最後更新： 2026-06-27
測試環境： GroupDocs.Search 25.4 for Java
作者： GroupDocs

相關教學

• GroupDocs.Search for Java 教學與範例
• .NET 使用 GroupDocs 部署搜尋網路節點以實現高效文件索引與檢索
• GroupDocs.Search .NET 搜尋效能優化教學