pixly.

Cách sửa lỗi NetherNet và lỗi Terracotta trên Geyser

Sửa lỗi NetherNet và Terracotta trên server Geyser: xem mã InitialConnection, cập nhật Geyser và kiểm tra kết nối TCP lẫn UDP.

AlekseiFounder
Cập nhật 8 phút đọc
Logo GeyserMC phía trên một cánh cửa đá đóng kín, các khối đất nung và một sợi cáp bị rút ra trên nền cỏ.

Pixly hỗ trợ Bedrock 26.60 ngay từ ngày đầu. Bật crossplay Bedrock trong Cài đặt rồi khởi động lại; Pixly tự cài và cấu hình Geyser cùng Floodgate. Người chơi Java và Bedrock vào cùng một địa chỉ.

Ý nghĩa của các mã NetherNet, Terracotta và Door

Bedrock 26.60, phát hành ngày 27 tháng 10 năm 2026, chỉ vào server qua NetherNet.12 Khi vào server thất bại với lỗi NetherNet, Terracotta hoặc Door, hãy nhấn Hiển thị chi tiết để xem số InitialConnection. Dùng số đó để chọn bước kiểm tra bên dưới.

Một lần vào server trên Bedrock 26.60 bắt đầu bằng signaling, tức một yêu cầu web qua TCP để tìm server, sau đó dữ liệu chơi game đi qua UDP.3 Ghi chú hỗ trợ của GeyserMC gắn mỗi số InitialConnection với một nguyên nhân:4

MãChi tiếtNguyên nhânCách sửa
TerracottaInitialConnection-149Geyser đang dùng RakNet, hoặc cổng TCP bị đóngBốn bước bên dưới
DoorInitialConnection-83UDP bị chặn, hoặc server nằm sau NATMở UDP, đặt advertise-addresses
NetherNetInitialConnection-13Không có phản hồi qua NetherNet lẫn RakNetKiểm tra địa chỉ và cả hai cổng
NetherNetInitialConnection-122Kết nối đã mở rồi bị đóngCập nhật Geyser; nếu vẫn lỗi, xem log ngắt kết nối

Terracotta với 149 nghĩa là server không dùng NetherNet, hoặc không truy cập được signaling của nó.4 Lỗi NetherNet với 13 nghĩa là server không phản hồi theo cả hai cách, nên hãy kiểm tra địa chỉ trước. Với 122, kết nối đã mở rồi bị đóng; các bản build Geyser trước 1273 bị như vậy trên Alpine Linux.5

Sửa lỗi Terracotta trên server Geyser

Tải Geyser từ trang tải xuống của GeyserMC, sau đó:

  1. Cập nhật Geyser lên bản build mới nhất. Build 1273, ra ngày 26 tháng 10, là bản đầu tiên hỗ trợ Bedrock 26.60, và các bản sau bổ sung 26.61 đến 26.63.6
  2. Đặt transport: nethernet trong cấu hình Geyser. File cấu hình nằm ở plugins/Geyser-Spigot/ trên Paper và ở config/Geyser-Fabric/ hoặc config/Geyser-NeoForge/ trên Fabric hoặc NeoForge.7 Các bản build đến 1279 giữ nguyên dòng raknet cũ; từ build 1280, Geyser tự đổi giúp bạn. Giá trị duy nhất còn lại là both, nhận thêm RakNet và cần một cổng UDP thứ hai.8910
  3. Mở cổng Geyser cho cả TCP và UDP. Với Docker, publish -p 19132:19132 -p 19132:19132/udp.3 Cổng này không được trùng với cổng của server Java.7
  4. Khởi động lại và thử vào bằng Bedrock. Dòng Built-in signaling started on http://0.0.0.0:19132 xác nhận server signaling của Geyser đã chạy.8 Vào từ bên ngoài mạng của bạn để kiểm tra người chơi có kết nối được qua TCP và UDP hay không.3

Khi đó, phần bedrock: trong cấu hình sẽ như sau:

bedrock:
  port: 19132
  transport: nethernet

Proxy, Geyser Standalone hoặc host chỉ mở cổng Java thì cần làm thêm; hướng dẫn cài Geyser và Floodgate có nói về các trường hợp đó.

Sửa lỗi Door: kiểm tra UDP và NAT

Door với 83 nghĩa là signaling qua TCP đã thành công nhưng dữ liệu chơi game qua UDP không đi qua được. Nguyên nhân là port forward hoặc ánh xạ cổng Docker chỉ cho TCP, nên hãy thêm UDP trên cùng cổng đó. Một chủ server đã hết lỗi Door 83 trên máy console chạy 26.60 nhờ sửa UDP, trong khi TCP vốn đã hoạt động.11

