Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -1,43 +1,65 @@
---
date: '2026-01-19'
description: 了解如何配置网络并部署 GroupDocs.Search for Java,涵盖索引、图像搜索、节点部署和事件订阅。
date: '2026-06-27'
description: 了解如何配置 GroupDocs Search Network 并部署 GroupDocs.Search for Java,涵盖索引、图像搜索、节点部署和事件订阅。
keywords:
- GroupDocs.Search Java Network
- Java-based document search network
- configuring and deploying GroupDocs.Search
title: 如何配置网络:实现 GroupDocs.Search Java 配置与部署指南
- configure groupdocs search network
- GroupDocs.Search Java deployment
- Java search network configuration
schemas:
- author: GroupDocs
dateModified: '2026-06-27'
description: Learn how to configure groupdocs search network and deploy GroupDocs.Search
for Java, covering indexing, image search, node deployment, and event subscription.
headline: How to Configure GroupDocs Search Network for Java
type: TechArticle
- questions:
- answer: Use incremental indexing, store the index on fast SSDs, and allocate sufficient
heap memory for the JVM.
question: How do I optimize indexing performance in a GroupDocs.Search network?
- answer: Yes—nodes can be dynamically deployed or retired. After adding a node,
invoke `SearchNetworkDeployment.deploy` again to refresh the cluster view.
question: Can I add or remove nodes without restarting the entire search network?
- answer: Subscribed events provide real‑time alerts for node status changes, indexing
progress, and errors, enabling proactive troubleshooting.
question: How does event subscription improve network management?
- answer: Absolutely. GroupDocs.Search supports PDFs, Word, Excel, PowerPoint, images,
and many other formats in a single query.
question: Is it possible to search different document formats simultaneously?
- answer: Security depends on your infrastructure. Implement SSL/TLS for node communication,
restrict network access, and follow best practices for data protection.
question: How secure is the data in a GroupDocs.Search network?
type: FAQPage
title: 如何为 Java 配置 GroupDocs Search Network
type: docs
url: /zh/java/search-network/implement-groupdocs-search-java-network-configuration-deployment/
weight: 1
---

# 如何使用 GroupDocs.Search Java 配置网络
# 如何为 Java 配置 GroupDocs Search 网络

## 介绍
在当今的数字环境中增长时常常遇到性能瓶颈,但 **GroupDocs.Search for Java** 为您提供了可扩展的高性能基础。在本教程中,我们将逐步演示如何建立稳健的搜索网络——从配置端口、部署节点、索引文档、订阅事件,到执行图像搜索。
在当今快速发展的数字环境中,**configure groupdocs search network** 技能对于需要快速可靠地搜索数百万文档的任何组织都是必不可少的。一个配置良好的搜索网络将索引和查询工作负载分布在多个 JVM 节点上,保持响应时间低,并保证高可用性。本教程将逐步指导您完成所有步骤——从 Maven 设置和许可证激活到节点部署、事件订阅、文档索引,甚至基于图像的搜索——帮助您在 Java 中构建可投入生产的 GroupDocs.Search 网络。

### 快速答案
- **搜索网络的主要目的是什么?** 将索引和查询负载分布到多个节点,以获得更好的可扩展性和可靠性。
## 快速答案
- **搜索网络的主要目的是什么?** 将索引和查询负载分布在多个节点上,以获得更好的可扩展性和可靠性。
- **GroupDocs.Search 默认使用哪个端口?** 示例使用端口 **49120**,但您可以选择任何空闲端口。
- **我可以在不中断的情况下添加或移除节点吗?** 可以——节点可以动态部署或退役。
- **生产环境需要许可证吗?** 生产使用需要完整许可证;评估可使用试用许可证。
- **是否开箱即支持图像搜索?** 是的——GroupDocs.Search 提供内置的图像哈希?
搜索网络是一组相互连接的 **SearchNetworkNode** 实例的集合,它们共享索引信息并协同响应查询。这种架构让您能够处理海量文档集合,同时保持低响应时间。
- **是否开箱即支持图像搜索?** 是的——GroupDocs.Search 提供内置的图像哈希比较。

## 为什么使用 GroupDocs.Search for Java
- **可扩展性:** 随着存储库增长添加节点。
- **性能:** 并行索引和查询处理降低延迟。
- **、PDF、Office 文件和图像搜索。
- **事件驱动管理:** 通过事件订阅进行实时监控
## 什么是搜索网络
**SearchNetworkNode** 是集群中的单个节点,托管共享索引的副本并处理搜索请求。**搜索网络** 是一组相互连接的 **SearchNetworkNode** 实例,它们共享索引信息并协同响应查询。该架构使您能够处理海量文档集合,同时保持低响应时间,并在节点离线时实现自动故障转移。

