Yggdrasil Official Proxy 安装与使用指南

1. 项目目录结构及介绍

Yggdrasil Official Proxy 是一个基于Kotlin编写的开源项目，旨在通过代理的形式提供对Mojang Yggdrasil认证服务的模拟或桥接，使得非正版服务器可以实现类似正版的登录验证体验。虽然项目详细目录结构未直接提供，但通常开源Java项目会有以下基本结构：

• src/main/kotlin: 包含项目的主要源代码，按包(package)组织。
• src/main/resources: 存放配置文件，如应用配置、数据库连接字符串等。
• build.gradle: Gradle构建脚本，用于项目构建和依赖管理。
• README.md: 项目的主要说明文档，包括安装步骤、快速入门等信息。
• LICENSE: 许可证文件，描述软件的使用权限和限制。

2. 项目的启动文件介绍

Yggdrasil Official Proxy 提供了不同的启动方式，主要涉及两个核心的启动文件，具体取决于您选择的运行模式（Proxy Edition 或 Agent Edition）：

• Proxy Edition: 使用的是典型的Java JAR文件，例如 YggdrasilOfficialProxy-XXX.jar，其中XXX代表版本号。启动此版本需要通过命令行执行 java -jar YggdrasilOfficialProxy-XXX.jar setup 来进入向导模式，首次运行会自动生成配置文件并随后关闭服务，要求手动配置。

• Agent Edition: 对于集成到现有服务器中的情况，它通过修改Java启动参数来加载，不直接作为一个独立的应用启动。这通常涉及到在您的服务器启动脚本中添加特定的Java Agent参数，比如 -javaagent:authlib-injector.jar=，具体的URL指向Yggdrasil代理服务器地址。

3. 项目的配置文件介绍

配置文件主要是 YggdrasilOfficialProxy.conf，这个文件在首次启动向导模式后被创建，并需要手动编辑以完成设置。关键设置包括但不限于：

• edited=true: 标记文件已编辑，确保程序识别这是一个完整配置。
• 服务器地址与端口: 在Proxy Edition下，你需要指定服务器运行的确切地址和端口号，确保与实际部署一致。
• Authlib-Injector配置: 若采用Agent Edition，需要调整Java启动参数中关于Authlib-Injector的设置，指向你的代理服务，确保正确桥接认证过程。

请注意，配置文件的具体内容和选项可能随版本更新有所变化，因此建议始终参考最新的官方文档或README文件进行配置。此外，安全性提示（如HTTP与HTTPS的选择）应依据实际情况谨慎处理，尤其是在生产环境中。