grasscutter 使用指南——Android/Windows/IOS端均已支持_Echidna_

大大的周 02-07 3180

grasscutter 使用指南——Android/Windows/IOS端均已支持前言

grasscutter是某二次元手游的开源后端，目前功能并不完整，但正在contributers正在全速开发中，未来可期。可以部署在linux和windows下，通过代理与各种平台的客户端进行交互。本文提供grasscutter的linux端部署（windows端比较简单）、windows/andriod/ios端的客户端连接指导，其中安卓提供机器root和非root两种情况下的解决方案。本文需要有一定的计算机基础，不面向小白，尽量说的详细，说明部分可能包含简单的shell命令，自行执行，不提供一键安装脚本，不提供已搭建完成的服务器，适合爱折腾的玩家，不希望任何人以此盈利，欢迎进行技术交流，有问题可以问。

关键突破点为mitmproxy在安卓客户端的ca证书安装，安卓可以使用vmos获得一个root过的虚拟机（vmos不要在应用商店下载，有关键功能阉割，去官网下载。root功能需要vip，有慈禧预付费版本，不想花钱的可以自己动手找一下）

更新

目前dev版本已更新秘境和深渊，大世界支持联机。

关键词

SSL、CA证书、grasscutter、某二次元游戏、代理转发、http注入、安卓、IOS、windows

环境准备 java se 17mongodb 4.0+mitmproxy

环境准备请自行度娘解决

linux服务端搭建（centos7）

1.git拉取或直接下载源代码，并上传到服务器,tar -xzf解压缩

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

注意下载的dev版本（如果编译不通过，又不想调试，可以改下stable版本）

1.关闭防火墙或配置放行策略（注意除了常规端口外，要放行TCP和UDP的22102端口） systemctl stop firewalld

我就比较直接，23333。如果是云服务器，记得去控制台配置一下安全组策略，服务端90%的问题来自这里。

2. 启动mongodb，自行百度linux下如何启动mongodb，这个基本上没啥问题，后续出现27017端口问题或mongodb类似的报错，多半是mongo服务没起或者挂了。这里提供一个教程，执行到启动mongodb服务并验证即可。 3. 编译，需要java17环境自带gradle全自动编译脚本，执行就完事了。 sh gradlew jar

执行时间视服务器配置而定，如有报错，请检查你的java环境和网络环境，善用度娘

编译成功后会在grasscutter的主目录下生成一个grasscutter开头（加版本号）的jar文件，直接运行

java -jar grasscutter-1.1.0.jar #1.1.0是我下载的版本

会提示缺少资源文件，并给你创好了资源文件的目录（resources，没创的话自行创一下），里面的内容需要你自己下载。

4. 下载资源文件

github地址

注：此仓库被github停掉的概率较高，注意备份，原因不多说了，dddd。

git clone https://github.com/memetrollsXD/Grasscutter_Resources.git

将Resources下的文件全部复制到grasscutter根目录下的resources文件夹中，包括BinOutput、ExcelBinOutput、Readable、Scripts、Subtitle、TextMap

5. 启动服务器

修改配置文件config.json

{ "DatabaseUrl": "mongodb://localhost:27017", "DatabaseCollection": "grasscutter", "RESOURCE_FOLDER": "./resources/", "DATA_FOLDER": "./data/", "PACKETS_FOLDER": "./packets/", "DUMPS_FOLDER": "./dumps/", "KEY_FOLDER": "./keys/", "SCRIPTS_FOLDER": "./resources/Scripts/", "PLUGINS_FOLDER": "./plugins/", "DebugMode": "NONE", "RunMode": "HYBRID", "GameServer": { "Name": "Test", "Ip": "0.0.0.0", "PublicIp": "your public ip", "Port": 22102, "PublicPort": 0, "DispatchServerDatabaseUrl": "mongodb://localhost:27017", "DispatchServerDatabaseCollection": "grasscutter", "InventoryLimitWeapon": 2000, "InventoryLimitRelic": 2000, "InventoryLimitMaterial": 2000, "InventoryLimitFurniture": 2000, "InventoryLimitAll": 30000, "MaxAvatarsInTeam": 4, "MaxAvatarsInTeamMultiplayer": 4, "MaxEntityLimit": 1000, "WatchGacha": false, "ServerNickname": "Server", "ServerAvatarId": 10000007, "ServerNameCardId": 210001, "ServerLevel": 1, "ServerWorldLevel": 1, "ServerSignature": "Server Signature", "WelcomeEmotes": [ 2007, 1002, 4010 ], "WelcomeMotd": "Welcome to Grasscutter emu", "WelcomeMailTitle": "Welcome to Grasscutter!", "WelcomeMailSender": "Lawnmower", "WelcomeMailContent": "Hi there!\r\nFirst of all, welcome to Grasscutter. If you have any issues, please let us know so that Lawnmower can help you! \r\n\r\nCheck out our:\r\n\u003ctype\u003d\"browser\" text\u003d\"Discord\" href\u003d\"https://discord.gg/T5vZU6UyeG\"/\u003e", "WelcomeMailItems": [ { "itemId": 13509, "itemCount": 1, "itemLevel": 1 }, { "itemId": 201, "itemCount": 10000, "itemLevel": 1 } ], "EnableOfficialShop": true, "Game": { "ADVENTURE_EXP_RATE": 1.0, "MORA_RATE": 1.0, "DOMAIN_DROP_RATE": 1.0 } }, "DispatchServer": { "Ip": "0.0.0.0", "PublicIp": "your public ip", "Port": 14514, "PublicPort": 0, "KeystorePath": "./keystore.p12", "KeystorePassword": "123456", "UseSSL": true, "FrontHTTPS": true, "CORS": false, "CORSAllowedOrigins": [ "*" ], "AutomaticallyCreateAccounts": false, "defaultPermissions": [ "" ], "GameServers": [] }, "LocaleLanguage": "en_US", "DefaultLanguage": "en", "OpenStamina": true }

