Cách cấu hình NetherNet cho GeyserMC trước bản Bedrock 26.60

Làm thế nào để cấu hình NetherNet cho máy chủ GeyserMC trước bản cập nhật Bedrock 26.60?

Để cấu hình NetherNet cho máy chủ GeyserMC, quản trị viên cần cập nhật Geyser lên bản dựng (build) từ 1237 trở lên, mở tệp config.yml, chuyển tham số transport trong mục bedrock thành nethernet (hoặc both) và mở đồng thời cả hai giao thức TCP và UDP trên cổng kết nối Bedrock trước ngày 27/10/2026.

Tóm tắt nhanh:

• Hạn chót chuyển đổi: Từ bản cập nhật Minecraft: Bedrock Edition 26.60 (ngày 27/10/2026), Mojang chính thức khai tử giao thức RakNet cũ và chuyển hoàn toàn sang NetherNet.

• Yêu cầu cổng mạng mới: Máy chủ Geyser cần mở thêm cổng TCP (dùng cho bước báo hiệu Signaling và tải MOTD) bên cạnh cổng UDP truyền thống (chạy dữ liệu trò chơi qua WebRTC).

• Chạy song song hai giao thức: Có thể đặt transport: both kèm một cổng webrtc-port (UDP) riêng biệt để hỗ trợ đồng thời người chơi ở phiên bản cũ (26.40 – 26.50) và mới (26.60+).

• Lưu ý về clone-remote-port: Tính năng dùng chung cổng với máy chủ Java không tương thích với bộ Signaling nội bộ (Built-in Signaling) do xung đột cổng TCP.

• Tự động hóa trên bảng điều khiển: Người dùng có thể kích hoạt gói Auto-config GeyserMC hoặc dùng trình cập nhật Plugin 1-click trên Panel quản trị để chuyển đổi an toàn mà không lo lỗi cú pháp.

Giao thức NetherNet là gì và thay đổi cách kết nối của GeyserMC ở tầng kỹ thuật nào?

NetherNet là giao thức truyền tải mạng thế hệ mới dựa trên chuẩn WebRTC được Mojang phát triển để thay thế hoàn toàn thư viện RakNet đã lỗi thời trên Minecraft: Bedrock Edition. Thay vì kết nối trực tiếp qua một cổng UDP duy nhất như trước, NetherNet bổ sung bước bắt tay tín hiệu (Signaling) qua giao thức HTTP/HTTPS trên cổng TCP trước khi thiết lập luồng dữ liệu trò chơi qua UDP.

Trong suốt nhiều năm qua, cả máy chủ Bedrock nguyên bản (BDS) lẫn plugin cầu nối đa nền tảng GeyserMC đều dựa vào giao thức RakNet hoạt động thuần túy trên tầng UDP. Tuy nhiên, kiến trúc cũ của RakNet từng bộc lộ nhiều hạn chế về khả năng xuyên tường lửa (NAT Traversal) và từng là mục tiêu của các đợt tấn công khuếch đại lưu lượng (RakNet Amplification DDoS) hoặc tấn công từ chối dịch vụ ở giai đoạn bắt tay sớm (Early Packet Handling DoS).

Từ phiên bản Bedrock 26.40, Mojang đã bắt đầu tích hợp giao thức NetherNet và sẽ biến nó thành phương thức kết nối duy nhất kể từ phiên bản 26.60 (dự kiến phát hành ngày 27/10/2026). Quy trình kết nối của một người chơi hệ máy điện thoại/console (Bedrock) vào máy chủ Java thông qua GeyserMC sẽ thay đổi qua 2 giai đoạn rõ rệt:

1. Giai đoạn 1 – Báo hiệu và lấy thông tin máy chủ (Signaling qua TCP): Khi người chơi làm mới danh sách máy chủ hoặc nhấn kết nối, client Bedrock sẽ gửi một truy vấn web (HTTP/HTTPS request) qua giao thức TCP đến cổng của Geyser. Máy chủ Signaling tích hợp sẵn trong Geyser sẽ trả về biểu tượng, dòng mô tả (MOTD), số lượng người chơi trực tuyến và các thông số định tuyến cần thiết. Nhờ cơ chế này, tính năng motd-passthrough của Geyser có thể nhận trực tiếp địa chỉ mà client đã ping để chuyển tiếp chính xác về máy chủ Java.

