返回顶部

[转载] Minecraft跨服端搭建从入门到精通(BungeeCord )

[复制链接]
zezhweLv.2 显示全部楼层 发表于 2024-1-20 16:48:17 |阅读模式 打印 上一主题 下一主题 来自 中国广东广州

马上登录/注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有账号?立即注册

x
本帖最后由 zezhwe 于 2024-1-20 16:54 编辑

Minecraft反代(跨服)服务端搭建从入门到精通(BungeeCord)
Hey,欢迎来到这里。
本文旨在通过一站式的教程,教会读者如何对目前市面上流行的反向代理服务端(跨服服务端)进行安装和配置。
本文介绍的服务端对象主要是 BungeeCord(以 Waterfall 为例)

什么是反向代理?
反向代理在电脑网络中是代理服务器的一种。服务器根据客户端的请求,从其关系的一组或多组后端服务器上获取资源,然后再将这些资源返回给客户端,客户端只会得知反向代理的IP地址,而不知道在代理服务器后面的服务器集群的存在。
由上我们可知,反向代理(简称「反代」)允许服务器端代理来自客户端的请求,为客户端返回来自服务器的资源。这与正常意义上的「代理」其实正好相反——代理一般搭建在客户端上,由代理系统作中间人,接管客户端向服务器的请求并返回。「科学上网」就是典型的代理系统。
而在MC服务器中,这些反代服务器同样可以代理来自玩家的进服请求,然后将玩家指引到代理服务器下游的各种服务器中——这便是跨服。

有关跨服的常见误区
跨服端是一个MC游戏逻辑服务端,可以使用跨服端直接开服让玩家进服游戏
这是个常见的误区,但实际上跨服端仅仅只是一个反代软件,他能够指引玩家连接到下游的指定逻辑服务端,但本身不具有任何游玩功能
使用跨服端后玩家通过任一下游服务端的IP进行游戏便可进行跨服
很显然,只有通过跨服端进入下游服务端,前者才有办法将玩家转移到其他下游服务端中,因此玩家必须通过跨服端进入服务器才可以跨服
我需要向公网暴露跨服端和下游服务端的所有连接地址和端口
事实上,你只需要暴露跨服端的连接地址和端口,然后确保跨服端能够连接到下游服务端即可。一般情况下,没有必要向玩家暴露下游服务端的连接地址。只需保证跨服端能够连接到下游服务端,然后跨服端便会充当中间人,传递玩家与下游服务端之间的数据交换。
我需要为指定下游服务端游戏版本下载相对应的跨服端版本
事实上,自1.8起,主流跨服端均已完成多版本的向下兼容,即任一版本的跨服端核心均支持 1.8-最新版本 的下游服务端游戏版本连接。如果您需要旧版,请前往 BungeeCord 的构建站界面 按照提示下载适用于旧版 Minecraft 版本的单一版本支持的 BungeeCord

开始学习使用 Waterfall 跨服
Tips:请确保您已正确安装 Java,并已准备好一个或多个下游服务端等待连接到跨服端

什么是 Waterfall
Waterfall 是一个 BungeeCord 的分支,由 PaperMC 团队主导开发,其特点是拥有更友好的控制台输出和更个性化的配置选项。

为什么不使用原生 BungeeCord
由 SpigotMC 团队开发的 BungeeCord 在控制台输出和log输出上并不完美,而 Waterfall 恰好改善了这一部分的体验,因此在这里我们使用 Waterfall 作为示例。如果你仍想使用原生 BungeeCord 或其分支(如HexaCord)也无需担心,因为 Waterfall 并不会改变主要配置文件(config.yml)和主要文件架构,因此您扔可通过本文来了解您所使用的 BungeeCord 跨服端如何配置
下载并安装 Waterfall
前往 PaperMC 官网 下载Waterfall

如上图,点击 Waterfall 标签下最上方的黑色按钮以下载 Waterfall 当前的最新构建版本
下载完成后,编写启动脚本以启动 Waterfall 。Waterfall 所需的内存并不多,因此您可按需为 Waterfall 分配 512MB-1024MB 内存
  • 对于使用 Bash/CMD 的 Windows 用户
:: on start.bat@echo offjava -Dfile.encoding=UTF-8 -Xms512M -Xmx1024M -jar waterfall-384.jarpause
  • 对于使用 Shell 的 Linux 用户
