This script provides a convenient way to control and configure the Psiphon service on Linux systems. With this script, you can manage the Psiphon service (start, stop, check status), change configurations like proxy ports and egress region, and restart the service to apply changes.
- A Linux system with Psiphon installed.
systemdmust be available to manage the Psiphon service.- Psiphon binary and configuration files must be correctly set up in the appropriate locations:
- x86_64:
/etc/psiphon/psiphon-tunnel-core-x86_64 - arm64/aarch64:
/etc/psiphon/psiphon-tunnel-core-arm64 - config:
/etc/psiphon/psiphon.config
- x86_64:
- Start Psiphon service.
- Stop Psiphon service.
- Check the status of the Psiphon service.
- Change the egress region (e.g.,
US,GB,CA). - Change the HTTP proxy port (e.g.,
8081). - Change the SOCKS proxy port (e.g.,
1081). - Restart the Psiphon service to apply any changes.
- Display proxy IP via the running Psiphon proxy.
- Uninstall the Psiphon service and remove associated files.
- Supports arm64/aarch64 in addition to x86_64/amd64.
To install the Psiphon service and control script, execute the following command:
curl -s https://raw.githubusercontent.com/090ebier/PsiphonLinux/refs/heads/main/Pinstaller.sh | sudo bashThis command will:
- Download and install the Psiphon binary and configuration files (x86_64 or arm64 based on your CPU).
- Create the necessary systemd service for managing Psiphon.
- Install the control script to
/usr/bin/psiphonfor easy management.
If you want to uninstall the Psiphon service and remove all associated files, run the following command:
sudo psiphon uninstallThis command will:
- Stop the Psiphon service if it is running.
- Disable and remove the Psiphon service from
systemd. - Remove Psiphon files from
/etc/psiphon/. - Remove the control script from
/usr/bin/psiphon. - Reload systemd daemon.
Note: After running the uninstall command, Psiphon will be completely removed from your system.
After installation, you can use the psiphon command to manage the service and configure settings. The basic syntax is:
psiphon [command] [arguments]- start - Start the Psiphon service.
- stop - Stop the Psiphon service.
- status - Show the status of the Psiphon service.
- region [REGION] - Change the egress region (e.g.,
US,GB,CA). - httpport [PORT] - Change the HTTP proxy port (e.g.,
8081). - socksport [PORT] - Change the SOCKS proxy port (e.g.,
1081). - restart - Restart the Psiphon service to apply any changes.
- ip - Display the outgoing IP address as seen through the Psiphon proxy.
Start the Psiphon service:
sudo psiphon startStop the Psiphon service:
sudo psiphon stopCheck the status of the Psiphon service:
sudo psiphon statusChange the egress region to US (United States):
sudo psiphon region USChange the HTTP proxy port to 8081:
sudo psiphon httpport 8081Change the SOCKS proxy port to 1081:
sudo psiphon socksport 1081Restart the Psiphon service to apply changes:
sudo psiphon restartShow proxy IP (through Psiphon):
sudo psiphon ipDisplay the help message to see all available commands:
sudo psiphon