core

package module
v5.5.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 23, 2023 License: MIT Imports: 34 Imported by: 61

README

V2Ray

Project V

Project V is a set of network tools that helps you to build your own computer network. It secures your network connections and thus protects your privacy.

GitHub Test Badge codecov.io codebeat Codacy Badge Downloads

Packaging Status

If you are willing to package V2Ray for other distros/platforms, please let us know or seek for help via GitHub issues.

Packaging status

License

The MIT License (MIT)

Credits

This repo relies on the following third-party projects:

Documentation

Overview

Package core provides an entry point to use V2Ray core functionalities.

V2Ray makes it possible to accept incoming network connections with certain protocol, process the data, and send them through another connection with the same or a difference protocol on demand.

It may be configured to work with multiple protocols at the same time, and uses the internal router to tunnel through different inbound and outbound connections.

Index

Constants

View Source 
const (
	// FormatAuto represents all available formats by auto selecting
	FormatAuto = "auto"
	// FormatJSON represents json format
	FormatJSON = "json"
	// FormatTOML represents toml format
	FormatTOML = "toml"
	// FormatYAML represents yaml format
	FormatYAML = "yaml"
	// FormatProtobuf represents protobuf format
	FormatProtobuf = "protobuf"
	// FormatProtobufShort is the short of FormatProtobuf
	FormatProtobufShort = "pb"
)

Variables

View Source 
var File_config_proto protoreflect.FileDescriptor

Functions

func AddInboundHandler 

func AddInboundHandler(server *Instance, config *InboundHandlerConfig) error

func AddOutboundHandler 

func AddOutboundHandler(server *Instance, config *OutboundHandlerConfig) error

func CreateObject 

func CreateObject(v *Instance, config interface{}) (interface{}, error)

CreateObject creates a new object based on the given V2Ray instance and config. The V2Ray instance may be nil.

func CreateObjectWithEnvironment added in v5.0.4 

func CreateObjectWithEnvironment(v *Instance, config, environment interface{}) (interface{}, error)

func Dial 

func Dial(ctx context.Context, v *Instance, dest net.Destination) (net.Conn, error)

Dial provides an easy way for upstream caller to create net.Conn through V2Ray. It dispatches the request to the given destination by the given V2Ray 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.

v2ray:api:stable

func DialUDP 

func DialUDP(ctx context.Context, v *Instance) (net.PacketConn, error)

DialUDP provides a way to exchange UDP packets through V2Ray 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.

v2ray:api:beta

func GetAllExtensions 

func GetAllExtensions() []string

GetAllExtensions get all extensions supported

func GetLoaderExtensions 

func GetLoaderExtensions(formatName string) ([]string, error)

GetLoaderExtensions get config loader extensions.

func RegisterConfigLoader 

func RegisterConfigLoader(format *ConfigFormat) error

RegisterConfigLoader add a new ConfigLoader.

func RequireFeatures 

func RequireFeatures(ctx context.Context, callback interface{}) error

RequireFeatures is a helper function to require features from Instance in context. See Instance.RequireFeatures for more information.

func ServerType 

func ServerType() interface{}

ServerType returns the type of the server.

func ToBackgroundDetachedContext 

func ToBackgroundDetachedContext(ctx context.Context) context.Context

ToBackgroundDetachedContext create a detached context from another context Internal API

func Version 

func Version() string

Version returns V2Ray's version as a string, in the form of "x.y.z" where x, y and z are numbers. ".z" part may be omitted in regular releases.

func VersionStatement 

func VersionStatement() []string

VersionStatement returns a list of strings representing the full version info.

Types

type Annotation 

type Annotation struct {
	// API is for types or functions that can be used in other libs. Possible values are:
	//
	// * v2ray:api:beta for types or functions that are ready for use, but maybe changed in the future.
	// * v2ray:api:stable for types or functions with guarantee of backward compatibility.
	// * v2ray:api:deprecated for types or functions that should not be used anymore.
	//
	// Types or functions without api annotation should not be used externally.
	API string
}

Annotation is a concept in V2Ray. This struct is only for documentation. It is not used anywhere. Annotations begin with "v2ray:" in comment, as metadata of functions or types.

type Config 

