leonwww/SETUP_GUIDE.md

# Gurted生态系统搭建指南

本指南将帮助您完整搭建Gurted生态系统的所有组件，使其正常运行。

## 1. 环境准备

### 1.1 安装必要的工具和依赖

```bash
# 安装Rust (如果尚未安装)
choco install rustup
rustup default stable

# 安装PostgreSQL (用于DNS和搜索引擎)
choco install postgresql

# 安装mkcert (用于开发环境的TLS证书)
choco install mkcert

# 安装Godot 4.x (用于运行和开发Flumi浏览器)
# 访问 https://godotengine.org/download 下载并安装

# 安装Node.js和npm (用于前端开发)
choco install nodejs
```

### 1.2 安装本地CA证书 (仅开发环境)

```bash
mkcert -install
```

## 2. DNS系统搭建

### 2.1 配置PostgreSQL数据库

```bash
# 启动PostgreSQL服务
pg_ctl -D "C:\Program Files\PostgreSQL\版本\data" start

# 创建数据库和用户
psql -U postgres
CREATE DATABASE gurt_dns;
CREATE USER gurt_user WITH PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE gurt_dns TO gurt_user;
\q
```

### 2.2 配置DNS服务器

```bash
cd d:\Projects\Rust\leonwww\dns
cp config.template.toml config.toml
```

编辑`config.toml`文件，配置数据库连接等信息：

```toml
[database]
url = "postgres://gurt_user:your_password@localhost/gurt_dns"

[server]
address = "127.0.0.1"
port = 4877
```

### 2.3 运行DNS服务器

```bash
cd d:\Projects\Rust\leonwww\dns
cargo run
```

DNS服务器现在应该运行在http://127.0.0.1:4877

## 3. GurtCA证书颁发机构搭建

### 3.1 编译GurtCA

```bash
cd d:\Projects\Rust\leonwww\protocol\gurtca
cargo build --release
```

### 3.2 获取CA证书

要使用GurtCA，首先需要获取CA证书。注意：GurtCA工具需要使用lw://协议的URL：

```bash
cd d:\Projects\Rust\leonwww\protocol\gurtca\target\release
# 使用默认的lw://dns.root CA URL
./gurtca get-ca --output ./ca.crt

# 或者指定自定义的CA URL
./gurtca get-ca --ca-url lw://your-ca-server --output ./ca.crt
```

重要说明：
- GurtCA工具需要使用lw://协议的URL（不支持http://或https://）
- 默认CA URL是lw://dns.root
- 如果连接失败，工具会尝试通过HTTP引导服务器（默认是http://10.0.0.138:8876）获取CA证书
- 您可能需要确保本地运行的DNS服务器可以解析这些地址

### 3.3 请求域名证书

要为您的域名请求证书：

```bash
cd d:\Projects\Rust\leonwww\protocol\gurtca\target\release
./gurtca request yourdomain.web --output ./certs
```

按照提示完成DNS挑战验证。

## 4. GURT协议服务器设置

### 4.1 生成TLS证书

#### 开发环境:

```bash
cd d:\Projects\Rust\leonwww\protocol\cli
mkcert localhost 127.0.0.1 ::1
```

#### 生产环境:

使用GurtCA获取证书:

```bash
cd d:\Projects\Rust\leonwww\protocol\gurtca\target\release
./gurtca request yourdomain.web --output ./certs
```

按照提示完成DNS验证挑战。

### 4.2 配置Gurty CLI

```bash
cd d:\Projects\Rust\leonwww\protocol\cli
cp gurty.template.toml gurty.toml
```

编辑`gurty.toml`文件以适应您的环境。

### 4.3 启动GURT服务器

```bash
cd d:\Projects\Rust\leonwww\protocol\cli
# 使用自签名证书(开发环境)
gurty serve --cert localhost+2.pem --key localhost+2-key.pem --config gurty.toml

# 或使用CA颁发的证书(生产环境)
gurty serve --cert ./certs/yourdomain.web.crt --key ./certs/yourdomain.web.key --config gurty.toml
```

## 5. 搜索引擎搭建

### 5.1 配置搜索引擎数据库

```bash
psql -U postgres
CREATE DATABASE gurt_search;
GRANT ALL PRIVILEGES ON DATABASE gurt_search TO gurt_user;
\q
```

### 5.2 配置搜索引擎

```bash
cd d:\Projects\Rust\leonwww\search-engine
cp config.template.toml config.toml
```

编辑`config.toml`文件，配置数据库连接和其他参数：

```toml
[database]
url = "postgres://gurt_user:your_password@localhost/gurt_search"

[server]
address = "127.0.0.1"
port = 4879
cert_path = "certs/t.crt"
key_path = "certs/t.key"
```

### 5.3 运行搜索引擎

```bash
cd d:\Projects\Rust\leonwww\search-engine
cargo run
```

搜索引擎现在应该运行在lw://127.0.0.1:4879

## 6. Flumi浏览器设置

### 6.1 编译和运行Flumi

1. 启动Godot引擎
2. 导入`d:\Projects\Rust\leonwww\flumi`项目
3. 构建并运行项目

### 6.2 配置Flumi连接到本地服务器

在Flumi浏览器中，您可以访问以下地址测试各个组件：
- DNS服务器: http://127.0.0.1:4877
- GURT服务器: lw://localhost:4878
- 搜索引擎: lw://127.0.0.1:4879

## 7. 开发流程

如果您修改了协议库或GDExtension，需要重新构建GDExtension：

```bash
cd d:\Projects\Rust\leonwww\protocol\gdextension
./build.sh
cp -r ./addon d:\Projects\Rust\leonwww\flumi\addons\gurt-protocol\
```

## 8. 完整生态系统的组件关系

- **DNS系统**: 管理域名解析，允许用户注册自定义TLD域名
- **GurtCA**: 颁发TLS证书，确保通信安全
- **GURT协议库**: 提供协议实现，被CLI和浏览器使用
- **Gurty CLI**: 用于设置和管理GURT服务器
- **Flumi浏览器**: 访问GURT网络的客户端工具
- **Ringle搜索引擎**: 索引和搜索GURT网络内容

## 9. 测试

使用`tests`目录中的示例文件来测试GURT协议的各种功能：

```bash
# 在GURT服务器中提供测试文件
cd d:\Projects\Rust\leonwww\protocol\cli
gurty serve --root ../tests --cert localhost+2.pem --key localhost+2-key.pem
```

然后在Flumi浏览器中访问：lw://localhost:4878/index.html

## 10. 部署建议

对于生产环境部署，建议使用Docker容器：

### DNS服务器部署

```bash
cd d:\Projects\Rust\leonwww\dns
docker-compose up -d
```

### 搜索引擎部署

```bash
cd d:\Projects\Rust\leonwww\search-engine
docker-compose up -d
```

## 11. 常见问题解答

### 11.1 TLS证书问题

- 确保正确安装了CA证书
- 检查证书路径是否正确配置
- 验证证书是否在有效期内

### 11.2 数据库连接问题

- 确认PostgreSQL服务正在运行
- 检查数据库连接字符串是否正确
- 验证用户权限设置是否正确

### 11.3 网络连接问题

- 检查防火墙设置
- 验证端口是否已正确配置
- 确保所有组件使用相同的协议版本

---

按照本指南，您应该能够成功搭建完整的Gurted生态系统。如果遇到任何问题，请参考各组件的README文件获取更详细的信息。