安装

面板服

Select a providerNot listed365HostsAklizApex HostingAquatisArth HostingAternosBedrockHostBirdflopBisectHostingBloom.HostCloud NordClovuxConsulhostingCraft-HostingCreeperHostCubes HostingDedicatedMCElfIDCEnviroMCexarotonExtraVMFadeHostFakaHedaFalixNodesFeatherFerox HostingFluctis HostingFREAKHOSTINGFreeMcServer.netFusion HostingGameHosting.itGameProHostGGServersGPortalHeavynodeHicoriaHost HavocHosterfyHostEZHosting-MinecraftHumbleServersKaasHostingKeKsHostKinetic HostingLilypadMC-HOST24.deMCFORFREE.DEMCPEhost.ruMCServerHostMeloncubeMinecraft-Hosting.proMinefortMinehutMineStratorModrinth HostingMyArenaNetbelaNFOserversNiCraftNitradoNodecraftOMGServOrionNodesPaperNodesPebblehostPhysgunPiglinHostPlanetNodePlay HostingPUBCSPufferfish HostRamShardRedline HostingRevivenodeScalaCubeServer.proShockbyteSkynode.proSnakecraft HostingSparked HostSRKHOSTSTIPESyntexHostingThe Minecraft HostingTNAHostingTurboHostUltimateSRVUltraServersVemoxHostVexyHostVirtual GladiatorsVolcano HostingVoltHostingVultamWasabi HostingWepwawetWinterNodeWiseHostingWitherHostingZapHosting

服务商使用说明

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

Paper / Spigot

信息

如果你的服务器未运行1.21.11版本，则需要安装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 and Geyser-NeoForge run only on a 1.21.11 server. See this page for more details.

信息

Geyser only works with server-side mods. Mods that require a client-side install will not work!

1. Select your server hosting provider in the dropdown above.

2. Download the mod from the download page.

3. Place the Geyser mod jar in the mods folder, and restart the server. For Fabric, you will also need FabricAPI.

4. Open your Geyser config, located in /config/Geyser-Fabric/config.yml (or /config/Geyser-NeoForge/config.yml), and find the following:

   bedrock: 
     # The IP address that will listen for connections.
     # Generally, you should only change this if you want to limit what IPs can connect to your server.
     address: 0.0.0.0
   
     # The port that will Geyser will listen on for incoming Bedrock connections.
     # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
     port: 19132
   
     # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
     # This option makes the Bedrock port the same as the Java port every time you start the server.
     clone-remote-port: false

   The vital part is the port. This is the port that Bedrock players will use to connect to your server. Follow the instructions in the provider selector - change the port, and if necessary, clone-remote-port & address. If clone-remote-port is enabled, the bedrock port will be overwritten with the Java port! Important: Other services/mods that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

5. Verify whether connections are possible by running geyser connectiontest <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

群组服

信息

• Install Geyser only on the proxy server! You can install Floodgate on all servers for better skin support & network-wide Floodgate API availability for other plugins.
• All servers on the network must accept 1.21.11 Java clients, as Geyser imitates one.

1. Select your server hosting provider in the dropdown above.

2. Download the plugin for your proxy software from the download page.

3. Place the Geyser jar in the plugins folder, and restart the server.

4. Open your Geyser config, located in /plugins/Geyser-xyz/config.yml, and find the following:

   bedrock:
     # The IP address that will listen for connections.
     # Generally, you should only change this if you want to limit what IPs can connect to your server.
     address: 0.0.0.0
   
     # The port that will Geyser will listen on for incoming Bedrock connections.
     # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
     port: 19132
   
     # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
     # This option makes the Bedrock port the same as the Java port every time you start the server.
     clone-remote-port: false

   The vital part is the port. This is the port that Bedrock players will use to connect to your server. Follow the instructions in the provider selector - change the port, and if necessary, clone-remote-port & address. If clone-remote-port is enabled, the bedrock port will be overwritten with the Java port! Important: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

5. Verify whether connections are possible by running geyser connectiontest <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

独立服

Paper / Spigot

信息

如果你的服务器未运行1.21.11版本，则需要安装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 and Geyser-NeoForge run only on a 1.21.11 server. See this page for more details.

信息

Geyser only works with server-side mods. Mods that require a client-side install will not work!

