One-command Tailscale deployment for any OpenWrt router — including devices too old or too small for official packages.
The official tailscale opkg package and luci-app-tailscale require OpenWrt ≥ 23.05 and sufficient storage. Many real-world routers don't meet these requirements. This project fills that gap.
| Official opkg | This project | |
|---|---|---|
| OpenWrt version | ≥ 23.05 | ≥ 21.02 |
| Binary size | ~30-35 MB | ~8-10 MB (UPX compressed) |
| Install method | opkg feed + SDK | Single wget command |
| Binary management | Manual opkg upgrade | Auto-update via cron |
| Flash requirement | ~50 MB free | ~8 MB (or RAM-only mode) |
| ucode / rpcd-mod-ucode | Required | Not required |
wget -O /usr/bin/tailscale-manager https://raw.githubusercontent.com/fl0w1nd/openwrt-tailscale/main/tailscale-manager.sh && chmod +x /usr/bin/tailscale-manager && tailscale-managerThen follow the interactive prompts.
- One-command install — interactive menu handles dependency detection, download, and service setup
- Small binary — UPX-compressed Tailscale (~8-10 MB), 80% smaller than official packages
- Auto-updates — daily cron for Tailscale binary and management script self-update
- Dual download source — choose between official full binaries or compressed small binaries
- Subnet routing — one-click network interface and firewall configuration
- Full OpenWrt integration — UCI config, procd service, optional LuCI web UI
- Userspace fallback — works even without kernel TUN support
- RAM mode — run entirely from
/tmpfor devices with minimal flash storage - LuCI management UI — status monitoring, service control, version management, and log viewer
Full documentation is available at the project site, including:
- Installation Guide
- Download Sources (Official vs Small binary)
- Storage Modes (Persistent vs RAM)
- Subnet Routing
- CLI Commands
- Configuration Reference
- LuCI Web UI
- Troubleshooting
- Roadmap
中文文档:https://fl0w1nd.github.io/openwrt-tailscale/zh/
See LICENSE file.