Hermes

Client that is used for bypassing firewalls.

If you want to take a quick look at the server implementation, go here https://github.com/lightswisp/Hermes-Server

Demo

2024-02-04.01-50-27.1.mp4

Dependencies

• Chromium browser
• ruby

How to configure?

Empty configuration file will be created on first launch in the appropriate directory.

For Linux: configuration file is located at /etc/hermes/config.json

For Windows: configuration file is located at %APPDATA%/Hermes/config.json

Example:

    {
        "server": "example.com",
        "check_server": "8.8.8.8"
        "max_buffer": 65535,
        "default_interface": "eth0"
    }

• server (Required) - Domain name of the vpn server
• check_server (Required) - This is used to verify internet connectivity + obtain your local ip address which is gonna be used later.
• default_interface (optional) - your default interface name

How to install & run

Linux

• Download the deb package from the "Releases"
• install it via dpkg or apt

    sudo apt install ./hermes-client.deb
    # or
    sudo dpkg -i ./hermes-client.deb

Windows

Installer will be added a bit later...

• Install ruby from https://rubyinstaller.org/downloads/
• Git clone the repository
• Cd into it
• Run the following commands: (You need admin rights)

    gem install bundler

    bundle install

• Now you can run the main script (You need admin rights)

    ruby hermes

Brief description of how it works

Maybe later...