保姆级Ubuntu搭建割草机（原神私服）教程

Ubuntu搭建原神私服

一. 准备
二. 安装服务端所需环境
- （1）安装 jdk-17
- （2）安装 MongoDB
三. 下载服务端文件
四. 配置服务端
- （1）预运行，生成必要的文件和文件夹
五. 代理
六. 客户端修改
七. 踩的坑

一. 准备

最好是装 Ubuntu 20.04 的系统，22.04 的系统的 Openssl（好像是这个）的版本是 3.0 的，MongoDB 用的版本是 1.1 的，安装 MongoDB 时会比较麻烦，所以直接推荐用 20.04 的系统。
本教程对应的版本无所谓，实测 3.7 和 4.0 的都能成功，只需要替换对应的文件即可。如果是其他的版本，理论上按照教程安装，然后有对应的客户端补丁就行。
最好有 ssh 和 ftp 软件，ssh 可以用 Windows 自带的 Terminal，商店可以安装，连接命令是：

ssh -p <port> <username>@<ip>

port 是端口号，如果没有修改的话一般是 22，没有修改端口，这部分可以不用。username 就是你的用户名，建议用 root，不用管权限问题。Ubuntu 安装后默认用 ubuntu 账号，好像是没有 root 权限的。建议是改成 root 用户登录。ip 就是服务器的 ip。

比如这样：

ssh [email protected]

或者如果修改了端口号：

ssh -p 2222 [email protected]

ftp 软件可以使用 Winscp 直接网上下载就行，具体使用方法百度下就行了，这里不赘述了。
创建一个文件夹，用来放服务端的文件，这里随便哪里都行，建议放在 /home 目录下。创建一个目录：

cd /home
mkdir grasscutter

这样在 /home 目录下有个 /grasscutter 文件夹，后续服务端文件都会放在这个里面。

二. 安装服务端所需环境

（1）安装 jdk-17

用上面说的方法登录到 Ubuntu 中，随便在哪个目录，先更新下：

apt-get update
apt-get upgrade

然后安装java：

apt-get install openjdk-17-jdk

等待安装完成。

（2）安装 MongoDB

安装：

apt-get install mongodb

检查是否安装成功：

systemctl status mongodb

如果显示类似下面的就说明成功了：

