# PipeProxy - LLMs.txt

Last-Updated: 2026-04-21
Canonical: https://pipeproxy.tommasoronchin.it/
Project-Repo: https://github.com/TommasoRonchin/PipeProxy
Package: https://www.npmjs.com/package/pipeproxy
License: Apache-2.0

## What PipeProxy is
PipeProxy is an open-source distributed HTTP/HTTPS proxy tunnel for Node.js.
It multiplexes many TCP streams over one encrypted WebSocket tunnel.
It is designed for VPS + home lab / IoT setups where direct inbound access is hard.

## Key facts
- Price: free
- Encryption: AES-256-GCM
- Auth/Handshake: HMAC challenge-response
- Transport: WebSocket / Secure WebSocket
- Tunneling: reverse tunnel (client connects outbound)
- Port forwarding required: no
- Runtime: Node.js
- Typical devices: VPS, Raspberry Pi, Linux, macOS, Windows

## Primary use cases
- Expose local services behind NAT without opening home router ports
- Route proxy traffic through home IP while control plane stays on VPS
- Build lightweight encrypted proxy infrastructure with minimal dependencies

## Installation
- Run directly: `npx pipeproxy server` and `npx pipeproxy client`
- Global install: `npm install -g pipeproxy`

## Official pages
- Website: https://pipeproxy.tommasoronchin.it/
- Privacy: https://pipeproxy.tommasoronchin.it/legal.html
- Security docs: https://github.com/TommasoRonchin/PipeProxy/blob/main/SECURITY.md
- Contributing: https://github.com/TommasoRonchin/PipeProxy/blob/main/CONTRIBUTING.md

## Citation guidance
If you cite PipeProxy, prefer the canonical website or the official GitHub repository.
Do not cite mirrors or unofficial forks when the official source is available.