# on start.shjava -Dfile.encoding=UTF-8 -Xms512M -Xmx1024M -jar ./waterfall-384.jar
第一次启动服务端时会下载额外的模块(位于 modules 文件夹内),下载完成后服务端便会启动。
当你看到Listening on /0.0.0.0:25577时即代表服务端已经完成了加载并开始正常工作了。因为我们需要配置服务端,因此输入end(不是stop)以关闭服务端。此时,你将可以看到 Waterfall 已经生成了一些文件。
配置 Waterfall
打开config.yml,您将可以看到 Waterfall(同样,也适用于 BungeeCord ) 的主要配置:
接下来介绍主要配置项目:
forge_support 代表是否启用对 Forge 的支持,默认值为true,即启用。启用后会为 Forge 客户端提供支持(尽管兼容性并不是很好,编者注)。

player_limit 代表整个 BungeeCord 实例能够接受的最大玩家数量,默认值为-1,即不限数量。调整为正整数即启用最大玩家数量限制。

premission 和 groups 由 BungeeCord 提供的简易权限管理设置。前者用以配置权限组内置的权限,default表示默认权限组;后者用以配置玩家所在的权限组。(这里的权限是指 BungeeCord 内置及其插件声明的权限,与下游服务器的权限完全无关,切勿混淆。正如 CraftBukkit 提供的 permission.yml 一样,这套简易的权限管理配置同样不受到欢迎,且难以配置。这里推荐安装 Luckperms 作为 BungeeCord 的权限组管理插件,编者注)。

log_commands 代表是否在控制台记录玩家输入的指令(同样,仅记录 BungeeCord 指令,与下游服务器无关,编者注)。默认值为false,即不记录。

log_pings 代表是否在控制台记录玩家客户端向 BungeeCord 发起 ping 请求的记录(这种记录一般是玩家尝试刷新服务器MOTD信息时出现的)。默认值为true,即记录。

online_mode 代表是否开启正版验证,开启正版验证时, BungeeCord 将仅接受经过 Mojang 正版验证服务器验证通过的玩家加入服务器,反之任何玩家都可进入服务器。默认值为true,即开启正版验证。(请注意,如果开启正版验证,那么请务必将所有下游服务器的正版验证关闭,否则玩家将无法连接至下游服务器(BungeeCord 将负责向下游服务器传递玩家的正版数据,如 UUID 等),编者注)。

ip_forward 代表是否启用 IP 追踪,默认值为 false,即不开启。开启后 BungeeCord 将会向下游服务端传递玩家的真实IP。如果不开启本项,那么下游服务端接收到的玩家 IP 将永远为 BungeeCord 服务端所在的 IP 地址。要想开启此项,您必须使用支持 ip_forward功能的服务端,并启用其配置中的设置(具体设置方法见下)。如果仅启用了此项而不配置下游服务端的是设置,那么玩家将无法连接到下游服务器。强烈建议所有人都启用此项以免出现某些 IP 问题。

listeners表示监听器设置,一个监听器对应一个监听端口,不同的监听端口可以允许不同的玩家加入设定的不同的服务器,且设置相互独立。一个 BungeeCord 实例可以设置多个监听器。BungeeCord 的默认配置文件只提供了一个监听器,如需添加多个监听器请自行按照 YAML 语法在listeners下重复添加。

listeners.query_enabled 代表是否开启 UDP 查询,开启后可籍由 UDP 协议监听该监听器的状态。默认值为false,即关闭查询。

listeners.query_port 代表查询端口,默认值为25577。

listeners.motd 代表当仅有一个默认服务器时,服务器将会显示给玩家的Motd。当listeners.ping_passthrough被开启时,此项无效。如果希望使用双行Motd,那么可以使用以下的格式(servers.[xxx].motd同):

motd: |    第一行MOTD    第二行MOTD
listeners.tab_list 代表连接到服务器的玩家的 TAB 列表所显示的内容格式。他可以有三个值,分别是GLOBAL_PING(默认值),GLOBAL和SERVER。当设置为第一种时, TAB 列表会显示所有连接到本 BungeeCord 实例的玩家和他们的 PING 值;当设置为第二种时,同上一种大致相同,但玩家的 PING 值不会更新;当设置为第三种时,只会显示玩家所在的下游服务器的玩家列表。

listeners.proxy_protocol 代表是否开启对 HAProxy 的支持,默认值为false,即关闭。开启后,BungeCord 将支持接收上游 HAProxy 籍由 ProxyProtocolV3 协议发送的玩家真实 IP,如不开启此项但在上游使用了 HAProxy 服务端,那么 BungeeCord 接收到的玩家 IP 地址将衡为 HAProxy 的所在地址。如果您不理解此项在说什么,请不要随意开启本项。

