From 6e728413377d355bc8c40e1cfaa0ea4f8b527903 Mon Sep 17 00:00:00 2001
From: yukkop <hectic.yukkop@gmail.com>
Date: Tue, 31 Mar 2026 20:09:27 +0000
Subject: [PATCH] docs: `neuro`: router forwarding

---
 nixos/system/neuro/ROUTER.md | 61 ++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 nixos/system/neuro/ROUTER.md

diff --git a/nixos/system/neuro/ROUTER.md b/nixos/system/neuro/ROUTER.md
new file mode 100644
index 0000000..79ef7a4
--- /dev/null
+++ b/nixos/system/neuro/ROUTER.md
@@ -0,0 +1,61 @@
+# Router Access (TP-Link)
+
+The server `neuro` is behind a NAT router at `192.168.0.1`.
+
+## Network Info
+
+| Device | IP |
+|--------|-----|
+| Router (TP-Link) | 192.168.0.1 |
+| neuro (internal) | 192.168.0.10 |
+| neuro (external) | 95.31.254.84 |
+
+## Access Router Admin Panel
+
+The router blocks requests with non-local `Host` headers, so SSH port forwarding
+with `-L` returns 403. Use a SOCKS proxy instead:
+
+1. Start SSH SOCKS proxy:
+   ```sh
+   ssh -D 1080 neuro
+   ```
+
+2. Launch browser with SOCKS proxy:
+   ```sh
+   nix run nixpkgs#chromium -- --proxy-server="socks5://localhost:1080"
+   # or
+   nix run nixpkgs#firefox -- # then configure manually (see below)
+   ```
+
+3. Navigate to **http://192.168.0.1**
+
+### Firefox Manual Configuration
+
+1. Settings -> Network Settings -> Settings...
+2. Select "Manual proxy configuration"
+3. SOCKS Host: `localhost`, Port: `1080`, SOCKS v5
+4. Click OK
+
+## Port Forwarding
+
+Ports that need to be forwarded from router to `192.168.0.10`:
+
+| External Port | Internal Port | Protocol | Service |
+|---------------|---------------|----------|---------|
+| 22 | 22 | TCP | SSH |
+| 80 | 80 | TCP | HTTP |
+| 443 | 443 | TCP | HTTPS |
+| 4443 | 4443 | TCP | Jitsi |
+| 5222 | 5222 | TCP | XMPP (c2s) |
+| 5269 | 5269 | TCP | XMPP (s2s) |
+| 10000 | 10000 | UDP | Jitsi Videobridge |
+| 25565 | 25565 | TCP | Minecraft |
+
+## Troubleshooting
+
+Check if ports are open externally:
+```sh
+nix run nixpkgs#nmap -- -Pn -p 80,443 95.31.254.84
+```
+
+Expected: `open` (not `filtered`)