pinggy
Auth/lab ref: Pinggy localhost tunneling service for HTTP(S), TCP, UDP, TLS, and TLSTCP tunnels over SSH, Pinggy CLI, Docker, GUI app, Node.js SDK, or Python SDK.
v2026.11.13-21cd5683 התקנות+3 ב-7 ימים39 כוכביםMITסונכרן לפני 10 שעות
התקנה
עדיין אין לכם את ה-CLI של NotHoly? התקינו אותו קודם.
$ curl -fsSL https://notholy.com/install.sh | sh$ notholy skills install aeondave/pinggyנכתב אל ~/.notholy/skills אחרי בדיקת החתימה וה-SHA-256.
חתימהחתום, ed25519
חבילהf4c47af7…163f31ba
f4c47af7ec1c…8b22163f31baשני קבצים · 7.1 KBסריקהבינונישני ממצאים
- injection.no_confirmationreferences/usage-matrix.md:105
- קישורים לדומיינים חיצוניים
מקורgithub.com/AeonDave/malskill/tree/main/offensive-tools/network/pinggy@21cd568
הפריט הזה עדיין לא נכתב בעברית, ולכן הוא מוצג בשפה אחרת: English.
בעמוד הזה
Public reverse tunnels to localhost using SSH remote forwarding or the Pinggy CLI. Use for authorized dev/test ingress, webhook capture, controlled lab callbacks, and temporary remote access without router port forwarding.
Scope Guard
- Confirm the exposed service, audience, time window, and authorization before creating a public URL or port.
- Default to short-lived tunnels, strong app-layer auth, and IP allowlists for anything sensitive.
- Do not expose admin consoles, databases, model servers, MCP tools, or shells to the internet without explicit access controls and owner approval.
- Prefer
tlsfor end-to-end encrypted HTTPS services when Pinggy must not inspect HTTP content; HTTP tunnels terminate at Pinggy to provide debugger and header features.
Choose the Mode
| Need | Mode | Pattern | Notes |
|---|---|---|---|
| Share web app/API/webhook | http default |
ssh -p 443 -R0:localhost:8000 free.pinggy.io |
Provides HTTP+HTTPS URLs, debugger, auth, header manipulation. |
| Expose arbitrary TCP service | tcp |
ssh -p 443 -R0:localhost:22 [email protected] |
Returns host+port; use for SSH, databases, listeners, raw protocols. |
| End-to-end HTTPS by SNI | tls |
ssh -p 443 -R0:localhost:8443 [email protected] |
No public TCP port; visitor connects to generated domain on 443; local service terminates TLS. |
| TCP with optional TLS wrapper | tlstcp |
ssh -p 443 -R0:localhost:8000 [email protected] |
Gives TCP port plus TLS endpoint that terminates at Pinggy then forwards plaintext. |
| Expose UDP service | udp |
./pinggy --type udp -l 8000 |
UDP requires Pinggy CLI/Docker; SSH-only form is not supported. |
| Persistent name/port | Pro token | ssh -p 443 -R0:localhost:8000 [email protected] |
Use token, dashboard, custom/persistent domains, persistent TCP/UDP ports. |
Quick Starts
# HTTP(S) via OpenSSH
ssh -p 443 -R0:localhost:8000 free.pinggy.io
# HTTP(S) with QR code in terminal
ssh -p 443 -R0:localhost:8000 [email protected]
# TCP tunnel to local SSH
ssh -p 443 -R0:localhost:22 [email protected]
# TLS tunnel to local HTTPS service
ssh -p 443 -R0:localhost:8443 [email protected]
# CLI equivalents
pinggy -l 8000
pinggy --type tcp -l 22
pinggy --type udp -l 51820
# Docker HTTP tunnel on Linux
docker run --net=host -it pinggy/pinggy -p 443 -R0:localhost:8000 a.pinggy.ioOn Windows, if localhost fails through OpenSSH, retry with 127.0.0.1.
SSH Grammar
ssh -p443 -R0:<local_host>:<local_port> [more -R rules] [<token>+<keywords>@]a.pinggy.io [remote options]Useful SSH flags:
| Flag | Use |
|---|---|
-p 443 |
Pinggy listens on 443 to pass most egress firewalls. |
-R0:localhost:PORT |
Expose exactly one local service; Pinggy assigns remote URL/port. |
-L4300:localhost:4300 |
Open local access to the Web Debugger UI/API. |
-t |
Allocate TTY; needed for rich UI and command-line options like auth/header controls. |
-T |
Disable rich terminal UI for scripts. |
-N |
Disables remote command execution; avoid when using debugger/header/auth features. |
Username keywords are joined with +: [email protected], [email protected], [email protected].
| Keyword | Effect |
|---|---|
http, tcp, tls, tlstcp |
Select tunnel type; HTTP is default. |
qr, aqr |
Print Unicode or ASCII QR code for quick mobile access. |
auth |
Force SSH password prompt compatibility; any string/blank password is acceptable. |
force |
Disconnect an existing tunnel using the same token before reconnecting. |
HTTP Controls
Append these after the SSH destination and use -t:
# Basic auth; username/password cannot contain ':'
ssh -p 443 -R0:localhost:8000 -t free.pinggy.io b:user:pass
# Multiple bearer keys: visitor sends Authorization: Bearer <key>
ssh -p 443 -R0:localhost:8000 -t free.pinggy.io k:key1 k:key2
# IP/CIDR allowlist
ssh -p 443 -R0:localhost:8000 -t free.pinggy.io w:203.0.113.10/32
# HTTPS-only redirect, CORS preflight pass-through, original URL header
ssh -p 443 -R0:localhost:8000 -t free.pinggy.io x:https x:passpreflight x:fullurl
# Local service expects HTTPS/TLS
ssh -p 443 -R0:localhost:8443 -t free.pinggy.io x:localServerTls:example.com
# Header manipulation: append, remove, update
ssh -p 443 -R0:localhost:8080 -t free.pinggy.io a:X-Lab:pinggy r:Referer u:Host:example.comOther controls:
| Option | Purpose |
|---|---|
x:xff[:Header-Name] |
Add source IP header, or use a custom header name. |
x:noreverseproxy |
Disable default reverse-proxy headers for HTTP tunnels. |
x:passpreflight |
Let unauthenticated CORS preflight requests pass when auth is enabled. |
a:Header:Value |
Append request header. |
r:Header |
Remove request header. |
u:Header:Value |
Replace request header; useful for Host. |
Web Debugger
ssh -p 443 -R0:localhost:8080 -L4300:localhost:4300 a.pinggy.io
# Open http://localhost:4300
# API examples: GET /urls, GET /ipwhitelistUse it to inspect requests/responses, replay modified HTTP requests, verify webhook payloads, and compare proxy headers before involving Burp, ZAP, mitmproxy, or app logs. Do not use HTTP debugger mode for secrets that Pinggy should not see; choose tls instead.
Multi-Forwarding and Domains
Pro tokens can route multiple services through one session, especially with wildcard custom domains.
ssh -p 443 \
-R http//app.example.com:1:localhost:3000 \
-R http//api.example.com:1:localhost:8080 \
-R tcp//ssh.example.com/34567:1:localhost:22 \
-R 1:localhost:80 \
[email protected]Listen address syntax: [schema//]hostname[/port][@name]. Schemas include http, tcp, tls, tlstcp, and udp. Custom domains use CNAME where possible; apex/root domains use relay setup. Relay-based custom domains do not support UDP, so use persistent subdomains/ports for UDP.
Offensive Lab Synergies
Use Pinggy as the public ingress layer; pair it with specialist tools locally.
| Workflow | Pinggy role | Pair with |
|---|---|---|
| Webhook and API testing | Public HTTPS receiver to localhost | Burp Suite, ZAP, mitmproxy, curl, jq, app logs |
| Controlled reverse-callback labs | Public TCP port to an owned listener | ncat/socat, Metasploit handlers, tcpdump, Wireshark |
| External service validation | Temporary public host/port for owned service | nmap, httpx, nuclei, testssl, browser devtools |
| Header/auth edge cases | Modify Host, XFF, bearer/basic auth, CORS |
Burp Repeater, ZAP Manual Request, mitmproxy scripts |
| IoT and remote admin | TCP tunnel to SSH/dashboard on owned device | ssh, scp, rsync, netdata, Home Assistant |
| Database or cache demos | TCP tunnel with allowlist to local DB | psql, mysql, redis-cli, mongosh, sqlmap only against owned labs |
| UDP service tests | CLI/Docker UDP tunnel | WireGuard lab, game servers, VoIP/game protocol tooling |
| Reverse proxy routing | Wildcard domain + multi-forwarding | Traefik, nginx, Kubernetes port-forward, Docker Compose |
When an operation needs SOCKS pivoting through a compromised host, prefer chisel. Use Pinggy when a public SaaS ingress endpoint is acceptable and fast setup matters more than stealth or routing.
CLI, SDK, Docker, and APIs
# CLI install and basic use
npm install -g pinggy
pinggy --help
pinggy -l 8000
pinggy --type tcp -l 22
pinggy --serve /path/to/files
# Saved configs and auto-start
pinggy config save my-tunnel -l 3000 [email protected]
pinggy start my-tunnel
pinggy start --all
pinggy start --all --remote-management <API_KEY>- CLI has auto-reconnect, JSON-style saved configuration, file-server mode, logging, and remote management.
- Node.js SDK: use
@pinggy/pinggy,pinggy.forward({ forwarding: "localhost:5000" }), then readtunnel.urls(). - Python SDK: install
pinggy, thenpinggy.start_tunnel(forwardto="localhost:8000"). - Pro API can list active tunnels and query session history with
Authorization: Bearer <API_KEY>.
Egress-Constrained Clients
# HTTP proxy with nc/ncat
ssh -p443 -R0:localhost:4000 -o ProxyCommand="nc -X connect -x 192.0.2.10:3128 %h %p" a.pinggy.io
ssh -p443 -R0:localhost:4000 -o ProxyCommand="ncat --proxy-type http --proxy 192.0.2.10:3128 %h %p" a.pinggy.io
# SSH-over-SSL when only TLS egress is allowed
ssh -p443 -R0:localhost:4000 -o ProxyCommand="openssl s_client -quiet -connect %h:%p" a.pinggy.io
ssh -p7878 -R0:localhost:4000 -o ProxyCommand="ncat --ssl %h %p" a.pinggy.ioUse these only when policy allows outbound proxy/TLS tunneling. On Windows, PuTTY proxy settings or installed OpenSSL/ncat can fill the same role.
Troubleshooting
| Symptom | Fix |
|---|---|
| Password prompt | Press Enter, type any string, or generate an SSH key for long-running tunnels. |
| Windows tunnel cannot reach service | Replace localhost with 127.0.0.1. |
| URL changes | Free tunnels are random and time-limited; use Pro persistent subdomain/custom domain. |
| UDP not working with SSH | Use Pinggy CLI or Docker; SSH-only UDP is not supported. |
| Advanced options ignored | Add -t and avoid -N. |
| Token already active | Stop it in dashboard or use TOKEN+force@.... |
| Sensitive data visible in debugger | Switch from HTTP to tls and terminate TLS locally. |
| Public exposure too broad | Add b:, k:, w:, shorten runtime, or bind local service to a disposable lab instance. |
Resources
| File | When to load |
|---|---|
references/usage-matrix.md |
Full use-case coverage, offensive lab pairings, quickstart recipe taxonomy, and feature-to-protocol mapping. |
הקבצים בגרסה הזו
references/17.5 KB
- usage-matrix.md7.5 KB
- SKILL.md9.7 KB
הרשאות
| הרשאה | הוצהר | נמצא בסריקה |
|---|---|---|
| קורא קבצים | לא | לא |
| כותב קבצים | כן | כן |
| מריץ פקודות shell | כן | כן |
| משתמש ברשת | כן | כן |
| משתמש במחברים | לא | לא |
| שולט בדפדפן | לא | לא |
ממצאי הסריקה
נבדק ב-13 בנוב׳ 2026
- בינוניתPrompt injection · injection.no_confirmationreferences/usage-matrix.md:105
- מידעקישור · קישורים לדומיינים חיצוניים
סריקה נקייה מורידה את הסיכון, אבל לא מוכיחה שהחבילה בטוחה. כדאי לקרוא מה מתקינים.
| גרסה | פורסמה | Commit | SHA-256 | חתימה | שינוי בהרשאות |
|---|---|---|---|---|---|
| v2026.11.13-21cd568 | 13 בנוב׳ 2026 | 21cd568 | f4c47af7 | חתומה | – |
עוד מ-AeonDave
הכול מהמפרסם הזהעוד בקטגוריה רשת, אלחוט ותקשורת
לקטגוריה- performing-network-packet-capture-analysismukul975/performing-network-packet-capture-analysis4
- network-segmentation-reviewsecurityskills/network-segmentation-review3
- performing-ssl-stripping-attackmukul975/performing-ssl-stripping-attack3
- implementing-next-generation-firewall-with-palo-altomukul975/implementing-next-generation-firewall-with-palo-alto3
- configuring-zscaler-private-access-for-ztnamukul975/configuring-zscaler-private-access-for-ztna3
- implementing-canary-tokens-for-network-intrusionmukul975/implementing-canary-tokens-for-network-intrusion3
שאלו כל מה שהסקופ מאפשר.
יוצרים חשבון, מוסיפים קרדיטים ושואלים את השאלה הראשונה בצ׳אט או בטרמינל.
- 1/3
יצירת חשבון
פרטי או חברה. אפשר לעבור לחשבון חברה אחר כך בלי לאבד יתרה או מפתחות.
פרטיחברה - 2/3
הוספת קרדיטים
בכרטיס אשראי. תשלום לפי טוקן, בלי מנוי.
$5.00טעינה מינימלית - 3/3
שאלה ראשונה
בצ׳אט, או להתקין את ה-CLI ולהריץ notholy login בטרמינל.
$ notholy login