其实只需要修改两处publicip为你的公网ip，以及如果你不想用443端口，修改一下DispatchServer.port即可，注意这里修改的话，下面的mitmdump的配置也需要同步修改。其他的不涉及网络的选项，你自己看着改。

（我开的端口有点臭，23333）

再执行一次启动命令

java -jar grasscutter-1.1.0.jar

显示游戏服务器在22102端口运行，转发服务器在14514端口运行，即为成功。

此时参照命令表，在该shell窗口输入账号创建命令

account create echidna 114514233

会提示账号创建成功。

QA java编译失败

列出我遇到的几种可能原因，

java环境没配好，这属于最不太可能的错误，但还是检测一下，输入java --version，看是不是17点几版本的，不是赶紧换。网络问题，编译过程会给你安装gradle和一系列jar依赖,看看卡在哪里了自行下载后导入。内存问题，编译需要占用较多内存，实测内存512MB失败，2G成功，运行时最低需要1G内存，（本来想用vps服务器的，但vps配置较差，没编过去，哈哈哈）程序问题，dev版本编译建失败实属正常现象，要么自己调一下，要么换stable版本。上述是我实际遇到过的问题，如依然不能解决，自行百度，本人C++工程师，java属实有点专业盲区。程序运行失败确认你的resources目录正常存在于编译生成的入口jar文件的同级目录下，并内容齐全。确认你config.json文件的json格式没有被破坏，比如手滑多删了个引号（还真有人这么蠢，是谁呢，不会是我吧？）确认你的mongodb的守护进程正常，ps -aux | grep mongod 确认没有程序占用你的端口，netstat -tunlp | grep <你设置的端口，默认是443>，linux下的常见犯人叫ngnix，windows下的常见犯人叫vmware，重点检查。确认你的可用内存大于1G 提示密码错误的，可以把config.json中的DispatchServer.KeystorePassword改为空（原本是空的改为123456，每个版本的key可能放的不一样，反正两个总有一个是对的）。 6. 配置抓包以及http注入

这里我们用到mitmproxy，我看到不少人使用fiddler，但fiddler是基于.net开发的程序，移植到linux并不方便。

可以直接使用pip3安装，没装python3的yum装一下。

pip3 install mitmproxy

会给你安装mitmproxy及其命令行版本，即mitmdump，还有其多版本的ca证书

也可以去官网下载二进制版本，但不带ca证书，需要你自行部署完成后开启代理并访问mitm.it下载，但国内的云服务器不允许域名转发到未备案域名，所以会比较麻烦。

安装完成后，我们回到grasscutter的主目录

vim proxy_config.py

修改配置文件，如下：

import os # This can also be replaced with another IP address. USE_SSL = True REMOTE_HOST = "your public ip" REMOTE_PORT = 14514 if os.getenv('MITM_REMOTE_HOST') != None: REMOTE_HOST = os.getenv('MITM_REMOTE_HOST') if os.getenv('MITM_REMOTE_PORT') != None: REMOTE_PORT = int(os.getenv('MITM_REMOTE_PORT')) if os.getenv('MITM_USE_SSL') != None: USE_SSL = bool(os.getenv('MITM_USE_SSL')) print('MITM Remote Host: ' + REMOTE_HOST) print('MITM Remote Port: ' + str(REMOTE_PORT)) print('MITM Use SSL ' + str(USE_SSL))

注意此处的REMOTE_PORT要与上面你修改的dispatchsever的port一致。

配置ca证书 cp ~/.mitmproxy/mitmproxy-ca-cert.crt /etc/ssl/certs # 这句是安装为根证书，未必需要 cp ~/.mitmproxy/mitmproxy-ca-cert.pem /etc/pki/ca-trust/source/anchors update-ca-trust extract

