proxy

Documentation

Overview

Package proxy provides parser utilities for various VPN proxy URLs (Shadowsocks, VMess, VLESS, Trojan). It has zero heavy dependencies and maps directly to the model.ProxyNode structure.

Index

• func DecodeIfBase64(raw string) string
• func Format(node *model.ProxyNode) (*url.URL, error)
• func FormatString(node *model.ProxyNode) (string, error)
• type Formatter
  • func NewFormatter() *Formatter
  • func (f *Formatter) Format(node *model.ProxyNode) (*url.URL, error)
  • func (f *Formatter) FormatString(node *model.ProxyNode) (string, error)
• type Parser
  • func NewParser() *Parser
  • func (p *Parser) Parse(proxyURL string) (*model.ProxyNode, error)

Functions

func DecodeIfBase64

func DecodeIfBase64(raw string) string

DecodeIfBase64 checks if the input is a base64-encoded proxy URL and decodes it. If the input is already a plaintext proxy URL or cannot be decoded to one, it is returned as is.

func Format

func Format(node *model.ProxyNode) (*url.URL, error)

Format is a package-level helper that converts a model.ProxyNode into a *url.URL.

func FormatString

func FormatString(node *model.ProxyNode) (string, error)

FormatString is a package-level helper that converts a model.ProxyNode into its string URL representation.

Types

type Formatter

type Formatter struct{}

Formatter serializes a model.ProxyNode into a valid proxy URL.

func NewFormatter

func NewFormatter() *Formatter

NewFormatter creates a new Formatter instance.

func (*Formatter) Format

func (f *Formatter) Format(node *model.ProxyNode) (*url.URL, error)

Format converts a model.ProxyNode into a *url.URL structure.

func (*Formatter) FormatString

func (f *Formatter) FormatString(node *model.ProxyNode) (string, error)

FormatString converts a model.ProxyNode into its string URL representation.

type Parser

type Parser struct{}

Parser provides native proxy URL parsing without external dependencies.

func NewParser

func NewParser() *Parser

NewParser creates a new Parser instance.

func (*Parser) Parse

func (p *Parser) Parse(proxyURL string) (*model.ProxyNode, error)

Parse parses a proxy URL string into a ProxyNode. Supported schemes are: ss://, vmess://, vless://, and trojan://. If the proxyURL is base64-encoded, it will be automatically decoded.