Skip to content

Unnofficial repository to make the installation of the Psiphon VPN on the Linux operating system easier

Notifications You must be signed in to change notification settings

090ebier/PsiphonLinux

 
 

Repository files navigation

Psiphon Control Script

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.

Prerequisites

  • A Linux system with Psiphon installed.
  • systemd must 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

Features

  • 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.

Installation

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 bash

This 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/psiphon for easy management.

Uninstalling Psiphon

If you want to uninstall the Psiphon service and remove all associated files, run the following command:

sudo psiphon uninstall

This 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.

Usage

After installation, you can use the psiphon command to manage the service and configure settings. The basic syntax is:

psiphon [command] [arguments]

Available Commands

  • 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.

Example Usage

Start the Psiphon service:

sudo psiphon start

Stop the Psiphon service:

sudo psiphon stop

Check the status of the Psiphon service:

sudo psiphon status

Change the egress region to US (United States):

sudo psiphon region US

Change the HTTP proxy port to 8081:

sudo psiphon httpport 8081

Change the SOCKS proxy port to 1081:

sudo psiphon socksport 1081

Restart the Psiphon service to apply changes:

sudo psiphon restart

Show proxy IP (through Psiphon):

sudo psiphon ip

Display the help message to see all available commands:

sudo psiphon

About

Unnofficial repository to make the installation of the Psiphon VPN on the Linux operating system easier

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%