mirror of https://github.com/XTLS/Xray-core
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
79 lines
2.6 KiB
79 lines
2.6 KiB
// +build !confonly |
|
|
|
package core |
|
|
|
import ( |
|
"bytes" |
|
"context" |
|
|
|
"github.com/xtls/xray-core/v1/common" |
|
"github.com/xtls/xray-core/v1/common/net" |
|
"github.com/xtls/xray-core/v1/features/routing" |
|
"github.com/xtls/xray-core/v1/transport/internet/udp" |
|
) |
|
|
|
// CreateObject creates a new object based on the given Xray instance and config. The Xray instance may be nil. |
|
func CreateObject(v *Instance, config interface{}) (interface{}, error) { |
|
ctx := v.ctx |
|
if v != nil { |
|
ctx = context.WithValue(ctx, xrayKey, v) |
|
} |
|
return common.CreateObject(ctx, config) |
|
} |
|
|
|
// StartInstance starts a new Xray instance with given serialized config. |
|
// By default Xray only support config in protobuf format, i.e., configFormat = "protobuf". Caller need to load other packages to add JSON support. |
|
// |
|
// xray:api:stable |
|
func StartInstance(configFormat string, configBytes []byte) (*Instance, error) { |
|
config, err := LoadConfig(configFormat, "", bytes.NewReader(configBytes)) |
|
if err != nil { |
|
return nil, err |
|
} |
|
instance, err := New(config) |
|
if err != nil { |
|
return nil, err |
|
} |
|
if err := instance.Start(); err != nil { |
|
return nil, err |
|
} |
|
return instance, nil |
|
} |
|
|
|
// Dial provides an easy way for upstream caller to create net.Conn through Xray. |
|
// It dispatches the request to the given destination by the given Xray instance. |
|
// Since it is under a proxy context, the LocalAddr() and RemoteAddr() in returned net.Conn |
|
// will not show real addresses being used for communication. |
|
// |
|
// xray:api:stable |
|
func Dial(ctx context.Context, v *Instance, dest net.Destination) (net.Conn, error) { |
|
dispatcher := v.GetFeature(routing.DispatcherType()) |
|
if dispatcher == nil { |
|
return nil, newError("routing.Dispatcher is not registered in Xray core") |
|
} |
|
r, err := dispatcher.(routing.Dispatcher).Dispatch(ctx, dest) |
|
if err != nil { |
|
return nil, err |
|
} |
|
var readerOpt net.ConnectionOption |
|
if dest.Network == net.Network_TCP { |
|
readerOpt = net.ConnectionOutputMulti(r.Reader) |
|
} else { |
|
readerOpt = net.ConnectionOutputMultiUDP(r.Reader) |
|
} |
|
return net.NewConnection(net.ConnectionInputMulti(r.Writer), readerOpt), nil |
|
} |
|
|
|
// DialUDP provides a way to exchange UDP packets through Xray instance to remote servers. |
|
// Since it is under a proxy context, the LocalAddr() in returned PacketConn will not show the real address. |
|
// |
|
// TODO: SetDeadline() / SetReadDeadline() / SetWriteDeadline() are not implemented. |
|
// |
|
// xray:api:beta |
|
func DialUDP(ctx context.Context, v *Instance) (net.PacketConn, error) { |
|
dispatcher := v.GetFeature(routing.DispatcherType()) |
|
if dispatcher == nil { |
|
return nil, newError("routing.Dispatcher is not registered in Xray core") |
|
} |
|
return udp.DialDispatcher(ctx, dispatcher.(routing.Dispatcher)) |
|
}
|
|
|