Nếu Geyser nằm sau router hoặc NAT và lỗi Door vẫn còn, GeyserMC khuyên thêm IP công khai của bạn vào bedrock.signaling.advertise-addresses rồi khởi động lại.4 Gộp đoạn này vào phần bedrock: hiện có, thay 203.0.113.10 bằng IP công khai của server:

bedrock:
  signaling:
    advertise-addresses:
      - "203.0.113.10"

Cảnh báo của Geyser sau 26.60 và ý nghĩa

Geyser in các cảnh báo này khi khởi động. Các build 1273 đến 1279 còn gửi tin nhắn về NetherNet cho OP khi họ vào server.69

Cảnh báo trong console Geyser

WARNING! NetherNet support is NOT enabled.

Các build 1273 đến 1279 in dòng này khi cấu hình vẫn ghi raknet. Cập nhật Geyser, hoặc đặt transport: nethernet, rồi khởi động lại.

WARNING! Raknet-only transport has now been REMOVED.

Build 1280 trở lên đã chuyển cấu hình sang NetherNet. Mở cổng cho TCP ngoài UDP.

NetherNet will not start! Could not load its WebRTC native library

Các build trước 1280 in NetherNet is not available on Linux (amd64) thay vào đó. Geyser không tải được thư viện NetherNet; các nguyên nhân đã được báo cáo là thiếu libcrypto.so.3 (trên Ubuntu hãy cài libssl3) và /tmp chỉ đọc.1211

Các build trước 1280 còn thêm vào cảnh báo cuối lời khuyên đặt transport thành raknet. Đừng làm theo: GeyserMC cho biết Bedrock 26.60 hoàn toàn không kết nối qua RakNet nữa.2

Đã thử nghiệm: mỗi thiết lập lỗi ảnh hưởng thế nào khi vào server

Ngày 1 tháng 11 năm 2026, chúng tôi chạy thử năm thiết lập với Paper 26.3, Geyser 2.12.1 và một client thử NetherNet viết bằng gophertunnel, một thư viện Bedrock mã nguồn mở.8

GeyserThiết lậpKết quả khi vào
1279transport: raknetBị từ chối ngay qua TCP
1279transport: nethernetĐăng nhập tới được Geyser
1280transport: raknetĐã chuyển sang NetherNet; đăng nhập tới được Geyser
1280Đóng TCP 19132Bị từ chối ngay qua TCP
1280Chặn UDP 19132Signaling hoạt động; hết thời gian chờ sau 30 s

Client thử nghiệm báo bước mà mỗi lần vào bị dừng. Các báo cáo bên ngoài khớp với thiết lập chạy được: một chủ server vào từ Bedrock 26.60 trên Windows qua NetherNet,13 và image server của groundsgg đã khôi phục việc vào từ 26.60 với build 1280 cùng TCP và UDP 19132.14

Câu hỏi về lỗi NetherNet và lỗi Terracotta

Người chơi sửa lỗi NetherNet thế nào?

Kiểm tra lại địa chỉ server và phiên bản game của bạn. Gửi cho chủ server toàn bộ màn hình Hiển thị chi tiết, thiết bị và phiên bản game của bạn, và cho biết người chơi khác có vào được không. Mã 13 và 122 nghĩa là kết nối thất bại hoặc bị đóng; chủ server có thể dùng các chi tiết đó để kiểm tra log server.

Vì sao server Geyser không hiện trong mục Trò chơi LAN trên 26.60?

Bedrock 26.60 tìm thế giới LAN trên cổng UDP 7551, nơi Geyser chưa phản hồi, theo một báo cáo vẫn còn mở trên trình theo dõi issue của Geyser vào ngày 10 tháng 11 năm 2026.13 Thay vào đó, hãy thêm server bằng địa chỉ trong tab Máy chủ.

Vì sao người chơi dùng bản Bedrock cũ không vào được?

Build 1273 đã bỏ Bedrock 26.30, và các build Geyser hiện tại nhận Bedrock 26.40 đến 26.63.615 Người chơi dùng bản cũ hãy cập nhật game từ cửa hàng ứng dụng trên thiết bị.

