Yggdrasil 是什么？

Yggdrasil 是一个实验性的 IPv6 网格网络（一种让计算机之间直接通信的覆盖网络）。每个节点会获得一个基于公钥的固定 IPv6 地址，无论它物理上在哪，地址都不变。你可以把它想象成在现有互联网之上再搭一层网络，让应用像使用普通网络一样通信。

准备工作

你需要：

• 安装 Go（版本 1.18 或更高），这是编程语言和运行环境。
• 一个代码编辑器（如 VS Code）。
• 基本的 Go 语言知识（知道如何创建 main.go 并运行）。

第一步：获取 ygglib 库

在你的 Go 项目目录中，打开终端，运行：

go get github.com/Arceliar/yggdrasil-go/ygglib

这会下载 ygglib 库，它是 Yggdrasil 的嵌入式版本。

第二步：创建一个最简单的节点

新建一个 main.go 文件，写入以下代码：

package main

import (
    "fmt"
    "github.com/Arceliar/yggdrasil-go/ygglib"
)

func main() {
    node, err := ygglib.NewCore(nil)
    if err != nil {
        panic(err)
    }
    defer node.Stop()
    node.RegisterTransport("tcp", &ygglib.DefaultTCPTransport{})
    node.RegisterTransport("tls", &ygglib.DefaultTLSTransport{})
    fmt.Println("Node address:", node.Address())
}

这段代码创建了一个 Yggdrasil 核心节点，注册了 TCP 和 TLS 传输方式，然后打印出节点的地址。

第三步：运行并验证

在终端中执行：

go run main.go

如果看到类似 Node address: 200:... 的输出，说明节点创建成功。这个地址就是你的节点在 Yggdrasil 网络中的唯一标识。

第四步：连接两个节点（进阶）

要真正通信，你需要至少两个节点。参考以下步骤：

1. 创建一个函数 createNode() 返回新的 Core 实例。
2. 启动第一个节点，并打开一个监听器：listener, _ := node1.Listen("tcp://:0")。
3. 启动第二个节点，让它连接到第一个节点：node2.CallPeer("tcp://" + listener.Addr().String())。
4. 此时两个节点已建立连接，可以交换数据。

注意：如果连接不稳定，可以使用 AddPeer 替代 CallPeer 来自动重连。

常见问题与提示

• 防火墙阻止连接：确保你的防火墙允许 UDP 和 TCP 流量。
• 地址冲突：每个节点地址唯一，无需担心冲突。
• 性能调优：嵌入式版本默认不创建 TUN 设备，所有流量在进程内处理，更适合应用集成。

现在你已经能在 Go 应用里嵌入 Yggdrasil 了！下一步可以尝试用它构建一个简单的聊天程序或文件传输工具。