安装

面板服

Select a providerNot listed365HostsAklizApex HostingAquatisArth HostingAternosAxentHostBedrockHostBirdflopBisectHostingBloom.HostCloudNordClovuxConsulhostingCraft-HostingCreeperHostCubes HostingDedicatedMCElfIDCEnviroMCexarotonExtraVMFadeHostFakaHedaFalixNodesFeatherFerox HostingFluctis HostingFREAKHOSTINGFreeMcServer.netFusion HostingGameHosting.itGameProHostGGServersGPortalHeavynodeHicoriaHost HavocHosterfyHostEZHosting-MinecraftHumbleServersKaasHostingKeKsHostKinetic HostingLilypadMC-HOST24.deMCFORFREE.DEMCPEhost.ruMCServerHostMeloncubeMinecraft-Hosting.proMinefortMinehutMineStratorModrinth HostingMyArenaNetbelaNFOserversNiCraftNitradoNodecraftNolimitHostOMGServOrionNodesPaperNodesPebblehostPhysgunPiglinHostPlanetNodePlay HostingPUBCSPufferfish HostRamShardRedline HostingRevivenodeScalaCubeServer.proServerPrismShockbyteSimpleGameHostingSkynode.proSnakecraft HostingSparked HostSRKHOSTSTIPESyntexHostingThe Minecraft HostingTNAHostingTurboHostUltimateSRVUltraServersVemoxHostVexyHostVirtual GladiatorsVolcano HostingVoltHostingVultamWasabi HostingWepwawetWinterNodeWiseHostingWitherHostingZapHosting

服务商使用说明

选择一个服务商以查看具体的安装说明

Paper / Spigot

信息

如果你的服务器运行的版本早于26.1-26.1.2，则需要安装ViaVersion。也可查看支持版本页面了解详情。

1. 从下载页面下载插件。

2. 将 Geyser-Spigot.jar 放入plugins文件夹，然后重启服务器。

3. 打开位于/plugins/Geyser-Spigot/config.yml的 Geyser 配置文件，找到以下内容：

    bedrock:
      # 用于监听连接的IP地址。
      # 通常情况下，只有当你想限制可连接服务器的IP范围时，才需要修改此项。
      address: 0.0.0.0
   
      # Geyser 用于监听基岩版连接的端口。
      # 由于《我的世界：基岩版》使用 UDP 协议，此端口必须允许 UDP 流量通过。
      port: 19132
   
      # 部分面板服会在每次启动服务器时修改Java版端口，并要求基岩版使用相同端口。
      # 启用此选项后，每次启动服务器时，基岩版端口会自动与Java端口保持一致。
      clone-remote-port: false

   核心配置项是端口，基岩版玩家将通过此端口连接你的服务器。 按照主机商选择器中的指引操作——修改端口，必要时调整clone-remote-port与address参数。 若启用clone-remote-port，基岩版端口将被Java版端口自动覆盖！ 重要提示：其他依赖UDP端口的服务或插件（如语音聊天、查询服务等），无法与Geyser共用同一端口。

4. 在控制台执行geyser connectiontest <ip> <port>命令，验证连接是否正常。

信息

若要允许基岩版玩家无需登录正版Java版账号即可加入服务器，你可以使用Floodgate。

模组服

注意

Geyser-Fabric 和 Geyser-NeoForge 仅 能在 26.1-26.1.2 服务器上运行。 查看 此页面 了解更多详情。

信息

Geyser 仅能与 服务端 模组配合使用。需要在客户端安装的模组将无法工作！

1. 在上方的下拉菜单中选择您的服务器托管服务商。

2. 从 下载页面 下载模组。

3. 将 Geyser 模组 jar 文件放入 mods 文件夹，并重启服务器。对于 Fabric，您还需要 FabricAPI。

