Skip to content

Phantom-WireGuard






Your Server. Your Network. Your Privacy.


Phantom-WireGuard is a modular tool for setting up and managing WireGuard VPN
infrastructure on your own server. Beyond basic VPN management, it provides
censorship-resistant connections, multi-layer encryption, and advanced privacy scenarios.


 https://www.phantom.tc


 Github


Quick Start


Requirements


Server:


    

  • A server with internet access, a public IPv4 address, and a supported operating system
    • 

  • Root access
    • 



Operating System:


    

  • Debian 12, 13
    • 

  • Ubuntu 22.04, 24.04
    • 





Resource Usage: WireGuard runs as a kernel module, consuming minimal system resources.
For detailed performance information, see WireGuard Performance.




Installation


curl -sSL https://install.phantom.tc | bash




    

        
Phantom WireGuard

        Terminal Recording
    

    

        

        

    





Creating a Client


After the installation is complete, you can create a client using the interactive CLI:

phantom-wireguard



CLI Navigation:


    

  1. 1 → Core Management
    2. 

  2. 1 → Client Operations
    3. 

  3. 1 → Add new client
    4. 

  4. Enter the client name (e.g., test-client)
    5. 

  5. 3 → Export client config
    6. 

  6. Copy the configuration or save it to a file
    7. 




    

        
Phantom WireGuard

        Terminal Recording
    

    

        

        

    






  
  Configuration Security: The client configuration contains private keys.
  Use secure channels (SCP, SFTP, end-to-end encrypted messaging) when transferring the file to the client device.
  Never share the configuration via email or unencrypted channels.









Client Connection


After transferring the configuration file to the client device:


# Move the configuration to the WireGuard directory
sudo mv client.conf /etc/wireguard/wg0.conf

# Start the VPN connection
sudo wg-quick up wg0

# Check the connection status
sudo wg show

# Verify your public IP address
curl -4 ifconfig.io




    

        
Phantom WireGuard

        Terminal Recording
    

    

        

        

    







Access Methods






Method
Command
Description






Interactive CLI
phantom-wireguard
Rich TUI-based user interface




API
phantom-api <module> <action>
Programmatic access, JSON output




Ghost Export
phantom-casper <client>
Ghost Mode client configuration








License


Copyright (c) 2025 Riza Emre ARAS r.emrearas@proton.me


This software is licensed under the AGPL-3.0 license. See LICENSE for details.


For third-party licenses, see THIRD_PARTY_LICENSES.


WireGuard® is a registered trademark of Jason A. Donenfeld.




Support


Phantom-WireGuard is an open-source project. If you'd like to support the project:


Monero (XMR):

84KzoZga5r7avaAqrWD4JhXaM6t69v3qe2gyCGNNxAaaJgFizt1NzAQXtYoBk1xJPXEHNi6GKV1SeDZWUX7rxzaAQeYyZwQ



Bitcoin (BTC):

bc1qnjjrsfdatnc2qtjpkzwpgxpmnj3v4tdduykz57