psipool

KO | EN

gitlite — search

#nodejs #html #macos #animation #redis #self-hosted #proxy #swift #nlp #mysql

(★ 18)

Multi-region Psiphon proxy pool, managed from your terminal

File Explorer

ZIP Download

demo.gif
LICENSE
psipool.sh
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Manage a multi-region Psiphon proxy pool entirely from the terminal.\
a single-file TUI that gives you one tunnel per country, with per-tunnel SOCKS5 + HTTP ports and systemd supervision.

![platform](https://img.shields.io/badge/platform-Linux%20%C2%B7%20systemd-informational?style=flat-square)
![shell](https://img.shields.io/badge/bash-4.4%2B-green?style=flat-square)
![arch](https://img.shields.io/badge/arch-x86__64%20%C2%B7%20arm64-lightgrey?style=flat-square)
![license](https://img.shields.io/badge/license-MIT-blue?style=flat-square)

![psipool demo](https://raw.githubusercontent.com/xHossein/psipool/master/demo.gif)

</div>

## Requirements

| | |
|---|---|
| OS | Debian 9+ / Ubuntu 18.04+ (any Linux with bash 4.4+ and systemd) |
| Architecture | x86_64, i686, arm64 |
| Packages | curl, iproute2, gawk (auto-installed on apt systems) |

## Install

```bash
curl -fsSL https://raw.githubusercontent.com/xHossein/psipool/master/psipool.sh -o /tmp/psipool \
  && sudo install -m 755 /tmp/psipool /usr/local/bin/psipool \
  && sudo psipool
```

Afterwards just `sudo psipool` from anywhere.

> To try it without installing:
>
> ```bash
> bash <(curl -fsSL https://raw.githubusercontent.com/xHossein/psipool/master/psipool.sh)
> ```

## Usage

| Key | Action |
|---|---|
| ↑ ↓ | Move |
| Space | Toggle (multi-select) |
| Enter | Confirm |
| / | Filter |
| Esc | Back |
| q | Quit |

## Using the proxies

Both listeners bind to 127.0.0.1 only.

```bash
curl -x http://127.0.0.1:19843    https://api.myip.com   # HTTP
curl -x socks5h://127.0.0.1:21471 https://api.myip.com   # SOCKS5
```

## Files & services

```
/opt/psipool/
├── psiphon-tunnel-core          # downloaded binary
├── configs/                     # config_<code>.json per instance
└── instances/                   # per-instance working dirs + cache
/etc/systemd/system/psipool@.service   # template unit
```

Each region is a systemd template instance:

```bash
systemctl status psipool@de       # check one instance
journalctl -u psipool@de -f       # follow its logs
systemctl restart psipool@de      # restart it manually
```
## Options

| Option | Description |
|---|---|
| `--no-color` | Disable ANSI colors |
| `--ascii` | Use ASCII-only borders |
| `-v` | Print version and exit |
| `-h` | Show help and exit |
| `PSIPHON_PREFIX` | Override the install prefix (default: `/opt/psiphon`) |
| `PSIPHON_SYSTEMD_DIR` | Override the systemd unit directory (default: `/etc/systemd/system`) |

## Troubleshooting

| Symptom | Fix |
|---|---|
| Region list comes up empty | The first probe can take up to 20 s to reach the network; the datastore is cached, so later runs are faster |
| Instance shows inactive | `journalctl -u psipool@<code> -f` — usually a port conflict or no outbound network |
| Exit IP shows unreachable | The tunnel is still establishing — give it 10-30 s, then check the logs |

## License

MIT. Unofficial wrapper around [psiphon-tunnel-core](https://github.com/Psiphon-Labs/psiphon-tunnel-core) — not affiliated with or endorsed by Psiphon Inc.

psipool

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

psipool

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README