2. Giai đoạn 2 – Truyền tải dữ liệu tương tác (Gameplay qua WebRTC / UDP): Sau khi hoàn tất bước xác thực tín hiệu qua TCP, máy khách Bedrock sẽ thiết lập phiên truyền tải thời gian thực dựa trên chuẩn WebRTC chạy trên giao thức UDP để đồng bộ chuyển động, khối vuông và gói tin thế giới.

Bảng so sánh kiến trúc mạng giữa giao thức RakNet cũ và NetherNet mới trên GeyserMC:

Việc chuyển sang kiến trúc kết hợp TCP + UDP đòi hỏi các quản trị viên máy chủ phải rà soát lại cấu hình tường lửa và tệp thiết lập của Geyser trước thời điểm Mojang khóa hoàn toàn RakNet.

Các bước nâng cấp và bật NetherNet trong config.yml của GeyserMC thực hiện ra sao?

Để kích hoạt NetherNet, quản trị viên cần tải bản dựng GeyserMC mới nhất (tối thiểu từ build 1237), sau đó chỉnh sửa tham số transport trong tệp config.yml thành nethernet (chỉ dùng giao thức mới) hoặc both (chạy song song cả RakNet và NetherNet trên 2 cổng UDP riêng biệt).

Trước khi tiến hành chỉnh sửa tệp cấu hình hoặc cập nhật bản dựng mới, bạn nên tạo một bản sao lưu dữ liệu để phòng ngừa rủi ro sai lệch cú pháp YAML. Trên hệ thống quản trị portal LumineCloud, mọi người dùng đều được cấp sẵn 1 slot Auto-Backup tự động hằng ngày của hệ thống cùng 1 slot Backup thủ công miễn phí. Ngoài ra, bạn có thể sử dụng ngay tính năng Auto-config GeyserMC hoặc trình cài đặt Plugin 1-click trên bảng điều khiển để hệ thống tự động cập nhật bản dựng mới nhất và định tuyến cổng mạng chuẩn xác.

Nếu bạn tự cấu hình thủ công trên máy chủ (Spigot/Paper, Fabric, NeoForge, Velocity hoặc BungeeCord), hãy thực hiện theo 4 bước sau:

Bước 1: Cập nhật GeyserMC lên phiên bản mới nhất

1. Tắt máy chủ an toàn bằng lệnh stop trên cửa sổ Console.

