144 lines
6.5 KiB
Markdown
144 lines
6.5 KiB
Markdown
---
|
|
title: Tailscale
|
|
type: infrastructure
|
|
status: active
|
|
created: 2026-07-26
|
|
updated: 2026-10-19
|
|
verified_on: 2026-10-19
|
|
confidence: high
|
|
tags: [tailscale, vpn, networking, infrastructure]
|
|
---
|
|
|
|
# Tailscale
|
|
|
|
## Purpose
|
|
WireGuard-based mesh VPN connecting all homelab hosts and providing HTTPS access via Tailscale Serve.
|
|
|
|
## Domain
|
|
- **Tailnet:** `kangaroo-eel.ts.net`
|
|
- **Primary node:** CT460 (`hermes.kangaroo-eel.ts.net`, `100.118.5.51`)
|
|
- **Runtipi node:** CT201 (`runtipi.kangaroo-eel.ts.net`)
|
|
|
|
## Tailscale Node Inventory (verified 2026-10-19)
|
|
Full node list from `tailscale status` — **49 non-funnel nodes** (48 live IPv4 peers + `hermes` itself). Offline peers are listed with their last-seen age.
|
|
Re-verified 2026-10-16: the 2026-10-11 table had drifted (15 nodes missing, several states wrong).
|
|
Re-verified 2026-10-16: `omarchymac` (100.84.180.69) added; `mattermost` state, offline ages and the omni/omarchymac rows refreshed from `tailscale status`.
|
|
Re-verified 2026-10-19 00:2x: three live peers had never been listed — `guest-vps` (100.117.14.84, online), `openmausbot` (100.91.214.91, online) and `openmausbot-vm` (100.77.107.30, online) — added; `mattermost` offline age 26d → **29d**. `tailscale status` reports 71 peers total, of which 23 are Tailscale's own entries (see the note below); the 48 with IPv4 addresses are the homelab set.
|
|
|
|
| Node | IP | State |
|
|
|---|---|---|
|
|
| hermes | 100.118.5.51 | **self** |
|
|
| agentzero | 100.106.54.94 | online |
|
|
| anthonys-imac | 100.112.123.124 | idle/offline 22d |
|
|
| anthonys-ipad | 100.111.198.120 | online |
|
|
| anthonys-iphone | 100.100.116.67 | online |
|
|
| anthonys-mac-mini | 100.74.17.15 | online |
|
|
| cachyos | 100.124.208.15 | idle/offline 42d |
|
|
| clawtest | 100.122.189.81 | online |
|
|
| cliproxyapi | 100.83.112.94 | online |
|
|
| cloudreve | 100.111.187.7 | idle/offline 83d |
|
|
| conduit | 100.81.79.87 | idle/offline 39d |
|
|
| docker-01 | 100.121.12.31 | online |
|
|
| docker | 100.96.150.69 | online |
|
|
| elementsynapse | 100.75.250.37 | idle/offline 86d |
|
|
| freellmapi | 100.127.208.75 | online |
|
|
| freshrss-new | 100.110.180.115 | idle/offline 59d |
|
|
| freshrss | 100.83.60.93 | online |
|
|
| gitea | 100.82.100.128 | online |
|
|
| guest-vps | 100.117.14.84 | online |
|
|
| hermesagent | 100.98.205.112 | online |
|
|
| homeassistant | 100.68.139.5 | active; offers exit node |
|
|
| litellm | 100.79.29.64 | online |
|
|
| m93p | 100.104.51.98 | online |
|
|
| mailflow | 100.115.60.92 | online |
|
|
| mattermost | 100.98.116.14 | active; relay "syd"; idle/offline 29d — CT255 stopped (re-verified live 2026-10-19) |
|
|
| n8n | 100.84.124.30 | online |
|
|
| nextcloud | 100.90.102.19 | online |
|
|
| ntfy | 100.67.153.116 | active |
|
|
| ollama | 100.108.44.119 | online |
|
|
| omarchy | 100.73.227.103 | online |
|
|
| omarchymac | 100.84.180.69 | online |
|
|
| omarchybook | 100.107.9.100 | online |
|
|
| omni | 100.93.204.4 | idle/offline 59d |
|
|
| omniroute-1 | 100.78.63.20 | active |
|
|
| omniroute | 100.88.81.19 | online |
|
|
| openweb | 100.69.230.13 | online |
|
|
| paseo | 100.72.188.93 | online |
|
|
| pve | 100.96.100.82 | online |
|
|
| qwenpaw | 100.110.72.126 | online |
|
|
| rclone | 100.107.116.17 | online |
|
|
| runtipi | 100.96.244.39 | online |
|
|
| rustdesk | 100.95.227.57 | online |
|
|
| sftpgo | 100.88.223.70 | active |
|
|
| social-dashboard | 100.70.183.37 | online |
|
|
| ubuntu-server-xfce | 100.101.26.104 | idle/offline 55d |
|
|
| vaultwarden | 100.123.225.90 | online |
|
|
| webserver | 100.82.40.23 | online |
|
|
|
|
> Note: `tailscale status` also lists 23 `funnel-ingress-node` peers with IPv6-only addresses — these are Tailscale's Funnel infrastructure, not homelab hosts, and are deliberately excluded above.
|
|
>
|
|
> Note: Tailscale's offline list is not authoritative for container state — cross-check `pct list` on the PVE host.
|
|
|
|
## CT460 Serve Routes
|
|
| Path | Target | Notes |
|
|
|---|---|---|
|
|
| `/` | `http://127.0.0.1:9119` | Hermes WebUI |
|
|
| `/ui` | `http://127.0.0.1:5175/` | Hermes UI (Vite) |
|
|
| `/jobs` | `http://127.0.0.1:9099` | Jobs Dashboard |
|
|
| `/wiki` | `http://100.118.5.51:9120` | Agent Estate Wiki (Quartz) |
|
|
| `/ignis` | `http://127.0.0.1:8080` | Ignis (browser-native Obsidian) |
|
|
| `/webui` | `http://127.0.0.1:8787/` | Hermes WebUI (Standalone) |
|
|
| `/gitea` | `http://100.82.100.128:3000` | Gitea |
|
|
| `/desktop` | `http://127.0.0.1:6081` | CUA noVNC |
|
|
| `/vnc-camofox` | `http://127.0.0.1:6080` | Camofox VNC |
|
|
| `/synergy-prep` | `http://127.0.0.1:9123/` | Synergy prep |
|
|
| `/agent-estate` | `http://127.0.0.1:8769` | Role dashboard — target is the bare host root, **not** `/agent-estate-role-dashboard.html` (corrected 2026-10-11) |
|
|
| `/evening-grid.html` | `http://127.0.0.1:9099/evening-grid.html` | Evening grid |
|
|
|
|
Verified against `tailscale serve status` on 2026-10-11.
|
|
|
|
## CT460 Funnel and 9443 Routes
|
|
| Port | Target | Notes |
|
|
|---|---|---|
|
|
| `:8443/webhook` | `http://127.0.0.1:8085/webhook` | Public webhook Funnel (`# Funnel on:` confirmed) |
|
|
| `:9443` (tailnet only) `/` | `http://127.0.0.1:5173` | Vite dev server on port 5173 exposed via a **tailnet-only** Serve on port 9443 — was missing from this page, added 2026-10-11 |
|
|
|
|
## CT201 Serve Routes
|
|
| Path | Target | Notes |
|
|
|---|---|---|
|
|
| `:8443` | `http://localhost:8082` | Homepage dashboard |
|
|
| `/steel` | `http://127.0.0.1:5173` | Steel Browser UI |
|
|
| `/steel-api` | `http://127.0.0.1:3000` | Steel Browser API (path prefix not stripped — use direct IP for API calls) |
|
|
|
|
## Atomic Restore Script
|
|
`/home/hermes/.hermes/scripts/tailscale-serve-apply.sh` — Rebuilds the complete CT460 route table, including tailnet Serve on `:443` and public Funnel on `:8443`.
|
|
|
|
`tailscale serve reset` clears Funnel state as well as Serve state. The atomic script therefore restores `/webhook` after rebuilding the 443 routes. Do not use the older Serve-only restore path for complete recovery.
|
|
|
|
## Key Commands
|
|
```bash
|
|
# Check routes
|
|
tailscale serve status
|
|
|
|
# Rebuild routes (CT460)
|
|
/home/hermes/.hermes/scripts/tailscale-serve-apply.sh --dry-run
|
|
/home/hermes/.hermes/scripts/tailscale-serve-apply.sh
|
|
|
|
# Add route
|
|
tailscale serve --set-path /jobs http://127.0.0.1:9099
|
|
|
|
# Remove route
|
|
tailscale serve --set-path /jobs off
|
|
```
|
|
|
|
## Notes
|
|
- Port 443 occupied by Traefik on CT201 — Tailscale uses port 8443 there
|
|
- CT460 has no conflict — Tailscale uses 443 directly
|
|
- Routes must be re-added in order (restore script handles this)
|
|
- After every rebuild, verify that `tailscale serve status` contains both the `:443` Serve routes and the `:8443/webhook` Funnel route.
|
|
|
|
## Related
|
|
- [[infrastructure/domains-and-tunnels]] — Full DNS and tunnel inventory
|
|
- [[systems/homepage-dashboard]] — Homepage on CT201 via Tailscale
|
|
- [[runbooks/job-radar]] — Dashboard incident and route verification
|