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.
| 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) |
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 psipoolAfterwards just sudo psipool from anywhere.
To try it without installing:
bash <(curl -fsSL https://raw.githubusercontent.com/xHossein/psipool/master/psipool.sh)
| Key | Action |
|---|---|
| ↑ ↓ | Move |
| Space | Toggle (multi-select) |
| Enter | Confirm |
| / | Filter |
| Esc | Back |
| q | Quit |
Both listeners bind to 127.0.0.1 only.
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/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:
systemctl status psipool@de # check one instance
journalctl -u psipool@de -f # follow its logs
systemctl restart psipool@de # restart it manually| 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) |
| 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 |
MIT. Unofficial wrapper around psiphon-tunnel-core — not affiliated with or endorsed by Psiphon Inc.