执行转发。重点来了，mitmproxy的安卓代理存在诸多问题，需要添加一系列参数进行规避，而这部分，大部分教程并未提及

mitmdump -s proxy.py --ssl-insecure --set block_global=false --no-http2

允许不安全的ssl连接，禁用http2连接，以及禁用internet对mitmproxy的直接访问，。

此时，代理服务器会在默认的8080端口启动，同样请确保端口不会冲突。

windows端登陆

配置ca证书

将服务器端~/.mitmproxy文件夹下的mitmproxy-ca-cert.p12文件拿到windows机器上，直接双击，选择给本地计算机安装，要密码直接空过，自动选择目录即可，重启机器。

windows端支持国服和国际服客户端登录，方法非常简单，打开网络和Internet设置，选择代理，打开手动设置代理选项，填写地址和端口，即为你上面设置的publicip和mitmdump的端口（默认8080那个）。

打开客户端，直接用你创建的账号密码登录即可。

为啥我客户端提示网络异常？

代理端口不对，建议检查你的mitmproxy是否活着，端口号是否正确。

为啥4206了？

大抵是证书装的有问题罢，要么你没有全局安装，要么可以把上面那个mitmproxy目录下的另外一个p12文件也拉出装一下，目前未验证grasscutter下的证书是否需要安装，可以尝试一下安装那个grasscutter下的keystore.p12文件。

连上去后网络非常不稳定

你服务器带宽问题。

登录进去显示12-4301

建议切换美服通道登录

为啥我发现我nohup后台运行程序的服务器炸了？

硬盘炸了，ssh连不上的话，先去控制台重启一下。首先，必须重定向nohup到dev/null，而且目前grasscutter有bug，会往主目录的log文件夹里疯狂写入latest.log，目前config.json中未发现相关选择，本人是懒得去代码里找，直接选择删除latest.log。

其他问题

检查你的有没有科学上网啥的，关了。

IOS端登录自行搜索ios如何安装ca证书，我们要安装的ca证书是~/.mitmproxy目录下的mitmproxy-ca-cert.pem，注意下载完成后要去找到这个文件，点一下，然后再执行证书安装的两个步骤（先安装再信任）。不要使用小火箭，会有bug，原因很简单，小火箭不会转发udp报文，但我们的grasscuter是依赖于kcp这种udp协议的。IOS端一把成功，没遇到啥问题，有问题应该和上述windows端差不多的解决方法。 Android端登录

比上面的都要复杂，问题主要出在，Android7.0往后，应用可以选择不信任用户证书，而很遗憾该手游app就是设置为不信任的那种，基于此，我想出3条解决方案。

magisk，就是俗称的面具root，不过没有备用机，不打算刷掉我的正常使用的手机，并不考虑。改包，设置为接受用户证书，然后重新打包，值得一试。使用虚拟机，也就是安卓模拟器。

乍一看，第三点是一个非常抽象的想法，这意味着要在安卓机上装安卓模拟器，这不搞笑吗。但找了一下，真的有这种东西，vmos pro。

至于这玩意咋整，应该没啥技术难度，注意我之前说的关于vmos pro的注意事项即可，剩下的百度解决。

当我们有了一个root过的虚拟机的时候，我需要将ca证书安装到系统目录下，为此需要openssl进行安卓系统ca证书的制作。

yum install openssl openssl x509 -inform PEM -subject_hash_old -in mitmproxy-ca-cert.pem -noout cp mitmproxy-ca-cert.pem c8750f0d.0 # 这边的c8750f0d是上一条命令的输出。

将这个文件放入/system/etc/security/cacerts/下，并修改权限为644

设置中长按你所连接的wifi，选择修改网络，设置代理，和上面的其他客户端一样的要求。

连接即可，注意需要国际服客户端。

结语

本人网络方向C++工程师，本来以为可以一晚上解决的，但其实还是研究了不少时间的，毕竟要跑dev版本的java的代码（我跑的那个版本编译都有问题2333），以及一堆ca证书问题，终于全客户端搞定了这玩意，搭建了一个服务器和朋友一起玩玩。为防止一切侵权隐患，以及屏蔽正义游侠，文章概不放图，但该讲到的节点都讲到了，有需要技术支持的请评论区留言，技术支持不收费，三言两语能解决的我都会回答（只要你不是小白，大部分问题属于这种），想以此盈利的请勿打扰（之前看到一个群友截图，大致说是有个卖家某宝98出售私服，结果买家进群，卖家说windows和ios都解决了，让大家等等安卓端的解决方案，笑死）。

关于私服问题，我是持摆烂态度的，只要不借此盈利即可，盈利那是纯纯的收割冤种。毕竟这是一个主打大世界探索的游戏，私服缺少你的核心玩法，注定就该只是自娱自乐。如果说只有单纯抽卡和副本的私服真的能把你干爆了，你是不是该想想自己游戏的问题呢（非指你游）？显然这种私服激不起什么浪花。