4. 打开位于 /config/Geyser-Fabric/config.yml（或 /config/Geyser-NeoForge/config.yml）的 Geyser 配置文件，找到以下内容：

   bedrock: 
     # 用于监听连接的 IP 地址。
     # 通常，您只应在希望限制可以连接到服务器的 IP 时才更改此设置。
     address: 0.0.0.0
   
     # Geyser 将用于监听传入基岩版连接的端口。
     # 由于《我的世界：基岩版》使用 UDP，此端口必须允许 UDP 流量。
     port: 19132
   
     # 某些托管服务会在每次启动服务器时更改您的 Java 端口，并要求基岩版使用相同的端口。
     # 此选项会在每次启动服务器时将基岩版端口设置为与 Java 端口相同。
     clone-remote-port: false

   关键部分是端口。这是基岩版玩家将用于连接到您服务器的端口。 按照服务商选择器中的说明操作 - 更改端口，如有必要，更改 clone-remote-port 和 address。 如果启用 clone-remote-port，基岩版端口将被 Java 端口覆盖！ 重要：其他依赖 UDP 端口的服务/模组，如语音聊天或查询功能，不能与 Geyser 共享端口。

5. 通过在控制台中运行 geyser connectiontest <ip> <port> 来验证连接是否可行。

信息

要允许基岩版玩家无需登录付费的 Java 版账户即可加入您的服务器，您可以使用 Floodgate。

群组服

信息

• 只需要在代理服务器上安装 Geyser！您可以在所有服务器上安装 Floodgate 以获得更好的皮肤支持，并为其他插件提供全网 Floodgate API。
• 网络上的所有服务器必须接受 26.1-26.1.2 Java 客户端，因为 Geyser 模仿了一个 Java 客户端。

1. 在上方下拉菜单中选择您的服务器托管服务提供商。

2. 从下载页面下载适用于您代理软件的插件。

3. 将 Geyser jar 文件放入 plugins 文件夹中，然后重启服务器。

4. 打开您的 Geyser 配置文件（位于 /plugins/Geyser-xyz/config.yml），找到以下内容：

   bedrock:
     # 用于监听连接的 IP 地址。
     # 通常，只有当您想要限制可以连接到服务器的 IP 时才需要更改此设置。
     address: 0.0.0.0
   
     # Geyser 将用于监听传入基岩版连接的端口。
     # 由于 Minecraft：基岩版使用 UDP，此端口必须允许 UDP 流量。
     port: 19132
   
     # 某些托管服务每次启动服务器时都会更改您的 Java 端口，并且要求基岩版使用相同的端口。
     # 此选项使每次启动服务器时基岩版端口与 Java 端口相同。
     clone-remote-port: false

   关键部分是端口。这是基岩版玩家将用于连接到您服务器的端口。 请遵循提供商选择器中的说明 - 更改端口，如有必要，还需要更改 clone-remote-port 和 address。 如果启用了 clone-remote-port，基岩版端口将被 Java 端口覆盖！ 重要：其他依赖 UDP 端口的服务/插件（如语音聊天或查询）不能与 Geyser 共享端口。

5. 通过在控制台中运行 geyser connectiontest <ip> <port> 来验证连接是否可行。

信息

要允许基岩版玩家无需登录正版的 Java 版账户即可加入您的服务器，您可以使用 Floodgate。

自建服

Paper / Spigot

信息

如果你的服务器运行的版本早于26.1-26.1.2，则需要安装ViaVersion。也可查看支持版本页面了解详情。

1. 从下载页面下载插件。

2. 将 Geyser-Spigot.jar 放入plugins文件夹，然后重启服务器。

