pobi - GitLite

KO | EN

gitlite — search

#javascript #python #react #golang #machine-learning #rust #deep-learning #windows #awesome #awesome-list #security #ios #mcp #openai

pobi

(★ 113)

Handle boring GFW related works for you, such as DNS cleaning, reset detect, auto proxy, switch links.... Can work with socks5 and shadowsocks for now.

File Explorer

Download Latest Version (.zip)

- hosts.whitelist
- pac.blacklist
- pac.whitelist
- direct.js
- http.js
- index.js
- shadow.js
- socks5.js
- pac.tmpl
- server.tmpl
.gitignore
boot.js
debug.js
dns.js
gfw.js
History.md
http.js
package.json
README.md
server.js
shadow.js
socks5.js
wpad.js

# Installation Guide

1. Get the code

git clone https://github.com/jackyz/pobi

Downloads the entire project code from GitHub to your computer.

cd pobi

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm -g install https://github.com/jackyz/pobi/tarball/master

Type this command into your terminal and run it.

DEBUG=* sudo npm -g start pobi --lodns=udp://192.168.1.1:53 --worker=shadow://pass@1.2.3.4:9876

Type this command into your terminal and run it.

DEBUG=* sudo npm -g start pobi --lodns=udp://192.168.1.1:53 --worker=socks5://127.0.0.1:1070

Type this command into your terminal and run it.

set DEBUG=* && npm -g start pobi --lodns=udp://192.168.1.1:53 --worker=shadow://pass@1.2.3.4:9876

Type this command into your terminal and run it.

set DEBUG=* && npm -g start pobi --lodns=udp://192.168.1.1:53 --worker=socks5://127.0.0.1:1070

Type this command into your terminal and run it.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Pobi Project

Diagram
-------
```
                 +---------------LOCAL----------------+         +--WORKER--+
                 |                                    |         |          |
+-------+        | +---+  +----+  +-----+    +------+ |  +---+  | +------+ |
|Browser| --DNS--> |DNS|  |WPAD|  |HTTP |    |SOCKS5| |  |GFW|  | |SERVER| |
|       | <------- |   |  |    |  |PROXY|    |PROXY | |  |   |  | |      | |
|chrome |        | +---+  |    |  |     |    |      | |  |   |  | |      | |
|safari | --WPAD PAC----> |    |  |     |    |      | |  |   |  | |      | |
|firefox| <-------------- |    |  |     |    |      | |  |   |  | |      | |
|opera  |        |        +----+  |     |    |      | |  |   |  | |      | |
|ie     | --HTTP PROXY----------> |     | -> |      | --ENCODED-> |      | |
|...    | <---------------------- |     | <- |      | <-ENCODED-- |      | |
+-------+        |                +-----+    |      | |  |   |  | |      | |
                 |                           |      | |  |   |  | |      | |
+-------+        |                           |      | |  |   |  | |      | |
|Tools  | --SOCKS5 PROXY-------------------> |      | --ENCODED-> |      | |
|curl   | <--------------------------------> |      | <-ENCODED-- |      | |
+-------+        |                           +------+ |  +---+  | +------+ |
                 +------------------------------------+         +----------+
```

Install & Run & Config
----------------------

### Install node.js (http://nodejs.org/download/)

### Install pobi (Linux/MacOSX/Windows)

```
npm -g install https://github.com/jackyz/pobi/tarball/master
```

### Run (Linux/MacOSX)
```
## Local DNS is 192.168.1.1 using shadowsocks secure link
DEBUG=* sudo npm -g start pobi --lodns=udp://192.168.1.1:53 --worker=shadow://pass@1.2.3.4:9876
## Local DNS is 192.168.1.1 using socks5 secure link
DEBUG=* sudo npm -g start pobi --lodns=udp://192.168.1.1:53 --worker=socks5://127.0.0.1:1070
```

### Run (Windows)
```
## Local DNS is 192.168.1.1 using shadowsocks secure link
set DEBUG=* && npm -g start pobi --lodns=udp://192.168.1.1:53 --worker=shadow://pass@1.2.3.4:9876
## Local DNS is 192.168.1.1 using socks5 secure link
set DEBUG=* && npm -g start pobi --lodns=udp://192.168.1.1:53 --worker=socks5://127.0.0.1:1070
```

### Config

Point your DNS to ip address that running pobi project. You can set on your own NIC(works for you only) or on your router(works for your local network).

Enable browser's 'Auto Proxy Configure'(works for macosx/linux/ios), or set 'Auto Proxy Configure url' as http://wpad/wpad.dat (works for windows).

* In IE: `Tool` - `Internet Options` - `Connection` - `Lan` - `Use AutoConfig` - Address:`http://wpad/wpad.dat`
* In Safari: `Preference` - `Advanced` - `Proxies` - `Auto Proxy Discovery`
* In Firefox: `Preference` - `Advanced` - `Network` - `Settings` - `Auto-detect proxy setting for this network`

You have done, Enjoy.

Upgrade
-------

Of course we need upgrade, you can do it easy.
```
npm -g remove pobi
npm -g install https://github.com/jackyz/pobi/tarball/master
```

Thanks
------

* Of course, __The Party__, __The Country__ and __The G.F.W.__ must be first ;)
* XiXiang project: http://code.google.com/p/scholarzhang
* AutoProxyGFWList: http://code.google.com/p/autoproxy-gfwlist
* AutoProxy2Pac: http://autoproxy2pac.appspot.com
* GFWWhiteList: https://github.com/n0wa11/gfw_whitelist
* Inspired By Clowwindy's ShadowSocks: https://github.com/clowwindy/shadowsocks-nodejs
* Name was Inspired by Liu Cixin's science fiction `The Three Body Trilogy` (aka. `SanTi`) part II