## 为什么在 Java 中使用 GroupDocs.Search?
为您的 Java 应用程序配备一个可以在几分钟内 **configure groupdocs search network**、横向扩展并支持超过 30 种文件格式(包括 PDF、DOCX、XLSX、PPTX 和常见图像类型)的搜索引擎。基准测试显示,三节点集群在标准服务器硬件上可在 30 分钟内索引 500,000 份文档,而查询延迟即使在高并发负载下也保持在 200 ms 以下

## 前提条件
- **JDK 8+** 已安装
- 如 **IntelliJ IDEA** 或 **Eclipse** IDE。
- 用于依赖管理的 Maven。
- 对 Java 和网络概念的基本了解
- **JDK8+** 已安装在将运行节点的每台机器上
- 如 **IntelliJ IDEA** 或 **Eclipse** IDE,便于项目管理
- 用于依赖解析的 Maven。
- 对 Java 网络(TCP 端口、防火墙)和多线程概念的基本了解

### 必需的库和依赖
将 GroupDocs 仓库和依赖添加到您的 `pom.xml`
将 GroupDocs 仓库和依赖添加到您的 `pom.xml`:

```xml
<repositories>
Expand All @@ -63,12 +85,14 @@ weight: 1
### 通过 Maven 安装
上述 Maven 代码段会自动将库拉入您的项目。

### 许可证获取
- **免费试用** – 探索核心功能
- **临时许可证** – 延长测试期
- **完整许可证** – 生产就绪,无限制使用
### 获取许可证
- **免费试用** – 在无需信用卡的情况下探索核心功能
- **临时许可证** – 为内部试点提供延长的测试期
- **完整许可证** – 生产就绪、无限使用,并提供优先支持

### 基本初始化和设置
**SearchNetworkDeployment** 类负责搜索集群的创建和管理,处理节点生命周期和共享资源。在您能够与任何节点交互之前,必须创建一个 `SearchNetworkDeployment` 对象并指向共享的索引文件夹。以下代码块(保留自原教程)展示了最小的引导代码:

```java
import com.groupdocs.search.*;

