WlayerX/goley-server-tools

# Goley Server Tools 专为在专用网络环境中端到端运行 Goley 客户端-服务端体系而设计的平台。 该平台在单一仓库中整合了用于在 Windows 上启动原版客户端的组件（client runtime）以及替代官方封闭基础设施的后端模拟服务（backend services）。其旨在提供一个可分发的开发与运维基础。 ## 系统边界 | 包含 | 不包含 | |-------|-------| | Client runtime 工具链 (`src/`) | 原版游戏二进制文件和 asset 文件 | | Backend 服务实现 (`server/`) | 官方 Joygame / Anipark 服务端代码 | | ProudNet 协议重新实现 | 官方 Nettention ProudNet 源代码 | | 集中式技术文档 (`docs/`) | 生产环境基础设施（CI、监控、密钥） | 原版客户端安装包（`GoleySetup.exe`）和游戏文件需从运维环境中获取；本仓库不包含也不分发这些组件。 ## 架构概述 ``` ┌──────────────────────────────────────────────────────────────┐ │ goley-private-server │ ├────────────────────────────┬─────────────────────────────────┤ │ Client Runtime │ Backend Services │ │ src/ │ server/ │ ├────────────────────────────┼─────────────────────────────────┤ │ revival_tool.exe │ entry-server :2270/TCP │ │ revival_patcher.dll │ lobby-server :2271/TCP │ │ revival_wrapper.exe │ battle-server :2272/TCP │ │ decrypt.py │ patch-server :80/HTTP │ │ │ launcher-web :8080/HTTP │ │ │ daum-auth :HTTP │ └────────────────────────────┴─────────────────────────────────┘ │ ProudNet TCP / UDP ``` **Client runtime** — 管理 Themida 和 nProtect 保护层、客户端启动、应用静态 patch 以及提取加密游戏数据（VLH/VLD）。 **Backend services** — 登录、大厅、对局匹配、patch 分发以及 launcher Web 界面。对局逻辑在客户端执行（P2P）；backend 提供 authentication、matchmaking 和 relay 服务。 详细架构：[docs/architecture/overview.md](docs/architecture/overview.md) ## 仓库组织结构 ``` goley-private-server/ ├── docs/ Tek kaynak dokümantasyon ├── src/ Client runtime (C/C++, x86) │ ├── tool/ CLI ve orchestration │ ├── patcher/ Runtime injection DLL │ ├── wrapper/ IFEO process wrapper │ └── extract/ Asset decryption ├── server/ Backend services (Go) │ ├── cmd/ Servis binary'leri │ ├── internal/ ProudNet stack │ ├── scripts/ Deployment script'leri │ └── web/ Launcher ve patch asset'leri ├── build_all.bat Client runtime build └── LICENSE ``` ## 前置条件 | 层级 | 要求 | |--------|------------| | 操作系统 | Windows 10 或 11（x64 主机，x86 目标） | | Client 编译 | Visual Studio 2022 Build Tools — MSVC v143, x86 | | Backend 编译 | Go 1.22 或更高版本 | | Asset 提取 | Python 3.10+, Unicorn | | Runtime | 管理员权限（IFFO registry、process injection） | | 原版客户端 | Joygame Goley 安装包（仓库外） | 编译和部署流程：[docs/operations/build.md](docs/operations/build.md) · [docs/operations/deployment.md](docs/operations/deployment.md) ## 安装说明 ### 1. Client runtime ``` build_all.bat src\tool\revival_tool.exe init "C:\path\to\GoleySetup.exe" src\tool\revival_tool.exe launch ``` ### 2. Backend services ``` cd server make build .\scripts\start-all.ps1 .\scripts\setup-hosts.ps1 ``` `setup-hosts.ps1` 需要管理员权限。对于 patch server，需要将原版二进制文件复制到 `server/web/launcher/chagu/Real_Server_Patch/` 目录下 — 参见 [docs/operations/deployment.md](docs/operations/deployment.md)。 ## 实现状态 | 领域 | 状态 | |------|-------| | Client build 和 CLI | 可运行 | | Themida runtime bypass | 部分 — 已到达 splash 屏幕 | | nProtect handshake | 未解决 — init 线程阻塞 | | Backend ProudNet handshake | 已通过 mock client 验证 | | 真实客户端集成 | 未验证 | 当前状态矩阵、已知限制及路线图：[docs/project/status.md](docs/project/status.md) · [docs/project/roadmap.md](docs/project/roadmap.md) ## 文档 所有技术参考文档均集中在 `docs/` 目录下进行管理。入口点：[docs/README.md](docs/README.md) | 角色 | 起始文档 | |-----|-------------------| | 架构 | [docs/architecture/overview.md](docs/architecture/overview.md) | | 运维 | [docs/operations/deployment.md](docs/operations/deployment.md) | | Client 开发 | [docs/client/cli-reference.md](docs/client/cli-reference.md) | | Backend 开发 | [docs/server/services.md](docs/server/services.md) | | 故障排查 | [docs/operations/runbook.md](docs/operations/runbook.md) | ## 开源许可 MIT — [LICENSE](LICENSE) 第三方依赖：[docs/legal/third-party-licenses.md](docs/legal/third-party-licenses.md)

标签：C/C++, 事务性I/O, 内核驱动, 后端模拟, 客户端运行时, 日志审计, 游戏私服, 网络协议, 逆向工具