type Config struct {

	// Inbound handler configurations. Must have at least one item.
	Inbound []*InboundHandlerConfig `protobuf:"bytes,1,rep,name=inbound,proto3" json:"inbound,omitempty"`
	// Outbound handler configurations. Must have at least one item. The first
	// item is used as default for routing.
	Outbound []*OutboundHandlerConfig `protobuf:"bytes,2,rep,name=outbound,proto3" json:"outbound,omitempty"`
	// App is for configurations of all features in V2Ray. A feature must
	// implement the Feature interface, and its config type must be registered
	// through common.RegisterConfig.
	App []*anypb.Any `protobuf:"bytes,4,rep,name=app,proto3" json:"app,omitempty"`
	// Transport settings.
	// Deprecated. Each inbound and outbound should choose their own transport
	// config. Date to remove: 2020-01-13
	//
	// Deprecated: Do not use.
	Transport *transport.Config `protobuf:"bytes,5,opt,name=transport,proto3" json:"transport,omitempty"`
	// Configuration for extensions. The config may not work if corresponding
	// extension is not loaded into V2Ray. V2Ray will ignore such config during
	// initialization.
	Extension []*anypb.Any `protobuf:"bytes,6,rep,name=extension,proto3" json:"extension,omitempty"`
	// contains filtered or unexported fields
}

Config is the master config of V2Ray. V2Ray takes this config as input and functions accordingly.

func LoadConfig 

func LoadConfig(formatName string, input interface{}) (*Config, error)

LoadConfig loads multiple config with given format from given source. input accepts: * string of a single filename/url(s) to open to read * []string slice of multiple filename/url(s) to open to read * io.Reader that reads a config content (the original way)

func (*Config) Descriptor deprecated 

func (*Config) Descriptor() ([]byte, []int)

Deprecated: Use Config.ProtoReflect.Descriptor instead.

func (*Config) GetApp 

func (x *Config) GetApp() []*anypb.Any

func (*Config) GetExtension 

func (x *Config) GetExtension() []*anypb.Any

func (*Config) GetInbound 

func (x *Config) GetInbound() []*InboundHandlerConfig

func (*Config) GetOutbound 

func (x *Config) GetOutbound() []*OutboundHandlerConfig

func (*Config) GetTransport deprecated 

func (x *Config) GetTransport() *transport.Config

Deprecated: Do not use.

func (*Config) ProtoMessage 

func (*Config) ProtoMessage()

func (*Config) ProtoReflect 

func (x *Config) ProtoReflect() protoreflect.Message

func (*Config) Reset 

func (x *Config) Reset()

func (*Config) String 

func (x *Config) String() string

type ConfigFormat 

type ConfigFormat struct {
	Name      []string
	Extension []string
	Loader    ConfigLoader
}

ConfigFormat is a configurable format of V2Ray config file.

type ConfigLoader 

type ConfigLoader func(input interface{}) (*Config, error)

ConfigLoader is a utility to load V2Ray config from external source.

type InboundHandlerConfig 

type InboundHandlerConfig struct {

	// Tag of the inbound handler. The tag must be unique among all inbound
	// handlers
	Tag string `protobuf:"bytes,1,opt,name=tag,proto3" json:"tag,omitempty"`
	// Settings for how this inbound proxy is handled.
	ReceiverSettings *anypb.Any `protobuf:"bytes,2,opt,name=receiver_settings,json=receiverSettings,proto3" json:"receiver_settings,omitempty"`
	// Settings for inbound proxy. Must be one of the inbound proxies.
	ProxySettings *anypb.Any `protobuf:"bytes,3,opt,name=proxy_settings,json=proxySettings,proto3" json:"proxy_settings,omitempty"`
	// contains filtered or unexported fields
}

InboundHandlerConfig is the configuration for inbound handler.

func (*InboundHandlerConfig) Descriptor deprecated 

func (*InboundHandlerConfig) Descriptor() ([]byte, []int)

Deprecated: Use InboundHandlerConfig.ProtoReflect.Descriptor instead.

func (*InboundHandlerConfig) GetProxySettings 

func (x *InboundHandlerConfig) GetProxySettings() *anypb.Any

func (*InboundHandlerConfig) GetReceiverSettings 

func (x *InboundHandlerConfig) GetReceiverSettings() *anypb.Any

func (*InboundHandlerConfig) GetTag 

func (x *InboundHandlerConfig) GetTag() string

func (*InboundHandlerConfig) ProtoMessage 

func (*InboundHandlerConfig) ProtoMessage()

func (*InboundHandlerConfig) ProtoReflect 

func (x *InboundHandlerConfig) ProtoReflect() protoreflect.Message

func (*InboundHandlerConfig) Reset 

func (x *InboundHandlerConfig) Reset()

func (*InboundHandlerConfig) String 

func (x *InboundHandlerConfig) String() string

type Instance 

type Instance struct {
	// contains filtered or unexported fields
}

Instance combines all functionalities in V2Ray.

func FromContext 

func FromContext(ctx context.Context) *Instance

FromContext returns an Instance from the given context, or nil if the context doesn't contain one.

func MustFromContext 

func MustFromContext(ctx context.Context) *Instance

MustFromContext returns an Instance from the given context, or panics if not present.

func New 

func New(config *Config) (*Instance, error)

New returns a new V2Ray instance based on given configuration. The instance is not started at this point. To ensure V2Ray instance works properly, the config must contain one Dispatcher, one InboundHandlerManager and one OutboundHandlerManager. Other features are optional.

