2016-01-01 17:44:11 -05:00
|
|
|
// Package proxy contains all proxies used by V2Ray.
|
2017-02-13 16:11:36 -05:00
|
|
|
//
|
|
|
|
// To implement an inbound or outbound proxy, one needs to do the following:
|
|
|
|
// 1. Implement the interface(s) below.
|
|
|
|
// 2. Register a config creator through common.RegisterConfig.
|
2016-08-19 11:05:15 -04:00
|
|
|
package proxy
|
2016-01-01 17:44:11 -05:00
|
|
|
|
|
|
|
import (
|
2017-01-14 18:17:06 -05:00
|
|
|
"context"
|
|
|
|
|
2017-01-13 18:27:45 -05:00
|
|
|
"v2ray.com/core/common/net"
|
2018-02-05 17:38:24 -05:00
|
|
|
"v2ray.com/core/common/protocol"
|
2018-10-11 14:43:37 -04:00
|
|
|
"v2ray.com/core/features/routing"
|
2018-11-03 07:36:29 -04:00
|
|
|
"v2ray.com/core/transport"
|
2016-08-20 14:55:45 -04:00
|
|
|
"v2ray.com/core/transport/internet"
|
2016-01-01 17:44:11 -05:00
|
|
|
)
|
|
|
|
|
2017-01-26 14:57:18 -05:00
|
|
|
// An Inbound processes inbound connections.
|
|
|
|
type Inbound interface {
|
2017-02-13 07:13:21 -05:00
|
|
|
// Network returns a list of network that this inbound supports. Connections with not-supported networks will not be passed into Process().
|
2017-01-14 18:57:06 -05:00
|
|
|
Network() net.NetworkList
|
2017-01-26 14:46:44 -05:00
|
|
|
|
2017-02-13 07:13:21 -05:00
|
|
|
// Process processes a connection of given network. If necessary, the Inbound can dispatch the connection to an Outbound.
|
2018-10-11 14:43:37 -04:00
|
|
|
Process(context.Context, net.Network, internet.Connection, routing.Dispatcher) error
|
2016-01-01 17:44:11 -05:00
|
|
|
}
|
|
|
|
|
2017-01-26 14:57:18 -05:00
|
|
|
// An Outbound process outbound connections.
|
|
|
|
type Outbound interface {
|
2017-02-13 07:13:21 -05:00
|
|
|
// Process processes the given connection. The given dialer may be used to dial a system outbound connection.
|
2018-11-03 07:36:29 -04:00
|
|
|
Process(context.Context, *transport.Link, internet.Dialer) error
|
2017-01-14 18:17:06 -05:00
|
|
|
}
|
2018-02-05 17:38:24 -05:00
|
|
|
|
|
|
|
// UserManager is the interface for Inbounds and Outbounds that can manage their users.
|
|
|
|
type UserManager interface {
|
|
|
|
// AddUser adds a new user.
|
2018-08-26 18:11:32 -04:00
|
|
|
AddUser(context.Context, *protocol.MemoryUser) error
|
2018-02-05 17:38:24 -05:00
|
|
|
|
2018-04-02 03:17:36 -04:00
|
|
|
// RemoveUser removes a user by email.
|
2018-02-05 17:38:24 -05:00
|
|
|
RemoveUser(context.Context, string) error
|
|
|
|
}
|
|
|
|
|
|
|
|
type GetInbound interface {
|
|
|
|
GetInbound() Inbound
|
|
|
|
}
|
|
|
|
|
|
|
|
type GetOutbound interface {
|
|
|
|
GetOutbound() Outbound
|
2018-02-05 17:39:04 -05:00
|
|
|
}
|