diff --git a/README.md b/README.md new file mode 100644 index 0000000..f049400 --- /dev/null +++ b/README.md @@ -0,0 +1,65 @@ +# wirecon + +WireGuard tunnel between a **rootless-Docker** internet host and an **unprivileged LXC** on Proxmox, with Caddy reverse-proxying inbound traffic into the LXC's LAN. Tuned for flaky uplinks (Telekom DSL/LTE Hybrid) with a fast-reconnect watchdog and structured journald logging. + +``` + internet Telekom Hybrid (DSL+LTE) + clients ──► Docker host ══════ wg0 (UDP 51820) ══════ LXC ──► 192.168.1.0/24 + (Caddy + (kernel WG + + wireguard-go, watchdog + + rootless) monitor) +``` + +## Install + +### LXC side — one-liner + +On a fresh unprivileged LXC (after you've added the tun passthrough from `proxmox/lxc.conf.snippet` and restarted the container): + +``` +curl -fsSL https://git.d4nn13.de/d4nn13/wirecon/raw/branch/main/lxc/bootstrap.sh | sudo bash +``` + +Then edit `/etc/wireguard/wg0.conf` (keys, endpoint, LAN iface in the `PostUp` rules), optionally tune `/etc/wirecon/wirecon.conf`, and: + +``` +systemctl enable --now wg-quick@wg0 wirecon-watchdog.timer wirecon-monitor.service +journalctl -f -t wirecon-watchdog -t wirecon-monitor +``` + +### Docker side + +On the internet host (rootless Docker daemon already running): + +``` +git clone https://git.d4nn13.de/d4nn13/wirecon.git +cd wirecon/docker +cp wg/config/wg0.conf.example wg/config/wg0.conf # fill in keys +# edit proxy/Caddyfile for your sites +docker compose up -d --build +``` + +Host prereqs: +- `/dev/net/tun` readable by the rootless user +- `sysctl net.ipv4.ip_unprivileged_port_start=80` if you want 80/443 bound directly + +### Proxmox + +Append `proxmox/lxc.conf.snippet` to `/etc/pve/lxc/.conf`, then `pct stop/start `. + +## Layout + +``` +docker/ rootless-Docker stack: wg (wireguard-go) + Caddy sharing netns +lxc/ installer, systemd units, watchdog/monitor/MTU-probe scripts +proxmox/ tun passthrough snippet for unprivileged LXC +``` + +## Tuning + +- **MTU** — default `1280`. Run `wirecon-mtu-probe.sh` on the LXC to find the real path MTU and update `MTU =` on both peers. +- **Watchdog** thresholds (`/etc/wirecon/wirecon.conf`): handshake-age, ping loss, and consecutive-failure streak before a forced `wg-quick down/up`. +- **Logs** — everything is structured `key=value` on journald: + ``` + journalctl -u wirecon-watchdog.service -u wirecon-monitor.service --since "1 hour ago" + ```