.. _代理端选择:

==================================================
核心代理端的选择
==================================================
代理端用于分流玩家连接、跨服传送或实现群组网络。如果你是小型单服可跳过本节。

简介
==================================================
代理端（Proxy）是群组服架构的入口，负责玩家连接分发、分区切换、跨服聊天等功能。常见的代理端有 BungeeCord、Velocity、Waterfall 以及微软官方的 Minecraft Gateway（基岩版专用）。

主流代理端介绍
==================================================

BungeeCord
--------------------------------------------------
- 官方开发的轻量级代理核心，基础功能完善但性能有限。
- 适合小型跨服网络或需要兼容老旧插件的场景。

**特点：**
- 支持服务器分组和自动平衡
- 基础IP封禁和权限管理
- 需要通过插件实现高级功能

下载地址：`BungeeCord <https://ci.md-5.net/job/BungeeCord/>`_

Velocity
--------------------------------------------------
- Paper 团队开发的现代代理端，性能比 BungeeCord 提升 300%，推荐新服使用。
- 适合追求高性能、稳定性和安全性的中大型服务器。

**优势：**
- 原生支持 Paper/Bukkit 消息通道  
- 内置更安全的 IP 转发机制  
- 插件生态逐步完善，社区活跃

下载地址：`Velocity <https://papermc.io/downloads#Velocity>`_

Waterfall
--------------------------------------------------
- BungeeCord 的优化分支，修复了原版的性能问题和内存泄漏。
- 适合需要运行 BungeeCord 插件、无法直接升级到 Velocity 的中等规模服务器。

**适用场景：**
- 需要运行 BungeeCord 插件
- 200-500 人规模的玩家网络
- 兼容性优先但希望提升稳定性

下载地址：`Waterfall <https://papermc.io/downloads#Waterfall>`_

Minecraft Gateway
--------------------------------------------------
- 微软官方提供的 Bedrock 版代理方案，用于连接不同平台的基岩版服务器。

**功能限制：**
- 仅支持基岩版客户端
- 需要配合 Azure 网络服务使用
- 不支持插件扩展

参考文档：`官方网关 <https://learn.microsoft.com/en-us/minecraft/creator/documents/gameadapter>`_

代理端对比
==================================================
.. csv-table:: 代理端核心对比
   :header: "代理端", "推荐规模", "关键特性"
   :widths: 15, 20, 30

   "BungeeCord", "50人以下", "基础功能/兼容旧插件"
   "Velocity", "无上限", "最高性能/现代架构/安全性强"
   "Waterfall", "50-500人", "平衡升级/修复内存泄漏/兼容BungeeCord插件"
   "Minecraft Gateway", "基岩版专用", "官方解决方案/仅限Bedrock"

选型建议
==================================================
- **新服/高性能/未来可扩展**：强烈推荐 Velocity
- **需要兼容老旧 BungeeCord 插件**：可选 Waterfall
- **仅基岩版服务器**：选择 Minecraft Gateway
- **极小型/实验服**：BungeeCord 也可用，但不推荐长期使用

常见问题 QA
==================================================
:Q1:  Velocity 和 BungeeCord 插件兼容吗？  
:A1:  大部分 BungeeCord 插件不能直接用于 Velocity，但 Velocity 社区已有许多常用插件的替代品。

:Q2:  代理端需要正版验证吗？  
:A2:  代理端通常开启正版验证（可离线，依赖你的需求），后端分区需关闭正版验证（online-mode=false），详见后续分区配置章节。

:Q3:  代理端会影响延迟吗？  
:A3:  现代代理端（如 Velocity）对延迟影响极小，且能提升整体稳定性和安全性。

:Q4:  可以多个代理端串联吗？  
:A4:  理论上可行，但实际意义不大，建议单一入口，简化架构。

:Q5:  代理端如何选择端口？  
:A5:  默认 25565 为主入口端口，建议不要更改，便于玩家直接连接。



详细安装与配置方法请参考后续章节 :ref:`Proxy安装`