Linux Setup Guide

Setting up CompassVPN on Linux

This guide will help you set up CompassVPN on your Linux system using a modern graphical client for the V2Ray/Xray protocol.

Prerequisites

Before you begin, you’ll need:

  • A configuration link or QR code from your CompassVPN server
  • A Linux distribution (Ubuntu, Debian, Arch, Fedora, etc.)
  • Basic terminal knowledge might be required for installation depending on the client and distribution.

Step 1: Choose and Install a Client

We recommend one of the following clients for Linux:

  • v2rayA: A popular client with a web-based user interface. It’s designed with Linux systems in mind and offers features like transparent proxying.

    • GitHub: https://github.com/v2rayA/v2rayA
    • Installation instructions can usually be found in the repository’s README or documentation (often includes APT source, AUR, Docker, Snap, or direct downloads).

  • Furious: A cross-platform desktop GUI client built with PySide6, supporting Xray-core and other protocols.

Please refer to the chosen client’s official GitHub repository or documentation for the most up-to-date installation instructions specific to your Linux distribution. You may need to install Xray-core separately or the client might handle it for you.

Step 2: Import Configuration

  1. Open the client application you installed (v2rayA usually runs as a service accessed via http://localhost:2017, while Furious is a standard desktop app).
  2. Copy the configuration link provided by your server.
  3. Look for an “Import”, “Add”, or “+” button within the client’s interface.
  4. Choose the option to import from clipboard or URL.
  5. Paste the link when prompted.
  6. The CompassVPN configuration should now appear in your list of servers or connections.

Step 3: Connect to CompassVPN

  1. Select the newly imported CompassVPN configuration in your client.
  2. Click the “Connect” or similar button to establish the VPN connection.
  3. Verify your connection by visiting a site like browserleaks.com/ip to check if your public IP address has changed.

Security Considerations

Always keep your Linux system, your chosen VPN client, and the underlying Xray/V2Ray core updated with the latest security patches. Follow the update instructions provided by the client developers.