2. Tải tệp .jar mới nhất từ trang chủ GeyserMC (đảm bảo phiên bản từ Build #1237 trở lên).

3. Tải tệp mới lên thư mục /plugins/ (đối với Paper/Purpur/Velocity/BungeeCord) hoặc /mods/ (đối với Fabric/NeoForge) và xóa bản cũ.

Bước 2: Mở tệp cấu hình Geyser

Truy cập trình quản lý tệp (File Manager) và mở tệp cấu hình tương ứng với nền tảng máy chủ của bạn:

• Paper / Spigot / Purpur: /plugins/Geyser-Spigot/config.yml

• Velocity / BungeeCord: /plugins/Geyser-Velocity/config.yml (hoặc Geyser-BungeeCord)

• Fabric / NeoForge: /config/Geyser-Fabric/config.yml (hoặc Geyser-NeoForge)

Bước 3: Lựa chọn chế độ truyền tải (transport) phù hợp

Tùy thuộc vào việc cộng đồng của bạn đã nâng cấp toàn bộ lên phiên bản Bedrock mới hay chưa, bạn hãy chọn 1 trong 2 phương án cấu hình dưới đây:

Phương án A: Chuyển hoàn toàn sang NetherNet (Khuyên dùng khi bản 26.60 phát hành)

Giữ nguyên cổng kết nối cũ của bạn (ví dụ 19132), đổi tham số transport sang nethernet và đảm bảo cổng này đã được mở cho cả hai giao thức TCP và UDP:

bedrock:
  # Địa chỉ IP lắng nghe kết nối (giữ nguyên mặc định 0.0.0.0)
  address: 0.0.0.0
  # Cổng kết nối này BẮT BUỘC phải mở cho cả TCP (Signaling) và UDP (WebRTC)
  port: 19132
  # Kích hoạt giao thức NetherNet mới thay thế RakNet
  transport: nethernet
  # Lưu ý: Tắt clone-remote-port nếu bạn dùng Built-in Signaling
  clone-remote-port: false

Phương án B: Chạy song song cả NetherNet và RakNet (transport: both)

Trong giai đoạn chuyển giao (khi một số người chơi vẫn dùng phiên bản Bedrock cũ hơn 26.40/26.50 vốn lấy thông tin MOTD qua RakNet, trong khi người chơi mới đã lên 26.60), bạn có thể cho Geyser lắng nghe đồng thời cả hai giao thức.

Vì RakNet và NetherNet không thể dùng chung một cổng UDP, bạn bắt buộc phải khai báo thêm một cổng UDP phụ tại dòng webrtc-port:

bedrock:
  address: 0.0.0.0
  # Cổng chính: Mở cả TCP (cho NetherNet Signaling) và UDP (cho RakNet cũ)
  port: 19132
  # Cổng phụ: Mở riêng giao thức UDP cho luồng dữ liệu WebRTC của NetherNet
  webrtc-port: 19133
  # Chấp nhận kết nối đồng thời từ cả RakNet lẫn NetherNet
  transport: both
  clone-remote-port: false

(Lưu ý: Người chơi trên mọi phiên bản vẫn chỉ cần nhập cổng chính 19132 trong danh sách server; quá trình điều hướng sang webrtc-port: 19133 sẽ do máy chủ Signaling tự động chỉ dẫn ngầm).

Bước 4: Khởi động và kiểm tra nhật ký Console

Khởi động lại máy chủ và quan sát cửa sổ Console. Nếu không có dòng cảnh báo đỏ nào xuất hiện và bạn có thể gõ lệnh /geyser dump thành công, máy chủ đã sẵn sàng đón người chơi qua giao thức mới.

Làm sao để xử lý lỗi xung đột cổng clone-remote-port và bảng cảnh báo bảo mật HTTPS?

Hai rào cản lớn nhất khi chuyển sang NetherNet là lỗi xung đột cổng TCP khi bật clone-remote-port: true và bảng thông báo "Trust on first use" (Tin cậy lần đầu) xuất hiện trên màn hình người chơi khi kết nối qua giao thức HTTP không mã hóa. Quản trị viên có thể giải quyết triệt để bằng cách cấp cổng riêng kết hợp chứng chỉ TLS/HTTPS hoặc sử dụng dịch vụ External Signaling (NXS) như Warden.

Khi vận hành thực tế, bạn cần lưu ý cách xử lý 2 vấn đề kỹ thuật đặc thù sau của NetherNet:

1. Giải quyết xung đột clone-remote-port trên máy chủ dùng chung cổng

Trước đây, rất nhiều quản trị viên bật clone-remote-port: true để người chơi cả hai hệ máy Java và Bedrock đều nhập chung một cổng kết nối (ví dụ: 25565). Cách này hoạt động được với RakNet vì máy chủ Java chỉ chiếm cổng TCP 25565, còn RakNet của Geyser chiếm cổng UDP 25565.

Tuy nhiên, bộ Built-in Signaling của NetherNet lại yêu cầu lắng nghe trên chính cổng TCP đó, dẫn đến xung đột trực tiếp với máy chủ Java và báo lỗi trên Console: Built-in signaling cannot use port … because the Java server already uses it

2 cách khắc phục chuẩn xác nhất:

• Cách 1 – Tách cổng riêng cho Geyser (Tối ưu nhất cho độ trễ và hiển thị MOTD trực tiếp): Đặt clone-remote-port: false, cấp cho Geyser một cổng riêng biệt mở cả TCP và UDP (hoặc dùng tính năng Subdomain/SRV Record để che cổng).

• Cách 2 – Sử dụng External Signaling (NXS / Dịch vụ Warden): Nếu bạn muốn giữ nguyên clone-remote-port: true hoặc không có thêm cổng TCP trống, Geyser sẽ tự động chuyển sang cơ chế báo hiệu bên ngoài (NetherNet External Signaling - NXS, chẳng hạn như dịch vụ Warden). Khi dùng NXS, máy khách sẽ gửi yêu cầu TCP đến máy chủ trung gian của dịch vụ NXS thay vì gửi trực tiếp vào cổng TCP của bạn, do đó máy chủ của bạn chỉ cần duy nhất 1 cổng UDP như cũ. (Điểm đánh đổi nhỏ: NXS không hỗ trợ chuyển tiếp trực tiếp MOTD theo thời gian thực cho từng lượt ping mà chỉ cập nhật định kỳ).

2. Tắt thông báo "Trust on first use" bằng HTTPS Signaling

Mặc định, bộ Signaling tích hợp của Geyser giao tiếp qua giao thức HTTP thuần (không mã hóa). Khi người chơi Bedrock kết nối vào máy chủ của bạn lần đầu tiên thông qua địa chỉ IP số hoặc tên miền chưa có SSL, trò chơi sẽ hiển thị một hộp thoại cảnh báo yêu cầu xác nhận tin cậy máy chủ ("Trust on first use").

Để loại bỏ hoàn toàn hộp thoại này và tạo trải nghiệm chuyên nghiệp cho cộng đồng, bạn có thể áp dụng 1 trong 3 giải pháp:

1. Khai báo chứng chỉ TLS trực tiếp trong Geyser: Trỏ đường dẫn chứng chỉ SSL/TLS của tên miền vào cấu hình Built-in Signaling để Geyser tự phục vụ giao thức HTTPS ngay trên cổng kết nối.

2. Đặt Reverse Proxy phía trước cổng Signaling: Sử dụng Nginx, Caddy hoặc HAProxy làm trạm trung chuyển xử lý chứng chỉ HTTPS và chuyển tiếp lưu lượng về cổng Signaling nội bộ của Geyser.

3. Sử dụng dịch vụ External Signaling có sẵn HTTPS: Các dịch vụ NXS như Warden đã được tích hợp sẵn chứng chỉ HTTPS hợp lệ, giúp người chơi vào thẳng server mà không gặp cảnh báo.

Bảng tóm tắt mã lỗi thường gặp khi chuyển đổi sang NetherNet và hướng xử lý nhanh:

Quá trình mã hóa đồng thời luồng dữ liệu WebRTC (UDP) và xử lý các truy vấn HTTP/HTTPS Signaling (TCP) đòi hỏi CPU máy chủ phải có tốc độ xử lý luồng mạng cao cùng hệ thống lọc gói tin thông minh. Tại LumineCloud, hạ tầng máy chủ được trang bị bộ vi xử lý AMD Ryzen 9 5950X và Ryzen 9 9950X kết hợp đường truyền nội địa Việt Nam có độ trễ chỉ 2–30 ms và hệ thống tường lửa chống DDoS Anycast 1.5 Tbps tương thích hoàn toàn với cả hai luồng TCP Signaling và UDP WebRTC. Nhờ đó, quá trình bắt tay kết nối của người chơi hệ máy Bedrock diễn ra tức thì mà không bị chặn nhầm bởi bộ lọc mạng hay gây tăng chỉ số MSPT của máy chủ chính. Để tìm hiểu thêm cách kết hợp GeyserMC cùng Floodgate và tối ưu hóa TPS cho máy chủ đa nền tảng, bạn có thể tham khảo các bài viết chuyên đề tại Blog hướng dẫn Minecraft của LumineCloud.

Câu hỏi thường gặp khi nâng cấp GeyserMC lên giao thức NetherNet

Người chơi trên điện thoại/console có cần đổi địa chỉ IP hay Port đã lưu không?

Nếu trước đây máy chủ Geyser của bạn đã chạy trên một cổng riêng biệt (ví dụ 19132) và bạn mở thêm giao thức TCP trên chính cổng đó, người chơi hoàn toàn không cần thay đổi bất kỳ thông tin nào trong danh sách server đã lưu. Họ chỉ cần sửa lại cổng nếu trước đó bạn dùng chung cổng với Java và nay quyết định tách sang một cổng mới cho Geyser.

Sử dụng các công cụ tạo đường hầm mạng (Tunnel) như Ngrok hay playit.gg có chạy được NetherNet không?

• Ngrok: Không hoạt động được với GeyserMC vì Ngrok không hỗ trợ truyền tải giao thức UDP cho luồng dữ liệu trò chơi.

• playit.gg: Đã cập nhật hỗ trợ NetherNet. Bạn cần tạo đường hầm hỗ trợ đồng thời cả hai giao thức TCP và UDP (Two-protocol tunnel) theo hướng dẫn mới của playit.gg thay vì chỉ tạo đường hầm UDP như thời RakNet.

Các tham số khởi động JVM (System Properties) nào dành riêng cho quản trị viên hệ thống?

Đối với các quản trị viên vận hành hệ thống lớn hoặc chạy qua Docker/Pterodactyl muốn ghi đè cấu hình trực tiếp từ dòng lệnh khởi động (Startup Flags), GeyserMC (từ build 1237+) hỗ trợ bộ cờ hệ thống sau:

• -DgeyserTransport=nethernet (hoặc both): Bật thẳng NetherNet mà không cần sửa file config.

• -DgeyserUdpPort=<port>: Chỉ định cổng kết nối chính của Bedrock.

• -DgeyserSignalingPort=<port> và -DgeyserWebrtcPort=<port>: Tách riêng cổng TCP Signaling và cổng UDP WebRTC nếu hạ tầng mạng cấp phát rời từng giao thức.

• -DgeyserSignalingMode=nxs: Ép Geyser sử dụng chế độ External Signaling.

• -DgeyserAdvertiseAddresses=<ip/domain>: Chỉ định địa chỉ IP công khai trả về cho người chơi khi máy chủ chạy bên trong môi trường Container hoặc sau lớp NAT.

Điều gì xảy ra với những người chơi vẫn dùng phiên bản Bedrock 26.30 trở xuống sau ngày 27/10/2026?

Ngay khi đội ngũ GeyserMC phát hành bản cập nhật hỗ trợ chính thức cho Minecraft: Bedrock Edition 26.60, quyền hỗ trợ cho phiên bản 26.30 sẽ bị gỡ bỏ hoàn toàn khỏi mã nguồn. Do đó, quản trị viên nên thông báo sớm để toàn bộ thành viên trong cộng đồng cập nhật trò chơi lên phiên bản mới nhất trước ngày 27/10.

Chủ động chuyển đổi sang giao thức NetherNet trước hạn chót ngày 27/10/2026 là bước chuẩn bị bắt buộc để cộng đồng người chơi Bedrock của bạn không bị gián đoạn kết nối khi Mojang tung ra bản cập nhật 26.60. Nếu bạn muốn vận hành một máy chủ Cross-play (chơi chéo Java & Bedrock) mượt mà mà không phải đau đầu về việc cấu hình cổng mạng TCP/UDP hay lỗi xung đột tệp hệ thống, hãy trải nghiệm ngay bảng điều khiển thông minh tại portal LumineCloud — nơi cung cấp sẵn gói Auto-config GeyserMC & OnlineMode miễn phí, trình cài đặt Plugin/Modpack/Bedrock Version chỉ với 1 cú nhấp chuột, tặng kèm MySQL Database miễn phí và tích hợp công cụ Server Import giúp bạn chuyển toàn bộ máy chủ từ nhà cung cấp khác về hạ tầng Ryzen 9 tại Việt Nam chỉ trong vài phút.