listeners.forced_hosts 代表端口转发设置,默认值为一个仅包含一个键为pvp.md-5.net,值为pvp的 Map (即pvp.md-5.net: pvp)。这意味着所有通过pvp.md-5.net域名连接到 BungeeCord 的玩家将不会再被连接到默认下游服务器(对于默认下游服务器的配置请见listeners.priorities项),而将会被重定向至服务器名为pvp的服务器(关于服务器名的配置请见servers项)。这要求您预先将名为pvp.md-5.net的子域先解析至 BungeeCord 所在的地址。

listeners.ping_passthrough是否开启 ping 穿透,默认值为false,即不开启。开启后,BungeeCord 将直接传递默认下游服务器的 ping(如motd,在线玩家数)信息到客户端,而不是显示 BungeeCord 设置的此类信息。

listeners.priorities 优先级设置,默认值为一个仅有lobby 服务器的列表,可以按照格式依次向下添加多个已在servers项中配置的服务器名,优先级由上到下逐级递减)。这代表玩家连接到 BungeeCord 后将会被转发到的服务器的顺序:第一个是首选服务器,如果因为某些原因使玩家无法连接到该服务器(如服务器已关闭,版本与玩家客户端版本不匹配),那么将尝试将玩家转发到下一个服务器,以此类推。如果所有服务器都无法连接,那么玩家将会收到一个服务器当前不可用的提示。(此项不一定必须全部对应servers内的下游服务端名称,如果您有一个登录服,那么此处应当只填写您的登录服名称,这样当您的登录服离线时,玩家将不能进入服务器,而不是绕过登录服的登录系统前往其他下游服务器)

listeners.bind_local_address 代表是否显式显示 BungeeCord 正在监听的 IP 地址,默认值为true。除非的服务器拥有多个 IP 地址,否则这并没有什么实际用处。如果没有特殊需求,最好不要改变此项。

listeners.host 代表该监听器监听的 IP 地址和端口,默认值为0.0.0.0:25577,即监听来自所有 IP 地址的来自25577端口的连接。0.0.0.0代表监听所有 IP 地址,如果您将其设置为非0.0.0.0的 IP 地址,则代表只监听来自于该 IP 地址的连接。一般情况下,您只需要修改25577为希望玩家连接的端口号,或保持不变。

listeners.max_players 代表玩家客户端将会显示的最大玩家数,默认值为1。此项只作为装饰,并未真实的最大玩家数设置,即使将此项设置为0,玩家仍可以进入服务器。要想设置真正的最大玩家数,请见player_limit项。 listeners.tab_size 代表将会显示在 TAB 列表上的最大玩家数量,默认值为60.

listeners.force_default_server 代表当每次玩家进入服务器时,是否强制将玩家发送到默认服务器中,默认值为false,即关闭。设置为false则代表玩家进入服务器时将会发送到玩家上一次下线时的服务器。如果您有一个登录服,亦或者使用了一个由单个大厅服务器管理的登录插件,请务必将此处设置为true以免玩家下次登录时直接绕过登录系统。此项与listeners.forced_hosts相冲突,如果您希望使用后者提供的重定向功能,那么请将此项设置为false。

prevent_proxy_connections 代表是否向 Mojang 发送玩家 IP 数据以阻止 使用了代理的玩家进入服务器。默认值为false,即不开启

connection_throttle 和 connection_throttle_limit 为 BungeeCord 自带的简易反压测策略,他们分别代表断开时间和断开次数,默认值分别为4000和3。这意味着单个 IP 一旦在 4000 毫秒内连接了 BungeeCord 3 次,那么它必须等待 4000 毫秒后才能再次连接。

