Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shadowsocks/simple-obfs
A simple obfuscating tool (Deprecated)
https://github.com/shadowsocks/simple-obfs
Last synced: about 1 month ago
JSON representation
A simple obfuscating tool (Deprecated)
- Host: GitHub
- URL: https://github.com/shadowsocks/simple-obfs
- Owner: shadowsocks
- License: gpl-3.0
- Created: 2016-12-31T12:21:24.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-11-05T06:26:58.000Z (about 2 years ago)
- Last Synced: 2024-04-24T12:18:13.010Z (7 months ago)
- Language: C
- Homepage:
- Size: 1.43 MB
- Stars: 2,347
- Watchers: 117
- Forks: 561
- Open Issues: 127
-
Metadata Files:
- Readme: README.md
- Changelog: Changes
- License: COPYING
Awesome Lists containing this project
- awesome-network-stuff - **1891**星
README
# simple-obfs
Deprecated. Followed by [v2ray-plugin](https://github.com/shadowsocks/v2ray-plugin).
## Intro
Simple-obfs is a simple obfuscating tool, designed as plugin server of shadowsocks.
Current version: 0.0.5 | [Changelog](Changes)
## Build
For Unix-like systems, especially Debian-based systems,
e.g. Ubuntu, Debian or Linux Mint, you can build the binary like this:
```bash
# Debian / Ubuntu
sudo apt-get install --no-install-recommends build-essential autoconf libtool libssl-dev libpcre3-dev libev-dev asciidoc xmlto automake
# CentOS / Fedora / RHEL
sudo yum install gcc autoconf libtool automake make zlib-devel openssl-devel asciidoc xmlto libev-devel
# Arch
sudo pacman -Syu gcc autoconf libtool automake make zlib openssl asciidoc xmlto
# Alpine
apk add gcc autoconf make libtool automake zlib-dev openssl asciidoc xmlto libpcre32 libev-dev g++ linux-headers
git clone https://github.com/shadowsocks/simple-obfs.git
cd simple-obfs
git submodule update --init --recursive
./autogen.sh
./configure && make
sudo make install
```
## Usage
For a detailed and complete list of all supported arguments, you may refer to the
man pages of the applications, respectively.
### Plugin mode with shadowsocks
Add respective item to `--plugin` and `--plugin-opts` arg or as value of `plugin` and `plugin_opts` in JSON.
On the client:
```bash
ss-local -c config.json --plugin obfs-local --plugin-opts "obfs=http;obfs-host=www.bing.com"
```
On the server:
```bash
ss-server -c config.json --plugin obfs-server --plugin-opts "obfs=http"
```
### Standalone mode
On the client:
```bash
obfs-local -s server_ip -p 8139 -l 1984 --obfs http --obfs-host www.bing.com
ss-local -c config.json -s 127.0.0.1 -p 1984 -l 1080
```
On the server:
```bash
obfs-server -s server_ip -p 8139 --obfs http -r 127.0.0.1:8388
ss-server -c config.json -s 127.0.0.1 -p 8388
```
### Coexist with an actual Web server
Only applicable on the server:
```bash
# HTTP only with plugin mode
ss-server -c config.json --plugin obfs-server --plugin-opts "obfs=http;failover=example.com:80"
# Both HTTP and HTTPS with standalone mode
obfs-server -s server_ip -p 80 --obfs http -r 127.0.0.1:8388 --failover example.com:80
obfs-server -s server_ip -p 443 --obfs tls -r 127.0.0.1:8388 --failover example.com:443
# suppose you have an HTTP webserver (apache/nginx/whatever) listening on localhost:8080 and HTTPS on 8443
# (you probably shouldn't expose these ports)
obfs-server -s server_ip -p 80 --obfs http -r 127.0.0.1:8388 --failover 127.0.0.1:8080
obfs-server -s server_ip -p 443 --obfs tls -r 127.0.0.1:8388 --failover 127.0.0.1:8443
```
## License
```
Copyright (C) 2016 Max Lv
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
```