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.

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ết | Nguyên nhân | Cách sửa |
|---|---|---|---|
| Terracotta | InitialConnection-149 | Geyser đang dùng RakNet, hoặc cổng TCP bị đóng | Bốn bước bên dưới |
| Door | InitialConnection-83 | UDP bị chặn, hoặc server nằm sau NAT | Mở UDP, đặt advertise-addresses |
| NetherNet | InitialConnection-13 | Không có phản hồi qua NetherNet lẫn RakNet | Kiểm tra địa chỉ và cả hai cổng |
| NetherNet | InitialConnection-122 | Kết nối đã mở rồi bị đóng | Cậ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 đó:
- 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
- Đặt
transport: nethernettrong cấu hình Geyser. File cấu hình nằm ởplugins/Geyser-Spigot/trên Paper và ởconfig/Geyser-Fabric/hoặcconfig/Geyser-NeoForge/trên Fabric hoặc NeoForge.7 Các bản build đến 1279 giữ nguyên dòngraknetcũ; 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 - 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 - Khởi động lại và thử vào bằng Bedrock. Dòng
Built-in signaling started on http://0.0.0.0:19132xá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: nethernetProxy, 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 đặttransport: 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ếulibcrypto.so.3(trên Ubuntu hãy càilibssl3) và/tmpchỉ đọ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
| Geyser | Thiết lập | Kết quả khi vào |
|---|---|---|
| 1279 | transport: raknet | Bị từ chối ngay qua TCP |
| 1279 | transport: nethernet | Đăng nhập tới được Geyser |
| 1280 | transport: raknet | Đã chuyển sang NetherNet; đăng nhập tới được Geyser |
| 1280 | Đóng TCP 19132 | Bị từ chối ngay qua TCP |
| 1280 | Chặn UDP 19132 | Signaling 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ủ.
Footnotes
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. ↩
GeyserMC, Preparing Your Geyser Server for NetherNet, ngày 8 tháng 10 năm 2026: “Bedrock clients will stop connecting over RakNet.” ↩ ↩
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. ↩ ↩ ↩
GeyserMC/Geyser issue #6807, đã đóng: trên image Alpine, client “shows
InitialConnection-122(NetherNetDataChannelClosed) after 30 s”; đã sửa trong build 1273. ↩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. ↩ ↩ ↩
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. ↩ ↩
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: nethernetvà giữ nguyêntransport: raknetcó sẵn, ghi logWARNING! NetherNet support is NOT enabled.↩ ↩ ↩GeyserMC, Remove RakNet-only transport (#6843), build 1280, ngày 31 tháng 10 năm 2026 (UTC): chuyển transport
raknetsangnethernet, bỏ các tin nhắn khi khởi động và khi vào serverWARNING! 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”. ↩ ↩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. ↩
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”. ↩ ↩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.” ↩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”. ↩ ↩
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. ↩
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. ↩