Skip to content

lovitus/gust

 
 

Repository files navigation

Gust

Fork of go-gost/gost v3.2.6 with SSH relay fallback enhancements. Implementation module: lovitus/gust-x (fork of go-gost/x v0.8.1)

Additional Features (vs upstream)

  • Porty Stealth Port Forwarding - Disguises TCP port forwarding as normal HTTPS/WebSocket traffic with AEAD authentication, smux session caching, multi-port mixed-role sessions, optional P2P direct mode, dynamic bindpath WS bridge for Mihomo/iOS, and the standalone portyd server.
  • SSH Relay Fallback - When SSH server disables TCP forwarding (AllowTcpForwarding=no), automatically falls back through multiplexed relay, embedded relay binary, or exec-based tools (nc/socat/perl/python/bash). Original direct-tcpip is always prioritized.
  • Multiplexed Relay - Single SSH exec session handles unlimited TCP connections via mux protocol, bypassing MaxSessions limits.
  • Smart Relay Upload - Embedded relay binary auto-uploaded to remote server, hash-cached (only transferred once per binary version).
  • Escape-Based Passwords - Supports backslash escapes and quotes in inline passwords (backward compatible with URL encoding).
  • Cross-Platform Builds - Pre-built binaries for 23 platform/arch combinations with UPX compression.

See FORK_CHANGES.md for detailed technical documentation and upstream merge notes. Full Porty documentation lives in gust-x docs/porty.md.


GO Simple Tunnel (Upstream)

GO语言实现的安全隧道

zh en

功能特性

概览

Overview

GOST作为隧道有三种主要使用方式。

正向代理

作为代理服务访问网络,可以组合使用多种协议组成转发链进行转发。

Proxy

端口转发

将一个服务的端口映射到另外一个服务的端口,同样可以组合使用多种协议组成转发链进行转发。

Forward

反向代理

利用隧道和内网穿透将内网服务暴露到公网访问。

Reverse Proxy

下载安装

包管理器

包管理器入口会在下一个稳定 tag 发布后自动生成和更新;维护者发布流程见 RELEASE.md

Homebrew (macOS/Linux)

brew tap lovitus/gust https://github.com/lovitus/gust
brew install gust
gost -V

Scoop (Windows)

scoop bucket add gust https://github.com/lovitus/gust
scoop install gust
gost -V

APT (Debian/Ubuntu amd64/arm64)

arch="$(dpkg --print-architecture)"
case "$arch" in amd64|arm64) ;; *) echo "unsupported APT arch: $arch" >&2; exit 1;; esac
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://lovitus.github.io/gust/apt/gust-archive-keyring.gpg \
  | sudo tee /etc/apt/keyrings/gust-archive-keyring.gpg >/dev/null
echo "deb [arch=$arch signed-by=/etc/apt/keyrings/gust-archive-keyring.gpg] https://lovitus.github.io/gust/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/gust.list >/dev/null
sudo apt update
sudo apt install gust

YUM/DNF (x86_64/aarch64)

sudo tee /etc/yum.repos.d/gust.repo >/dev/null <<'EOF'
[gust]
name=gust stable repository
baseurl=https://lovitus.github.io/gust/rpm/$basearch
enabled=1
repo_gpgcheck=1
gpgcheck=0
gpgkey=https://lovitus.github.io/gust/rpm/RPM-GPG-KEY-gust
EOF

sudo dnf install gust
# 或: sudo yum install gust

RPM 源当前签名的是仓库 metadata,暂不对单个 RPM 包签名,因此 repo 配置中使用 repo_gpgcheck=1gpgcheck=0

二进制文件

https://github.com/lovitus/gust/releases

安装脚本

# 安装最新版本
bash <(curl -fsSL https://raw.githubusercontent.com/lovitus/gust/master/install.sh) --install
# 选择要安装的版本
bash <(curl -fsSL https://raw.githubusercontent.com/lovitus/gust/master/install.sh)

源码编译

git clone https://github.com/lovitus/gust.git
cd gust/cmd/gost
go build

Docker

docker run --rm gogost/gost -V

工具

GUI

go-gost/gostctl

WebUI

go-gost/gost-ui

Shadowsocks Android插件

hamid-nazari/ShadowsocksGostPlugin

帮助与支持

Wiki站点:https://gost.run

YouTube: https://www.youtube.com/@gost-tunnel

Telegram:https://t.me/gogost

Google讨论组:https://groups.google.com/d/forum/go-gost

旧版入口:v2.gost.run

About

GO Simple Tunnel - a simple tunnel written in golang

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Go 54.0%
  • PowerShell 15.6%
  • Shell 13.4%
  • Makefile 11.1%
  • Ruby 3.9%
  • Dockerfile 2.0%