stun下載 - stun源代碼下載

stun

其他源碼

v2.0.0

下載

派恩特

Stun的實施

軟件包stun實現了NAT（stun）（RFC 5389）協議的會話遍歷實用程序，並且在熱路徑中沒有外部依賴關係和零分配的客戶端。客戶支持自動請求重新啟動。

例子

您可以通過發送綁定請求從任何眩暈服務器中獲取當前的IP地址。在cmd/stun-client上查看更多慣用示例。

 package main

import (
	"fmt"

	"github.com/pion/stun"
)

func main () {
	// Parse a STUN URI
	u , err := stun . ParseURI ( "stun:stun.l.google.com:19302" )
	if err != nil {
		panic ( err )
	}

	// Creating a "connection" to STUN server.
	c , err := stun . DialURI ( u , & stun. DialConfig {})
	if err != nil {
		panic ( err )
	}
	// Building binding request with random transaction id.
	message := stun . MustBuild ( stun . TransactionID , stun . BindingRequest )
	// Sending request to STUN server, waiting for response message.
	if err := c . Do ( message , func ( res stun. Event ) {
		if res . Error != nil {
			panic ( res . Error )
		}
		// Decoding XOR-MAPPED-ADDRESS attribute from message.
		var xorAddr stun. XORMappedAddress
		if err := xorAddr . GetFrom ( res . Message ); err != nil {
			panic ( err )
		}
		fmt . Println ( "your IP is" , xorAddr . IP )
	}); err != nil {
		panic ( err )
	}
}

RFCS

實施的

RFC 5389 ：NAT的會話遍歷公用事業（Stun）
RFC 5769 ：NAT的會話遍歷實用程序的測試向量（Stun）
RFC 6062 ：使用NAT附近的繼電器（轉彎）擴展TCP分配的遍歷
RFC 7064 ：用於NAT（Stun）協議的會話遍歷實用程序的URI方案
RFC 7065 ：使用NAT周圍的繼電器（轉彎）統一資源標識符的遍歷
RFC 5780 ：使用CMD/Stun-Nat-Behaviour使用會話遍歷實用程序（Stun）的NAT行為發現
（TLS-Over-）TCP客戶端支持

計劃

RFC 5389 ：備用服務器支持＃48

兼作說明

RFC 5389 Omboteletes RFC 3489，因此實現被目的忽略了，但是，RFC 3489可以輕鬆地作為單獨的軟件包實現。

穩定

當前軟件包是穩定的，除關鍵錯誤或安全修復程序外，預計不會向後不兼容的更改。

其他屬性不太可能在Stun軟件包的範圍中實現，唯一的例外是屬性或消息類型的常數。

要求

目前在CI中支持和測試GO 1.12。

測試

客戶行為經過許多方式進行了測試和驗證：

長期證書的端到端
- Coturn ：Coturn Server（Linux）
一堆代碼靜態檢查器（襯裡）
帶有覆蓋範圍報告的標准單位檢驗（Linux {AMD64， ARM 64}，Windows和Darwin）
顯式API向後兼容檢查，請參閱api目錄

有關更多信息，請參見Teamcity項目和e2e目錄。此外，Wireshark .pcap文件也可用於構建工件中的E2E測試。

基準

英特爾（R）Core（TM）I7-8700K：

 version: 1.22.2
