# Wstunnel

> Use this skill when the user wants to tunnel traffic through firewalls, set up a SOCKS5 proxy, bypass DPI, or securely tunnel traffic over WebSocket.

- Skill: `javimosch/wstunnel` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/wstunnel`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/wstunnel/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/wstunnel

---


# wstunnel Plugin

Tunnel all your traffic over WebSocket or HTTP2 — bypass firewalls and proxies.

## Commands

### Server
- `wstunnel server start` — Start wstunnel server

### Client
- `wstunnel client start` — Start wstunnel client

## Usage Examples
- "Start a wstunnel server"
- "Connect as a client to tunnel traffic"
- "Set up a SOCKS5 proxy"
- "Tunnel SSH traffic"

## Installation

Download from https://github.com/erebe/wstunnel/releases

## Examples

```bash
# Start server
wstunnel server wss://0.0.0.0:8080

# Client with SOCKS5 proxy
wstunnel client -L socks5://127.0.0.1:8888 wss://my.server.com:8080

# Local port forwarding
wstunnel client -L tcp://9999:127.0.0.1:22 wss://my.server.com:443

# With HTTP proxy
wstunnel client -L tcp://9999:127.0.0.1:22 -p http://proxy:8080 wss://my.server.com:443
```

## Key Features
- Bypass firewalls and DPI
- WebSocket and HTTP2 transport
- TCP, UDP, SOCKS5, Unix socket support
- Transparent proxy (Linux)
- mTLS support
- WireGuard tunneling