func NewWithContext 

func NewWithContext(ctx context.Context, config *Config) (*Instance, error)

func StartInstance 

func StartInstance(configFormat string, configBytes []byte) (*Instance, error)

StartInstance starts a new V2Ray instance with given serialized config. By default V2Ray only support config in protobuf format, i.e., configFormat = "protobuf". Caller need to load other packages to add JSON support.

v2ray:api:stable

func (*Instance) AddFeature 

func (s *Instance) AddFeature(feature features.Feature) error

AddFeature registers a feature into current Instance.

func (*Instance) Close 

func (s *Instance) Close() error

Close shutdown the V2Ray instance.

func (*Instance) GetFeature 

func (s *Instance) GetFeature(featureType interface{}) features.Feature

GetFeature returns a feature of the given type, or nil if such feature is not registered.

func (*Instance) RequireFeatures 

func (s *Instance) RequireFeatures(callback interface{}) error

RequireFeatures registers a callback, which will be called when all dependent features are registered. The callback must be a func(). All its parameters must be features.Feature.

func (*Instance) Start 

func (s *Instance) Start() error

Start starts the V2Ray instance, including all registered features. When Start returns error, the state of the instance is unknown. A V2Ray instance can be started only once. Upon closing, the instance is not guaranteed to start again.

v2ray:api:stable

func (*Instance) Type 

func (s *Instance) Type() interface{}

Type implements common.HasType.

type OutboundHandlerConfig 

type OutboundHandlerConfig struct {

	// Tag of this outbound handler.
	Tag string `protobuf:"bytes,1,opt,name=tag,proto3" json:"tag,omitempty"`
	// Settings for how to dial connection for this outbound handler.
	SenderSettings *anypb.Any `protobuf:"bytes,2,opt,name=sender_settings,json=senderSettings,proto3" json:"sender_settings,omitempty"`
	// Settings for this outbound proxy. Must be one of the outbound proxies.
	ProxySettings *anypb.Any `protobuf:"bytes,3,opt,name=proxy_settings,json=proxySettings,proto3" json:"proxy_settings,omitempty"`
	// If not zero, this outbound will be expired in seconds. Not used for now.
	Expire int64 `protobuf:"varint,4,opt,name=expire,proto3" json:"expire,omitempty"`
	// Comment of this outbound handler. Not used for now.
	Comment string `protobuf:"bytes,5,opt,name=comment,proto3" json:"comment,omitempty"`
	// contains filtered or unexported fields
}

OutboundHandlerConfig is the configuration for outbound handler.

func (*OutboundHandlerConfig) Descriptor deprecated 

func (*OutboundHandlerConfig) Descriptor() ([]byte, []int)

Deprecated: Use OutboundHandlerConfig.ProtoReflect.Descriptor instead.

func (*OutboundHandlerConfig) GetComment 

func (x *OutboundHandlerConfig) GetComment() string

func (*OutboundHandlerConfig) GetExpire 

func (x *OutboundHandlerConfig) GetExpire() int64

func (*OutboundHandlerConfig) GetProxySettings 

func (x *OutboundHandlerConfig) GetProxySettings() *anypb.Any

func (*OutboundHandlerConfig) GetSenderSettings 

func (x *OutboundHandlerConfig) GetSenderSettings() *anypb.Any

func (*OutboundHandlerConfig) GetTag 

func (x *OutboundHandlerConfig) GetTag() string

func (*OutboundHandlerConfig) ProtoMessage 

func (*OutboundHandlerConfig) ProtoMessage()

func (*OutboundHandlerConfig) ProtoReflect 

func (x *OutboundHandlerConfig) ProtoReflect() protoreflect.Message

func (*OutboundHandlerConfig) Reset 

func (x *OutboundHandlerConfig) Reset()

func (*OutboundHandlerConfig) String 

func (x *OutboundHandlerConfig) String() string

type Server 

type Server interface {
	common.Runnable
}

Server is an instance of V2Ray. At any time, there must be at most one Server instance running.

Source Files

View all Source files

Directories

Path Synopsis
app
Package app contains feature implementations of V2Ray.
 Package app contains feature implementations of V2Ray.
browserforwarder
commander
dispatcher
dns
Package dns is an implementation of core.DNS feature.
 Package dns is an implementation of core.DNS feature.
dns/fakedns
instman
instman/command
log
log/command
observatory
observatory/burst
observatory/command
observatory/multiobservatory
policy
Package policy is an implementation of policy.Manager feature.
 Package policy is an implementation of policy.Manager feature.
proxyman
proxyman/command
proxyman/inbound
proxyman/outbound
restfulapi
reverse
router
router/command
router/routercommon
stats
stats/command
Package common contains common utilities that are shared among other packages.
 Package common contains common utilities that are shared among other packages.
