Update velocity.md

2025-01-18 15:35:10 +08:00 · 2024-05-04 18:17:01 +08:00 · 2024-05-04 18:17:01 +08:00 · 2a6a389b07
commit 2a6a389b07
parent d34cb89630
1 changed files with 251 additions and 1 deletions
--- a/docs/跨服端/搭建/velocity.md
+++ b/docs/跨服端/搭建/velocity.md
@ -4,6 +4,256 @@ sidebar_position: 2

 # velocity

+[官方英文文档]([Welcome to the Velocity Docs | PaperMC Docs](https://docs.papermc.io/velocity))
+
 ## 下载

-在 [核心选择](/docs/跨服端/核心选择.md) 找到 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 现代转发**。