3. 打开位于/plugins/Geyser-Spigot/config.yml的 Geyser 配置文件，找到以下内容：

   bedrock:
     # 用于监听连接的IP地址。
     # 通常仅当你需要限制可连接服务器的IP时，才需要修改此项。
     address: 0.0.0.0
   
     # Geyser 用于监听基岩版连接的端口。
     # 由于《我的世界：基岩版》使用 UDP 协议，此端口必须允许 UDP 流量通过。
     port: 19132
   
     # 部分面板服会在每次启动服务器时修改Java版端口，并要求基岩版使用相同端口。
     # 启用此选项后，每次启动服务器时，基岩版端口会自动与Java端口保持一致。
     clone-remote-port: false

   这里最关键的是端口——这是基岩版玩家连接服务器时需要使用的端口！ 如果启用clone-remote-port，基岩版端口会被Java端口覆盖。 由于你是自建服务器，可自由选择端口，默认端口为19132。 重要提示：其他依赖UDP端口的服务/插件（如语音聊天或查询服务），无法与Geyser共用同一个端口。

4. 连接至你的服务器

   同一网络内本地连接 在运行服务器的设备上，可使用localhost或127.0.0.1作为地址连接。 注意：如果在同一台Windows设备上同时搭建和游玩服务器，你需要应用环回修复。 同一局域网内的其他设备，可使用你的本地IPv4地址连接——通常以10.或192.168.开头。

   跨网络远程连接 如果允许外部网络的玩家加入，你需要将Geyser使用的端口暴露至公网。 你有以下两种实现方式：

   • 端口映射：在路由器/调制解调器以及Windows/Linux防火墙中，开放Geyser端口（例如19132）的UDP协议权限。 端口映射指南详细说明了操作步骤。 完成后，玩家可通过你的公网IPv4地址+端口连接服务器。

   • playit.gg：如果你无法或不想开放端口（避免暴露家庭IP），可使用playit.gg服务创建隧道来转发流量。查看我们的playit.gg 教程了解详情。 注意：Ngrok 仅支持TCP协议，无法用于Geyser。

5. 在控制台输入geyser connectiontest <ip> <port>命令，验证外部网络是否能正常连接服务器。

注意

若要允许基岩版玩家无需登录正版Java版账号即可加入服务器，你可以使用Floodgate。

模组服

注意

Geyser-Fabric 和 Geyser-NeoForge 仅 能在 26.1-26.1.2 服务器上运行。 更多详情请参阅 此页面。

信息

Geyser 仅与 服务端 模组兼容。需要在客户端安装的模组将无法工作！

1. 从 下载页面 下载模组。

2. 将 Geyser 模组 jar 文件放入 mods 文件夹，然后重启服务器。对于 Fabric，你还需要 FabricAPI。

3. 打开你的 Geyser 配置文件，位置在 /config/Geyser-Fabric/config.yml（或 /config/Geyser-NeoForge/config.yml），找到以下内容：

   bedrock:
     # 用于监听连接的 IP 地址。
     # 通常，只有当你想要限制可以连接到服务器的 IP 时，才需要更改此设置。
     address: 0.0.0.0
   
     # Geyser 用于监听传入的基岩版连接的端口。
     # 由于 Minecraft：基岩版使用 UDP，此端口必须允许 UDP 流量。
     port: 19132
   
     # 一些托管服务每次启动服务器时都会更改你的 Java 端口，并且要求基岩版使用相同的端口。
     # 此选项使每次启动服务器时，基岩版端口与 Java 端口相同。
     clone-remote-port: false

   至关重要的部分是端口。这是基岩版玩家用来连接到你的服务器的端口！ 如果你启用了 clone-remote-port，端口将被覆盖，并使用 Java 端口。 由于你是自托管，你可以自由选择端口——默认端口是 19132。 重要提示：其他依赖 UDP 端口的服务/模组，如语音聊天或查询，不能与 Geyser 共享端口。