Footnotes

  1. minecraft.wiki, Bedrock Edition 26.60: phát hành ngày 27 tháng 10 năm 2026, giao thức 2225. Kiểm tra ngày 1 tháng 11 năm 2026. ↩

  2. GeyserMC, Preparing Your Geyser Server for NetherNet, ngày 8 tháng 10 năm 2026: “Bedrock clients will stop connecting over RakNet.” ↩ ↩

  3. GeyserMC, Port forwarding: “players find the server over TCP (signaling), and play on it over UDP.” Kiểm tra ngày 1 tháng 11 năm 2026. ↩ ↩ ↩

  4. GeyserMC, tag hỗ trợ cho mã lỗi Bedrock, GeyserDiscordBot: InitialConnection-149 là “Terracotta”, UnsupportedTransport, và “may also appear if the signaling server is unreachable or not running”; 83 là “Door”, NetherNetICE, “try adding your public IP address to the advertise-addresses config option”; 13 là “NetherNet”, LegacyDisconnect, hiện ra “if both attempts time out”; 122 là “NetherNet”, NetherNetDataChannelClosed. Kiểm tra ngày 1 tháng 11 năm 2026. ↩ ↩ ↩

  5. GeyserMC/Geyser issue #6807, đã đóng: trên image Alpine, client “shows InitialConnection-122 (NetherNetDataChannelClosed) after 30 s”; đã sửa trong build 1273. ↩

  6. GeyserMC, danh sách build của Geyser 2.12.1: build 1273, ngày 26 tháng 10 năm 2026, “Support 26.60”, “Surgically remove 26.30” và “Add operator join message informing NetherNet deprecation, change bedrock.transport config default to nethernet”; build 1291, ngày 6 tháng 11, “Indicate Minecraft: Bedrock Edition 26.61 and 26.62 Support”; build 1298, ngày 9 tháng 11, “Indicate Minecraft: Bedrock Edition 26.63 Support”. Kiểm tra ngày 10 tháng 11 năm 2026. ↩ ↩ ↩

  7. GeyserMC, hướng dẫn cài đặt Geyser: “Geyser uses it over both TCP and UDP, so it cannot be the port of the Paper / Spigot server.” Kiểm tra ngày 1 tháng 11 năm 2026. ↩ ↩

  8. Thử nghiệm của Pixly, ngày 1 tháng 11 năm 2026: Paper 26.3 và Geyser-Spigot 2.12.1 build 1279 và 1280 chạy trong Docker, được một client NetherNet viết bằng gophertunnel vào từ cùng mạng; các cổng được đóng bằng quy tắc firewall bên trong container của server. Build 1279 tạo cấu hình mới với transport: nethernet và giữ nguyên transport: raknet có sẵn, ghi log WARNING! NetherNet support is NOT enabled. ↩ ↩ ↩

  9. GeyserMC, Remove RakNet-only transport (#6843), build 1280, ngày 31 tháng 10 năm 2026 (UTC): chuyển transport raknet sang nethernet, bỏ các tin nhắn khi khởi động và khi vào server WARNING! NetherNet support is NOT enabled., và thay thông báo Linux bằng “NetherNet will not start! Could not load its WebRTC native library”. ↩ ↩

  10. GeyserMC, GeyserConfig.java: “both”: “accepts NetherNet and RakNet. Each needs its own UDP port”. Kiểm tra ngày 10 tháng 11 năm 2026. ↩

  11. spruyt-labs, run NetherNet transport for Bedrock 26.60 clients, đã đóng ngày 28 tháng 10 năm 2026: “The first console test failed with initialconnection 83. TCP signaling worked”, sau đó UDP được sửa và “A console on Minecraft 26.60 reaches the server list and joins”; trước đó khởi động thất bại với “/tmp/datachannel-java-...: Read-only file system”. ↩ ↩

  12. GeyserMC/Geyser issue #6852, “NETHERNET: Terracotta error”, ngày 31 tháng 10 năm 2026: log hiện libcrypto.so.3: cannot open shared object file, và một contributor của Geyser trả lời “Installing libssl3 should resolve your issue.” ↩

  13. GeyserMC/Geyser issue #6853, ngày 31 tháng 10 năm 2026, vẫn mở vào ngày 10 tháng 11: “Joining by address from the Servers tab works fine over NetherNet” trên Bedrock 26.60 cho Windows với Geyser 2.12.1-b1279, trong khi gói broadcast LAN của client tới UDP 7551 không có phản hồi vì “Nothing listens on UDP 7551”. ↩ ↩

  14. groundsgg, fix(geyser): restore Bedrock 26.60 connections, merge ngày 1 tháng 11 năm 2026: ghim Geyser 2.12.1 build 1280 và mở TCP và UDP 19132. ↩

  15. GeyserMC, Supported versions: “Geyser currently supports Minecraft Bedrock 26.40-26.63 and Minecraft Java 26.3.” Kiểm tra ngày 10 tháng 11 năm 2026. ↩

AlekseiFounder at Pixly

Viết về việc vận hành server Minecraft — số liệu đo thực tế, cách khắc phục làm lại được, và những đánh đổi mà các trang hosting không nhắc tới.

Đọc tiếp.