tailscale-proxy 1.2.0 → 1.4.0

package/README.md

@@ -3,8 +3,23 @@
 [![ci](https://github.com/meabed/tailscale-proxy/actions/workflows/ci.yml/badge.svg)](https://github.com/meabed/tailscale-proxy/actions/workflows/ci.yml)
 [![release](https://github.com/meabed/tailscale-proxy/actions/workflows/release.yml/badge.svg)](https://github.com/meabed/tailscale-proxy/actions/workflows/release.yml)
 [![npm](https://img.shields.io/npm/v/tailscale-proxy)](https://www.npmjs.com/package/tailscale-proxy)
+[![docs](https://img.shields.io/badge/docs-tailscaleproxy.vercel.app-blue)](https://tailscaleproxy.vercel.app)
 
-📖 **Docs:** https://tailscaleproxy.vercel.app · sources in [`website/`](website)
+## ⚡ Start in one command
+
+```bash
+npx tailscale-proxy
+```
+
+That's it — no install, no config. It discovers your running dev servers and shares
+them all through one Tailscale URL. (First time? Run `npx tailscale-proxy doctor` to
+check Tailscale is set up — see [Requirements](#requirements).)
+
+```bash
+brew install meabed/tap/tsp && tsp     # or install the binary, then run `tsp`
+```
+
+---
 
 An open-source, **self-hosted [ngrok](https://ngrok.com) alternative** built on
 [Tailscale](https://tailscale.com). Discover your local dev servers by **port**,
@@ -85,6 +100,18 @@ Supported: **macOS, Linux, Windows, WSL** (amd64 + arm64).
 Update later with **`tsp update`** — it self-updates a standalone binary, or prints
 `brew upgrade tsp` / `npm i -g tailscale-proxy@latest` for managed installs.
 
+### Desktop app (menu bar / tray)
+
+Prefer clicking to typing? There's a tray-first desktop app (Wails) that drives the
+same engine in-process — start/stop, switch Funnel/Serve, open service URLs, and
+**start at login** — sharing the same `~/.tailscale-proxy/config.json` as the CLI.
+
+```bash
+cd desktop && go build -o tsp-app . && ./tsp-app
+```
+
+Build/packaging details: [`desktop/README.md`](desktop/README.md).
+
 ---
 
 ## Commands
@@ -116,6 +143,7 @@ Run `tsp start --help` for all flags. Global: `-h/--help`, `-v/--version`.
 | `--https-port <n>` | `443` | Public/tailnet HTTPS port (Funnel: `443`/`8443`/`10000`) |
 | `--deregister-cycles <n>` | `5` | Missing scans before a gone service is removed |
 | `--forward-host` | off | Forward the public host to apps via `X-Forwarded-Host/Proto`. Default presents a **local** request so apps behave exactly like `localhost` |
+| `--accept-dns <bool>` | unset | Optionally `tailscale set --accept-dns=<true\|false>` on start. Unset = leave it alone. `false` lets a tailnet host resolve the **public** funnel name (persists after exit) |
 | `--bg` | off | Run detached (logs → `./tsp.log`) |
 | `--proxy-only` | off | Run the proxy only; print the `tailscale` command |
 | `--log-requests` | on | Log each proxied request |
@@ -146,7 +174,7 @@ use). Flags override config at runtime; the file is the source of defaults.
 {
   "ports": "3000-5000", "all": false, "runtimes": "", "private": false,
   "bind": "127.0.0.1", "port": 8443, "interval": 20, "httpsPort": 443,
-  "logRequests": true, "deregisterCycles": 5, "forwardHost": false
+  "logRequests": true, "deregisterCycles": 5, "forwardHost": false, "acceptDns": ""
 }
 ```
 
@@ -177,6 +205,26 @@ Step-by-step with screenshots-worth-of-detail: **[docs/EXAMPLES.md](docs/EXAMPLE
 
 ## How it works
 
+```mermaid
+flowchart LR
+    C["Caller<br/>internet or tailnet"]
+    C -->|"https://node.ts.net/web/foo"| TS
+    subgraph machine["your machine"]
+        direction TB
+        TS["tailscale funnel | serve<br/>TLS · :443 / 8443 / 10000"]
+        P["tsp proxy<br/>net/http · :8443"]
+        SCAN["discovery loop<br/>lsof·ps / netstat·tasklist"]
+        D1["127.0.0.1:4983<br/>web · bun"]
+        D2["127.0.0.1:3000<br/>api · node"]
+        TS -->|plain HTTP| P
+        P -->|"/web/foo → strip → /foo<br/>Host → localhost:4983"| D1
+        P --> D2
+        SCAN -->|"slug → port map"| P
+        SCAN -.->|"scan every --interval"| D1
+        SCAN -.-> D2
+    end
+```
+
 1. Every `--interval` seconds, `tsp` lists listening TCP sockets in the range
    (macOS/Linux via `lsof`+`ps`, Windows via `netstat`+`tasklist`), classifies the
    runtime, and derives a slug from the nearest project-root folder
@@ -187,7 +235,23 @@ Step-by-step with screenshots-worth-of-detail: **[docs/EXAMPLES.md](docs/EXAMPLE
 3. `tailscale serve|funnel --bg <proxy-port>` exposes the proxy. On exit the entry
    is reset.
 
-More in [docs/HOW-IT-WORKS.md](docs/HOW-IT-WORKS.md).
+**Request routing:**
+
+```mermaid
+flowchart TD
+    R["Request /seg/rest?query"] --> M{"first segment<br/>matches a slug?"}
+    M -->|yes| H["strip segment · Host → localhost:port<br/>set tsp_route cookie"]
+    M -->|"no (prefix-less asset/HMR)"| CK{"tsp_route<br/>cookie set?"}
+    CK -->|yes| FF["forward full path to the cookie's backend"]
+    CK -->|no| NF["404 + list of services"]
+    H --> UP{"backend up?"}
+    FF --> UP
+    UP -->|yes| OK["stream response<br/>(SSE · WebSocket)"]
+    UP -->|no| E502["502"]
+```
+
+More — including the discovery pipeline and lifecycle sequence diagrams — in
+[docs/HOW-IT-WORKS.md](docs/HOW-IT-WORKS.md).
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tailscale-proxy",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Discover local dev servers by port and expose them through one Tailscale Serve/Funnel entry, routed by project name.",
   "keywords": [
     "tailscale",
@@ -74,12 +74,12 @@
     "semantic-release": "^25.0.3"
   },
   "optionalDependencies": {
-    "tailscale-proxy-darwin-arm64": "1.2.0",
-    "tailscale-proxy-darwin-x64": "1.2.0",
-    "tailscale-proxy-linux-x64": "1.2.0",
-    "tailscale-proxy-linux-arm64": "1.2.0",
-    "tailscale-proxy-win32-x64": "1.2.0",
-    "tailscale-proxy-win32-arm64": "1.2.0"
+    "tailscale-proxy-darwin-arm64": "1.4.0",
+    "tailscale-proxy-darwin-x64": "1.4.0",
+    "tailscale-proxy-linux-x64": "1.4.0",
+    "tailscale-proxy-linux-arm64": "1.4.0",
+    "tailscale-proxy-win32-x64": "1.4.0",
+    "tailscale-proxy-win32-arm64": "1.4.0"
   },
   "packageManager": "bun@1.3.14",
   "engines": {