4. 连接到你的服务器

   在同一网络内本地连接 在与服务器相同的设备上，你可以使用 localhost 或 127.0.0.1 作为地址进行连接。 请注意：在同一台 Windows 设备上托管和游玩时，你需要 修复回环。 同一本地网络中的其他设备可以使用你的本地 IPv4 进行连接——它以 10. 或 192.168. 开头。

   从不同网络连接 如果你希望来自网络外部的玩家加入，你需要将 Geyser 运行的端口暴露到互联网。 为此，你有两种选择：

   • 端口转发：在你的路由器/调制解调器以及 Windows/Linux 防火墙中打开 Geyser 端口（例如 19132）的 UDP 协议。 我们的 端口转发指南 详细解释了如何做到这一点。 然后，玩家可以使用你的公网 IPv4 + 端口连接到你的服务器。

   • playit.gg：与其开放端口（这可能不是一个选择/如果你不想暴露你的家庭 IP），你可以使用 playit.gg 服务为你创建一个隧道来路由流量。请参阅我们的 playit.gg 指南。 Ngrok 将无法工作，因为它仅支持 TCP。

5. 通过在控制台中运行 geyser connectiontest <ip> <port> 来验证是否可以从其他网络进行连接。

信息

要允许基岩版玩家无需登录付费的 Java 版帐户即可加入你的服务器，你可以使用 Floodgate。

群组服

信息

• 仅在代理服务器上安装 Geyser！你可以在所有服务器上安装 Floodgate，以获得更好的皮肤支持并为其他插件提供网络范围的 Floodgate API 可用性。
• 网络中的所有服务器都必须接受 26.1-26.1.2 Java 客户端，因为 Geyser 会模拟 Java 客户端。

1. 从下载页面下载适用于你的代理软件的插件。

2. 将 Geyser jar 文件放入 plugins 文件夹，然后重启服务器。

3. 打开你的 Geyser 配置文件，位于 /plugins/Geyser-xyz/config.yml，找到以下内容：

   bedrock:
     # 用于监听连接的 IP 地址。
     # 通常，仅当你希望限制可以连接到服务器的 IP 时才需要更改此设置。
     address: 0.0.0.0
   
     # Geyser 将监听传入的基岩版连接的端口。
     # 由于 Minecraft：基岩版使用 UDP，此端口必须允许 UDP 流量。
     port: 19132
   
     # 某些主机服务每次启动服务器时都会更改你的 Java 端口，并要求基岩版使用相同的端口。
     # 此选项使基岩版端口在每次启动服务器时与 Java 端口保持一致。
     clone-remote-port: false

   关键部分是端口。这是基岩版玩家用来连接到你的服务器的端口！ 如果你启用了 clone-remote-port，则端口将被覆盖，并使用 Java 端口。 由于你是自托管，你可以自由选择端口——默认端口是 19132。 重要提示：依赖 UDP 端口的其他服务/插件（如语音聊天或查询）无法与 Geyser 共享端口。

4. 连接到你的服务器

   在同一网络内本地连接 在与服务器相同的设备上，你可以使用 localhost 或 127.0.0.1 作为地址进行连接。 请注意：在同一台 Windows 设备上托管和游玩时，你需要回环修复。 同一局域网中的其他设备可以使用你的本地 IPv4 进行连接——本地 IP 以 10. 或 192.168. 开头。

   从不同网络连接 如果你希望来自网络外部的玩家加入，你需要将 Geyser 运行的端口暴露到互联网。 为此，你有两个选择：

   • 端口转发：在你的路由器/调制解调器以及 Windows/Linux 防火墙中，为 UDP 协议开放 Geyser 端口（例如 19132）。 我们的端口转发指南详细解释了如何执行此操作。 然后，玩家可以使用你的公网 IPv4 + 端口连接到你的服务器。

   • playit.gg：无需开放端口（这可能是一个选择/如果你不想暴露你的家庭 IP），你可以使用 playit.gg 服务为你创建一个隧道来路由流量。请参阅我们的 playit.gg 指南。 Ngrok 将无法使用，因为它仅支持 TCP。

5. 通过在控制台运行 geyser connectiontest <ip> <port> 来验证是否可以从其他网络连接。

信息

