🚀 Haxorport - Tunneling Tool

Haxorport is a tunneling tool that allows you to expose local services to the internet through TCP and HTTP tunnels quickly and easily.

✨ Features

• TCP Tunneling: Easily expose local TCP ports to the internet
• HTTP Tunneling: Expose local web servers with custom subdomains
• Token Authentication: Security with token-based authentication
• Interactive Mode: Intuitive command-line interface
• Global Installation: Run from anywhere with the haxorport command
• Enhanced Authentication: Immediate API validation with loading animation
• Better User Experience: Colorful output with emojis and improved formatting
• Interactive Prompts: Always returns to prompt after commands
• Account Info: Shows subscription details on startup and after login

📦 Installation

Installation from NPM (Recommended)

# Global installation
npm install -g haxorport

Installation from Source

# Clone repository
git clone https://gitlab.com/alwanandri2712/haxor-client.git
cd haxor-client

# Install dependencies and install globally
npm install
npm install -g .

🔧 Usage

Authentication

Before using Haxorport, you need to authenticate with a token:

haxorport add-authtoken <your-token>

Running the Application

# Run in interactive mode
haxorport

Available Commands

In interactive mode, you can use the following commands:

| Command | Description | |----------|------------| | tcp <port> [host] [subdomain] | Create a TCP tunnel | | http <port> [host] [subdomain] | Create an HTTP tunnel | | list | Display all active tunnels | | remove <id> | Remove a specific tunnel | | help | Display help message | | exit | Exit the program |

Usage Examples

# Create a TCP tunnel for SSH (port 22)
tcp 22
# Output: ✓ Forwarding: tcp://tcp.haxorport.online:12345 -> localhost:22

# Create an HTTP tunnel for a web server with a custom subdomain
http 3000 localhost myapp
# Output: ✓ Forwarding: https://myapp.haxorport.online → localhost:3000

⚙️ Configuration

Configuration is stored in platform-specific directories:

• Windows: %APPDATA%\haxorport
• macOS: ~/Library/Application Support/haxorport
• Linux/Unix: ~/.config/haxorport

💻 Development

Project Structure

haxorport/
├── client.js           # Application entry point
├── config.js           # Application configuration
├── auth/               # Authentication module
│   └── index.js        # Authentication functions
├── tunnels/            # Tunneling module
│   ├── index.js        # Tunnel implementation
│   └── direct.js       # Direct connections
├── services/           # API services
│   └── api.js          # Backend communication
└── cli/                # Command-line interface
    └── index.js        # CLI implementation

Server Configuration

• WebSocket server: ws://tcp.haxorport.online:9000
• API server: http://haxorport.test
• API endpoint: /AuthToken/validate

Tunneling Protocol

The tunneling protocol uses WebSocket with the following message types:

• tunnel-request: Request to create a tunnel
• tunnel-success: Confirmation that the tunnel was created successfully
• tunnel-error: Notification of a tunnel error

📝 Version Notes

v1.0.0

• Initial implementation with TCP and HTTP tunnel support
• Token authentication
• Interactive mode with CLI
• Global installation with the haxorport command
• Enhanced banner display
• More informative tunnel message format

v1.0.5

• Added loading animation during authentication
• Improved success messages with colors and emojis
• Show account info immediately after login
• Always return to interactive prompt after commands
• Disabled debug API messages for cleaner output

📄 License

ISC

Made with ❤️ by the Michu Team