netcode

網路程式碼

netcode是建立在 UDP 之上的安全客戶端/伺服器協定。

它旨在供即時多人遊戲使用，這些遊戲需要面向連接的協議，但沒有 TCP 的隊頭阻塞。

網路程式碼具有以下特點：

• 使用連線令牌保護客戶端連線。只有您授權的客戶端才能連線到您的伺服器。這對於您在網路後端執行匹配然後將客戶端發送到伺服器的遊戲來說是完美的。
• 客戶端槽系統。伺服器有 n 個供客戶端使用的插槽。用戶端在連接到伺服器時會被指派到一個插槽，如果所有插槽都被佔用，很快就會被拒絕連線。
• 在連接的用戶端或伺服器端快速且乾淨地斷開連接，以便為新用戶端開啟插槽，以及硬斷開的逾時。
• 加密和簽署的資料包。資料包不能被未參與連線的各方竄改或讀取。密碼學是由優秀的鈉庫執行的。
• 許多安全功能包括針對惡意製作的資料包、資料包重播攻擊和資料包放大攻擊的強大保護。
• 支援資料包標記，可大幅減少 Wi-Fi 路由器上的抖動。閱讀這篇文章以了解更多詳細資訊。

網路程式碼穩定並且可以投入生產。

用法

首先產生隨機的 32 位元組私鑰。不要與任何人分享您的私鑰。

特別是，不要將您的私鑰包含在客戶端可執行檔中！

這是一個測試私鑰：

 static uint8_t private_key [ NETCODE_KEY_BYTES ] = { 0x60 , 0x6a , 0xbe , 0x6e , 0xc9 , 0x19 , 0x10 , 0xea , 
                                                  0x9a , 0x65 , 0x62 , 0xf6 , 0x6f , 0x2b , 0x30 , 0xe4 , 
                                                  0x43 , 0x71 , 0xd6 , 0x2c , 0xd1 , 0x99 , 0x27 , 0x26 ,
                                                  0x6b , 0x3c , 0x60 , 0xf4 , 0xb7 , 0x15 , 0xab , 0xa1 };

使用私鑰創建伺服器：

 char * server_address = "127.0.0.1:40000" ;

struct netcode_server_config_t server_config ;
netcode_default_server_config ( & server_config );
memcpy ( & server_config . private_key , private_key , NETCODE_KEY_BYTES );

struct netcode_server_t * server = netcode_server_create ( server_address , & server_config , time );
if ( ! server )
{
    printf ( "error: failed to create servern" );
    return 1 ;
}

然後使用您想要的客戶端插槽數量啟動伺服器：

 netcode_server_start ( server , 16 );

若要連接用戶端，您的用戶端應使用傳回連線令牌的後端 REST API。

使用連線令牌可以保護您的伺服器，以便只有獲得您後端授權的用戶端才能連線。

 netcode_client_connect ( client , connect_token );

一旦客戶端連接到伺服器，客戶端就會被分配一個客戶端索引，並且可以與伺服器交換加密和簽署的資料包。

有關更多詳細信息，請參閱 client.c 和 server.c

原始碼

此儲存庫保存了 C 語言的網路程式碼實作。

其他網路代碼實作包括：

• 網路代碼C#實現
• 網路程式碼Golang實現
• netcode Rust 實作（更新了 vvanders/netcode.io 的分支）
• netcode Rust 實作（從頭開始的新 Rust 實作）
• Unity 的網路程式碼
• UE4 的網路程式碼
• Typescript 的網路程式碼

如果您想建立自己的 netcode 實現，請閱讀 netcode 1.02 標準。

貢獻者

這些人太棒了：

• Val Vanders - Rust 實現
• Walter Pearce - Rust 實現
• Isaac Dawson - Golang 實現
• Alan Stagner - Unity 集成，C# 實現
• Jérôme Leclercq - 支援隨機連線令牌隨機數
• Randy Gaul - 發現重播保護中的漏洞
• Benny Chen - Typescript 實現
• Benny Nazimov - Rust 實現

感謝您對網絡代碼的貢獻！

作者

本庫的作者是 Glenn Fiedler。

同一作者的其他開源程式庫包括：reliable、serialize 和 yojimbo。

如果您發現該軟體有用，請考慮贊助它。謝謝！

執照

BSD 3 條款許可證。