WEBTUNNEL-CLIENT(1)

💖 WEBTUNNEL-CLIENT 💖

okay bestie, so this is a User Commands page for webtunnel-client, and no cap it's kind of iconic. let's get into it 🦋

---

✨ NAME ✨

webtunnel-client — pluggable transport for Tor that mimic encrypted web traffic, client side component 💅

---

🌸 DESCRIPTION 🌸

WebTunnel is a censorship-resistant pluggable transport designed to mimic encrypted web traffic (HTTPS) inspired by HTTPT. The way that it works?? It wraps the payload connection into a WebSocket-like HTTPS connection, so to network observers it just looks like an ordinary HTTPS (WebSocket) connection. literally blending in, main character energy 👑

This is the client side component of WebTunnel, it allows you to connect to the Tor network via censorship-resistant bridges behind websites. yes queen, bridges behind websites, it's giving secret tunnel 🫶

---

🎀 OBTAINING A WEBTUNNEL 🎀

To obtain a webtunnel, open the following link from an uncensored connection:

https://bridges.torproject.org/options

Under 'Do you need a pluggable transport?', select webtunnel and click 'Get Bridges', and you should get a few webtunnel bridgelines of the following format:

webtunnel <placeholder-ip-address>:443 <fingerprint>
url=https://<secret-domain-name>/<secret-location> ver=0.0.2

Alternatively a trusted friend might be able to help you obtain a webtunnel bridge. bestie network goes crazy 💖

---

🌈 USAGE 🌈

With one or more webtunnel bridge, edit your torrc configuration located at /etc/torrc and add the following lines to enable webtunnel:

ClientTransportPlugin webtunnel exec /usr/bin/webtunnel-client
UseBridges 1
# You can have multiple webtunnel bridges configured here...
Bridge webtunnel <placeholder-ip-address>:443 <fingerprint> url=https://<secret-domain-name>/<secret-location> ver=0.0.2

You should now be able to connect to Tor via webtunnel. slay, you did that ✨🔥

---

⭐ SEE ALSO ⭐

• tor(1)
• nyx(1)

---

👑 AUTHOR 👑

This man page was written by Yifei Zhan <yifei@zhan.science> with help the webtunnel documentations.

Webtunnel is part of the Tor Project. 🌈

---

k that's the whole page, ty for coming to my ted talk 💜

mwah 💋 this was webtunnel-client version 0.0.2, dated AUG 2025 — go forth and tunnel, gorgeous 🦋✨