要允许基岩版玩家无需登录付费的 Java 版账户即可加入你的服务器，你可以使用 Floodgate。

ViaProxy

1. 设置 ViaProxy。

2. 从下载页面下载插件。

3. 将 Geyser-ViaProxy.jar 放入 plugins 文件夹，然后重启 ViaProxy。

4. 打开位于 /plugins/Geyser/config.yml 的 Geyser 配置文件，找到以下内容：

   bedrock:
     # 用于监听连接的 IP 地址。
     # 通常，只有当您想限制哪些 IP 可以连接到您的服务器时，您才需要更改此设置。
     address: 0.0.0.0
   
     # Geyser 用于监听传入 Bedrock 连接的端口。
     # 由于 Minecraft: Bedrock Edition 使用 UDP，此端口必须允许 UDP 流量。
     port: 19132
   
     # 某些托管服务每次启动服务器时都会更改 Java 端口，并要求 Bedrock 使用相同的端口。
     # 此选项使 Bedrock 端口在每次启动服务器时与 Java 端口相同。
     clone-remote-port: false

   关键部分是端口。这是 Bedrock 玩家将用来连接到您的服务器的端口！ 如果您启用了 clone-remote-port，该端口将被覆盖并使用 ViaProxy 端口。 由于您是自托管，您可以自由选择端口 - 默认端口是 19132。

   重要：其他依赖 UDP 端口的服务/插件，例如语音聊天或查询，不能与 Geyser 共享端口。

   如果您使用 ViaProxy GUI，您可以使用其账户管理系统通过 Bedrock Edition 加入正版验证服务器。如果您使用 ViaProxy CLI 并希望允许 Bedrock 玩家加入您的正版验证服务器，您必须安装并设置 Floodgate。
   

   注意：auth-type 字段的值将被忽略，由 ViaProxy 自动管理。

5. 连接到您的服务器

   在同一网络中本地连接

   在与服务器相同的设备上，您可以使用 localhost 或 127.0.0.1 作为地址进行连接。 请注意：在同一台 Windows 设备上同时托管和游玩时，您将需要回环修复。 同一本地网络中的其他设备可以使用您的本地 IPv4 连接 - 它以 10. 或 192.168. 开头。

   从不同的网络连接

   如果您想让网络外的玩家加入，您需要将 Geyser 运行的端口暴露到互联网。 要实现这一点，您有两个选择：

   • 端口转发：在您的路由器/调制解调器以及 Windows/Linux 防火墙中，在 UDP 协议上打开 Geyser 端口（例如 19132）。 我们的端口转发指南 详细解释了如何执行此操作。 完成后，玩家可以使用您的公网 IPv4 + 端口连接到您的服务器。

   • playit.gg：您可以使用 playit.gg 服务为您创建隧道以路由流量，而不是打开端口（这可能不可行/如果您不想暴露您的家庭 IP）。请参阅我们的 playit.gg 指南。 Ngrok 将无法工作，因为它仅支持 TCP。

6. 通过在控制台中运行 geyser connectiontest <ip> <port> 来验证是否可以从其他网络进行连接。

信息

要允许 Bedrock Edition 玩家无需登录付费的 Java Edition 账户即可加入您的服务器，您可以使用 Floodgate。

独立版

信息

您需要安装 Java 21 或更高版本才能运行 Geyser。要在 Android 上运行 Geyser 独立版，请参阅本页底部。

注意

Geyser-Standalone 不是插件或模组！它是一个独立的 Java 程序，需要与您的 Java 版服务器分开运行。

常规设置与配置

1. 从这里下载 Geyser 独立版。

2. 为 Geyser 创建一个新文件夹，并将 jar 文件放入其中。

3. 启动 Geyser 独立版：

   • GUI（推荐）： 双击 jar 文件，Geyser 的所有必要文件将自动创建。
   • 或使用 控制台设置： 创建一个新的 bat 或启动脚本，类似于您用于 Spigot/Paper 服务器的脚本，请查看此页面了解脚本内容。 运行启动脚本/bat，Geyser 的所有必要文件将自动创建。