1. Download the mod from the download page.

2. Place the Geyser mod jar in the mods folder, and restart the server. For Fabric, you will also need FabricAPI.

3. Open your Geyser config, located in /config/Geyser-Fabric/config.yml (or /config/Geyser-NeoForge/config.yml), and find the following:

   bedrock:
     # The IP address that will listen for connections.
     # Generally, you should only change this if you want to limit what IPs can connect to your server.
     address: 0.0.0.0
   
     # The port that will Geyser will listen on for incoming Bedrock connections.
     # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
     port: 19132
   
     # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
     # This option makes the Bedrock port the same as the Java port every time you start the server.
     clone-remote-port: false

   The vital part is the port. This is the port that Bedrock players will use to connect to your server! If you enable clone-remote-port, the port will be overridden and the Java port is used. Since you are self-hosting, you can choose the port freely - the default port is 19132.
   Important: Other services/mods that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

4. Connecting to your server

   Connecting locally in the same network
   On the same device as the server, you can connect using localhost, or 127.0.0.1 as the address. Do note: When hosting and playing on the same Windows device, you will need the loopback fix. Other devices in the same local network can use your local IPv4 to connect - it starts with 10. or 192.168..

   Connecting from a different network
   You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. To achieve that, you have two options:

   • Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. Our port forwarding guide explains how to do this in detail. Then, players can connect with your public IPv4 + port to your server.

   • playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use the playit.gg service to create a tunnel for you to route the traffic through. See our playit.gg guide. Ngrok will not work since it is TCP-only.

5. Verify whether connections from other networks are possible by running geyser connectiontest <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

群组服

信息

• Install Geyser only on the proxy server! You can install Floodgate on all servers for better skin support & network-wide Floodgate API availability for other plugins.
• All servers on the network must accept 1.21.11 Java clients, as Geyser imitates one.

1. Download the plugin for your proxy software from the download page.

2. Place the Geyser jar in the plugins folder, and restart the server.

3. Open your Geyser config, located in /plugins/Geyser-xyz/config.yml, and find the following:

   bedrock:
     # The IP address that will listen for connections.
     # Generally, you should only change this if you want to limit what IPs can connect to your server.
     address: 0.0.0.0
   
     # The port that will Geyser will listen on for incoming Bedrock connections.
     # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
     port: 19132
   
     # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
     # This option makes the Bedrock port the same as the Java port every time you start the server.
     clone-remote-port: false

   The vital part is the port. This is the port that Bedrock players will use to connect to your server! If you enable clone-remote-port, the port will be overridden and the Java port is used. Since you are self-hosting, you can choose the port freely - the default port is 19132.
   Important: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

4. Connecting to your server

   Connecting locally in the same network
   On the same device as the server, you can connect using localhost, or 127.0.0.1 as the address. Do note: When hosting and playing on the same Windows device, you will need the loopback fix. Other devices in the same local network can use your local IPv4 to connect - it starts with 10. or 192.168..

   Connecting from a different network
   You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. To achieve that, you have two options:

   • Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. Our port forwarding guide explains how to do this in detail. Then, players can connect with your public IPv4 + port to your server.

   • playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use the playit.gg service to create a tunnel for you to route the traffic through. See our playit.gg guide. Ngrok will not work since it is TCP-only.

5. Verify whether connections from other networks are possible by running geyser connectiontest <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

ViaProxy

1. Setup ViaProxy.

2. Download the plugin from the download page.

3. Place the Geyser-ViaProxy.jar in the plugins folder, and restart ViaProxy.

4. Open your Geyser config, located in /plugins/Geyser/config.yml, and find the following:

   bedrock:
     # The IP address that will listen for connections.
     # Generally, you should only change this if you want to limit what IPs can connect to your server.
     address: 0.0.0.0
   
     # The port that will Geyser will listen on for incoming Bedrock connections.
     # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
     port: 19132
   
     # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
     # This option makes the Bedrock port the same as the Java port every time you start the server.
     clone-remote-port: false

   The vital part is the port. This is the port that Bedrock players will use to connect to your server! If you enable clone-remote-port, the port will be overridden and the ViaProxy port is used. Since you are self-hosting, you can choose the port freely - the default port is 19132.

   Important: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

   If you use the ViaProxy GUI you can use its account management system to join online mode servers with Bedrock Edition. If you use the ViaProxy CLI and want to allow Bedrock players to join your online mode server you have to install and set up Floodgate.
   

   NOTE: The value of the auth-type field is ignored and managed by ViaProxy automatically.

