MapPortHandler Callback for container support

agent.go

@@ -174,6 +174,9 @@ type Agent struct {
 	renominationInterval  time.Duration
 	lastRenominationTime  time.Time
 
+	// Port mapping support for container
+	mapPort func(candidate Candidate) int
+
 	turnClientFactory func(*turn.ClientConfig) (turnClient, error)
 }
 

agent_options.go

@@ -960,3 +960,13 @@ func WithLoggerFactory(loggerFactory logging.LoggerFactory) AgentOption {
 		return nil
 	}
 }
+
+func WithMapPortHandler(handler func(cand Candidate) int) AgentOption {
+	return func(a *Agent) error {
+		a.mapPort = func(candidate Candidate) int {
+			return handler(candidate)
+		}
+
+		return nil
+	}
+}

candidate_base.go

@@ -440,7 +440,7 @@ func (c *candidateBase) Priority() uint32 {
 }
 
 // Equal is used to compare two candidateBases.
-func (c *candidateBase) Equal(other Candidate) bool {
+func (c *candidateBase) Equal(other Candidate) bool { //nolint:cyclop
 	if c.addr() != other.addr() {
 		if c.addr() == nil || other.addr() == nil {
 			return false

gather.go

@@ -414,6 +414,12 @@ func (a *Agent) gatherCandidatesLocal(ctx context.Context, networkTypes []Networ
 
 						continue
 					}
+					if a.mapPort != nil {
+						mappedPort := a.mapPort(candidateHost)
+						if mappedPort != 0 {
+							candidateHost.port = mappedPort
+						}
+					}
 
 					if err := a.addCandidate(ctx, candidateHost, connAndPort.conn); err != nil {
 						if closeErr := candidateHost.close(); closeErr != nil {
@@ -512,15 +518,22 @@ func (a *Agent) gatherCandidatesLocalUDPMux(ctx context.Context) error { //nolin
 				return err
 			}
 
-			c, err := NewCandidateHost(&hostConfig)
+			cand, err := NewCandidateHost(&hostConfig)
+			if a.mapPort != nil {
+				mappedPort := a.mapPort(cand)
+				if mappedPort != 0 {
+					cand.port = mappedPort
+				}
+			}
+
 			if err != nil {
 				closeConnAndLog(conn, a.log, "failed to create host mux candidate: %s %d: %v", candidateIP, udpAddr.Port, err)
 
 				continue
 			}
 
-			if err := a.addCandidate(ctx, c, conn); err != nil {
-				if closeErr := c.close(); closeErr != nil {
+			if err := a.addCandidate(ctx, cand, conn); err != nil {
+				if closeErr := cand.close(); closeErr != nil {
 					a.log.Warnf("Failed to close candidate: %v", closeErr)
 				}
 
@@ -623,7 +636,7 @@ func (a *Agent) gatherCandidatesSrflxMapped(ctx context.Context, networkTypes []
 					RelAddr:   currentAddr.IP.String(),
 					RelPort:   currentAddr.Port,
 				}
-				c, err := NewCandidateServerReflexive(&srflxConfig)
+				cand, err := NewCandidateServerReflexive(&srflxConfig)
 				if err != nil {
 					closeConnAndLog(currentConn, a.log, "failed to create server reflexive candidate: %s %s %d: %v",
 						network,
@@ -633,9 +646,15 @@ func (a *Agent) gatherCandidatesSrflxMapped(ctx context.Context, networkTypes []
 
 					continue
 				}
+				if a.mapPort != nil {
+					mappedPort := a.mapPort(cand)
+					if mappedPort != 0 {
+						cand.port = mappedPort
+					}
+				}
 
-				if err := a.addCandidate(ctx, c, currentConn); err != nil {
-					if closeErr := c.close(); closeErr != nil {
+				if err := a.addCandidate(ctx, cand, currentConn); err != nil {
+					if closeErr := cand.close(); closeErr != nil {
 						a.log.Warnf("Failed to close candidate: %v", closeErr)
 					}
 					a.log.Warnf("Failed to append to localCandidates and run onCandidateHdlr: %v", err)
@@ -712,15 +731,21 @@ func (a *Agent) gatherCandidatesSrflxUDPMux(ctx context.Context, urls []*stun.UR
 						RelAddr:   localAddr.IP.String(),
 						RelPort:   localAddr.Port,
 					}
-					c, err := NewCandidateServerReflexive(&srflxConfig)
+					cand, err := NewCandidateServerReflexive(&srflxConfig)
 					if err != nil {
 						closeConnAndLog(conn, a.log, "failed to create server reflexive candidate: %s %s %d: %v", network, ip, port, err)
 
 						return
 					}
+					if a.mapPort != nil {
+						mappedPort := a.mapPort(cand)
+						if mappedPort != 0 {
+							cand.port = mappedPort
+						}
+					}
 
-					if err := a.addCandidate(ctx, c, conn); err != nil {
-						if closeErr := c.close(); closeErr != nil {
+					if err := a.addCandidate(ctx, cand, conn); err != nil {
+						if closeErr := cand.close(); closeErr != nil {
 							a.log.Warnf("Failed to close candidate: %v", closeErr)
 						}
 						a.log.Warnf("Failed to append to localCandidates and run onCandidateHdlr: %v", err)
@@ -805,15 +830,21 @@ func (a *Agent) gatherCandidatesSrflx(ctx context.Context, urls []*stun.URI, net
 					RelAddr:   lAddr.IP.String(),
 					RelPort:   lAddr.Port,
 				}
-				c, err := NewCandidateServerReflexive(&srflxConfig)
+				cand, err := NewCandidateServerReflexive(&srflxConfig)
 				if err != nil {
 					closeConnAndLog(conn, a.log, "failed to create server reflexive candidate: %s %s %d: %v", network, ip, port, err)
 
 					return
 				}
+				if a.mapPort != nil {
+					mappedPort := a.mapPort(cand)
+					if mappedPort != 0 {
+						cand.port = mappedPort
+					}
+				}
 
-				if err := a.addCandidate(ctx, c, conn); err != nil {
-					if closeErr := c.close(); closeErr != nil {
+				if err := a.addCandidate(ctx, cand, conn); err != nil {
+					if closeErr := cand.close(); closeErr != nil {
 						a.log.Warnf("Failed to close candidate: %v", closeErr)
 					}
 					a.log.Warnf("Failed to append to localCandidates and run onCandidateHdlr: %v", err)
@@ -1158,6 +1189,12 @@ func (a *Agent) createRelayCandidate(ctx context.Context, ep relayEndpoint, ip n
 
 		return err
 	}
+	if a.mapPort != nil {
+		mappedPort := a.mapPort(candidate)
+		if mappedPort != 0 {
+			candidate.port = mappedPort
+		}
+	}
 
 	if err := a.addCandidate(ctx, candidate, ep.conn); err != nil {
 		if closeErr := candidate.close(); closeErr != nil {