yacy/yacy_search_server

YaCy 分布式P2P搜索引擎

概述

YaCy是一款基于分布式对等网络（P2P）的搜索引擎软件，其核心特点是无需中央服务器，搜索结果来自独立用户节点组成的网络。用户隐私是设计核心，搜索词在发送前会进行哈希处理，每个用户可创建独立的搜索索引和排名规则，构建个性化搜索门户。YaCy既支持加入大型分布式搜索网络（通过内置P2P协议交换索引），也可作为个人或企业内网的私有搜索解决方案，替代商业企业搜索产品。

核心功能与特性

• 分布式P2P架构：无中央服务器，搜索索引分布在用户节点网络中，无单一实体控制内容或排序
• 隐私保护：搜索词本地哈希处理，用户索引***化，无集中式数据存储
• 多场景索引能力：
  • 支持全网搜索（自动协同其他YaCy节点）
  • 合作式网络爬取，兼容其他爬虫
  • 内网资源索引（HTTP、FTP、SMB服务器发现）
  • 自定义搜索门户搭建
• 用户平等性：所有用户节点权利平等，共同贡献网络索引能力
• 轻量部署：仅需Java 1.8+环境，无需Apache、Tomcat、MySQL等额外依赖

使用场景

• 个人搜索门户：构建个人化、无广告的搜索入口，自定义索引范围和排名
• 企业内网搜索：替代商业企业搜索方案，索引内网HTTP、FTP、SMB资源
• 分布式网络搜索：加入YaCy节点网络，贡献索引能力，获取更全面的搜索结果
• 隐私敏感环境：在对数据隐私要求高的场景中，避免使用中心化搜索引擎

依赖要求

• 运行环境：Java 1.8或更高版本（推荐Oracle JDK或OpenJDK）
• 兼容实现：支持IcedTea 3+（详情见IcedTea官网）
• 无其他依赖：无需Web服务器（如Apache）、应用服务器（如Tomcat）或数据库（如MySQL）

安装与使用指南

启动与停止

根据操作系统选择对应方式：

GNU/Linux 与 OpenBSD

bash
# 启动
./startYACY.sh

# 停止
./stopYACY.sh

Windows

• 启动：双击 startYACY.bat
• 停止：双击 stopYACY.bat

macOS

• 使用Mac应用程序，双击启动/停止（与常规应用程序操作一致）

管理界面

启动后自动启动内置Web服务器，通过浏览器访问管理界面：

http://localhost:8090

界面包含搜索功能和管理配置选项。

无头服务器部署（远程服务器）

在非本地环境（如服务器）部署时，需在首次启动后10分钟内设置管理员账户（默认10分钟后生成随机密码，远程访问将受限）：

1. 访问远程服务器地址：http://<remote-server-address>:8090/ConfigAccounts_p.html
2. 设置管理员账户凭证

端口配置

默认端口为8090，如需使用80端口可通过iptables转发：

bash
# 端口转发（80→8090）
iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 8090

# 开放8090端口访问权限
iptables -I INPUT -m tcp -p tcp --dport 8090 -j ACCEPT

资源配置

• 内存调整：默认Java进程分配600MB内存，可通过管理界面 http://localhost:8090/Performance_p.html 调整。建议：
  • 索引量<10万页：200MB
  • 索引量100万页：600MB+
• 磁盘空间：数百万网页索引可能占用数GB空间，可通过 http://localhost:8090/ConfigHTCache_p.html 配置存储策略

Docker部署

YaCy支持Docker容器化部署，详细说明见https://github.com/yacy/yacy_search_server/blob/master/docker/Readme.md%E3%80%82%E5%9F%BA%E6%9C%AC%E9%83%A8%E7%BD%B2%E7%A4%BA%E4%BE%8B%EF%BC%9A

bash
# 拉取镜像（假设官方镜像）
docker pull yacy/yacy-search-server

# 运行容器（暴露8090端口，挂载数据卷）
docker run -d \
  --name yacy \
  -p 8090:8090 \
  -v yacy-data:/yacy_data \
  yacy/yacy-search-server

注：实际镜像名称和参数请参考官方Docker文档

许可证

• 主项目采用 GPL 2.0或更高版本 开源许可
• 部分组件可能使用 GNU Lesser General Public License
• 完整许可信息请查看各文件头部声明，源代码包含在发布包的 /source 和 /htroot 目录中

官方文档与社区

• 官网：[***]
• 国际论坛：[***]
• 多语言Wiki：
  • 德语：De:Start
  • 世界语：Eo:Start
  • 法语：Fr:Start
  • 西班牙语：Es:Start
  • 俄语：Ru:Start
• 视频教程：
  • 英文：Tutorials
  • 德语：Lehrfilme

开发与编译

源码获取

bash
git clone https://github.com/yacy/yacy_search_server.git

编译依赖

• Java 1.8+
• Apache Ant 或 Maven

Ant编译

bash
# 清理并全量编译
ant clean all

# 生成发布包
ant dist

# 生成macOS应用（仅macOS环境）
ant distMacApp

# 生成Debian包
ant deb

Maven编译

bash
# 首次编译需先构建依赖模块
cd libbuild
mvn clean install -DskipTests

# 返回主目录编译
cd ..
mvn clean install

Eclipse开发环境

1. 导入Git项目：File → Import → Git → Projects from Git → 选择本地仓库
2. 构建：Run → External Tools → 配置Ant Build（目标build.xml）
3. 运行：右键项目 → Run as → Java Application → 选择 "yacy - net.yacy"

贡献代码

• 社区开发论坛：searchlab.eu
• 提交PR：https://github.com/yacy/yacy_search_server