5. Connecting to your server

   Connecting locally in the same network

   On the same device as the server, you can connect using localhost, or 127.0.0.1 as the address. Do note: When hosting and playing on the same Windows device, you will need the loopback fix. Other devices in the same local network can use your local IPv4 to connect - it starts with 10. or 192.168..

   Connecting from a different network

   You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. To achieve that, you have two options:

   • Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. Our port forwarding guide explains how to do this in detail. After doing this, players can connect with your public IPv4 + port to your server.

   • playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use the playit.gg service to create a tunnel for you to route the traffic through. See our playit.gg guide. Ngrok will not work since it is TCP-only.

6. Verify whether connections from other networks are possible by running geyser connectiontest <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

独立版

信息

You need to have Java 17 or higher installed to run Geyser. To run Geyser Standalone on Android, see the bottom of this page.

注意

Geyser-Standalone is NOT a plugin or mod! It is a standalone Java program that you would run separately to your Java Edition server.

General Setup & Configuration

1. Download Geyser Standalone from here.

2. Create a new folder for Geyser, and drop the jar in there.

3. Start Geyser Standalone:

   • GUI (Recommended):
     Double-click the jar file and all the necessary files for Geyser will be created.
   • Or use the console setup:
     Create a new bat or startup script, similar to the one you'd use for a Spigot/Paper server, and take a look at this page for what to put into it.
     Run the startup script/bat, and all the necessary files for Geyser will be created.

4. Open your Geyser config (config.yml), and find the following:

   bedrock:
     # The IP address that Geyser will bind on to listen for incoming Bedrock connections.
     # Generally, you should only change this if you want to limit what IPs can connect to your server.
     address: 0.0.0.0
   
     # The port that will Geyser will listen on for incoming Bedrock connections.
     # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
     port: 19132
   

   The port is the port Bedrock players will enter to connect to the server.
   Uncommenting and changing address here is only needed if you need to limit connections to a specific IP address.

   To configure which Java Edition server Geyser Standalone will send players to, find the remote section:

   java:
     # The IP address of the Java Edition server.
     address: 127.0.0.1
   
     # The port of the Java Edition server.
     port: 25565
   
     # What type of authentication Bedrock players will be checked against when logging into the Java server.
     # Can be "floodgate" (see https://wiki.geysermc.org/floodgate/), "online", or "offline".
     auth-type: online

   Here, change address to the Java server's address, or leave it as-is if the server is on the same machine as Geyser-Standalone. Then, change port to the Java server's port. If you have set up Floodgate on the remote Java server, you can set auth-type to "floodgate" - otherwise, set it to either online for an online mode server, or offline for an offline mode server. To install and set up Floodgate with a Standalone server, see here.

5. Connecting to your server

   Connecting locally in the same network
   On the same device as the server, you can connect using localhost, or 127.0.0.1 as the address. Do note: When hosting and playing on the same Windows device, you will need the loopback fix. Other devices in the same local network can use your local IPv4 to connect - it starts with 10. or 192.168.. Alternatively, open Minecraft: Bedrock edition, and join the LAN-Server in the Friends tab.

   Connecting from a different network
   You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. To achieve that, you have two options:

   • Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. After doing this, players can connect with your public IPv4 + port to your server. See here for a helpful guide.

   • playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use the playit.gg service to create a tunnel for you to route the traffic through. See our playit.gg guide. Ngrok will not work since it is TCP-only.

6. Verify whether connections from other networks are possible by running geyser connectiontest <ip> <port> in the console.

Running Geyser-Standalone on Android

注意

Applications such as Termux on Android are capable of running Geyser, but this largely depends on how powerful your Android device is. Please do so at your own risk.

Termux (Android)

1. Download and install Termux
2. Run pkg install openjdk-17
3. Run wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone
4. Run java -jar Geyser-Standalone.jar

OR

We have an automated setup script for clean Termux installs, which might not work for all users. If the manual guide above does not work, try this. Run this to start the download/install:

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