[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AYPCVTNTN4VPJ5EFHJWC8C":3,"skill-same:01M7AYPCVTNTN4VPJ5EFHJWC8C":71},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":38,"commitSha":39,"skillDirectory":40,"forksCount":41,"repositoryHtmlUrl":42,"repositoryHomepageUrl":6,"ownerHtmlUrl":43,"ownerBlogUrl":44,"ownerDescription":45,"updatedAt":46,"install":47,"resources":60},"01M7AYPCVTNTN4VPJ5EFHJWC8C","homelab-infra-setup",null,"Set up a homelab server from bare metal — SSH hardening, UFW, fail2ban, Docker, Tailscale, Cloudflare Tunnel, Nginx reverse proxy. Works on Ubuntu LTS.","oat431\u002Fhermes_config_backup","oat431","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F54722120?v=4","01M7AYD07EH8SYPMYY8CGZKS22","Oralita","01M7AYD0816QDF77E3TWCRSQC9",1,"Unlicense","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fhermes-main-profile\u002Fhomelab-infra-setup\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: homelab-infra-setup\ndescription: Set up a homelab server from bare metal — SSH hardening, UFW, fail2ban, Docker, Tailscale, Cloudflare Tunnel, Nginx reverse proxy. Works on Ubuntu LTS.\ntriggers:\n  - \"set up a homelab server\"\n  - \"configure a new server\"\n  - \"harden SSH\"\n  - \"set up cloudflare tunnel\"\n  - \"set up tailscale on server\"\n  - \"reverse proxy with nginx\"\n  - \"bare metal server setup\"\n  - \"set up database containers\"\n  - \"docker compose for databases\"\n  - \"seaweedfs setup\"\n  - \"rclone onedrive backup\"\n  - \"adguard home setup\"\n  - \"homelab audit\"\n---\n\n# Homelab Infrastructure Setup\n\nComplete server setup from bare metal to production-ready. Designed for Ubuntu LTS (tested on 24.04 and 26.04).\n\n## Execution Order\n\nExecute in this exact order. Each step depends on the previous.\n\n### 1. SSH Key Setup\n\n```bash\n# On local machine\nmkdir -p ~\u002F.ssh && chmod 700 ~\u002F.ssh\nssh-keygen -t ed25519 -C \"label@server\" -f ~\u002F.ssh\u002Fid_homelab -N \"\"\nssh-copy-id -i ~\u002F.ssh\u002Fid_homelab user@server-ip\nssh -o BatchMode=yes user@server-ip \"echo ok\"\n```\n\n**Pitfall:** On Windows Git Bash, ed25519 keys with passphrases fail to sign (`we did not send a packet`). Use RSA or generate ed25519 without passphrase (`-N \"\"`) for automation.\n\n**Pitfall:** If `ssh-copy-id` fails with stdin issues, use:\n```bash\nPUB_KEY=$(cat ~\u002F.ssh\u002Fid_homelab.pub)\nssh user@server \"echo '$PUB_KEY' >> ~\u002F.ssh\u002Fauthorized_keys\"\n```\n\n**Pitfall:** After reinstalling a server, old host keys block SSH. Fix: `ssh-keygen -R \u003Cserver-ip>`\n\n### 2. Enable Passwordless Sudo (for automation)\n\n```bash\n# On the server\necho 'user ALL=(ALL) NOPASSWD:ALL' | sudo tee \u002Fetc\u002Fsudoers.d\u002Fuser\n```\n\nRevoke later: `sudo rm \u002Fetc\u002Fsudoers.d\u002Fuser`\n\n### 3. SSH Hardening\n\n```bash\nsudo tee \u002Fetc\u002Fssh\u002Fsshd_config.d\u002Fhardened.conf > \u002Fdev\u002Fnull \u003C\u003C 'EOF'\nPasswordAuthentication no\nPermitRootLogin no\nAllowUsers youruser\nEOF\nsudo systemctl restart sshd\n```\n\n### 4. UFW Firewall\n\n```bash\nsudo apt update && sudo apt install -y ufw\nsudo ufw default deny incoming\nsudo ufw default allow outgoing\nsudo ufw allow ssh\necho 'y' | sudo ufw enable\n```\n\n### 5. Fail2ban\n\n```bash\nsudo apt install -y fail2ban\nsudo systemctl enable --now fail2ban\n```\n\n### 6. Docker\n\n```bash\nsudo apt install -y ca-certificates curl\nsudo install -m 0755 -d \u002Fetc\u002Fapt\u002Fkeyrings\nsudo curl -fsSL https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu\u002Fgpg -o \u002Fetc\u002Fapt\u002Fkeyrings\u002Fdocker.asc\nsudo chmod a+r \u002Fetc\u002Fapt\u002Fkeyrings\u002Fdocker.asc\n\nARCH=$(dpkg --print-architecture)\nCODENAME=$(. \u002Fetc\u002Fos-release && echo $VERSION_CODENAME)\necho \"deb [arch=$ARCH signed-by=\u002Fetc\u002Fapt\u002Fkeyrings\u002Fdocker.asc] https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu $CODENAME stable\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fdocker.list\n\nsudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin\nsudo groupadd docker 2>\u002Fdev\u002Fnull\nsudo usermod -aG docker user\n```\n\n**Pitfall:** The repo line must use the actual codename (e.g., `resolute` for 26.04). When running via SSH, variable expansion can break — write the line in a separate SSH command, not inline with escaping.\n\n### 7. Tailscale\n\n```bash\ncurl -fsSL https:\u002F\u002Ftailscale.com\u002Finstall.sh | sh\nsudo tailscale up  # prints auth URL — user clicks it\nsudo systemctl enable tailscaled\n```\n\nTailscale assigns a stable IP per device (100.x.x.x). Doesn't change on reboot, ISP change, or server move.\n\n### 8. Cloudflare Tunnel\n\n```bash\n# Install binary directly (apt repo may not have newest Ubuntu)\ncurl -fsSL https:\u002F\u002Fgithub.com\u002Fcloudflare\u002Fcloudflared\u002Freleases\u002Flatest\u002Fdownload\u002Fcloudflared-linux-amd64 -o \u002Ftmp\u002Fcloudflared\nsudo install -m 755 \u002Ftmp\u002Fcloudflared \u002Fusr\u002Flocal\u002Fbin\u002Fcloudflared\n\n# Authenticate\ncloudflared tunnel login  # prints URL — user clicks it, selects domain\n\n# Create tunnel\ncloudflared tunnel create homelab\n\n# Configure\ncat > ~\u002F.cloudflared\u002Fconfig.yml \u003C\u003C EOF\ntunnel: \u003Ctunnel-id>\ncredentials-file: \u002Fhome\u002Fuser\u002F.cloudflared\u002F\u003Ctunnel-id>.json\n\ningress:\n  - hostname: '*.yourdomain.com'\n    service: http:\u002F\u002Flocalhost:80\n  - hostname: yourdomain.com\n    service: http:\u002F\u002Flocalhost:80\n  - service: http_status:404\nEOF\n\n# Route DNS\ncloudflared tunnel route dns homelab '*.yourdomain.com'\ncloudflared tunnel route dns homelab yourdomain.com\n\n# Install as service\nsudo mkdir -p \u002Fetc\u002Fcloudflared\nsudo cp ~\u002F.cloudflared\u002Fconfig.yml \u002Fetc\u002Fcloudflared\u002F\nsudo cp ~\u002F.cloudflared\u002F\u003Ctunnel-id>.json \u002Fetc\u002Fcloudflared\u002F\nsudo cloudflared service install\nsudo systemctl enable --now cloudflared\n```\n\n**Pitfall:** `cloudflared tunnel route dns` fails if a conflicting DNS record already exists. Delete old A\u002FCNAME records first.\n\n**Pitfall:** `cloudflared service install` can't find config if it's only in `~\u002F.cloudflared\u002F`. Copy to `\u002Fetc\u002Fcloudflared\u002F` first.\n\n**Pitfall:** Cloudflare's apt repo may not have packages for newest Ubuntu releases. Use direct binary download instead.\n\n### 9. Nginx Reverse Proxy\n\n```bash\nsudo apt install -y nginx\nsudo systemctl enable --now nginx\n\n# Hide version\nsudo sed -i 's\u002Fserver_tokens build;\u002Fserver_tokens off;\u002F' \u002Fetc\u002Fnginx\u002Fnginx.conf\n\n# Catch-all (drop unknown hosts)\nsudo tee \u002Fetc\u002Fnginx\u002Fsites-available\u002F00-catch-all > \u002Fdev\u002Fnull \u003C\u003C 'EOF'\nserver {\n    listen 80 default_server;\n    listen [::]:80 default_server;\n    server_name _;\n    return 444;\n}\nEOF\nsudo ln -sf \u002Fetc\u002Fnginx\u002Fsites-available\u002F00-catch-all \u002Fetc\u002Fnginx\u002Fsites-enabled\u002F00-catch-all\nsudo rm -f \u002Fetc\u002Fnginx\u002Fsites-enabled\u002Fdefault\n\n# Per-service config template\nsudo tee \u002Fetc\u002Fnginx\u002Fsites-available\u002Fservice.panomete.com > \u002Fdev\u002Fnull \u003C\u003C 'EOF'\nserver {\n    server_name service.panomete.com;\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:PORT;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}\nEOF\nsudo ln -sf \u002Fetc\u002Fnginx\u002Fsites-available\u002Fservice.panomete.com \u002Fetc\u002Fnginx\u002Fsites-enabled\u002F\nsudo nginx -t && sudo systemctl reload nginx\n```\n\nNo DNS changes needed — `*.domain.com` wildcard already points to tunnel.\n\n## Adding a New Subdomain (Nginx + Cloudflare Tunnel)\n\nNo DNS changes needed — `*.domain.com` wildcard already points to tunnel. Just add Nginx config:\n\n```bash\nsudo tee \u002Fetc\u002Fnginx\u002Fsites-available\u002Fservice.domain.com > \u002Fdev\u002Fnull \u003C\u003C 'EOF'\nserver {\n    server_name service.domain.com;\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:PORT;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}\nEOF\nsudo ln -sf \u002Fetc\u002Fnginx\u002Fsites-available\u002Fservice.domain.com \u002Fetc\u002Fnginx\u002Fsites-enabled\u002F\nsudo nginx -t && sudo systemctl reload nginx\n```\n\n### HTTPS services (e.g., Portainer on 9443)\n\nWhen a service runs on HTTPS internally with a self-signed cert:\n\n```nginx\nserver {\n    server_name container.panomete.com;\n    location \u002F {\n        proxy_pass https:\u002F\u002F127.0.0.1:7001;\n        proxy_ssl_verify off;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}\n```\n\n**Pitfall:** \"Client sent an HTTP request to an HTTPS server\" → service expects HTTPS but Nginx sends HTTP. Change `proxy_pass` to `https:\u002F\u002F` and add `proxy_ssl_verify off`.\n\n## AdGuard Home \u002F Pi-hole DNS Setup\n\n### Port 53 conflict with systemd-resolved\n\n```bash\nsudo systemctl disable --now systemd-resolved\necho \"nameserver 1.1.1.1\" | sudo tee \u002Fetc\u002Fresolv.conf  # temporary DNS\n# ... start AdGuard container ...\necho \"nameserver 127.0.0.1\" | sudo tee \u002Fetc\u002Fresolv.conf  # point to AdGuard\n```\n\n### Docker port binding for LAN-wide DNS\n\n```yaml\nports:\n  - \"127.0.0.1:7000:3000\"   # web UI — localhost only\n  - \"0.0.0.0:53:53\u002Ftcp\"     # DNS — open for LAN (router can reach it)\n  - \"0.0.0.0:53:53\u002Fudp\"     # DNS — open for LAN\n```\n\nWeb UI on localhost (via Nginx). DNS on `0.0.0.0` so router\u002Fdevices can use it. Safe behind NAT.\n\n### Router DNS\n\nPoint router's **DHCP DNS** (not Static DNS) to server LAN IP. All devices get ad blocking automatically.\n\n## Key Architecture\n\n```\nPublic (anyone)    → Cloudflare Tunnel → Nginx → service\nPrivate (you only) → Tailscale → direct access (SSH, game servers, admin UIs)\n```\n\n- Cloudflare handles TLS at edge — no certbot needed\n- Nginx only receives HTTP on localhost\n- All services bind to `127.0.0.1` — only accessible via Nginx\n- Tailscale for SSH\u002Fmanagement — no public IP needed\n- Wildcard `*.domain.com` in tunnel config — no per-subdomain DNS changes\n- Cloudflare Tunnel is **HTTP\u002FHTTPS only** — TCP\u002FUDP (game servers) go through Tailscale\n\n## Security: Public vs Private Access\n\n| Expose publicly (Cloudflare) | Tailscale only (private) |\n|-----------------------------|--------------------------|\n| Web apps, blog, resume | SSH, Portainer, AdGuard UI |\n| API gateway | Database UIs (SeaweedFS Filer, pgAdmin) |\n| S3 API (has credentials) | Grafana, monitoring dashboards |\n\n**Rule:** If it has admin access or no auth → Tailscale only.\n\n## Database Stack (2026+)\n\n| Use case | Recommended | Notes |\n|----------|-------------|-------|\n| Relational | **PostgreSQL 18** | jsonb, full-text search, extensions |\n| Caching\u002FSessions | **Valkey 9** | Open-source Redis fork. Redis changed licensing 2024. |\n| Object Storage | **SeaweedFS 4.x** | S3-compatible, Apache 2.0. MinIO is now AGPL. |\n| Document DB | **MongoDB 8** | Only if needed. PostgreSQL jsonb covers most cases. |\n\n### Shared database network\n\n```bash\ndocker network create db-network\n```\n\n```yaml\n# Every database and app compose\nnetworks:\n  shared-network:\n    external: true\n    name: db-network\n```\n\nApps connect by container name: `postgres:\u002F\u002Fuser:pass@local-postgres:5432\u002Fdb`\n\n### SeaweedFS S3 gateway pitfall\n\nv4.x changed the flag: `-master=master:9333` → `-filer=filer:8888`:\n```yaml\ncommand: s3 -port=8333 -filer=filer:8888 -config=\u002Fetc\u002Fseaweedfs\u002Fs3.json\n```\n\n## rclone OneDrive (Headless Server)\n\nRun `rclone authorize \"onedrive\"` on your **local PC**, paste token to server.\n\n**Pitfall:** v1.74+ requires `drive_id`. Fetch it:\n```bash\ncurl -s -H \"Authorization: Bearer \u003Ctoken>\" 'https:\u002F\u002Fgraph.microsoft.com\u002Fv1.0\u002Fme\u002Fdrive' | grep '\"id\"'\n```\nAdd `drive_id` and `drive_type = personal` to `~\u002F.config\u002Frclone\u002Frclone.conf`.\n\n## Port Convention\n\n| Range | Purpose |\n|-------|---------|\n| 7000-8000 | Self-hosted apps (AdGuard, Portainer) |\n| 8000-9000 | Personal projects (Gateway, Keycloak) |\n| Default | Databases (Postgres 5432, Valkey 6379, MongoDB 27017, SeaweedFS 8333\u002F9333\u002F8888) |\n\n## Pitfalls\n\n- **Port 53 conflict with systemd-resolved:** If running AdGuard\u002FPi-hole, disable systemd-resolved first and set temporary DNS before starting the container.\n- **Docker group not active immediately:** User must log out and back in (or start new SSH session) for `docker` group to take effect.\n- **server_tokens sed pattern:** Ubuntu 26.04 ships `server_tokens build;` not `server_tokens off;`. The sed pattern must match the actual line.\n- **Host key mismatch after reinstall:** Old host keys in `known_hosts` block SSH after server reinstall. Fix: `ssh-keygen -R \u003Cserver-ip>` before connecting.\n- **Nginx HTTPS proxy:** Services on HTTPS (Portainer, etc.) need `proxy_pass https:\u002F\u002F` + `proxy_ssl_verify off`. Missing this gives \"HTTP request to HTTPS server\" error.\n- **DNS binding for LAN access:** AdGuard\u002FPi-hole DNS must bind to `0.0.0.0:53` (not `127.0.0.1`) for LAN devices to reach it. Web UI stays on localhost.\n- **Admin UIs exposed publicly:** SeaweedFS Filer\u002FMaster, Portainer, AdGuard have no auth or weak auth. Don't put Nginx configs for these — access via Tailscale only.\n- **Nginx `restart` vs `reload`:** Group membership changes (e.g., `usermod -aG user www-data`) require `systemctl restart nginx`, not `reload`. Workers keep old groups until restarted.\n- **Nginx static files in home dir:** Home dirs are 750. Nginx (www-data) can't read them. Fix: `sudo usermod -aG user www-data` + `chmod -R g+rX \u002Fpath\u002F` + `sudo systemctl restart nginx`.\n","# Homelab Infrastructure Setup\n\nComplete server setup from bare metal to production-ready. Designed for Ubuntu LTS (tested on 24.04 and 26.04).\n\n## Execution Order\n\nExecute in this exact order. Each step depends on the previous.\n\n### 1. SSH Key Setup\n\n```bash\n# On local machine\nmkdir -p ~\u002F.ssh && chmod 700 ~\u002F.ssh\nssh-keygen -t ed25519 -C \"label@server\" -f ~\u002F.ssh\u002Fid_homelab -N \"\"\nssh-copy-id -i ~\u002F.ssh\u002Fid_homelab user@server-ip\nssh -o BatchMode=yes user@server-ip \"echo ok\"\n```\n\n**Pitfall:** On Windows Git Bash, ed25519 keys with passphrases fail to sign (`we did not send a packet`). Use RSA or generate ed25519 without passphrase (`-N \"\"`) for automation.\n\n**Pitfall:** If `ssh-copy-id` fails with stdin issues, use:\n```bash\nPUB_KEY=$(cat ~\u002F.ssh\u002Fid_homelab.pub)\nssh user@server \"echo '$PUB_KEY' >> ~\u002F.ssh\u002Fauthorized_keys\"\n```\n\n**Pitfall:** After reinstalling a server, old host keys block SSH. Fix: `ssh-keygen -R \u003Cserver-ip>`\n\n### 2. Enable Passwordless Sudo (for automation)\n\n```bash\n# On the server\necho 'user ALL=(ALL) NOPASSWD:ALL' | sudo tee \u002Fetc\u002Fsudoers.d\u002Fuser\n```\n\nRevoke later: `sudo rm \u002Fetc\u002Fsudoers.d\u002Fuser`\n\n### 3. SSH Hardening\n\n```bash\nsudo tee \u002Fetc\u002Fssh\u002Fsshd_config.d\u002Fhardened.conf > \u002Fdev\u002Fnull \u003C\u003C 'EOF'\nPasswordAuthentication no\nPermitRootLogin no\nAllowUsers youruser\nEOF\nsudo systemctl restart sshd\n```\n\n### 4. UFW Firewall\n\n```bash\nsudo apt update && sudo apt install -y ufw\nsudo ufw default deny incoming\nsudo ufw default allow outgoing\nsudo ufw allow ssh\necho 'y' | sudo ufw enable\n```\n\n### 5. Fail2ban\n\n```bash\nsudo apt install -y fail2ban\nsudo systemctl enable --now fail2ban\n```\n\n### 6. Docker\n\n```bash\nsudo apt install -y ca-certificates curl\nsudo install -m 0755 -d \u002Fetc\u002Fapt\u002Fkeyrings\nsudo curl -fsSL https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu\u002Fgpg -o \u002Fetc\u002Fapt\u002Fkeyrings\u002Fdocker.asc\nsudo chmod a+r \u002Fetc\u002Fapt\u002Fkeyrings\u002Fdocker.asc\n\nARCH=$(dpkg --print-architecture)\nCODENAME=$(. \u002Fetc\u002Fos-release && echo $VERSION_CODENAME)\necho \"deb [arch=$ARCH signed-by=\u002Fetc\u002Fapt\u002Fkeyrings\u002Fdocker.asc] https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu $CODENAME stable\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fdocker.list\n\nsudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin\nsudo groupadd docker 2>\u002Fdev\u002Fnull\nsudo usermod -aG docker user\n```\n\n**Pitfall:** The repo line must use the actual codename (e.g., `resolute` for 26.04). When running via SSH, variable expansion can break — write the line in a separate SSH command, not inline with escaping.\n\n### 7. Tailscale\n\n```bash\ncurl -fsSL https:\u002F\u002Ftailscale.com\u002Finstall.sh | sh\nsudo tailscale up  # prints auth URL — user clicks it\nsudo systemctl enable tailscaled\n```\n\nTailscale assigns a stable IP per device (100.x.x.x). Doesn't change on reboot, ISP change, or server move.\n\n### 8. Cloudflare Tunnel\n\n```bash\n# Install binary directly (apt repo may not have newest Ubuntu)\ncurl -fsSL https:\u002F\u002Fgithub.com\u002Fcloudflare\u002Fcloudflared\u002Freleases\u002Flatest\u002Fdownload\u002Fcloudflared-linux-amd64 -o \u002Ftmp\u002Fcloudflared\nsudo install -m 755 \u002Ftmp\u002Fcloudflared \u002Fusr\u002Flocal\u002Fbin\u002Fcloudflared\n\n# Authenticate\ncloudflared tunnel login  # prints URL — user clicks it, selects domain\n\n# Create tunnel\ncloudflared tunnel create homelab\n\n# Configure\ncat > ~\u002F.cloudflared\u002Fconfig.yml \u003C\u003C EOF\ntunnel: \u003Ctunnel-id>\ncredentials-file: \u002Fhome\u002Fuser\u002F.cloudflared\u002F\u003Ctunnel-id>.json\n\ningress:\n  - hostname: '*.yourdomain.com'\n    service: http:\u002F\u002Flocalhost:80\n  - hostname: yourdomain.com\n    service: http:\u002F\u002Flocalhost:80\n  - service: http_status:404\nEOF\n\n# Route DNS\ncloudflared tunnel route dns homelab '*.yourdomain.com'\ncloudflared tunnel route dns homelab yourdomain.com\n\n# Install as service\nsudo mkdir -p \u002Fetc\u002Fcloudflared\nsudo cp ~\u002F.cloudflared\u002Fconfig.yml \u002Fetc\u002Fcloudflared\u002F\nsudo cp ~\u002F.cloudflared\u002F\u003Ctunnel-id>.json \u002Fetc\u002Fcloudflared\u002F\nsudo cloudflared service install\nsudo systemctl enable --now cloudflared\n```\n\n**Pitfall:** `cloudflared tunnel route dns` fails if a conflicting DNS record already exists. Delete old A\u002FCNAME records first.\n\n**Pitfall:** `cloudflared service install` can't find config if it's only in `~\u002F.cloudflared\u002F`. Copy to `\u002Fetc\u002Fcloudflared\u002F` first.\n\n**Pitfall:** Cloudflare's apt repo may not have packages for newest Ubuntu releases. Use direct binary download instead.\n\n### 9. Nginx Reverse Proxy\n\n```bash\nsudo apt install -y nginx\nsudo systemctl enable --now nginx\n\n# Hide version\nsudo sed -i 's\u002Fserver_tokens build;\u002Fserver_tokens off;\u002F' \u002Fetc\u002Fnginx\u002Fnginx.conf\n\n# Catch-all (drop unknown hosts)\nsudo tee \u002Fetc\u002Fnginx\u002Fsites-available\u002F00-catch-all > \u002Fdev\u002Fnull \u003C\u003C 'EOF'\nserver {\n    listen 80 default_server;\n    listen [::]:80 default_server;\n    server_name _;\n    return 444;\n}\nEOF\nsudo ln -sf \u002Fetc\u002Fnginx\u002Fsites-available\u002F00-catch-all \u002Fetc\u002Fnginx\u002Fsites-enabled\u002F00-catch-all\nsudo rm -f \u002Fetc\u002Fnginx\u002Fsites-enabled\u002Fdefault\n\n# Per-service config template\nsudo tee \u002Fetc\u002Fnginx\u002Fsites-available\u002Fservice.panomete.com > \u002Fdev\u002Fnull \u003C\u003C 'EOF'\nserver {\n    server_name service.panomete.com;\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:PORT;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}\nEOF\nsudo ln -sf \u002Fetc\u002Fnginx\u002Fsites-available\u002Fservice.panomete.com \u002Fetc\u002Fnginx\u002Fsites-enabled\u002F\nsudo nginx -t && sudo systemctl reload nginx\n```\n\nNo DNS changes needed — `*.domain.com` wildcard already points to tunnel.\n\n## Adding a New Subdomain (Nginx + Cloudflare Tunnel)\n\nNo DNS changes needed — `*.domain.com` wildcard already points to tunnel. Just add Nginx config:\n\n```bash\nsudo tee \u002Fetc\u002Fnginx\u002Fsites-available\u002Fservice.domain.com > \u002Fdev\u002Fnull \u003C\u003C 'EOF'\nserver {\n    server_name service.domain.com;\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:PORT;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}\nEOF\nsudo ln -sf \u002Fetc\u002Fnginx\u002Fsites-available\u002Fservice.domain.com \u002Fetc\u002Fnginx\u002Fsites-enabled\u002F\nsudo nginx -t && sudo systemctl reload nginx\n```\n\n### HTTPS services (e.g., Portainer on 9443)\n\nWhen a service runs on HTTPS internally with a self-signed cert:\n\n```nginx\nserver {\n    server_name container.panomete.com;\n    location \u002F {\n        proxy_pass https:\u002F\u002F127.0.0.1:7001;\n        proxy_ssl_verify off;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}\n```\n\n**Pitfall:** \"Client sent an HTTP request to an HTTPS server\" → service expects HTTPS but Nginx sends HTTP. Change `proxy_pass` to `https:\u002F\u002F` and add `proxy_ssl_verify off`.\n\n## AdGuard Home \u002F Pi-hole DNS Setup\n\n### Port 53 conflict with systemd-resolved\n\n```bash\nsudo systemctl disable --now systemd-resolved\necho \"nameserver 1.1.1.1\" | sudo tee \u002Fetc\u002Fresolv.conf  # temporary DNS\n# ... start AdGuard container ...\necho \"nameserver 127.0.0.1\" | sudo tee \u002Fetc\u002Fresolv.conf  # point to AdGuard\n```\n\n### Docker port binding for LAN-wide DNS\n\n```yaml\nports:\n  - \"127.0.0.1:7000:3000\"   # web UI — localhost only\n  - \"0.0.0.0:53:53\u002Ftcp\"     # DNS — open for LAN (router can reach it)\n  - \"0.0.0.0:53:53\u002Fudp\"     # DNS — open for LAN\n```\n\nWeb UI on localhost (via Nginx). DNS on `0.0.0.0` so router\u002Fdevices can use it. Safe behind NAT.\n\n### Router DNS\n\nPoint router's **DHCP DNS** (not Static DNS) to server LAN IP. All devices get ad blocking automatically.\n\n## Key Architecture\n\n```\nPublic (anyone)    → Cloudflare Tunnel → Nginx → service\nPrivate (you only) → Tailscale → direct access (SSH, game servers, admin UIs)\n```\n\n- Cloudflare handles TLS at edge — no certbot needed\n- Nginx only receives HTTP on localhost\n- All services bind to `127.0.0.1` — only accessible via Nginx\n- Tailscale for SSH\u002Fmanagement — no public IP needed\n- Wildcard `*.domain.com` in tunnel config — no per-subdomain DNS changes\n- Cloudflare Tunnel is **HTTP\u002FHTTPS only** — TCP\u002FUDP (game servers) go through Tailscale\n\n## Security: Public vs Private Access\n\n| Expose publicly (Cloudflare) | Tailscale only (private) |\n|-----------------------------|--------------------------|\n| Web apps, blog, resume | SSH, Portainer, AdGuard UI |\n| API gateway | Database UIs (SeaweedFS Filer, pgAdmin) |\n| S3 API (has credentials) | Grafana, monitoring dashboards |\n\n**Rule:** If it has admin access or no auth → Tailscale only.\n\n## Database Stack (2026+)\n\n| Use case | Recommended | Notes |\n|----------|-------------|-------|\n| Relational | **PostgreSQL 18** | jsonb, full-text search, extensions |\n| Caching\u002FSessions | **Valkey 9** | Open-source Redis fork. Redis changed licensing 2024. |\n| Object Storage | **SeaweedFS 4.x** | S3-compatible, Apache 2.0. MinIO is now AGPL. |\n| Document DB | **MongoDB 8** | Only if needed. PostgreSQL jsonb covers most cases. |\n\n### Shared database network\n\n```bash\ndocker network create db-network\n```\n\n```yaml\n# Every database and app compose\nnetworks:\n  shared-network:\n    external: true\n    name: db-network\n```\n\nApps connect by container name: `postgres:\u002F\u002Fuser:pass@local-postgres:5432\u002Fdb`\n\n### SeaweedFS S3 gateway pitfall\n\nv4.x changed the flag: `-master=master:9333` → `-filer=filer:8888`:\n```yaml\ncommand: s3 -port=8333 -filer=filer:8888 -config=\u002Fetc\u002Fseaweedfs\u002Fs3.json\n```\n\n## rclone OneDrive (Headless Server)\n\nRun `rclone authorize \"onedrive\"` on your **local PC**, paste token to server.\n\n**Pitfall:** v1.74+ requires `drive_id`. Fetch it:\n```bash\ncurl -s -H \"Authorization: Bearer \u003Ctoken>\" 'https:\u002F\u002Fgraph.microsoft.com\u002Fv1.0\u002Fme\u002Fdrive' | grep '\"id\"'\n```\nAdd `drive_id` and `drive_type = personal` to `~\u002F.config\u002Frclone\u002Frclone.conf`.\n\n## Port Convention\n\n| Range | Purpose |\n|-------|---------|\n| 7000-8000 | Self-hosted apps (AdGuard, Portainer) |\n| 8000-9000 | Personal projects (Gateway, Keycloak) |\n| Default | Databases (Postgres 5432, Valkey 6379, MongoDB 27017, SeaweedFS 8333\u002F9333\u002F8888) |\n\n## Pitfalls\n\n- **Port 53 conflict with systemd-resolved:** If running AdGuard\u002FPi-hole, disable systemd-resolved first and set temporary DNS before starting the container.\n- **Docker group not active immediately:** User must log out and back in (or start new SSH session) for `docker` group to take effect.\n- **server_tokens sed pattern:** Ubuntu 26.04 ships `server_tokens build;` not `server_tokens off;`. The sed pattern must match the actual line.\n- **Host key mismatch after reinstall:** Old host keys in `known_hosts` block SSH after server reinstall. Fix: `ssh-keygen -R \u003Cserver-ip>` before connecting.\n- **Nginx HTTPS proxy:** Services on HTTPS (Portainer, etc.) need `proxy_pass https:\u002F\u002F` + `proxy_ssl_verify off`. Missing this gives \"HTTP request to HTTPS server\" error.\n- **DNS binding for LAN access:** AdGuard\u002FPi-hole DNS must bind to `0.0.0.0:53` (not `127.0.0.1`) for LAN devices to reach it. Web UI stays on localhost.\n- **Admin UIs exposed publicly:** SeaweedFS Filer\u002FMaster, Portainer, AdGuard have no auth or weak auth. Don't put Nginx configs for these — access via Tailscale only.\n- **Nginx `restart` vs `reload`:** Group membership changes (e.g., `usermod -aG user www-data`) require `systemctl restart nginx`, not `reload`. Workers keep old groups until restarted.\n- **Nginx static files in home dir:** Home dirs are 750. Nginx (www-data) can't read them. Fix: `sudo usermod -aG user www-data` + `chmod -R g+rX \u002Fpath\u002F` + `sudo systemctl restart nginx`.\n",{"name":5,"triggers":24,"description":7},[25,26,27,28,29,30,31,32,33,34,35,36,37],"set up a homelab server","configure a new server","harden SSH","set up cloudflare tunnel","set up tailscale on server","reverse proxy with nginx","bare metal server setup","set up database containers","docker compose for databases","seaweedfs setup","rclone onedrive backup","adguard home setup","homelab audit","main","2988869c5a7d7be2225c9ea7a54a4a56a59b0d45","workflow\u002Fhermes-main-profile\u002Fhomelab-infra-setup",0,"https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup","https:\u002F\u002Fgithub.com\u002Foat431","https:\u002F\u002Fpanomete.com\u002F","Hope and Luck is not a part of the strategy, \r\n\r\nSoftskill produces plan Hard skill produce product.","2026-11-03 00:43:08",{"source":8,"skillName":5,"commands":48,"prompt":58,"zipAvailable":59},[49,52,55],{"tool":50,"command":51},"npx","npx skills add oat431\u002Fhermes_config_backup --skill homelab-infra-setup",{"tool":53,"command":54},"bunx","bunx skills add oat431\u002Fhermes_config_backup --skill homelab-infra-setup",{"tool":56,"command":57},"pnpm","pnpm dlx skills add oat431\u002Fhermes_config_backup --skill homelab-infra-setup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fhermes-main-profile\u002Fhomelab-infra-setup\u002FSKILL.md",true,[61,67],{"path":62,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fdatabase-compose-templates.md","REFERENCE","参考文档",3648,"https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fhermes-main-profile\u002Fhomelab-infra-setup\u002Freferences\u002Fdatabase-compose-templates.md",{"path":68,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fwindows-ssh-workarounds.md",1193,"https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fhermes-main-profile\u002Fhomelab-infra-setup\u002Freferences\u002Fwindows-ssh-workarounds.md",[72,80,87,94,101,108],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AYZ2JY3NFKAPQSC39N5F3F","project-spec-docs","Fill\u002Fupdate project_spec docs (templates, MM handoffs).","MIT","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fproject-spec-docs\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AYYRZPE7HQX7778558X52S","penpot-mcp","Penpot MCP: connect, verify, and fix streaming via nginx.","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fpenpot-mcp\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7AYYNKP61CN2281VMJDXMB5","nginx-streaming-proxy","Configure nginx for streaming endpoints (SSE, MCP, WS).","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fnginx-streaming-proxy\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M7AYYJP0MDV1D3WVEEZB3SGA","branding-ci","Use for brand\u002FCI identity, style guides, and brand docs.","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fbranding-ci\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":19},"01M7AYYGCXVT97DDTCM0ZJT6F6","yuanbao","Yuanbao (元宝) groups: @mention users, query info\u002Fmembers.","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fshared-skills\u002Fyuanbao\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":19},"01M7AYYC2Y65NMGMD4GQXAZMMS","slidev","Create and present web-based slidedecks for developers using Slidev with Markdown, Vue components, code highlighting, animations, and interactive features. Use when building technical presentations, conference talks, code walkthroughs, teaching materials, or developer decks.","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fshared-skills\u002Fslidev\u002FSKILL.md",[],[]]