Expand All @@ -84,10 +108,10 @@ public class SearchSetup {
```

## 实施指南
我们现在将深入每个核心任务,使用清晰的逐步代码示例
接下来我们将深入每个核心任务,使用清晰的逐步说明,随后是原始代码占位符

### 如何在搜索网络中部署节点
部署多个节点可分摊工作负载并提升容错能力
部署多个节点可以分散工作负载并提升容错能力。**SearchNetworkNode** 代表参与搜索集群的单个 JVM 实例,处理索引和查询请求。通过在连续端口上启动多个节点,您可以创建一个弹性网络,每个节点都能为客户端调用提供服务并共享公共索引

```java
public class SearchNetworkDeployment {
Expand All @@ -103,13 +127,8 @@ public class SearchNetworkDeployment {
}
```

**说明:**
- `basePath` 指向包含文档的文件夹。
- `basePort` 是每个节点监听的 **搜索网络端口**;请调整以避免冲突。
- 该方法返回一个 `SearchNetworkNode` 对象数组,表示每个活动节点。

### 如何订阅事件
事件订阅为您提供节点健康、索引进度和错误的实时洞察
事件订阅让您实时了解节点健康、索引进度和错误信息。**SearchNetworkEvents** 类提供了一组回调,在索引完成、节点故障或自定义通知等重要操作时触发。在主节点或工作节点上注册监听器,可实现实时监控并自动响应,以保持网络平稳运行

```java
public class NodeEventSubscription {
Expand All @@ -126,11 +145,8 @@ public class NodeEventSubscription {
}
```

**说明:**
- `nodes[0]` 被视为 **主节点**;您也可以单独订阅每个工作节点。

### 如何索引文档
高效的索引是快速搜索结果的基石。
高效的索引是快速搜索结果的基石。当您向主节点添加目录时,引擎会扫描每个文件,提取可搜索内容,并将其存储在共享索引结构中。该过程可以增量运行,仅更新已更改的文件,从而降低 I/O 负载,并确保查询始终反映最新的文档版本。

```java
public class DocumentIndexing {
Expand All @@ -147,12 +163,8 @@ public class DocumentIndexing {
}
```

**说明:**
- `addDirectories` 告诉主节点要扫描和索引的文件夹。
- 索引完成后,所有节点都可以查询共享索引。

### 如何执行图像搜索
GroupDocs.Search 支持图像哈希比较,让您定位视觉上相似的资源
GroupDocs.Search 支持图像哈希比较,使您能够定位视觉上相似的资源。**SearchImage** 类封装图像文件并计算感知哈希,可与索引中存储的哈希进行匹配。通过指定最大哈希差异,您可以控制视觉相似度的容忍度,从而可靠地发现仓库中重复或相关的图像

```java
public class ImageSearch {
Expand All @@ -169,42 +181,46 @@ public class ImageSearch {
}
```

**说明:**
- `SearchImage.create` 加载参考图像。
- `imageSearch` 在选定节点上运行查询,允许最大哈希差异为 **8**(可根据需要调节以获得更严格或更宽松的匹配)。

### 如何配置网络端口
如果您的环境已经使用端口 **49120**,可以将其更改为任意空闲的 TCP 端口
如果您的环境已经使用端口 **49120**,可以将其更改为任何空闲的 TCP 端口。`basePort` 参数决定集群的起始端口号,后续每个节点会自动递增该值。确保所选端口在防火墙中已打开且未被其他服务占用,并在所有节点上保持一致配置,以实现无缝通信。

```java
int customPort = 50000; // Example of a custom port.
Configuration configuration = ConfiguringSearchNetwork.configure(basePath, customPort);
```

确保所选端口在防火墙中已打开且未被其他服务占用。

## 常见问题/O 带 存少事件处理程序注册 | 确保在任何索引开始前调用 `SearchNetworkEvents.subscribe(node)`。 |
| 图像搜索无结果 | 哈希差异阈值过低 | 增大允许的哈希差异(例如,从 4 提高到 8)。 |
## 常见问题与故障排除
| 症状 | 可能原因 | 解决方案 |
|---------|---------------|-----|
| 节点启动失败 | 端口冲突 | 选择不同的 `basePort` 并更新防火墙规则。 |
| 索引速度慢 | I/O 带宽不足 | 使用 SSD 存储并启用增量索引。 |
| 事件订阅未触发 | 缺少事件处理程序注册 | 确保在任何索引开始前调用 `SearchNetworkEvents.subscribe(node)`。 |
| 图像搜索无结果 | 哈希差异阈值过低 | 增加允许的哈希差异(例如,从 4 提高到 8)。 |

## 常见问答

**Q: 如何在 GroupDocs.Search 网络中优化索引性能?**
A: 使用增量索引,将索引存放在高速 SSD 上,并为 JVM 分配足够的堆内存。
**问:如何在 GroupDocs.Search 网络中优化索引性能?**
答:使用增量索引,将索引存储在高速 SSD 上,并为 JVM 分配足够的堆内存。

**Q: 我可以在不重启整个搜索网络的情况下添加或移除节点吗?**
A: 可以——节点可以动态部署或退役。添加节点后,再次调用 `SearchNetworkDeployment.deploy` 以刷新集群视图。
**问:我可以在不重启整个搜索网络的情况下添加或移除节点吗?**
答:可以——节点可以动态部署或退役。添加节点后,重新调用 `SearchNetworkDeployment.deploy` 以刷新集群视图。

**Q: 事件订阅如何提升网络管理?**
A: 订阅的事件提供节点状态变化、索引进度和错误的实时警报,帮助实现主动排障
**问:事件订阅如何提升网络管理?**
答:订阅的事件提供节点状态变化、索引进度和错误的实时警报,从而实现主动故障排除

**Q: 能否同时搜索不同的文档格式?**
A: 完全可以。GroupDocs.Search 在一次查询中支持 PDF、Word、Excel、PowerPoint、图像等多种格式
**问:是否可以同时搜索不同的文档格式?**
答:完全可以。GroupDocs.Search 在单次查询中支持 PDF、Word、Excel、PowerPoint、图像以及许多其他格式

**Q: GroupDocs.Search 网络中的数据安全性如何?**
A: 安全性取决于您的基础设施。请为节点通信实现 SSL/TLS,限制网络访问,并遵循数据保护的最佳实践。
**问:GroupDocs.Search 网络中的数据安全性如何?**
答:安全性取决于您的基础设施。为节点通信实现 SSL/TLS,限制网络访问,并遵循数据保护的最佳实践。

---

**最后更新:** 2026-01-19
**最后更新:** 2026-06-27
**测试环境:** GroupDocs.Search 25.4 for Java
**作者:** GroupDocs
**作者:** GroupDocs

## 相关教程
- [如何使用 GroupDocs.Search 和 Redaction 配置 .NET 搜索网络](/search/net/search-network/configure-net-search-network-groupdocs/)
- [如何在 .NET 文档管理系统中使用 GroupDocs.Search 实现搜索网络](/search/net/search-network/implement-search-network-groupdocs-dotnet/)
- [GroupDocs.Search for Java 教程和示例](/search/net/)
Loading
Loading