servers 代表下游服务端设置,只有在此处设置过的下游服务器才可被连接。它包括一个名为lobby的默认下游服务端,您可以按照这种格式继续向下添加更多的下游服务器。(如果修改了lobby的名称,请千万不要忘记修改上方listeners.priorities的优先级设置以免因不存在一个名为lobby的下游服务端而无法连接。其中:
  • server.[XXX]代表服务器名称,可为任意值,但必须是唯一的;
  • server.[xxx].motd代表当有多个默认服务器时,被匹配到可以连接的首选服务器将会显示给玩家的Motd。同样当listeners.ping_passthrough被开启时,此项无效。如果希望使用双行Motd,请参见上方listeners.motd的注释。
  • server.[xxx].address代表目标下游服务器的 IP 地址和端口,请填写 BungeeCord 所在的网络环境能够连接到的地址(包括本地地址和内网地址),无需保证玩家可以连接。
  • server.[xxx].restricted 代表权限控制,默认值为false。当设置为true时,只有拥有bungeecord.server.[xxx]权限时,玩家才能进入此服务器。

配置下游服务端
如果您正在使用 Vanilla 服务端:
  • 前往server.properties将server-ip项设置为 BungeeCord 所在的 IP 地址(如果 BungeeCord 和 下游服务端位于同一个网络环境,那么可以使用127.0.0.1),将network-compression-threshold项设置为-1(此项将交由 BungeeCord 管理)
  • 如果您启用了 BungeeCord 的ip_forward,那么您需要安装 VanillaCore,并依照其介绍为 Vanila 服务端注入补丁,注入完成后,使用修改后的 Vanilla 服务端即可支持 ip_forward
如果您正在使用 CraftBukkit 服务端:
  • 前往server.properties将server-ip项设置为 BungeeCord 所在的 IP 地址(如果 BungeeCord 和 下游服务端位于同一个网络环境,那么可以使用127.0.0.1),将network-compression-threshold项设置为-1(此项将交由 BungeeCord 管理)
  • 前往bukkit.yml,将connection-throttle设置为-1(以免 BungeeCord 连接到下游服务端时因尝试多次而连接失败)
  • 您不能启用 BungeeCord 的ip_forward,因为 CraftBukkit 不支持 ip_forward
如果您正在使用 Spigot 及其分支服务端(包括但不限于 Paper,Tuinity,Akarin,Thermos,Contigo,Uranium,CatServer,Mohist,Magma,Arclight):
  • 前往server.properties将server-ip项设置为 BungeeCord 所在的 IP 地址(如果 BungeeCord 和 下游服务端位于同一个网络环境,那么可以使用127.0.0.1),然后将network-compression-threshold项设置为-1(此项将交由 BungeeCord 管理)
  • 前往bukkit.yml,将connection-throttle设置为-1(以免 BungeeCord 连接到下游服务端时因尝试多次而连接失败)
  • 如果您启用了 BungeeCord 的ip_forward,那么请前往spigot.yml,将settings.bungeecord设置为true。如果您找不到该项,那么请确认您的 Spigot 版本是否高于 1.7 #5版本,如您的 Spigot 版本低于该版本,则您不应启用ip_forward项
如果您正在使用 Sponge(SpongeVanilla,SpongeForge) 及其分支服务端:
  • 前往server.properties将server-ip项设置为 BungeeCord 所在的 IP 地址(如果 BungeeCord 和 下游服务端位于同一个网络环境,那么可以使用127.0.0.1),然后将network-compression-threshold项设置为-1(此项将交由 BungeeCord 管理)
  • 如果您正在使用 SpongeForge,那么请开启 BungeeCord 中的forge_support以接收 Forge 数据包
  • 如果您启用了 BungeeCord 的ip_forward,那么请前往config/sponge/global.conf,将modules.bungeecord和bungeecord.ip-forwarding设置为true。
如果您正在使用 VanillaFabric(或所谓carpet服务端):
  • 前往server.properties将server-ip项设置为 BungeeCord 所在的 IP 地址(如果 BungeeCord 和 下游服务端位于同一个网络环境,那么可以使用127.0.0.1),然后将network-compression-threshold项设置为-1(此项将交由 BungeeCord 管理)
  • 如果您启用了 BungeeCord 的ip_forward,那么您需要安装 FabricProxy 模组以支持ip_forward。
如果您完成了以上的所有配置,那么恭喜您,您的 Waterfall 已经部署完毕,可以进行跨服工作了。

额外的配置
对于 Waterfall,其在waterfall.yml上显示了很多有用的额外配置,您可以前往该文件内自行探索。

如何跨服
使用/server 服务器名指令即可传送到指定的服务器;
使用/send 玩家名 服务器名指令可以将指定在线玩家发送至指定的服务器;
请注意,不要忘记在权限管理系统中给予玩家bungeecord.command.server权限,给予有权限的管理员bungeecord.command.send权限以允许这些玩家使用上述指令。
其他 BungeeCord 指令请自行探索。

为 Waterfall 安装插件
您可以前往 SpigotMC 为 Waterfall 下载插件,并将插件放入plugins文件夹,并重启服务器,即可完成插件安装
至此,您已经完成了使用 Waterfall 进行跨服的全部学习。

帖子地址: 

程志伟
回复

使用道具 举报

精彩评论1

xiaofeiLv.2 显示全部楼层 发表于 2024-1-20 17:46:19 来自 中国河北邯郸
非常不错
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

像素世界 成立于2022年8月,是中国开发者开创的一个综合像素沙盒游戏交流社区,拥有稳定的开发维护及运营技术,提供长期交流需求。本社区开放了我的世界模组、地图、插件等资源交流版块,集中了大量资源为玩家和开发者提供了优质的游戏环境。
  • 官方B站

  • 微信公众号

  • 商务合作