root@VM-16-12-ubuntu:~# systemctl status mongodb
● mongodb.service - An object/document-oriented database
     Loaded: loaded (/lib/systemd/system/mongodb.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2023-09-01 22:42:39 CST; 12h ago
       Docs: man:mongod(1)
   Main PID: 128405 (mongod)
      Tasks: 26 (limit: 3971)
     Memory: 174.6M
     CGroup: /system.slice/mongodb.service
             └─128405 /usr/bin/mongod --unixSocketPrefix=/run/mongodb --config /etc/mongodb.conf

9月 01 22:42:39 VM-16-12-ubuntu systemd[1]: Started An object/document-oriented database.

创建一个用户，账户名密码随意：

db.createUser({
    
    user: "root",pwd: "123456", roles: [ {
    
     role: "root", db: "admin" } ]})

查看是否创建成功：

db.auth("root", "123456") #返回1，则表示成功

这里数据库的事情已经结束了，如果想要远程访问数据库的话，那么需要修改 /etc/mongodb.conf 中的配置，将 bindip 改为 0.0.0.0 ，保存退出，然后 service mongodb restart 重启就行。

三. 下载服务端文件

（1）下载 Grasscutter

打开 Grasscutter，点击 Actions，然后选择最新的成功 build 的版本，拉到最下面，点击 Grasscutter 下载。
下载完之后解压，会得到一个类似 grasscutter-1.7.0.jar 的文件，用 ftp 软件（WinSCP）上传到 /home/grasscutter 文件夹中。

（2）下载 Resources

用 ssh 跳转到 grasscutter 目录中，然后用 git 命令（一般是已经有的，不用自己安装，没有的话，就手动安装一下）下载 Resources 文件：

cd /home/grasscutter
git clone https://gitlab.com/YuukiPS/GC-Resources.git

等待下载完成，可以后面干其他的事情。

（3）下载插件

跟下 Grasscutter 一样，打开 gc-opencommand-plugin，点击 Actions，选择最新的 build，下载 opencommand。
解压后会得到一个类似 opencommand-1.6.1.jar 的文件。
在 /home/grasscutter 中创建一个 plugins 文件夹

cd /home/grasscutter
mkdir plugins

然后将 opencommand-1.6.1.jar 上传到 plugins 中。

打开 Grasscutter，点击右上角的下载按钮，将此文件 keystore.p12 下载下来。然后上传到 /home/grasscutter 中。
到此，等待 git 下载完成，那么所有服务端文件已经准备完毕。在/home/grasscutter 中，有以下几个文件：
```
GC-Resources	// 文件夹
plugins			// 文件夹，里面有个 opencommand-1.6.1.jar 文件
grasscutter-1.7.0.jar
keystore.p12
```

四. 配置服务端

（1）预运行，生成必要的文件和文件夹

在 ssh 命令行中输入如下的命令：

cd /home/grasscutter
java -jar grasscutter-1.7.0.jar		// 如果你不是这个版本，只需要输入 java -jar gr 然后按 Tab 键，即可

运行后，会出现如下结果：

11:32:27 <INFO:Grasscutter> config.json could not be found. Generating a default configuration ...
11:32:28 <INFO:Grasscutter> Loading Grasscutter...
11:32:28 <INFO:Utils> 正在创建 resources 目录...
11:32:28 <INFO:Utils> 请将 BinOutput 和 ExcelBinOutput 复制到 resources 目录
11:32:28 <INFO:Utils> 请将 BinOutput 和 ExcelBinOutput 复制到 resources 目录
11:32:28 <INFO:Utils> 为完整使用任务，推荐添加 'Server' 目录
11:32:28 <INFO:Utils> 为完整使用任务，推荐添加 'ScriptSceneData' 目录
11:32:28 <INFO:Utils> 在 'Anime-Game-Servers/CustomGCResources' 找到额外的 resources

此时，用 WinSCP 查看 grasscutter 目录会发现已经生成了几个文件和文件夹，打开 config.json 文件，修改以下几个地方：

"folderStructure": {
    
    
  "resources": "./resources/", // 这里比较偷懒的方法是改成 ./GC-Resources/Resources
  "data": "./data/",
  "packets": "./packets/",
  "scripts": "resources:Scripts/",
  "plugins": "./plugins/",
  "cache": "./cache/"
},

"databaseInfo": {
    
    
    "server": {
    
    
      "connectionUri": "mongodb://localhost:27017",
      "collection": "grasscutter"	//如果你搭了多个版本的，比如3.7和4.0共存，那么这个可以改个名字，不要重复就行
    },
    "game": {
    
    
      "connectionUri": "mongodb://localhost:27017",
      "collection": "grasscutter"	//如果你搭了多个版本的，比如3.7和4.0共存，那么这个可以改个名字，不要重复就行
    }
  },


"server": {
    
    
  "debugWhitelist": [],
  "debugBlacklist": [],
  "runMode": "HYBRID",
  "logCommands": false,
  "fastRequire": true,
  "http": {
    
    
    "startImmediately": false,
    "bindAddress": "0.0.0.0",
    "bindPort": 443,	// 这里需要修改成你的端口号，尽量别用 443，不然可能会造成端口号已占用的情况，比较麻烦
    "accessAddress": "127.0.0.1",	// 这里修改成你的服务器的 IP
    "accessPort": 0,
    "encryption": {
    
    
      "useEncryption": true,	// 这里改成 false
      "useInRouting": true,	// 这里改成 false
      "keystore": "./keystore.p12",
      "keystorePassword": "123456"
    },
    "policies": {
    
    
      "cors": {
    
    
        "enabled": true,
        "allowedOrigins": [
          "*"
        ]
      }
    },
    "files": {
    
    
      "indexFile": "./index.html",
      "errorFile": "./404.html"
    }
  },
  "game": {
    
    
    "bindAddress": "0.0.0.0",
    "bindPort": 22102,
    "accessAddress": "127.0.0.1",	// 这里改成你的服务器的 IP，后面没有需要修改的了，如果你想改服务器名啥的，可以下面找找改一改
    "accessPort": 0,
    "loadEntitiesForPlayerRange": 300,
    "enableScriptInBigWorld": true,
    "enableConsole": true,
    "kcpInterval": 20,
    "logPackets": "NONE",
    "isShowPacketPayload": false,
    "isShowLoopPackets": false,
    "cacheSceneEntitiesEveryRun": false,
    ......

改完保存。然后再次运行上面的代码：

java -jar grasscutter-1.7.0.jar

等待一段时间，当出现下面的情况时：

12:12:51 <INFO:Grasscutter> Loading Grasscutter...
12:12:51 <INFO:Grasscutter> 正在启动 Grasscutter...
12:12:51 <INFO:Grasscutter> 游戏版本：4.0.0
12:12:51 <INFO:Grasscutter> Grasscutter 版本：1.7.0-a7bd929
12:12:53 <INFO:PluginManager> 正在加载插件：opencommand-plugin
12:12:53 <INFO:ResourceLoader> 正在加载 resources...
12:12:57 <ERROR:TsvUtils> Error loading file './GC-Resources/Resources/ExcelBinOutput/HomeWorldNPCExcelConfigData.tsj' - File does not exist. You are missing resources. Note that this file may exist in JSON, TSV, or TSJ format, any of which are suitable.
12:13:09 <INFO:ResourceLoader> 完成加载 resources
12:13:09 <INFO:HttpServer> [Dispatch] Dispatch 服务器启动于 192.168.200.128:10088
12:13:09 <INFO:GameServer> Grasscutter 是免费开源软件，遵循 AGPL-3.0 license。
        如果你是付费购买的，那你已经被骗了。
        项目地址：https://github.com/Grasscutters/Grasscutter
12:13:09 <INFO:GameServer> 游戏服务器启动于 192.168.200.128:22102
12:13:09 <INFO:PluginManager> 启用插件：opencommand-plugin
12:13:09 <INFO:OpenCommandPlugin> [OpenCommand] Enabled. https://github.com/jie65535/gc-opencommand-plugin
12:13:09 <INFO:Grasscutter> 加载完成！输入 "help" 查看命令列表
>

此时可以输入 help 查看帮助信息。
我们需要在这里创建一个账号，xxx 是你的账号名，10001 是对应的UID，UID是从10001开始往后排：

account creater xxx 10001

五. 代理

下载代理软件，下载到你的电脑上，然后解压，打开之后，填入你的服务器地址和端口号，不选择使用 SSL，点击启动代理。（可能会有问题，多试几次）

六. 客户端修改

客户端需要下载对应的版本，目前2023年9月2日，4.0版本可以下载官方客户端，然后打补丁，3.7版本可以下载这个客户端，这是 Grasscutter 提供的客户端。3.7 下载后也需要打补丁，可以去QQ群（随便找原神私服群）里搜，或者网上找一找，都有，我就不贴出来了。补丁一般直接复制到 Genshin Impact Game 目录下，要替换掉源文件，如果没有显示替换源文件，说明补丁位置放错了。
打完补丁之后，就可以启动游戏了，填入上面写的账号，随便输入密码（密码要记住），就可以开始游戏了。

七. 踩的坑

关于 ipv6 导致客户端连不上的问题，这个搞了好久，明明啥都没问题，为什么就是连不上。后来发现是ip的问题，服务端不要开启 ipv6。关闭的方法可以百度下。
记得开启服务端的端口。Ubuntu 系统的防火墙看看有没有启动，如果启动了，要么关闭防火墙，要么开放出来端口。如果是腾讯云、阿里云什么的，还需要在控制台，开启端口。需要的端口有：
tcp：你修改的那个端口，8888，80，443，22102
udp：22102