Highly-opinionated (ex-bullshit-free) MTPROTO proxy for Telegram. If you use v1.0 or upgrade broke you proxy, please read the chapter Version 2
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.

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357
  1. package mtglib
  2. import (
  3. "context"
  4. "errors"
  5. "fmt"
  6. "net"
  7. "strconv"
  8. "sync"
  9. "time"
  10. "github.com/9seconds/mtg/v2/essentials"
  11. "github.com/9seconds/mtg/v2/mtglib/internal/dc"
  12. "github.com/9seconds/mtg/v2/mtglib/internal/faketls"
  13. "github.com/9seconds/mtg/v2/mtglib/internal/faketls/record"
  14. "github.com/9seconds/mtg/v2/mtglib/internal/obfuscation"
  15. "github.com/9seconds/mtg/v2/mtglib/internal/relay"
  16. "github.com/panjf2000/ants/v2"
  17. )
  18. // Proxy is an MTPROTO proxy structure.
  19. type Proxy struct {
  20. ctx context.Context
  21. ctxCancel context.CancelFunc
  22. streamWaitGroup sync.WaitGroup
  23. allowFallbackOnUnknownDC bool
  24. tolerateTimeSkewness time.Duration
  25. domainFrontingPort int
  26. domainFrontingIP string
  27. workerPool *ants.PoolWithFunc
  28. telegram *dc.Telegram
  29. clientObfuscatror obfuscation.Obfuscator
  30. secret Secret
  31. network Network
  32. antiReplayCache AntiReplayCache
  33. blocklist IPBlocklist
  34. allowlist IPBlocklist
  35. eventStream EventStream
  36. logger Logger
  37. }
  38. // DomainFrontingAddress returns a host:port pair for a fronting domain.
  39. // If DomainFrontingIP is set, it is used instead of resolving the hostname.
  40. func (p *Proxy) DomainFrontingAddress() string {
  41. host := p.secret.Host
  42. if p.domainFrontingIP != "" {
  43. host = p.domainFrontingIP
  44. }
  45. return net.JoinHostPort(host, strconv.Itoa(p.domainFrontingPort))
  46. }
  47. // ServeConn serves a connection. We do not check IP blocklist and concurrency
  48. // limit here.
  49. func (p *Proxy) ServeConn(conn essentials.Conn) {
  50. p.streamWaitGroup.Add(1)
  51. defer p.streamWaitGroup.Done()
  52. ctx := newStreamContext(p.ctx, p.logger, conn)
  53. defer ctx.Close()
  54. go func() {
  55. <-ctx.Done()
  56. ctx.Close()
  57. }()
  58. p.eventStream.Send(ctx, NewEventStart(ctx.streamID, ctx.ClientIP()))
  59. ctx.logger.Info("Stream has been started")
  60. defer func() {
  61. p.eventStream.Send(ctx, NewEventFinish(ctx.streamID))
  62. ctx.logger.Info("Stream has been finished")
  63. }()
  64. if !p.doFakeTLSHandshake(ctx) {
  65. return
  66. }
  67. if err := p.doObfuscatedHandshake(ctx); err != nil {
  68. p.logger.InfoError("obfuscated handshake is failed", err)
  69. return
  70. }
  71. if err := p.doTelegramCall(ctx); err != nil {
  72. p.logger.WarningError("cannot dial to telegram", err)
  73. return
  74. }
  75. relay.Relay(
  76. ctx,
  77. ctx.logger.Named("relay"),
  78. ctx.telegramConn,
  79. ctx.clientConn,
  80. )
  81. }
  82. // Serve starts a proxy on a given listener.
  83. func (p *Proxy) Serve(listener net.Listener) error {
  84. p.streamWaitGroup.Add(1)
  85. defer p.streamWaitGroup.Done()
  86. for {
  87. conn, err := listener.Accept()
  88. if err != nil {
  89. select {
  90. case <-p.ctx.Done():
  91. return nil
  92. default:
  93. return fmt.Errorf("cannot accept a new connection: %w", err)
  94. }
  95. }
  96. ipAddr := conn.RemoteAddr().(*net.TCPAddr).IP //nolint: forcetypeassert
  97. logger := p.logger.BindStr("ip", ipAddr.String())
  98. if !p.allowlist.Contains(ipAddr) {
  99. conn.Close() //nolint: errcheck
  100. logger.Info("ip was rejected by allowlist")
  101. p.eventStream.Send(p.ctx, NewEventIPAllowlisted(ipAddr))
  102. continue
  103. }
  104. if p.blocklist.Contains(ipAddr) {
  105. conn.Close() //nolint: errcheck
  106. logger.Info("ip was blacklisted")
  107. p.eventStream.Send(p.ctx, NewEventIPBlocklisted(ipAddr))
  108. continue
  109. }
  110. err = p.workerPool.Invoke(conn)
  111. switch {
  112. case err == nil:
  113. case errors.Is(err, ants.ErrPoolClosed):
  114. return nil
  115. case errors.Is(err, ants.ErrPoolOverload):
  116. logger.Info("connection was concurrency limited")
  117. p.eventStream.Send(p.ctx, NewEventConcurrencyLimited())
  118. }
  119. }
  120. }
  121. // Shutdown 'gracefully' shutdowns all connections. Please remember that it
  122. // does not close an underlying listener.
  123. func (p *Proxy) Shutdown() {
  124. p.ctxCancel()
  125. p.streamWaitGroup.Wait()
  126. p.workerPool.Release()
  127. p.allowlist.Shutdown()
  128. p.blocklist.Shutdown()
  129. }
  130. func (p *Proxy) doFakeTLSHandshake(ctx *streamContext) bool {
  131. rec := record.AcquireRecord()
  132. defer record.ReleaseRecord(rec)
  133. rewind := newConnRewind(ctx.clientConn)
  134. if err := rec.Read(rewind); err != nil {
  135. p.logger.InfoError("cannot read client hello", err)
  136. p.doDomainFronting(ctx, rewind)
  137. return false
  138. }
  139. hello, err := faketls.ParseClientHello(p.secret.Key[:], rec.Payload.Bytes())
  140. if err != nil {
  141. p.logger.InfoError("cannot parse client hello", err)
  142. p.doDomainFronting(ctx, rewind)
  143. return false
  144. }
  145. if err := hello.Valid(p.secret.Host, p.tolerateTimeSkewness); err != nil {
  146. p.logger.
  147. BindStr("hostname", hello.Host).
  148. BindStr("hello-time", hello.Time.String()).
  149. InfoError("invalid faketls client hello", err)
  150. p.doDomainFronting(ctx, rewind)
  151. return false
  152. }
  153. if p.antiReplayCache.SeenBefore(hello.SessionID) {
  154. p.logger.Warning("replay attack has been detected!")
  155. p.eventStream.Send(p.ctx, NewEventReplayAttack(ctx.streamID))
  156. p.doDomainFronting(ctx, rewind)
  157. return false
  158. }
  159. if err := faketls.SendWelcomePacket(rewind, p.secret.Key[:], hello); err != nil {
  160. p.logger.InfoError("cannot send welcome packet", err)
  161. return false
  162. }
  163. ctx.clientConn = &faketls.Conn{
  164. Conn: ctx.clientConn,
  165. }
  166. return true
  167. }
  168. func (p *Proxy) doObfuscatedHandshake(ctx *streamContext) error {
  169. dc, conn, err := p.clientObfuscatror.ReadHandshake(ctx.clientConn)
  170. if err != nil {
  171. return fmt.Errorf("cannot process client handshake: %w", err)
  172. }
  173. ctx.dc = dc
  174. ctx.clientConn = conn
  175. ctx.logger = ctx.logger.BindInt("dc", dc)
  176. return nil
  177. }
  178. func (p *Proxy) doTelegramCall(ctx *streamContext) error {
  179. dcid := ctx.dc
  180. addresses := p.telegram.GetAddresses(dcid)
  181. if len(addresses) == 0 && p.allowFallbackOnUnknownDC {
  182. ctx.logger = ctx.logger.BindInt("original_dc", dcid)
  183. ctx.logger.Warning("unknown DC, fallbacks")
  184. ctx.dc = dc.DefaultDC
  185. addresses = p.telegram.GetAddresses(dc.DefaultDC)
  186. }
  187. var (
  188. conn essentials.Conn
  189. err error
  190. foundAddr dc.Addr
  191. )
  192. for _, addr := range addresses {
  193. conn, err = p.network.Dial(addr.Network, addr.Address)
  194. if err == nil {
  195. foundAddr = addr
  196. break
  197. }
  198. }
  199. if err != nil {
  200. return fmt.Errorf("no addresses to call: %w", err)
  201. }
  202. tgConn, err := foundAddr.Obfuscator.SendHandshake(conn, ctx.dc)
  203. if err != nil {
  204. conn.Close() // nolint: errcheck
  205. return fmt.Errorf("cannot perform server handshake: %w", err)
  206. }
  207. ctx.telegramConn = connTraffic{
  208. Conn: tgConn,
  209. streamID: ctx.streamID,
  210. stream: p.eventStream,
  211. ctx: ctx,
  212. }
  213. p.eventStream.Send(ctx,
  214. NewEventConnectedToDC(ctx.streamID,
  215. conn.RemoteAddr().(*net.TCPAddr).IP, //nolint: forcetypeassert
  216. ctx.dc),
  217. )
  218. return nil
  219. }
  220. func (p *Proxy) doDomainFronting(ctx *streamContext, conn *connRewind) {
  221. p.eventStream.Send(p.ctx, NewEventDomainFronting(ctx.streamID))
  222. conn.Rewind()
  223. frontConn, err := p.network.DialContext(ctx, "tcp", p.DomainFrontingAddress())
  224. if err != nil {
  225. p.logger.WarningError("cannot dial to the fronting domain", err)
  226. return
  227. }
  228. frontConn = connTraffic{
  229. Conn: frontConn,
  230. ctx: ctx,
  231. streamID: ctx.streamID,
  232. stream: p.eventStream,
  233. }
  234. relay.Relay(
  235. ctx,
  236. ctx.logger.Named("domain-fronting"),
  237. frontConn,
  238. conn,
  239. )
  240. }
  241. // NewProxy makes a new proxy instance.
  242. func NewProxy(opts ProxyOpts) (*Proxy, error) {
  243. if err := opts.valid(); err != nil {
  244. return nil, fmt.Errorf("invalid settings: %w", err)
  245. }
  246. tg, err := dc.New(opts.getPreferIP())
  247. if err != nil {
  248. return nil, fmt.Errorf("cannot build telegram dc fetcher: %w", err)
  249. }
  250. ctx, cancel := context.WithCancel(context.Background())
  251. logger := opts.getLogger("proxy")
  252. updatersLogger := logger.Named("telegram-updaters")
  253. proxy := &Proxy{
  254. ctx: ctx,
  255. ctxCancel: cancel,
  256. secret: opts.Secret,
  257. network: opts.Network,
  258. antiReplayCache: opts.AntiReplayCache,
  259. blocklist: opts.IPBlocklist,
  260. allowlist: opts.IPAllowlist,
  261. eventStream: opts.EventStream,
  262. logger: logger,
  263. domainFrontingPort: opts.getDomainFrontingPort(),
  264. domainFrontingIP: opts.DomainFrontingIP,
  265. tolerateTimeSkewness: opts.getTolerateTimeSkewness(),
  266. allowFallbackOnUnknownDC: opts.AllowFallbackOnUnknownDC,
  267. telegram: tg,
  268. clientObfuscatror: obfuscation.Obfuscator{
  269. Secret: opts.Secret.Key[:],
  270. },
  271. }
  272. publicConfigUpdater := dc.NewPublicConfigUpdater(
  273. tg,
  274. updatersLogger.Named("public-config"),
  275. opts.Network.MakeHTTPClient(nil),
  276. )
  277. go publicConfigUpdater.Run(ctx, dc.PublicConfigUpdateURLv4, "tcp4")
  278. go publicConfigUpdater.Run(ctx, dc.PublicConfigUpdateURLv6, "tcp6")
  279. pool, err := ants.NewPoolWithFunc(opts.getConcurrency(),
  280. func(arg any) {
  281. proxy.ServeConn(arg.(essentials.Conn)) //nolint: forcetypeassert
  282. },
  283. ants.WithLogger(opts.getLogger("ants")),
  284. ants.WithNonblocking(true))
  285. if err != nil {
  286. panic(err)
  287. }
  288. proxy.workerPool = pool
  289. return proxy, nil
  290. }