原神私服 Grasscutter 搭建指南 - 2.7 更新

注意：未经授权修改与使用游戏客户端及服务端是侵犯相关公司版权的行为

此指南仅供技术交流使用，请于研究测试后 24 小时内删除，任何商业使用及商业利益冲突带来的法律纠纷与本人无关、概不负责。

在一段时间的开发后，社区开发者构建了很多 Grasscutter 相关的辅助工具，这些工具都很好用，有兴趣的可以自行探索。

但是，作者依旧不推荐使用任何的一键整合包，也不推荐游玩任何公共私服，原因如下：如果你拥有基本的计算机知识，就应该理解服务器的部署是一件多简单的事情，以及——在这基础上的二次开发和劫持是多简单的事情，你的数据安全没有保障。

我相信大部分提供服务器的人都是希望能够为自行部署存在困难的人提供帮助，但中文互联网的情况大家都了解，还请多长个心眼。如果你希望和朋友们一起游玩，找个廉价 Linux 服务器自行部署是很好的选择。无论如何，一切的核心是不要在任何私服内以任何形式投入资金，避免上当受骗。

有关于这方面的私人问题可以直接 DM 联系我的 Twitter。

资源整合

本指南中的全部资源均可于此百度网盘分享 (解压密码：@dsrkafuu) 找到，但可能存在资源更新不及时的问题，请自行检查并从官方/上游下载。本指南基于 Windows 11 (x64)，其他系统环境大同小异，请自行尝试。

本指南不对软件下载安装、环境变量配置、MongoDB 使用等基础内容进行详细描述。也不会对相关资源进行整合再发布，请自行独立下载并使用。

更新记录

2022-05-30 更新 2.7 版本
2022-05-11 更新新版指南和游戏资源
2022-05-08 添加一些实用工具的链接
2022-05-03 更新游戏资源

运行环境

MongoDB

请至官网下载。版本需求为 4.0+，指南中所使用的版本为 5.0.6 Community。MongoDB Compass 可以一并安装便于管理数据库，如果本地有 Navicat 的也可以直接使用。

除此之外 MongoDB Atlas 提供免费的 MongoDB 云实例，也可以直接进行使用。

JDK

~~要求特定版本 8u202，其他版本未测试，请至 Oracle 官网下载并安装。~~

稳定版 v1.1.0 之后要求使用 Java 17+，请至 Oracle 官网下载并安装，或使用微软编译的 OpenJDK 版本。

服务端

预编译核心

预编译的核心可以直接在项目仓库的 Actions 内找到。上文资源整合的百度网盘内有作者自行编译的核心。

若使用预编译核心，则需要将以下三项资源放置于目录内：

自行编译核心

首先拉取所需分支的 Grasscutter 源码，以开发分支为例：

git clone -b development https://github.com/Grasscutters/Grasscutter.git
cd .\Grasscutter\

完成后，进行本地编译：

.\gradlew.bat
.\gradlew.bat jar

编译完成后，在项目目录内即可找到名为 grasscutter-<version>.jar 的服务器核心。

游戏资源

除了服务端本身以外，还需要游戏的相关资源放置于目录内。本指南基于游戏版本 2.7，资源来自 Grasscutter Resources (Commit 20ced72)，将 Resources 目录内的全部文件夹拷贝到 resources 目录内即可，其中包含了 2.7 版本的全部资源。

运行服务器

java -jar .\grasscutter-<version>.jar.jar

首次运行时需要选择语言，输入 chs 即可。

服务器默认数据库连接地址为 mongodb://localhost:27017，若需要修改则直接改动 config.json即可。

服务器默认使用端口 8888、443、80 和 22102，若出现端口绑定错误，请检查是否有相关端口被占用并检查相关进程：

netstat -ano | findstr /r /c:":8888.*LISTENING"
netstat -ano | findstr /r /c:":443.*LISTENING"
netstat -ano | findstr /r /c:":80.*LISTENING"
netstat -ano | findstr /r /c:":22102.*LISTENING"

在服务端需要更新时，直接替换新核心或者拉取最新的源码重新进行本地编译，最后提供新的游戏资源即可。游戏资源的获取可以关注 Genkit TG 群组，频道中还有一些非官方的 Grasscutter 包可用，本指南仅关注 Grasscutter 官方源。

客户端

在运行客户端之前，首先需要将客户端请求代理至本地服务器 (同理可代理至运行服务端的云服务器)。使用类似 mitmproxy 和 Fiddler Classic 的软件均可，本指南使用 mitmproxy 8.0 版本。

安装完成后，以代理至端口 12345 为例运行项目目录内的 proxy.py 即可：

mitmdump -s proxy.py --ssl-insecure --listen-port 12345

若为直接使用预编译的服务器核心，该文件见仓库。

如果需要让外部主机连接 (如公共服务器) 需要设置参数 --set block_global=false。代理运行后，首先关闭现有的 Clash 等系统代理软件，前往系统网络设置，手动设置代理为 127.0.0.1:12345。

设置完成后，需要添加 mitmproxy 生成的证书才可以正常进行连接，使用浏览器访问 http://mitm.it/，下载对应平台的证书，并根据网页教程添加至 "受信任的根证书颁发机构" 即可。若为服务器运行，此处的证书需要保存并发送给所有需要连接服务器的人添加。

在进入游戏之前，首先要创建账户，在服务端控制台运行如下指令：

account create [username] {playerid}

完成账户创建后，即可在 MongoDB 中看见新创建的账户。

服务端的全部控制台指令可以通过 help 指令获取。

最后，运行对应游戏资源版本的游戏客户端即可，本指南使用国际服 2.7 版本客户端。输入注册的用户名并随便设置一个密码即可进入游戏。进入游戏后代理可以关闭，推荐在连接公共服务器时尽快关闭代理以节约服务器流量。