Skip to content

Commit 6ec6f6e

Browse files
shadowy-pycodershadowy-pycoder
committed
Initial commit for v1.0.0
0 parents  commit 6ec6f6e

File tree

10 files changed

+457
-0
lines changed

10 files changed

+457
-0
lines changed

‎.gitignore‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Binaries, plugins, libs
2+
*.dll
3+
*.dylib
4+
*.exe
5+
*.exe~
6+
*.so
7+
bin/
8+
9+
# Testing
10+
*.test
11+
*.tmp
12+
13+
# local
14+
.idea
15+
.DS_Store
16+
*.gob
17+
18+
# Environments
19+
.env
20+
.envrc
21+
env/
22+
ENV/
23+
env.bak/
24+
25+
# https/tls
26+
tls/
27+
28+
*.prof
29+
30+
# llm stuff
31+
models/**/*
32+
*.model
33+
*.vocab

‎LICENSE‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
MIT License
2+
3+
Copyright (c) 2025 shadowy-pycoder
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.
22+

‎Makefile‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
APP_NAME=gohpts
2+
TEST_FILE=${APP_NAME}.test
3+
4+
.PHONY: all
5+
all: build
6+
7+
.PHONY: build
8+
build:
9+
go build -ldflags "-s -w" -trimpath -o ./bin/${APP_NAME} ./cmd/${APP_NAME}/*.go
10+
11+
.PHONY: bench test
12+
bench:
13+
go test -bench=. -benchmem -run=^$$ -benchtime 512x -cpuprofile='cpu.prof' -memprofile='mem.prof'
14+
15+
.PHONY: clean
16+
clean:
17+
find ./bin ! -name '.gitignore' -type f -exec rm -vrf {} +
18+

‎README.md‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
# GoHPTS - HTTP proxy to SOCKS5 proxy written in Go
2+
3+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4+
[![Go Reference](https://pkg.go.dev/badge/github.com/shadowy-pycoder/go-http-proxy-to-socks.svg)](https://pkg.go.dev/github.com/shadowy-pycoder/go-http-proxy-to-socks)
5+
![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/shadowy-pycoder/go-http-proxy-to-socks)
6+
[![Go Report Card](https://goreportcard.com/badge/github.com/shadowy-pycoder/go-http-proxy-to-socks)](https://goreportcard.com/report/github.com/shadowy-pycoder/go-http-proxy-to-socks)
7+
![GitHub Release](https://img.shields.io/github/v/release/shadowy-pycoder/go-http-proxy-to-socks)
8+
![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/shadowy-pycoder/go-http-proxy-to-socks/total)
9+
10+
## Introduction
11+
12+
`GoHPTS` CLI tool is a bridge between HTTP clients and a SOCKS5 proxy server. It listens locally as an HTTP proxy, accepts standard HTTP
13+
or HTTPS (via CONNECT) requests and forwards the connection through a SOCKS5 proxy. Inspired by [http-proxy-to-socks](https://github.com/oyyd/http-proxy-to-socks)
14+
15+
Possible use case: you need to connect to external API via Postman, but this API only available from some remote server.
16+
The following commands will help you to perform such a task:
17+
18+
Create SOCKS5 proxy server via `ssh`:
19+
20+
```shell
21+
ssh <remote server> -D 1080 -Nf
22+
```
23+
24+
Create HTTP-to-SOCKS5 connection with `gohpts`
25+
26+
```shell
27+
gohpts -s :1080 -l :8080
28+
```
29+
30+
Specify http server in proxy configuration of Postman
31+
32+
## Installation
33+
34+
You can download the binary for your platform from [Releases](https://github.com/shadowy-pycoder/go-http-proxy-to-socks/releases) page.
35+
36+
Alternatively, you can install it using `go install` command (requires Go [1.24](https://go.dev/doc/install) or later):
37+
38+
```shell
39+
go install -ldflags "-s -w" -trimpath github.com/shadowy-pycoder/go-http-proxy-to-socks/cmd/gohpts@latest
40+
```
41+
42+
This will install the `gohpts` binary to your `$GOPATH/bin` directory.
43+
44+
Another alternative is to build from source:
45+
46+
```shell
47+
git clone https://github.com/shadowy-pycoder/go-http-proxy-to-socks.git
48+
cd go-http-proxy-to-socks
49+
make build
50+
./bin/gohpts
51+
```
52+
53+
## Usage
54+
55+
```shell
56+
gohpts -h
57+
58+
_____ _ _ _____ _______ _____
59+
/ ____| | | | | __ \__ __/ ____|
60+
| | __ ___ | |__| | |__) | | | | (___
61+
| | |_ |/ _ \| __ | ___/ | | \___ \
62+
| |__| | (_) | | | | | | | ____) |
63+
\_____|\___/|_| |_|_| |_| |_____/
64+
65+
GoHPTS (HTTP Proxy to SOCKS5) by shadowy-pycoder
66+
GitHub: https://github.com/shadowy-pycoder/go-http-proxy-to-socks
67+
68+
Usage: gohpts [OPTIONS]
69+
Options:
70+
-h Show this help message and exit.
71+
-d Show logs in DEBUG mode
72+
-j Show logs in JSON format
73+
-l value
74+
Address of HTTP proxy server (Default: localhost:8080)
75+
-s value
76+
Address of SOCKS5 proxy server (Default: localhost:1080)
77+
-v print version
78+
79+
```
80+
81+
## Example
82+
83+
```shell
84+
gohpts -s 1080 -l 8080 -d -j
85+
```
86+
87+
Output:
88+
89+
```shell
90+
{"level":"info","time":"2025-05-28T06:15:18+00:00","message":"SOCKS5 Proxy: :1080"}
91+
{"level":"info","time":"2025-05-28T06:15:18+00:00","message":"HTTP Proxy: :8080"}
92+
{"level":"debug","time":"2025-05-28T06:15:22+00:00","message":"HTTP/1.1 - CONNECT - www.google.com:443"}
93+
```
94+
95+
## License
96+
97+
MIT

‎cmd/gohpts/cli.go‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
package main
2+
3+
import (
4+
"flag"
5+
"fmt"
6+
"os"
7+
"strconv"
8+
9+
gohpts "github.com/shadowy-pycoder/go-http-proxy-to-socks"
10+
)
11+
12+
const (
13+
app string = "gohpts"
14+
addrSOCKS = ":1080"
15+
addrHTTP = ":8080"
16+
)
17+
const usagePrefix string = `
18+
_____ _ _ _____ _______ _____
19+
/ ____| | | | | __ \__ __/ ____|
20+
| | __ ___ | |__| | |__) | | | | (___
21+
| | |_ |/ _ \| __ | ___/ | | \___ \
22+
| |__| | (_) | | | | | | | ____) |
23+
\_____|\___/|_| |_|_| |_| |_____/
24+
25+
GoHPTS (HTTP Proxy to SOCKS5) by shadowy-pycoder
26+
GitHub: https://github.com/shadowy-pycoder/go-http-proxy-to-socks
27+
28+
Usage: gohpts [OPTIONS]
29+
Options:
30+
-h Show this help message and exit.
31+
`
32+
33+
func root(args []string) error {
34+
conf := gohpts.Config{AddrSOCKS: addrSOCKS, AddrHTTP: addrHTTP}
35+
flags := flag.NewFlagSet(app, flag.ExitOnError)
36+
flags.Func("s", "Address of SOCKS5 proxy server (Default: localhost:1080)", func(flagValue string) error {
37+
i, err := strconv.Atoi(flagValue)
38+
if err == nil {
39+
conf.AddrSOCKS = fmt.Sprintf(":%d", i)
40+
} else {
41+
conf.AddrSOCKS = flagValue
42+
}
43+
return nil
44+
})
45+
flags.Func("l", "Address of HTTP proxy server (Default: localhost:8080)", func(flagValue string) error {
46+
i, err := strconv.Atoi(flagValue)
47+
if err == nil {
48+
conf.AddrHTTP = fmt.Sprintf(":%d", i)
49+
} else {
50+
conf.AddrHTTP = flagValue
51+
}
52+
return nil
53+
})
54+
flags.BoolFunc("d", "Show logs in DEBUG mode", func(flagValue string) error {
55+
conf.Debug = true
56+
return nil
57+
})
58+
flags.BoolFunc("j", "Show logs in JSON format", func(flagValue string) error {
59+
conf.Json = true
60+
return nil
61+
})
62+
flags.BoolFunc("v", "print version", func(flagValue string) error {
63+
fmt.Println(gohpts.Version)
64+
os.Exit(0)
65+
return nil
66+
})
67+
68+
flags.Usage = func() {
69+
fmt.Print(usagePrefix)
70+
flags.PrintDefaults()
71+
}
72+
73+
if err := flags.Parse(args); err != nil {
74+
return err
75+
}
76+
app := gohpts.New(&conf)
77+
app.Run()
78+
return nil
79+
}

‎cmd/gohpts/main.go‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
package main
2+
3+
import (
4+
"fmt"
5+
"os"
6+
)
7+
8+
func main() {
9+
if err := root(os.Args[1:]); err != nil {
10+
fmt.Fprintf(os.Stderr, "%s: %v (type '%s help' for help)\n", app, err, app)
11+
os.Exit(2)
12+
}
13+
}

‎go.mod‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
module github.com/shadowy-pycoder/go-http-proxy-to-socks
2+
3+
go 1.24.1
4+
5+
require (
6+
github.com/rs/zerolog v1.34.0
7+
golang.org/x/net v0.40.0
8+
)
9+
10+
require (
11+
github.com/mattn/go-colorable v0.1.13 // indirect
12+
github.com/mattn/go-isatty v0.0.19 // indirect
13+
golang.org/x/sys v0.33.0 // indirect
14+
)

‎go.sum‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc=
2+
github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA=
3+
github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
4+
github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
5+
github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
6+
github.com/mattn/go-isatty v0.0.19 h1:JITubQf0MOLdlGRuRq+jtsDlekdYPia9ZFsB8h/APPA=
7+
github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
8+
github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
9+
github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0=
10+
github.com/rs/zerolog v1.34.0 h1:k43nTLIwcTVQAncfCw4KZ2VY6ukYoZaBPNOE8txlOeY=
11+
github.com/rs/zerolog v1.34.0/go.mod h1:bJsvje4Z08ROH4Nhs5iH600c3IkWhwp44iRc54W6wYQ=
12+
golang.org/x/net v0.40.0 h1:79Xs7wF06Gbdcg4kdCCIQArK11Z1hr5POQ6+fIYHNuY=
13+
golang.org/x/net v0.40.0/go.mod h1:y0hY0exeL2Pku80/zKK7tpntoX23cqL3Oa6njdgRtds=
14+
golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
15+
golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
16+
golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
17+
golang.org/x/sys v0.33.0 h1:q3i8TbbEz+JRD9ywIRlyRAQbM0qF7hu24q3teo2hbuw=
18+
golang.org/x/sys v0.33.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=

0 commit comments

Comments
 (0)