mirror
/
gost
mirror of https://github.com/go-gost/gost.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
GO Simple Tunnel - a simple tunnel written in golang
500 Commits
1 Branch
34 Tags
25 MiB
Go 78.9%
Python 16.1%
Makefile 2.4%
Shell 1.9%
Dockerfile 0.7%
 
 
 
 
 
Go to file
ginuerzh 43724a5c40 test: add http2 handler e2e suite and tighten host-mapper + idle-timeout tests 
Add tests/e2e/http2_test.go covering the http2 handler/listener/connector/dialer
end-to-end through the canonical gost-as-client pattern (8 subtests: forward,
auth, bypass, probeResist/metadata, h2 stream multiplexing). Include
testdata/http2/{server,server_auth,server_bypass,server_proberesist,client,
client_auth}.yaml. Note that h2/h2c listeners pair with the tunnel handler
and only http2 listener pairs with handler http2 (reads r/w from metadata).

Tighten TestDNSHostMapper by pointing the handler at an unreachable upstream
so unmapped names fail at the exchanger, confirming the host-mapper path was
the sole reason mapped names resolved. Fix http_idle_timeout.py to speak HTTP
through the CONNECT tunnel rather than a raw ping, matching the echo backend.

Co-Authored-By: Claude <noreply@anthropic.com>
 		2026-06-27 20:15:31 +08:00
.github/workflows ci: harden docker/release/nightly GitHub Actions workflows 2026-06-19 19:11:25 +08:00
cmd/gost fix: use atomic int for multi-worker exit code and clean up cancellation 2026-06-21 21:07:37 +08:00
tests/e2e test: add http2 handler e2e suite and tighten host-mapper + idle-timeout tests 2026-06-27 20:15:31 +08:00
.gitignore bump x to v0.10.1, go-shadowsocks2 to v0.1.3; add gost binary to .gitignore 2026-05-22 23:21:30 +08:00
.goreleaser.yaml fix: disable UPX compression to resolve #863 startup regression 2026-05-31 22:25:57 +08:00
CLAUDE.md add CLAUDE.md with build, CLI, and lifecycle documentation 2026-05-23 00:00:56 +08:00
Dockerfile fix: disable UPX compression in Dockerfile to resolve #863 startup regression 2026-06-03 00:13:58 +08:00
LICENSE add license 2021-07-06 09:52:51 +08:00
Makefile add support for linux/amd64v3, windows/amd64v3 2022-10-07 09:27:22 +08:00
README.md add proxyProtocol support for dialer 2025-08-03 15:38:57 +08:00
README_en.md add context for conn 2025-08-04 19:34:54 +08:00
go.mod chore(deps): bump go-gost/x to v0.12.5 2026-06-26 20:21:42 +08:00
go.sum chore(deps): bump go-gost/x to v0.12.5 2026-06-26 20:21:42 +08:00
gost.yml add hop 2022-09-22 18:59:56 +08:00
install.sh Update install.sh 2026-04-26 22:16:06 +08:00

README_en.md

GO Simple Tunnel

A simple security tunnel written in golang

en zh

Features

Overview

Overview

There are three main ways to use GOST as a tunnel.

Proxy

As a proxy service to access the network, multiple protocols can be used in combination to form a forwarding chain for traffic forwarding.

Proxy

Port Forwarding

Mapping the port of one service to the port of another service, you can also use a combination of multiple protocols to form a forwarding chain for traffic forwarding.

Forward

Reverse Proxy

Use tunnel and intranet penetration to expose local services behind NAT or firewall to public network for access.

Reverse Proxy

Installation

Binary files

https://github.com/go-gost/gost/releases

install script

# install latest from [https://github.com/go-gost/gost/releases](https://github.com/go-gost/gost/releases)
bash <(curl -fsSL https://github.com/go-gost/gost/raw/master/install.sh) --install

# select version for install 
bash <(curl -fsSL https://github.com/go-gost/gost/raw/master/install.sh)

From source

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

Docker

docker run --rm gogost/gost -V

Tools

GUI

go-gost/gostctl

WebUI

go-gost/gost-ui

Shadowsocks Android

hamid-nazari/ShadowsocksGostPlugin

Support

Wiki: https://gost.run

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

Telegram: https://t.me/gogost

Google group: https://groups.google.com/d/forum/go-gost

Legacy version: v2.gost.run