gDHT 的安装和配置教程

项目基础介绍

gDHT 是一个分布式的自托管 DHT (分布式哈希表) 资源搜索套件，它允许用户托管自己的资源搜索引擎。该项目主要由四个主要组件构成：爬虫 (crawler)、服务器 (server)、ElasticSearch 和前端网页 (web)。分布式爬虫会监控 DHT 网络上的流量，收集资源的元信息，然后通过 gRPC 将收集到的信息发送到服务器。服务器接收到信息后，会将它们推送到 Redis 消息队列，并异步处理（例如过滤不需要的资源）然后将它们索引到 ElasticSearch 中。最终，用户可以在 React 网页界面上搜索资源信息。

项目主要编程语言

该项目主要使用 Go 语言进行开发，同时使用了 CSS、JavaScript、HTML 和 Dockerfile。

项目使用的关键技术和框架

• DHT (分布式哈希表)：一种用于分布式系统的信息查询技术。
• gRPC：Google 开发的用于替代 RESTful API 的高性能、跨语言的 RPC 框架。
• Redis：一个开源的使用 ANSI C 编写的内存数据结构存储系统，用作数据库、缓存和消息中间件。
• ElasticSearch：一个基于 Lucene 构建的开源搜索引擎，用于全文搜索和分析。
• React：Facebook 开发的一个用于构建用户界面的 JavaScript 库。

项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已安装以下软件：

• Docker：用于容器化应用。
• Docker Compose：用于定义和运行多容器 Docker 应用。

详细安装步骤

1. 克隆项目

   首先，您需要在本地克隆项目仓库：

   git clone https://github.com/Olament/gDHT.git
   cd gDHT
   

2. 配置环境变量

   在 docker-compose.yml 文件中，配置 Nginx 的域名变量 YOURDOMAIN.COM 为您的实际域名。

   # 示例配置
   environment:
     URL: yourdomain.com
   

   同时，为爬虫配置服务器地址 address：

   # 示例配置
   crawler:
     environment:
       address: master-server-ip-address:50051
   

3. 配置 ElasticSearch 用户

   根据文档中的说明，您需要在 ElasticSearch 中创建两个用户：web 和 crawler。确保 crawler 用户具有读写索引的权限，web 用户具有读索引的权限。

4. 配置前端用户认证

   在 web/src/.env 文件中，配置 REACT_APP_USERNAME 和 REACT_APP_PASSWORD 为您的 ElasticSearch web 用户名和密码。

5. 构建并启动服务

   使用以下命令构建并启动服务：

   docker-compose build
   docker-compose up
   

完成以上步骤后，您的 gDHT 应该已经成功运行，您可以通过配置的域名访问网页界面进行资源搜索。

请注意，这些步骤提供了一个基本的安装指南，具体配置可能需要根据您的环境进行适当调整。