4. 打开您的 Geyser 配置文件（config.yml），找到以下内容：

   bedrock:
     # Geyser 将绑定的 IP 地址，用于监听传入的基岩版连接。
     # 通常，只有当您想要限制哪些 IP 可以连接到您的服务器时，才需要更改此设置。
     address: 0.0.0.0
   
     # Geyser 将监听传入基岩版连接的端口。
     # 由于 Minecraft: 基岩版使用 UDP，此端口必须允许 UDP 流量。
     port: 19132
   

   port 是基岩版玩家输入以连接到服务器的端口。 只有当您需要将连接限制到特定 IP 地址时，才需要取消注释并更改此处的 address。

   要配置 Geyser 独立版将玩家发送到哪个 Java 版服务器，请找到 remote 部分：

   java:
     # Java 版服务器的 IP 地址。
     address: 127.0.0.1
   
     # Java 版服务器的端口。
     port: 25565
   
     # 基岩版玩家登录 Java 服务器时将检查的身份验证类型。
     # 可以是 "floodgate"（请参阅 https://wiki.geysermc.org/floodgate/）、"online" 或 "offline"。
     auth-type: online

   在这里，将 address 更改为 Java 服务器的地址，如果服务器与 Geyser-Standalone 在同一台机器上，则保持原样。 然后，将 port 更改为 Java 服务器的端口。如果您在远程 Java 服务器上设置了 Floodgate，可以将 auth-type 设置为 "floodgate" - 否则， 对于在线模式服务器，将其设置为 online，对于离线模式服务器，将其设置为 offline。要使用 Standalone 服务器安装和设置 Floodgate，请参阅这里。

5. 连接到您的服务器

   在同一网络中本地连接 在与服务器相同的设备上，您可以使用 localhost 或 127.0.0.1 作为地址进行连接。 请注意：在同一台 Windows 设备上托管和游玩时，您需要回环修复。 同一本地网络中的其他设备可以使用您的本地 IPv4 进行连接 - 它以 10. 或 192.168. 开头。 或者，打开 Minecraft: 基岩版，并在 好友 选项卡中加入 LAN 服务器。

   从不同网络连接 如果您希望来自网络外部的玩家加入，您需要将 Geyser 运行的端口暴露到互联网。 要实现这一点，您有两种选择：

   • 端口转发：在您的路由器/调制解调器以及 Windows/Linux 防火墙中，打开 Geyser 端口（例如 19132）的 UDP 协议。 完成此操作后，玩家可以使用您的公共 IPv4 + 端口连接到您的服务器。 请参阅这里获取有用的指南。

   • playit.gg：如果您不想打开端口（这可能不是一个选项/如果您不想暴露您的家庭 IP），您可以使用 playit.gg 服务为您创建一个隧道来路由流量。请参阅我们的 playit.gg 指南。 Ngrok 将无法工作，因为它仅支持 TCP。

6. 通过在控制台中运行 geyser connectiontest <ip> <port> 来验证是否可以从其他网络连接。

在 Android 上运行 Geyser-Standalone

注意

Android 上的 Termux 等应用程序能够运行 Geyser，但这在很大程度上取决于您的 Android 设备的性能。请自行承担风险。

Termux (Android)

1. 下载并安装 Termux
2. 运行 pkg install openjdk-21
3. 运行 wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone
4. 运行 java -jar Geyser-Standalone.jar

或者

我们为全新的 Termux 安装提供了自动化设置脚本，这可能不适用于所有用户。如果上述手动指南不起作用，请尝试此方法。 运行以下命令开始下载/安装：

curl https://gist.githubusercontent.com/rtm516/e3e07d6595ee41e05a38b03c0f4d7a80/raw/install.sh | bash