Psiphon Linux VPN Service

System-wide Psiphon VPN service for Linux with absolute kill-switch protection. Zero-trust networking model: all traffic must go through VPN or is blocked; non-root user isolation for Psiphon binary.

🛡️ Key Features

• Absolute Kill Switch

  • Fail-closed security model
  • No bypass routes or exceptions
  • Full IPv4/IPv6 protection

• Zero Trust Security

  • Default deny-all policy
  • DNS leak prevention
  • Dedicated non-root user isolation

📋 Requirements

• Linux with systemd (only if you want to use it)
• Root access
• nftables

🚀 Installation

git clone https://github.com/boilingoden/psiphon-client-linux-service.git
cd psiphon-client-linux-service
sudo ./Psiphon-Linux-VPN-Service-Setup.sh install

� Quick Start

# Show all available commands
sudo ./Psiphon-Linux-VPN-Service-Setup.sh help

# Start VPN
sudo systemctl start psiphon-tun

# Stop VPN
sudo systemctl stop psiphon-tun

# Check status
sudo systemctl status psiphon-tun

# Keep kill-switch on and restart only the Psiphon binary
sudo systemctl reload psiphon-tun

# Restart without keeping kill-switch
sudo systemctl Restart psiphon-tun

→ Full documentation in docs/ directory ✨

📚 Documentation

Start here:

• Getting Started (5 min) - Install & test
• Commands Reference - All commands
• Configuration - Settings + 5 presets
• Troubleshooting - Fix problems
• FAQ - Quick answers
• Usage & Commands - How to use
• Security - Kill switch, DNS, isolation
• Network Setup - Network details

See docs/README.md for full documentation index.

Configuration: /opt/psiphon-tun/psiphon/psiphon.config

🔍 Network Info

• Interface: PsiphonTUN
• IPv4: 10.200.3.0/24
• IPv6: fd42:42:42::/64

🐛 Troubleshooting

# View logs (script mode)
sudo tail -f /opt/psiphon-tun/psiphon-tun.log

# View logs (systemd service mode)
sudo systemctl status psiphon-tun.service
sudo systemctl status psiphon-binary.service

# Test connection
sudo ./Psiphon-Linux-VPN-Service-Setup.sh status
sudo ./Psiphon-Linux-VPN-Service-Setup.sh diagnose

See Troubleshooting guide

📄 License

This is free and unencumbered software released into the public domain - See LICENSE file