mirror of
https://github.com/postyizhan/NitWikit.git
synced 2024-12-15 08:10:37 +08:00
重置velocity内容
This commit is contained in:
postyizhan
parent
b6937d380b
commit
26beed3210
BIN
docs/跨服端/_images/灵魂画师教开群组服.kra
Normal file
BIN
docs/跨服端/_images/灵魂画师教开群组服.kra
Normal file
Binary file not shown.
BIN
docs/跨服端/_images/灵魂画师教开群组服.png
Normal file
BIN
docs/跨服端/_images/灵魂画师教开群组服.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 28 KiB |
6
docs/跨服端/搭建/BungeeCord/_category_.json
Normal file
6
docs/跨服端/搭建/BungeeCord/_category_.json
Normal file
@ -0,0 +1,6 @@
|
||||
{
|
||||
"position": 1,
|
||||
"link": {
|
||||
"type": "generated-index"
|
||||
}
|
||||
}
|
||||
7
docs/跨服端/搭建/BungeeCord/概览.md
Normal file
7
docs/跨服端/搭建/BungeeCord/概览.md
Normal file
@ -0,0 +1,7 @@
|
||||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# 概览
|
||||
|
||||
TODO
|
||||
6
docs/跨服端/搭建/Velocity/_category_.json
Normal file
6
docs/跨服端/搭建/Velocity/_category_.json
Normal file
@ -0,0 +1,6 @@
|
||||
{
|
||||
"position": 2,
|
||||
"link": {
|
||||
"type": "generated-index"
|
||||
}
|
||||
}
|
||||
139
docs/跨服端/搭建/Velocity/velocity.toml.md
Normal file
139
docs/跨服端/搭建/Velocity/velocity.toml.md
Normal file
@ -0,0 +1,139 @@
|
||||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
以下配置仅为汉化参考 **请勿直接复制！！**
|
||||
|
||||
```toml
|
||||
# 配置版本。不要更改这个
|
||||
config-version = "2.7"
|
||||
|
||||
# 代理应该绑定到哪个端口？默认情况下，我们将绑定到25577端口的所有地址。
|
||||
bind = "0.0.0.0:25577"
|
||||
|
||||
# 应该显示什么MOTD（服务器消息）？当玩家将您的服务器添加到他们的服务器列表时，会显示这个。只接受MiniMessage格式。
|
||||
motd = "<#09add3>一个Velocity服务器"
|
||||
|
||||
# 我们应该显示多少最大玩家数？（Velocity不支持在线玩家数的限制。）
|
||||
show-max-players = 500
|
||||
|
||||
# 我们应该使用Mojang对玩家进行身份验证吗 (译者注: 正版验证)？ 默认情况下，这是开启的。
|
||||
online-mode = true
|
||||
|
||||
# 代理是否应该强制执行新的公钥安全标准？默认情况下，这是开启的。
|
||||
force-key-authentication = true
|
||||
|
||||
# 如果从这个代理发送的客户端的ISP/AS与Mojang的认证服务器的不同，玩家将被踢出。这禁止了一些VPN和代理连接，但这是一种较弱的保护形式。
|
||||
prevent-client-proxy-connections = false
|
||||
|
||||
# 我们应该将IP地址和其他数据转发到后端服务器吗？
|
||||
# 可用选项：
|
||||
# - "none": 不会进行任何转发。所有玩家看起来都是从代理连接的，并且将拥有离线模式的UUID。
|
||||
# - "legacy": 以BungeeCord兼容格式转发玩家IP和UUID。如果您运行的是Minecraft 1.12或更低版本的服务器，请使用此选项。
|
||||
# - "bungeeguard": 以BungeeGuard插件支持的格式转发玩家IP和UUID。如果您运行的是Minecraft 1.12或更低版本的服务器，并且无法实现网络级防火墙（在共享主机上），请使用此选项。
|
||||
# - "modern": 使用Velocity的原生转发，在登录过程中转发玩家IP和UUID。仅适用于Minecraft 1.13或更高版本。
|
||||
player-info-forwarding-mode = "NONE"
|
||||
|
||||
# 如果您使用modern 或BungeeGuard IP转发，请在此处配置包含唯一密钥的文件。
|
||||
# 文件应该是UTF-8编码的，并且不为空。
|
||||
forwarding-secret-file = "forwarding.secret"
|
||||
|
||||
# 宣布您的服务器是否支持Forge。如果您运行一个模组服务器，我们建议开启这个。
|
||||
#
|
||||
# 如果您的网络持续运行一个模组包，考虑使用ping-passthrough = "mods"代替，以便在服务器列表中更好地显示。
|
||||
announce-forge = false
|
||||
|
||||
# 如果启用（默认为false），并且代理处于在线模式，Velocity将踢出任何已在线的玩家，如果尝试进行重复连接。
|
||||
kick-existing-players = false
|
||||
|
||||
# Velocity是否应该将服务器列表ping请求传递给后端服务器？
|
||||
# 可用选项：
|
||||
# - "disabled": 不会进行任何传递。velocity.toml和server-icon.png将决定初始服务器列表ping响应。
|
||||
# - "mods": 只将后端服务器的模组列表传递到响应中。
|
||||
# 使用您尝试列表中的第一个服务器（或强制主机）的模组列表。如果无法联系到后端服务器，Velocity将不会显示任何模组信息。
|
||||
# - "description": 使用来自后端服务器的描述和模组列表。尝试列表中（或强制主机）响应的第一个服务器将被用于描述和模组列表。
|
||||
# - "all": 使用后端服务器的响应作为代理响应。如果没有服务器可以联系，将使用Velocity配置。
|
||||
ping-passthrough = "DISABLED"
|
||||
|
||||
# 如果未启用（默认为true），玩家IP地址将被替换为<ip address withheld>在日志中
|
||||
enable-player-address-logging = true
|
||||
|
||||
[servers]
|
||||
# 在此处配置您的服务器。每个键代表服务器的名称，值代表要连接到的服务器的IP地址。
|
||||
lobby = "127.0.0.1:30066"
|
||||
factions = "127.0.0.1:30067"
|
||||
minigames = "127.0.0.1:30068"
|
||||
|
||||
# 当玩家登录或从服务器被踢出时，我们应该尝试让他进入哪个服务器？
|
||||
try = [
|
||||
"lobby"
|
||||
]
|
||||
|
||||
[forced-hosts]
|
||||
# 在此处配置您的强制主机。
|
||||
"lobby.example.com" = [
|
||||
"lobby"
|
||||
]
|
||||
"factions.example.com" = [
|
||||
"factions"
|
||||
]
|
||||
"minigames.example.com" = [
|
||||
"minigames"
|
||||
]
|
||||
|
||||
[advanced]
|
||||
# Minecraft数据包必须有多大，我们才会压缩它。将其设置为零将压缩所有数据包，将其设置为-1将完全禁用压缩。
|
||||
compression-threshold = 256
|
||||
|
||||
# 应该进行多少压缩（从0-9）。默认是-1，使用默认级别6。
|
||||
compression-level = -1
|
||||
|
||||
# 客户端在上次连接后允许多快连接（以毫秒为单位）？默认是三秒。通过将其设置为0来禁用此功能。
|
||||
login-ratelimit = 3000
|
||||
|
||||
# 在此处指定连接超时的自定义超时时间。默认是五秒。
|
||||
connection-timeout = 5000
|
||||
|
||||
# 在此处指定连接的读取超时时间。默认是30秒。
|
||||
read-timeout = 30000
|
||||
|
||||
# 启用与HAProxy的PROXY协议的兼容性。如果您不知道这是干什么用的，那么就不要启用它。
|
||||
haproxy-protocol = false
|
||||
|
||||
# 在代理上启用TCP快速打开支持。需要代理在Linux上运行。
|
||||
tcp-fast-open = false
|
||||
|
||||
# 在Velocity上启用BungeeCord插件消息通道支持。
|
||||
bungee-plugin-message-channel = true
|
||||
|
||||
# 显示来自客户端的ping请求到代理。
|
||||
show-ping-requests = false
|
||||
|
||||
# 默认情况下，Velocity将尝试优雅地处理用户意外失去与服务器的连接而没有明确的断开消息的情况，通过尝试回退用户，除了读取超时的情况。BungeeCord将断开用户连接。您可以禁用此设置以使用BungeeCord的行为。
|
||||
failover-on-unexpected-server-disconnect = true
|
||||
|
||||
# 向1.13+客户端声明代理命令。
|
||||
announce-proxy-commands = true
|
||||
|
||||
# 启用命令的日志记录
|
||||
log-command-executions = false
|
||||
|
||||
# 启用记录玩家连接到代理，切换服务器以及从代理断开连接的日志。
|
||||
log-player-connections = true
|
||||
|
||||
# 允许通过Transfer数据包（Minecraft 1.20.5）从其他主机传输的玩家被接收。
|
||||
accepts-transfers = false
|
||||
|
||||
[query]
|
||||
# 是否启用对GameSpy 4查询响应的响应。
|
||||
enabled = false
|
||||
|
||||
# 如果查询已启用，查询协议应该在哪个端口上监听？
|
||||
port = 25577
|
||||
|
||||
# 这是向查询服务报告的名称。
|
||||
map = "Velocity"
|
||||
|
||||
# 默认情况下是否应该在查询响应中显示插件
|
||||
show-plugins = false
|
||||
```
|
||||
20
docs/跨服端/搭建/Velocity/命令.md
Normal file
20
docs/跨服端/搭建/Velocity/命令.md
Normal file
@ -0,0 +1,20 @@
|
||||
---
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# 命令
|
||||
|
||||
Velocity 默认在代理的核心中包含了一些命令，这些命令是基于它们对大多数用户所需的。如果您需要更多命令，您可以安装插件来添加。
|
||||
|
||||
| 命令 | 权限 | 描述 |
|
||||
|-------------------------------------------|--------------------------------------|--------------------------------------------------------------|
|
||||
| `/velocity` | N/A | 包含许多子命令，用于管理代理。 |
|
||||
| `/velocity plugins` | `velocity.command.plugins` | 可以使用此命令查看代理上当前激活的所有插件，包括名称、作者和版本。 |
|
||||
| `/velocity version` | `velocity.command.info` | （默认所有用户拥有），可以查看代理上运行的 Velocity 版本。 |
|
||||
| `/velocity reload` | `velocity.command.reload` | 代理将从磁盘上的 `velocity.toml` 读取并重新配置自己。 |
|
||||
| `/velocity dump` | `velocity.command.plugins` | 可以使用此命令获取代理的匿名详细信息转储。 |
|
||||
| `/velocity heap` | `velocity.command.heap` | **警告**：此命令生成的堆转储包含有关您的 Velocity 实例的详细信息，可能相当敏感。 |
|
||||
| `/server` | `velocity.command.server` | （默认所有用户拥有），玩家可以使用此命令查看并切换到另一个服务器。 |
|
||||
| `/shutdown` | 无（从控制台执行） | 此命令将优雅地关闭 Velocity 代理，所有玩家将从代理断开连接。 |
|
||||
| `/glist` | `velocity.command.glist` | 如果用户具有此权限（默认无人具有），玩家可以使用此命令查看当前在代理上的玩家数量。 |
|
||||
| `/send` | `velocity.command.send` | 他们可以将其他玩家（或代理上的所有玩家）发送到另一个服务器。 |
|
||||
162
docs/跨服端/搭建/Velocity/搭建.md
Normal file
162
docs/跨服端/搭建/Velocity/搭建.md
Normal file
@ -0,0 +1,162 @@
|
||||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# 搭建
|
||||
|
||||
## 下载
|
||||
|
||||
在 [核心选择](/docs/跨服端/核心选择.md) 找到 velocity 然后下载
|
||||
|
||||
## 启动
|
||||
|
||||
创建一个新的文件夹将核心放进去
|
||||
|
||||
并且使用参数启动以生成初始文件
|
||||
|
||||
如果想进一步优化可以使用JVM参数 [Velocity官方](https://docs.papermc.io/velocity/getting-started)有推荐的flags
|
||||
|
||||
```bash
|
||||
java -Xms1000M -Xmx1000M -jar 核心名字.jar
|
||||
```
|
||||
|
||||
## 配置
|
||||
|
||||
打开 `velocity.toml`
|
||||
|
||||
找到并修改以下内容
|
||||
|
||||
在 **[servers]** 那里该填什么?
|
||||
|
||||
`子服名 = "子服地址"`
|
||||
|
||||
如 `login = "0.0.0.0:25501"`
|
||||
|
||||
[详细配置文件讲解](velocity.toml.md)
|
||||
|
||||
```
|
||||
# velocity端的端口号,数字1000~65536随意
|
||||
bind = "0.0.0.0:25577"
|
||||
# 正版验证,有1.19.1+的子服不建议开启此项
|
||||
online-mode = false
|
||||
# 1.13+这里填modern 1.12-填bungeeguard
|
||||
player-info-forwarding-mode = "modern"
|
||||
# ping穿透,填all
|
||||
ping-passthrough = "all"
|
||||
# 子服名称和地址,名称不可包含”.”
|
||||
[servers]
|
||||
## 登录服
|
||||
login = "0.0.0.0:25501"
|
||||
## 生存服
|
||||
survival = "0.0.0.0.:25502"
|
||||
## 资源服
|
||||
resource = "0.0.0.0:25503"
|
||||
# 尝试连接子服的先后顺序
|
||||
try = [
|
||||
“login”,"survival"
|
||||
]
|
||||
# 建议删除此项所有值
|
||||
[forced-hosts]
|
||||
"lobby.example.com" = [
|
||||
"lobby"
|
||||
]
|
||||
```
|
||||
|
||||
## 子服配置
|
||||
|
||||
Velocity支持将玩家信息（如IP地址、UUID和皮肤）转发到您的服务器。Velocity支持三种转发格式：
|
||||
|
||||
- **Velocity Modern 转发** (现代转发)是一种自定义的转发格式（modern 转发），它更安全。
|
||||
- **BungeeCord 转发**（也称为_传统转发_），它有更好的兼容性但安全性较低。
|
||||
- **BungeeGuard**，与传统BungeeCord转发相同，但包含了一个密钥。它比单独的BungeeCord转发更好，但不如Velocitymodern 转发理想。
|
||||
|
||||
您只能选择这些转发格式中的一种。目前不可能“混合匹配”转发模式或同时使用所有转发格式。一般来说，如果您只支持使用Minecraft 1.13及更新版本的客户端，请使用Velocity Modern 转发；否则，您必须使用BungeeCord转发。
|
||||
|
||||
### 配置现代转发 (Modern Forwarding)
|
||||
|
||||
<details>
|
||||
<summary>点击展开</summary>
|
||||
|
||||
**`modern` 转发** 是 Velocity 的原生格式，以高效的二进制格式转发所有玩家信息，并采用 MAC 代码增加安全性，使非法服务器难以绕过您的 Velocity 代理。但它**仅支持 Minecraft 1.13 或更高版本**。
|
||||
|
||||
#### 警告
|
||||
|
||||
- `modern` 转发与 **Minecraft 1.13 以下版本** 和 **ProtocolSupport 插件** 不兼容。如果使用这些，您需要使用传统的 BungeeCord 兼容转发。
|
||||
|
||||
#### 配置步骤
|
||||
|
||||
1. 在 `velocity.toml` 文件中将 `player-info-forwarding` 设置为 `modern`。
|
||||
2. 确保您的服务器已正确配置以使用 Velocity 转发。
|
||||
|
||||
#### 为 Paper 配置现代转发
|
||||
|
||||
- Paper **1.14 及以上版本** 以及 **1.13.1/1.13.2 版本 377 及以上版本** 原生支持 Velocity 现代转发。
|
||||
|
||||
1. 在 `server.properties` 文件中禁用 `online-mode` 设置，以防止服务器自行验证玩家身份。
|
||||
2. 如果之前已启用 BungeeCord 转发，需在 `spigot.yml` 中将 `settings.bungeecord` 设置为 `false`。
|
||||
3. 在 `config/paper-global.yml` 中：
|
||||
- 设置 `proxies.velocity.enabled` 为 true。
|
||||
- 设置 `proxies.velocity.secret` 以匹配您的 `forwarding.secret` 文件中的密钥。
|
||||
- 设置 `proxies.velocity.online-mode` 与您的 `velocity.toml` 中的 `online-mode` 一致。
|
||||
4. 编辑完成后，重新启动服务器。
|
||||
|
||||
**注意**：如果您使用的是 Paper **1.18.2 或更低版本**，请在 `paper.yml` 文件中查找相关设置。
|
||||
|
||||
<details>
|
||||
<summary>点击展开-为Fabric/Forge配置现代转发</summary>
|
||||
|
||||
#### 为 Fabric 配置现代转发
|
||||
|
||||
- 使用名为 **FabricProxy-Lite** 的 mod，可以在 Fabric 上使用修改过的服务器与 Velocity 现代转发。
|
||||
|
||||
#### 为 Forge 配置现代转发
|
||||
|
||||
- 使用名为 **ProxyCompatibleForge** 的 mod，可以在 Forge **1.16.5 或更高版本** 的修改过的服务器上使用 Velocity 现代转发。
|
||||
|
||||
</details>
|
||||
|
||||
</details>
|
||||
|
||||
### 配置传统 BungeeCord 兼容转发 (Legacy Forwarding)
|
||||
|
||||
<details>
|
||||
<summary>点击展开</summary>
|
||||
|
||||
#### 警告
|
||||
|
||||
- 传统转发 **本质上是不安全的**。如果必须使用，应了解如何正确保护您的服务器。
|
||||
|
||||
1. `legacy` 转发是 BungeeCord 启用 IP 转发时使用的玩家信息转发协议。
|
||||
2. 它广泛支持且兼容性强，但 **不安全**。
|
||||
3. 在 `velocity.toml` 中将 `player-info-forwarding` 设置为 `legacy`。
|
||||
4. 确保服务器能接受 Velocity 发送的转发玩家数据。
|
||||
|
||||
#### 增加安全性
|
||||
|
||||
- 对于托管在共享主机上的代理，Velocity 可选地支持 **BungeeGuard**。
|
||||
- 将 `velocity.toml` 中的 `player-info-forwarding` 设置为 `bungeeguard`。
|
||||
- 在 BungeeGuard 配置的令牌部分添加 `forwarding.secret` 文件中的值。
|
||||
|
||||
#### 为 Spigot / Paper 配置传统转发
|
||||
|
||||
1. 在 `spigot.yml` 中将 `settings.bungeecord` 设置为 `true`。
|
||||
2. 重新启动服务器。
|
||||
|
||||
<details>
|
||||
<summary>点击展开-为Sponge/Fabric配置传送转发</summary>
|
||||
|
||||
#### 为 Sponge 配置传统转发
|
||||
|
||||
1. 停止服务器。
|
||||
2. 在 `config/sponge/global.conf` 文件中将 `modules.bungeecord` 和 `bungeecord.ip-forwarding` 设置为 true。
|
||||
3. 重新启动 Sponge 服务器。
|
||||
|
||||
#### 为 Fabric 配置传统转发
|
||||
|
||||
**警告**：不再有任何积极支持传统转发的 mod。**请改用 Velocity 现代转发**。
|
||||
|
||||
</details>
|
||||
|
||||
</details>
|
||||
|
||||
接着便可以加入加入服务器测试了
|
||||
7
docs/跨服端/搭建/Velocity/概览.md
Normal file
7
docs/跨服端/搭建/Velocity/概览.md
Normal file
@ -0,0 +1,7 @@
|
||||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# 概览
|
||||
|
||||
[官方英文文档]([Welcome to the Velocity Docs | PaperMC Docs](https://docs.papermc.io/velocity))
|
||||
@ -1,259 +0,0 @@
|
||||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# velocity
|
||||
|
||||
[官方英文文档]([Welcome to the Velocity Docs | PaperMC Docs](https://docs.papermc.io/velocity))
|
||||
|
||||
## 下载
|
||||
|
||||
在 [核心选择](https://nitwikit.yizhan.wiki/跨服端/核心选择) 找到 velocity 然后下载
|
||||
|
||||
## 安装
|
||||
|
||||
创建一个新的文件夹将核心放进去
|
||||
|
||||
并且使用参数启动
|
||||
|
||||
如果想进一步优化可以使用JVM参数 [Velocity官方](https://docs.papermc.io/velocity/getting-started)有推荐的flags
|
||||
|
||||
```bash
|
||||
java -Xms1000M -Xmx1000M -jar 核心名字.jar
|
||||
```
|
||||
|
||||
## 配置
|
||||
|
||||
打开目录下的 velocity.toml
|
||||
|
||||
以下配置仅为汉化参考 **请勿直接复制！！**
|
||||
|
||||
```toml
|
||||
# 配置版本。不要更改这个
|
||||
config-version = "2.7"
|
||||
|
||||
# 代理应该绑定到哪个端口？默认情况下，我们将绑定到25577端口的所有地址。
|
||||
bind = "0.0.0.0:25577"
|
||||
|
||||
# 应该显示什么MOTD（服务器消息）？当玩家将您的服务器添加到他们的服务器列表时，会显示这个。只接受MiniMessage格式。
|
||||
motd = "<#09add3>一个Velocity服务器"
|
||||
|
||||
# 我们应该显示多少最大玩家数？（Velocity不支持在线玩家数的限制。）
|
||||
show-max-players = 500
|
||||
|
||||
# 我们应该使用Mojang对玩家进行身份验证吗 (译者注: 正版验证)？ 默认情况下，这是开启的。
|
||||
online-mode = true
|
||||
|
||||
# 代理是否应该强制执行新的公钥安全标准？默认情况下，这是开启的。
|
||||
force-key-authentication = true
|
||||
|
||||
# 如果从这个代理发送的客户端的ISP/AS与Mojang的认证服务器的不同，玩家将被踢出。这禁止了一些VPN和代理连接，但这是一种较弱的保护形式。
|
||||
prevent-client-proxy-connections = false
|
||||
|
||||
# 我们应该将IP地址和其他数据转发到后端服务器吗？
|
||||
# 可用选项：
|
||||
# - "none": 不会进行任何转发。所有玩家看起来都是从代理连接的，并且将拥有离线模式的UUID。
|
||||
# - "legacy": 以BungeeCord兼容格式转发玩家IP和UUID。如果您运行的是Minecraft 1.12或更低版本的服务器，请使用此选项。
|
||||
# - "bungeeguard": 以BungeeGuard插件支持的格式转发玩家IP和UUID。如果您运行的是Minecraft 1.12或更低版本的服务器，并且无法实现网络级防火墙（在共享主机上），请使用此选项。
|
||||
# - "modern": 使用Velocity的原生转发，在登录过程中转发玩家IP和UUID。仅适用于Minecraft 1.13或更高版本。
|
||||
player-info-forwarding-mode = "NONE"
|
||||
|
||||
# 如果您使用modern 或BungeeGuard IP转发，请在此处配置包含唯一密钥的文件。
|
||||
# 文件应该是UTF-8编码的，并且不为空。
|
||||
forwarding-secret-file = "forwarding.secret"
|
||||
|
||||
# 宣布您的服务器是否支持Forge。如果您运行一个模组服务器，我们建议开启这个。
|
||||
#
|
||||
# 如果您的网络持续运行一个模组包，考虑使用ping-passthrough = "mods"代替，以便在服务器列表中更好地显示。
|
||||
announce-forge = false
|
||||
|
||||
# 如果启用（默认为false），并且代理处于在线模式，Velocity将踢出任何已在线的玩家，如果尝试进行重复连接。
|
||||
kick-existing-players = false
|
||||
|
||||
# Velocity是否应该将服务器列表ping请求传递给后端服务器？
|
||||
# 可用选项：
|
||||
# - "disabled": 不会进行任何传递。velocity.toml和server-icon.png将决定初始服务器列表ping响应。
|
||||
# - "mods": 只将后端服务器的模组列表传递到响应中。
|
||||
# 使用您尝试列表中的第一个服务器（或强制主机）的模组列表。如果无法联系到后端服务器，Velocity将不会显示任何模组信息。
|
||||
# - "description": 使用来自后端服务器的描述和模组列表。尝试列表中（或强制主机）响应的第一个服务器将被用于描述和模组列表。
|
||||
# - "all": 使用后端服务器的响应作为代理响应。如果没有服务器可以联系，将使用Velocity配置。
|
||||
ping-passthrough = "DISABLED"
|
||||
|
||||
# 如果未启用（默认为true），玩家IP地址将被替换为<ip address withheld>在日志中
|
||||
enable-player-address-logging = true
|
||||
|
||||
[servers]
|
||||
# 在此处配置您的服务器。每个键代表服务器的名称，值代表要连接到的服务器的IP地址。
|
||||
lobby = "127.0.0.1:30066"
|
||||
factions = "127.0.0.1:30067"
|
||||
minigames = "127.0.0.1:30068"
|
||||
|
||||
# 当玩家登录或从服务器被踢出时，我们应该尝试让他进入哪个服务器？
|
||||
try = [
|
||||
"lobby"
|
||||
]
|
||||
|
||||
[forced-hosts]
|
||||
# 在此处配置您的强制主机。
|
||||
"lobby.example.com" = [
|
||||
"lobby"
|
||||
]
|
||||
"factions.example.com" = [
|
||||
"factions"
|
||||
]
|
||||
"minigames.example.com" = [
|
||||
"minigames"
|
||||
]
|
||||
|
||||
[advanced]
|
||||
# Minecraft数据包必须有多大，我们才会压缩它。将其设置为零将压缩所有数据包，将其设置为-1将完全禁用压缩。
|
||||
compression-threshold = 256
|
||||
|
||||
# 应该进行多少压缩（从0-9）。默认是-1，使用默认级别6。
|
||||
compression-level = -1
|
||||
|
||||
# 客户端在上次连接后允许多快连接（以毫秒为单位）？默认是三秒。通过将其设置为0来禁用此功能。
|
||||
login-ratelimit = 3000
|
||||
|
||||
# 在此处指定连接超时的自定义超时时间。默认是五秒。
|
||||
connection-timeout = 5000
|
||||
|
||||
# 在此处指定连接的读取超时时间。默认是30秒。
|
||||
read-timeout = 30000
|
||||
|
||||
# 启用与HAProxy的PROXY协议的兼容性。如果您不知道这是干什么用的，那么就不要启用它。
|
||||
haproxy-protocol = false
|
||||
|
||||
# 在代理上启用TCP快速打开支持。需要代理在Linux上运行。
|
||||
tcp-fast-open = false
|
||||
|
||||
# 在Velocity上启用BungeeCord插件消息通道支持。
|
||||
bungee-plugin-message-channel = true
|
||||
|
||||
# 显示来自客户端的ping请求到代理。
|
||||
show-ping-requests = false
|
||||
|
||||
# 默认情况下，Velocity将尝试优雅地处理用户意外失去与服务器的连接而没有明确的断开消息的情况，通过尝试回退用户，除了读取超时的情况。BungeeCord将断开用户连接。您可以禁用此设置以使用BungeeCord的行为。
|
||||
failover-on-unexpected-server-disconnect = true
|
||||
|
||||
# 向1.13+客户端声明代理命令。
|
||||
announce-proxy-commands = true
|
||||
|
||||
# 启用命令的日志记录
|
||||
log-command-executions = false
|
||||
|
||||
# 启用记录玩家连接到代理，切换服务器以及从代理断开连接的日志。
|
||||
log-player-connections = true
|
||||
|
||||
# 允许通过Transfer数据包（Minecraft 1.20.5）从其他主机传输的玩家被接收。
|
||||
accepts-transfers = false
|
||||
|
||||
[query]
|
||||
# 是否启用对GameSpy 4查询响应的响应。
|
||||
enabled = false
|
||||
|
||||
# 如果查询已启用，查询协议应该在哪个端口上监听？
|
||||
port = 25577
|
||||
|
||||
# 这是向查询服务报告的名称。
|
||||
map = "Velocity"
|
||||
|
||||
# 默认情况下是否应该在查询响应中显示插件
|
||||
show-plugins = false
|
||||
```
|
||||
|
||||
## 核心命令
|
||||
|
||||
Velocity 默认在代理的核心中包含了一些命令，这些命令是基于它们对大多数用户所需的。如果您需要更多命令，您可以安装插件来添加。
|
||||
|
||||
|
||||
|
||||
| 命令 | 权限 | 描述 |
|
||||
|-------------------------------------------|--------------------------------------|--------------------------------------------------------------|
|
||||
| `/velocity` | N/A | 包含许多子命令，用于管理代理。 |
|
||||
| `/velocity plugins` | `velocity.command.plugins` | 可以使用此命令查看代理上当前激活的所有插件，包括名称、作者和版本。 |
|
||||
| `/velocity version` | `velocity.command.info` | （默认所有用户拥有），可以查看代理上运行的 Velocity 版本。 |
|
||||
| `/velocity reload` | `velocity.command.reload` | 代理将从磁盘上的 `velocity.toml` 读取并重新配置自己。 |
|
||||
| `/velocity dump` | `velocity.command.plugins` | 可以使用此命令获取代理的匿名详细信息转储。 |
|
||||
| `/velocity heap` | `velocity.command.heap` | **警告**：此命令生成的堆转储包含有关您的 Velocity 实例的详细信息，可能相当敏感。 |
|
||||
| `/server` | `velocity.command.server` | （默认所有用户拥有），玩家可以使用此命令查看并切换到另一个服务器。 |
|
||||
| `/shutdown` | 无（从控制台执行） | 此命令将优雅地关闭 Velocity 代理，所有玩家将从代理断开连接。 |
|
||||
| `/glist` | `velocity.command.glist` | 如果用户具有此权限（默认无人具有），玩家可以使用此命令查看当前在代理上的玩家数量。 |
|
||||
| `/send` | `velocity.command.send` | 他们可以将其他玩家（或代理上的所有玩家）发送到另一个服务器。 |
|
||||
|
||||
## 下游服务端配置
|
||||
|
||||
Velocity支持将玩家信息（如IP地址、UUID和皮肤）转发到您的服务器。Velocity支持三种转发格式：
|
||||
|
||||
- **Velocity Modern 转发** 是一种自定义的转发格式（modern 转发），它更安全。
|
||||
- **BungeeCord 转发**（也称为_传统转发_），它有更好的兼容性但安全性较低。
|
||||
- **BungeeGuard**，与传统BungeeCord转发相同，但包含了一个密钥。它比单独的BungeeCord转发更好，但不如Velocitymodern 转发理想。
|
||||
|
||||
您只能选择这些转发格式中的一种。目前不可能“混合匹配”转发模式或同时使用所有转发格式。一般来说，如果您只支持使用Minecraft 1.13及更新版本的客户端，请使用Velocity Modern 转发；否则，您必须使用BungeeCord转发。
|
||||
|
||||
### 配置现代转发 (Modern Forwarding)
|
||||
|
||||
**`modern` 转发** 是 Velocity 的原生格式，以高效的二进制格式转发所有玩家信息，并采用 MAC 代码增加安全性，使非法服务器难以绕过您的 Velocity 代理。但它**仅支持 Minecraft 1.13 或更高版本**。
|
||||
|
||||
#### 警告
|
||||
|
||||
- `modern` 转发与 **Minecraft 1.13 以下版本** 和 **ProtocolSupport 插件** 不兼容。如果使用这些，您需要使用传统的 BungeeCord 兼容转发。
|
||||
|
||||
#### 配置步骤
|
||||
|
||||
1. 在 `velocity.toml` 文件中将 `player-info-forwarding` 设置为 `modern`。
|
||||
2. 确保您的服务器已正确配置以使用 Velocity 转发。
|
||||
|
||||
#### 为 Paper 配置现代转发
|
||||
|
||||
- Paper **1.14 及以上版本** 以及 **1.13.1/1.13.2 版本 377 及以上版本** 原生支持 Velocity 现代转发。
|
||||
|
||||
1. 在 `server.properties` 文件中禁用 `online-mode` 设置，以防止服务器自行验证玩家身份。
|
||||
2. 如果之前已启用 BungeeCord 转发，需在 `spigot.yml` 中将 `settings.bungeecord` 设置为 `false`。
|
||||
3. 在 `config/paper-global.yml` 中：
|
||||
- 设置 `proxies.velocity.enabled` 为 true。
|
||||
- 设置 `proxies.velocity.secret` 以匹配您的 `forwarding.secret` 文件中的密钥。
|
||||
- 设置 `proxies.velocity.online-mode` 与您的 `velocity.toml` 中的 `online-mode` 一致。
|
||||
4. 编辑完成后，重新启动服务器。
|
||||
|
||||
**注意**：如果您使用的是 Paper **1.18.2 或更低版本**，请在 `paper.yml` 文件中查找相关设置。
|
||||
|
||||
#### 为 Fabric 配置现代转发
|
||||
|
||||
- 使用名为 **FabricProxy-Lite** 的 mod，可以在 Fabric 上使用修改过的服务器与 Velocity 现代转发。
|
||||
|
||||
#### 为 Forge 配置现代转发
|
||||
|
||||
- 使用名为 **ProxyCompatibleForge** 的 mod，可以在 Forge **1.16.5 或更高版本** 的修改过的服务器上使用 Velocity 现代转发。
|
||||
|
||||
### 配置传统 BungeeCord 兼容转发 (Legacy Forwarding)
|
||||
|
||||
#### 警告
|
||||
|
||||
- 传统转发 **本质上是不安全的**。如果必须使用，应了解如何正确保护您的服务器。
|
||||
|
||||
1. `legacy` 转发是 BungeeCord 启用 IP 转发时使用的玩家信息转发协议。
|
||||
2. 它广泛支持且兼容性强，但 **不安全**。
|
||||
3. 在 `velocity.toml` 中将 `player-info-forwarding` 设置为 `legacy`。
|
||||
4. 确保服务器能接受 Velocity 发送的转发玩家数据。
|
||||
|
||||
#### 增加安全性
|
||||
|
||||
- 对于托管在共享主机上的代理，Velocity 可选地支持 **BungeeGuard**。
|
||||
- 将 `velocity.toml` 中的 `player-info-forwarding` 设置为 `bungeeguard`。
|
||||
- 在 BungeeGuard 配置的令牌部分添加 `forwarding.secret` 文件中的值。
|
||||
|
||||
#### 为 Spigot / Paper 配置传统转发
|
||||
|
||||
1. 在 `spigot.yml` 中将 `settings.bungeecord` 设置为 `true`。
|
||||
2. 重新启动服务器。
|
||||
|
||||
#### 为 Sponge 配置传统转发
|
||||
|
||||
1. 停止服务器。
|
||||
2. 在 `config/sponge/global.conf` 文件中将 `modules.bungeecord` 和 `bungeecord.ip-forwarding` 设置为 true。
|
||||
3. 重新启动 Sponge 服务器。
|
||||
|
||||
#### 为 Fabric 配置传统转发
|
||||
|
||||
**警告**：不再有任何积极支持传统转发的 mod。**请改用 Velocity 现代转发**。
|
||||
7
docs/跨服端/搭建/加入服务器.md
Normal file
7
docs/跨服端/搭建/加入服务器.md
Normal file
@ -0,0 +1,7 @@
|
||||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# 概览
|
||||
|
||||
TODO
|
||||
@ -4,36 +4,59 @@ sidebar_position: 1
|
||||
|
||||
# 什么是跨服端?
|
||||
|
||||
简单的来说就是将多个服务器连成一个整体(比如你经常看到的某些生存一区, 生存二区), 玩家可以自由选择到哪个服务器, 而不用退出重连,
|
||||
简单的来说就是将多个服务器连成一个整体(比如你经常看到的某些生存一区, 生存二区), 玩家可以自由选择到哪个服务器, 而不用退出重连,
|
||||
|
||||
不同服务器之间可以通过跨服同步（比如HuskSync)和数据库同步数据, 平时常听到的群组服也是一个意思. 跨服通常的实现方法是:
|
||||
|
||||
一个反向代理端(如velocity/bungeecord)和多个子服务器(如paper/purpur/leaf等). 玩家只需要连接到反向代理端即可让反向代理端和子服务器联系, 最后把玩家送到对应的服务器.
|
||||
|
||||
# 原理讲解
|
||||
|
||||
假设你现在有三个服务器,分别为 登录服,生存服和资源服,三个服务器都能正常进入和游玩
|
||||
|
||||
现在你想建设一个群组服把这三个服务器连接起来,那么,你的服务器结构就会是这样
|
||||
|
||||
|
||||
:::info
|
||||
|
||||
BungeeCord/velocity端(或他们的fork)在这里我们称为`跨服端`
|
||||
|
||||
这三个服务器都称为`子服` 图中为三个子服,子服没有先后之分
|
||||
|
||||
:::
|
||||
|
||||
如果你的群组服搭建完成,那么正常流程是:
|
||||
|
||||
玩家通过客户端连接到跨服端,接着由跨服端送至各个子服,玩家可以通过一些方式切换自己所在的子服,感觉上就像是切换维度,玩家甚至意识不到自己换过服
|
||||
|
||||
# 为什么需要代理端?
|
||||
|
||||
1. MC 是个单核心游戏, 玩家数量在超过50-100后几乎任何核心都无法保证完全流畅(Folia除外), 而使用多个服务器则可以充分利用多核心优势, 大服务器必备;
|
||||
|
||||
|
||||
2. 对多个服务器, 玩家需要退出重新进入, 且数据不能共享. 仅仅只是开两个服务器无法产生有效交互. 所以需要跨服端对服务器进行切换和交互的完善;
|
||||
|
||||
3. 对单个服务器, 在内存有一点点富裕的情况下(通常不到1gb), 仍推荐使用代理端, 服务端对于反假人攻击的性能不如代理端, 如果你被攻击了, 更换成代理端再说;
|
||||
|
||||
4. 有些插件是代理端才能安装的, 而在 bukkit 系下可能不稳定(如[Multilogin](https://github.com/CaaMoe/MultiLogin)).
|
||||
|
||||
# 推荐用什么?
|
||||
|
||||
推荐使用velocity
|
||||
|
||||
# 怎么做跨服端?
|
||||
|
||||
1. 开启至少两个子服务端(这不废话吗), 将**子服务端**按照Bungeecord/Velocity的要求打开对应的配置:
|
||||
|
||||
|
||||
无论如何, 先把 server.properties 中的 network-compression-threshold项设置为-1(这个值意味着子服务器不会对数据进行压缩, 而由代理端压缩, 这在一定程度上也缓解了子服务器的压力)
|
||||
|
||||
对于 bungeecord/waterfall:
|
||||
|
||||
|
||||
1. 在bukkit.yml, 将connection-throttle设置为-1（以免 BungeeCord 连接到下游服务端时因尝试多次而连接失败）
|
||||
|
||||
2. 如果在 BungeeCord 启用了 ip_forward, 那么请在 spigot.yml , 将settings.bungeecord设置为true
|
||||
|
||||
|
||||
对于velocity:
|
||||
|
||||
|
||||
1. 如果您将 player-info-forwarding-mode 设置为了 modern ，则请前往 paper.yml，将 settings.velocity-support.enabled 设置为true，并将 settings.velocity-support.secret 设置为您在 velocity.toml 中 forwarding-secret 项设置的密钥
|
||||
|
||||
2. 将 settings.velocity-support.online-mode 设置为您在 velocity.toml 中设置的 online-mode 值.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user