mirror of
https://github.com/XTLS/Xray-core.git
synced 2024-09-06 08:19:20 +03:00
95 lines
2.3 KiB
Go
95 lines
2.3 KiB
Go
|
// Package session provides functions for sessions of incoming requests.
|
||
|
package session // import "github.com/xtls/xray-core/v1/common/session"
|
||
|
|
||
|
import (
|
||
|
"context"
|
||
|
"math/rand"
|
||
|
|
||
|
"github.com/xtls/xray-core/v1/common/errors"
|
||
|
"github.com/xtls/xray-core/v1/common/net"
|
||
|
"github.com/xtls/xray-core/v1/common/protocol"
|
||
|
)
|
||
|
|
||
|
// ID of a session.
|
||
|
type ID uint32
|
||
|
|
||
|
// NewID generates a new ID. The generated ID is high likely to be unique, but not cryptographically secure.
|
||
|
// The generated ID will never be 0.
|
||
|
func NewID() ID {
|
||
|
for {
|
||
|
id := ID(rand.Uint32())
|
||
|
if id != 0 {
|
||
|
return id
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
// ExportIDToError transfers session.ID into an error object, for logging purpose.
|
||
|
// This can be used with error.WriteToLog().
|
||
|
func ExportIDToError(ctx context.Context) errors.ExportOption {
|
||
|
id := IDFromContext(ctx)
|
||
|
return func(h *errors.ExportOptionHolder) {
|
||
|
h.SessionID = uint32(id)
|
||
|
}
|
||
|
}
|
||
|
|
||
|
// Inbound is the metadata of an inbound connection.
|
||
|
type Inbound struct {
|
||
|
// Source address of the inbound connection.
|
||
|
Source net.Destination
|
||
|
// Getaway address
|
||
|
Gateway net.Destination
|
||
|
// Tag of the inbound proxy that handles the connection.
|
||
|
Tag string
|
||
|
// User is the user that authencates for the inbound. May be nil if the protocol allows anounymous traffic.
|
||
|
User *protocol.MemoryUser
|
||
|
}
|
||
|
|
||
|
// Outbound is the metadata of an outbound connection.
|
||
|
type Outbound struct {
|
||
|
// Target address of the outbound connection.
|
||
|
Target net.Destination
|
||
|
// Gateway address
|
||
|
Gateway net.Address
|
||
|
}
|
||
|
|
||
|
// SniffingRequest controls the behavior of content sniffing.
|
||
|
type SniffingRequest struct {
|
||
|
OverrideDestinationForProtocol []string
|
||
|
Enabled bool
|
||
|
}
|
||
|
|
||
|
// Content is the metadata of the connection content.
|
||
|
type Content struct {
|
||
|
// Protocol of current content.
|
||
|
Protocol string
|
||
|
|
||
|
SniffingRequest SniffingRequest
|
||
|
|
||
|
Attributes map[string]string
|
||
|
|
||
|
SkipRoutePick bool
|
||
|
}
|
||
|
|
||
|
// Sockopt is the settings for socket connection.
|
||
|
type Sockopt struct {
|
||
|
// Mark of the socket connection.
|
||
|
Mark int32
|
||
|
}
|
||
|
|
||
|
// SetAttribute attachs additional string attributes to content.
|
||
|
func (c *Content) SetAttribute(name string, value string) {
|
||
|
if c.Attributes == nil {
|
||
|
c.Attributes = make(map[string]string)
|
||
|
}
|
||
|
c.Attributes[name] = value
|
||
|
}
|
||
|
|
||
|
// Attribute retrieves additional string attributes from content.
|
||
|
func (c *Content) Attribute(name string) string {
|
||
|
if c.Attributes == nil {
|
||
|
return ""
|
||
|
}
|
||
|
return c.Attributes[name]
|
||
|
}
|