MikuLeaks/MikuSB - 快速上手

由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名

项目介绍快速开始学习路径贡献者 5 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品上榜历史

MikuSB 5分钟快速开始指南

快速部署一个本地游戏服务器模拟器，用于网络协议研究。

环境要求

支持的操作系统

Windows macOS Linux

运行环境

.NET SDK 9.0 必需

所需工具

Git

克隆项目

必需

文本编辑器

编辑配置文件

必需

操作步骤

安装 .NET 9.0 SDK

从微软官网下载并安装 .NET 9.0 SDK。

预期结果：：在终端输入 `dotnet --version` 能看到 9.x.x 版本号。

如果系统已有更高版本的 .NET SDK，可能需要安装特定版本。

克隆项目

使用 Git 克隆 MikuSB 项目到本地。

克隆仓库

git clone https://github.com/MikuLeaks/MikuSB.git

进入项目目录

cd MikuSB

预期结果：：看到项目文件被下载到 MikuSB 文件夹。

确保网络可以访问 GitHub。

构建项目

还原依赖并构建项目。

还原 NuGet 包

dotnet restore

以 Release 模式构建项目

dotnet build --configuration Release

预期结果：：构建成功，没有错误。

首次构建可能需要较长时间下载依赖。

配置游戏路径

编辑配置文件，指定游戏可执行文件的路径。

预期结果：：配置文件 Config.json 已更新。

如果暂时没有游戏客户端，可以先留空或设为一个占位符路径，服务器仍可启动。

启动服务器并创建账号

运行服务器，然后在控制台创建账号。

启动服务器

dotnet run --project MikuSB --configuration Release

创建新账号（例如：create testuser）

在服务器控制台输入 `create <用户名>`

预期结果：：看到服务器启动成功日志，并显示账号创建成功信息。

服务器默认监听 HTTP 端口（通常为 5000）和 TCP 端口。

（可选）启用本地代理

如果需要将游戏域名重定向到本地服务器，请启用代理。

启动代理（监听 127.0.0.1:8888）

在服务器控制台输入 `proxy on`

启用代理后，需要将系统或游戏的代理设置指向 127.0.0.1:8888。

验证服务器是否成功运行

确认服务器各个组件已启动并就绪。

控制台显示 SdkServer 已启动并监听 HTTP 端口

控制台显示 GameServer 已启动并监听 TCP 端口

成功创建账号并看到相关日志

（如果启用代理）控制台显示 Proxy 已启动并监听 8888 端口

快速提示

环境

所有命令都在项目根目录（包含 .sln 文件的目录）执行。

配置

如果遇到端口冲突，可以检查并修改配置文件中的端口设置。

调试

查看控制台日志可以了解服务器运行状态和错误信息。

常见问题

dotnet build 报错找不到 SDK

确保已正确安装 .NET 9.0 SDK，并在终端中能运行 `dotnet` 命令。

启动时报告端口被占用

修改 Config.json 中的端口配置，或关闭占用该端口的程序。

无法连接到 GitHub 克隆项目

检查网络连接，或尝试使用代理。也可以手动下载 ZIP 包。

服务器启动后游戏客户端无法连接

1. 检查防火墙设置。2. 如果使用代理，确保客户端代理指向正确。3. 检查客户端配置是否正确指向服务器地址。

下一步

尝试使用游戏客户端连接

配置游戏客户端指向本地服务器（通常需要修改客户端配置文件或使用代理）。

查看项目文档

阅读 READMEjp.md 获取更详细的日语文档。

加入社区

访问项目 Discord 服务器获取帮助和最新信息。