goos: linux
goarch: amd64
pkg: github.com/pion/stun
PASS
benchmark                                         iter       time/iter      throughput   bytes alloc        allocs
---------                                         ----       ---------      ----------   -----------        ------
BenchmarkMappedAddress_AddTo-12               32489450     38.30 ns/op                        0 B/op   0 allocs/op
BenchmarkAlternateServer_AddTo-12             31230991     39.00 ns/op                        0 B/op   0 allocs/op
BenchmarkAgent_GC-12                            431390   2918.00 ns/op                        0 B/op   0 allocs/op
BenchmarkAgent_Process-12                     35901940     36.20 ns/op                        0 B/op   0 allocs/op
BenchmarkMessage_GetNotFound-12              242004358      5.19 ns/op                        0 B/op   0 allocs/op
BenchmarkMessage_Get-12                      230520343      5.21 ns/op                        0 B/op   0 allocs/op
BenchmarkClient_Do-12                          1282231    943.00 ns/op                        0 B/op   0 allocs/op
BenchmarkErrorCode_AddTo-12                   16318916     75.50 ns/op                        0 B/op   0 allocs/op
BenchmarkErrorCodeAttribute_AddTo-12          21584140     54.80 ns/op                        0 B/op   0 allocs/op
BenchmarkErrorCodeAttribute_GetFrom-12       100000000     11.10 ns/op                        0 B/op   0 allocs/op
BenchmarkFingerprint_AddTo-12                 19368768     64.00 ns/op     687.81 MB/s        0 B/op   0 allocs/op
BenchmarkFingerprint_Check-12                 24167007     49.10 ns/op    1057.99 MB/s        0 B/op   0 allocs/op
BenchmarkBuildOverhead/Build-12                5486252    224.00 ns/op                        0 B/op   0 allocs/op
BenchmarkBuildOverhead/BuildNonPointer-12      2496544    517.00 ns/op                      100 B/op   4 allocs/op
BenchmarkBuildOverhead/Raw-12                  6652118    181.00 ns/op                        0 B/op   0 allocs/op
BenchmarkMessage_ForEach-12                   28254212     35.90 ns/op                        0 B/op   0 allocs/op
BenchmarkMessageIntegrity_AddTo-12             1000000   1179.00 ns/op      16.96 MB/s        0 B/op   0 allocs/op
BenchmarkMessageIntegrity_Check-12              975954   1219.00 ns/op      26.24 MB/s        0 B/op   0 allocs/op
BenchmarkMessage_Write-12                     41040598     30.40 ns/op     922.13 MB/s        0 B/op   0 allocs/op
BenchmarkMessageType_Value-12               1000000000      0.53 ns/op                        0 B/op   0 allocs/op
BenchmarkMessage_WriteTo-12                   94942935     11.30 ns/op                        0 B/op   0 allocs/op
BenchmarkMessage_ReadFrom-12                  43437718     29.30 ns/op     682.87 MB/s        0 B/op   0 allocs/op
BenchmarkMessage_ReadBytes-12                 74693397     15.90 ns/op    1257.42 MB/s        0 B/op   0 allocs/op
BenchmarkIsMessage-12                       1000000000      1.20 ns/op   16653.64 MB/s        0 B/op   0 allocs/op
BenchmarkMessage_NewTransactionID-12            521121   2450.00 ns/op                        0 B/op   0 allocs/op
BenchmarkMessageFull-12                        5389495    221.00 ns/op                        0 B/op   0 allocs/op
BenchmarkMessageFullHardcore-12               12715876     94.40 ns/op                        0 B/op   0 allocs/op
BenchmarkMessage_WriteHeader-12              100000000     11.60 ns/op                        0 B/op   0 allocs/op
BenchmarkMessage_CloneTo-12                   30199020     41.80 ns/op    1626.66 MB/s        0 B/op   0 allocs/op
BenchmarkMessage_AddTo-12                    415257625      2.97 ns/op                        0 B/op   0 allocs/op
BenchmarkDecode-12                            49573747     23.60 ns/op                        0 B/op   0 allocs/op
BenchmarkUsername_AddTo-12                    56282674     22.50 ns/op                        0 B/op   0 allocs/op
BenchmarkUsername_GetFrom-12                 100000000     10.10 ns/op                        0 B/op   0 allocs/op
BenchmarkNonce_AddTo-12                       39419097     35.80 ns/op                        0 B/op   0 allocs/op
BenchmarkNonce_AddTo_BadLength-12            196291666      6.04 ns/op                        0 B/op   0 allocs/op
BenchmarkNonce_GetFrom-12                    120857732      9.93 ns/op                        0 B/op   0 allocs/op
BenchmarkUnknownAttributes/AddTo-12           28881430     37.20 ns/op                        0 B/op   0 allocs/op
BenchmarkUnknownAttributes/GetFrom-12         64907534     19.80 ns/op                        0 B/op   0 allocs/op
BenchmarkXOR-12                               32868506     32.20 ns/op   31836.66 MB/s
BenchmarkXORSafe-12                            5185776    234.00 ns/op    4378.74 MB/s
BenchmarkXORFast-12                           30975679     32.50 ns/op   31525.28 MB/s
BenchmarkXORMappedAddress_AddTo-12            21518028     54.50 ns/op                        0 B/op   0 allocs/op
BenchmarkXORMappedAddress_GetFrom-12          35597667     34.40 ns/op                        0 B/op   0 allocs/op
ok      github.com/pion/stun   60.973s