A powerful and smart script for the automated installation of Psiphon core, bundled with a Telegram management bot and a dedicated command-line tool.
If you have a VPN server (like X-UI, Marzban, etc.), you might face issues like IP bans, blocked websites (OpenAI, Netflix, Spotify), or strict datacenter firewalls.
This script installs Psiphon in the background of your server and gives you a clean, dynamic local proxy. You can use this proxy to:
- Bypass Geo-blocks: Change your server's outgoing IP to 30+ different countries instantly.
- Smart Routing: Route only specific blocked websites through Psiphon while keeping normal traffic on your main high-speed IP.
- Hide VPS IP: Prevent your main server IP from being exposed or blocked.
- ⚙️ Fully Automated Setup: Install Psiphon core, configurations, and dependencies with a single line of code.
- 🤖 Exclusive Telegram Bot: Full server management (Start, Stop, Restart, Change Location) directly from Telegram.
- 🌍 Smart Location Changer: Access over 30 different countries using an interactive inline menu in Telegram.
- 💻 Custom CLI Tool: Quickly change server locations via terminal using the custom
changeloccommand. - 🔄 Auto Connection Check: Smart system to verify and display the new IP address.
- A Virtual Private Server (VPS) running Ubuntu or Debian.
- Root (
root) privileges. - A Telegram Bot Token (Get it from @BotFather).
- Your numeric Telegram User ID (Get it from @userinfobot).
To install the complete package, simply copy and run the following command in your server's terminal:
bash <(curl -Ls https://raw.githubusercontent.com/a-salemi/psiphon-linux/main/install.sh)
During the installation, the script will prompt you for your Token and Admin ID. Enter them and wait for the magic to happen! 🎉
Once installed, Psiphon runs quietly in the background and creates a Local SOCKS5 Proxy.
You can easily route your panel's traffic through it. Here is how to configure it as an Outbound in X-UI (Sanaei):
- Go to the Outbounds section in your X-UI panel.
- Click on Add Outbound.
- Fill in the following details:
- Tag:
psiphon-out - Protocol:
socks - Address:
127.0.0.1 - Port:
2080
- Tag:
- Now, go to the Routing Rules section.
- Create a new rule, select the domains you want to bypass (e.g.,
geosite:openai), and set their outbound tag topsiphon-out.
Go to your Telegram bot and send /start. You will see buttons to:
- 📊 Check Service Status & Current IP.
- 🌍 Open an inline menu to switch between 30+ countries instantly.
▶️ Start / ⏹ Stop / 🔄 Restart the service.
If you are in the terminal (SSH) and want to change the location, just type:
changelocEnter the two-letter country code, and the tool will do the rest!
Developed with ❤️ by Amir Salemi. If you found this project helpful, please consider giving it a star (⭐)!
This project is open-source and available under the MIT License.