antireplay
bitmask
buf
Package buf provides a light-weight memory allocation mechanism.
 Package buf provides a light-weight memory allocation mechanism.
bytespool
cache
cmdarg
crypto
Package crypto provides common crypto libraries for V2Ray.
 Package crypto provides common crypto libraries for V2Ray.
crypto/internal
dice
Package dice contains common functions to generate random number.
 Package dice contains common functions to generate random number.
drain
environment
environment/envctx
environment/envimpl
environment/filesystemcap
environment/transientstorageimpl
errors
Package errors is a drop-in replacement for Golang lib 'errors'.
 Package errors is a drop-in replacement for Golang lib 'errors'.
errors/errorgen
log
mux
net
Package net is a drop-in replacement to Golang's net package, with some more functionalities.
 Package net is a drop-in replacement to Golang's net package, with some more functionalities.
net/packetaddr
peer
platform
platform/ctlcmd
platform/filesystem
platform/filesystem/fsifce
platform/securedload
protocol
protocol/bittorrent
protocol/dns
protocol/http
protocol/quic
protocol/tls
protocol/tls/cert
protocol/udp
protoext
protoext/testing
protofilter
registry
retry
serial
session
Package session provides functions for sessions of incoming requests.
 Package session provides functions for sessions of incoming requests.
signal
signal/done
signal/pubsub
signal/semaphore
strmatcher
taggedfeatures
task
units
uuid
dns
dns/localdns
extension
extension/storage
inbound
outbound
policy
routing
routing/dns
routing/session
stats
infra
conf/cfgcommon
conf/cfgcommon/duration
conf/cfgcommon/loader
conf/cfgcommon/muxcfg
conf/cfgcommon/proxycfg
conf/cfgcommon/sniffer
conf/cfgcommon/socketcfg
conf/cfgcommon/testassist
conf/cfgcommon/tlscfg
conf/geodata
conf/geodata/memconservative
conf/geodata/standard
conf/json
conf/jsonpb
conf/merge
Package merge provides the capability to merge multiple JSON files or contents into one output.
 Package merge provides the capability to merge multiple JSON files or contents into one output.
conf/mergers
conf/rule
conf/serial
conf/synthetic/dns
conf/synthetic/log
conf/synthetic/router
conf/v2jsonpb
conf/v4
conf/v5cfg
vformat
vprotogen
commands
commands/all
commands/all/api
commands/all/api/jsonv4
commands/all/engineering
commands/all/jsonv4
commands/all/tls
commands/base
Package base defines shared basic pieces of the commands, in particular logging and the Command structure.
 Package base defines shared basic pieces of the commands, in particular logging and the Command structure.
commands/helpers
distro/all
distro/debug
formats
v2binding
v2binding/v2api
Package proxy contains all proxies used by V2Ray.
 Package proxy contains all proxies used by V2Ray.
blackhole
Package blackhole is an outbound handler that blocks all connections.
 Package blackhole is an outbound handler that blocks all connections.
dns
dokodemo
freedom
http
http/simplified
loopback
shadowsocks
Package shadowsocks provides compatible functionality to Shadowsocks.
 Package shadowsocks provides compatible functionality to Shadowsocks.
shadowsocks/simplified
socks
Package socks provides implements of Socks protocol 4, 4a and 5.
 Package socks provides implements of Socks protocol 4, 4a and 5.
socks/simplified
trojan
trojan/simplified
vless
Package vless contains the implementation of VLess protocol and transportation.
 Package vless contains the implementation of VLess protocol and transportation.
vless/encoding
vless/inbound
vless/outbound
vlite
Package vlite contains the integration code for VLite protocol variety
 Package vlite contains the integration code for VLite protocol variety
vlite/inbound
vlite/outbound
vmess
Package vmess contains the implementation of VMess protocol and transportation.
 Package vmess contains the implementation of VMess protocol and transportation.
vmess/aead
vmess/encoding
vmess/inbound
vmess/outbound
testing
mocks
Package mocks is a generated GoMock package.
 Package mocks is a generated GoMock package.
scenarios
servers/http
servers/tcp
servers/udp
internet
internet/domainsocket
internet/grpc
internet/grpc/encoding
internet/headers/http
internet/headers/noop
internet/headers/srtp
internet/headers/tls
internet/headers/utp
internet/headers/wechat
internet/headers/wireguard
internet/http
internet/kcp
Package kcp - A Fast and Reliable ARQ Protocol
 Package kcp - A Fast and Reliable ARQ Protocol
internet/quic
internet/security
internet/tagged
internet/tagged/taggedimpl
internet/tcp
internet/tls
internet/tls/utls
internet/udp
internet/websocket
Package websocket implements Websocket transport
 Package websocket implements Websocket transport
pipe

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.