socksproxy

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 22 Open GitHub ↗

Simple SOCKS proxy via SSH and iptables

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

socksproxy
----------

sockproxy is a simple script to run a [SOCKS proxy](http://en.wikipedia.org/wiki/SOCKS) on your own server. It is merely a wrapper script to orchestrate `ssh` and `iptables` properly to make it easier in everyday use.

What is socksproxy?
-------------------
Much like a regular HTTP(S) proxy, a SOCKS proxy can be used to redirect/tunnel traffic through a certain server. This is useful if you want to circumvent country or content-based Internet filtering or access blocked content, e.g., by governments, workplaces, schools, and country-specific web services. Unlike HTTP(S) proxies, however, SOCKS operates on a lower level and can hence also used for other protocols (e.g. FTP, SMTP, ..).

**Without socksproxy**, the Internet is potentially blocked/filtered by the ISP:

![Without socksproxy](https://raw.githubusercontent.com/binwiederhier/socksproxy/master/images/without-socksproxy.png)

**With socksproxy** (running on a machine without filtered access), all traffic is tunneled to through socksproxy and filters are circumvented:

![With socksproxy](https://raw.githubusercontent.com/binwiederhier/socksproxy/master/images/with-socksproxy.png)

Installation
------------
Dependencies are *openssh-server* and *iptables*, so be sure to have those installed.

**Debian-based systems:**   
1. Either download a `.deb`-file from the [release page](https://github.com/binwiederhier/socksproxy/releases)   
2. Or: Add my [Debian/APT archive](http://archive.philippheckel.com/apt/):

```bash
wget -qO - http://archive.philippheckel.com/apt/Release.key | sudo apt-key add -
sudo sh -c "echo deb http://archive.philippheckel.com/apt/release/ release main > /etc/apt/sources.list.d/archive.philippheckel.com.list"
sudo apt-get update
sudo apt-get install socksproxy
```

**Other Linux systems:**
Manually install it like this:
```bash
$ sudo make install
$ sudo make uninstall # To remove
```

Usage
-----
Edit the config file at `/etc/socksproxy.conf` and add the allowed IP addresses and (if you like) the port on which the proxy should run on:

```bash
# Sets the port on which the proxy can be accessed on.
proxyport=1080

# Defines the IP addresses allowed to use the proxy. 
allowedips=1.2.3.4 5.6.7.8
```

Then start the SOCKS proxy by running:

```bash
$ socksproxy start
Starting socksproxy on port 1080 ... Started with PID 15761.
```

You can now add it to your browser / operating system config and you are ready to surf via your proxy host!

Build
-----
To build the `.deb` archive yourself, run the following commands:
```bash
$ sudo apt-get install devscripts  # for 'debuild'
$ make clean deb
$ sudo dpkg -i build/*.deb
```

socksproxy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README