README.md

WARP

WARP now integrates with Cloudbric service, offering an advanced solution for forwarding TCP traffic through an SSH tunnel with the added advantage of a free VPN over WireGuard. This integration aims to enhance the security and efficiency of your network data routing.

Table of Contents

• Introduction
• Installation
• Usage
  • Command Line Options
  • Configuration File Options
• Examples
• License

Introduction

With the latest update, WARP consolidates its functionality by not only forwarding TCP traffic through an SSH tunnel but also by offering seamless integration with Cloudbric for enhanced VPN services via WireGuard. This makes WARP a comprehensive network security tool.

Installation

Before installing, make sure make is available on your system. Follow these steps to install:

git clone https://github.com/merzzzl/warp.git
cd warp
make build

Usage

To use WARP, begin by creating a ~/.warp.conf file in your home directory. Launch WARP with the following command, adjusting the options as needed::

sudo ./warp --verbose

Command Line Options

Currently, WARP supports the following command-line option:

• -verbose: Enable verbose logging to get detailed operational logs (default: disabled).

Configuration File Options

Below is a template for the WARP configuration file, reflecting the current structure. Replace the placeholders with your actual data:

# WARP configuration file example
---
tunnel:
  name: utun11
  ip: 192.168.127.0
ssh:
  user: <USER>
  password: <PASSWORD>
  host: <HOST>
  domain: .*example\.com$
cloudbric:
  domain: .*example\.com$
  device_id: <DEVICE_UUID>
  private_key: <PRIVATE_KEY>

Examples

Here's an updated example demonstrating how to forward TCP traffic through an SSH tunnel:

sudo ./warp

License

WARP is licensed under the MIT License, supporting open and collaborative development.