You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+30-23Lines changed: 30 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,20 @@
1
1
# luci-app-tailscale-ng
2
2
3
-
LuCI web interface for managing [Tailscale](https://tailscale.com/) on OpenWRT routers.
3
+
LuCI web interface for managing [Tailscale](https://tailscale.com/) on OpenWrt routers.
4
4
5
-
Inspired by [asvow/luci-app-tailscale](https://github.com/asvow/luci-app-tailscale), this project is a ground-up redesign that eliminates conflicts with the standard OpenWRT `tailscale` package.
5
+
Inspired by [asvow/luci-app-tailscale](https://github.com/asvow/luci-app-tailscale), this project is a major redesign that eliminates conflicts with the standard OpenWrt `tailscale` package. See [Motivation](#motivation) for details.
6
+
7
+
## Quick Install
8
+
9
+
Auto-detects `opkg` / `apk` and installs the latest release:
10
+
11
+
```shell
12
+
wget -qO- https://raw.githubusercontent.com/vad-b/luci-app-tailscale-ng/main/install.sh | sh
13
+
```
14
+
15
+
After installation, navigate to **VPN -> Tailscale NG** in the LuCI web interface.
16
+
17
+
Need manual package install options instead? See [Manual Installation](#manual-installation).
6
18
7
19
## Screenshots
8
20
@@ -21,18 +33,23 @@ Inspired by [asvow/luci-app-tailscale](https://github.com/asvow/luci-app-tailsca
21
33
22
34
## Motivation
23
35
24
-
The goals of `luci-app-tailscale-ng` are:
25
-
26
-
- keep integration non-conflicting with the standard OpenWRT `tailscale` package
27
-
- make the OpenWRT Tailscale UI closer to the Tailscale management UI in pfSense and OPNsense
36
+
### Problem
28
37
29
-
The original [asvow/luci-app-tailscale](https://github.com/asvow/luci-app-tailscale) project is excellent and inspired this work, but its integration model is tightly coupled to core files from the OpenWRT`tailscale` package, which leads to two operational drawbacks:
38
+
The original [asvow/luci-app-tailscale](https://github.com/asvow/luci-app-tailscale) project is excellent and inspired this work, but its integration model is tightly coupled to core files from the OpenWrt`tailscale` package, which leads to three operational drawbacks:
30
39
31
-
-**Invasive Installation** - installation overwrites original `/etc/init.d/tailscale` and `/etc/config/tailscale` files.
32
-
-**Breaking Uninstallation** - uninstall removes these required files; restoring normal Tailscale operation requires manual file recreation or reinstalling the `tailscale` package.
40
+
-**Invasive install:** During installation, `asvow/luci-app-tailscale` replaces core `tailscale` files (`/etc/init.d/tailscale` and `/etc/config/tailscale`) and takes ownership of them.
41
+
-**Breaking uninstallation:** When `asvow/luci-app-tailscale` is removed, those same files are deleted, leaving the stock `tailscale` package non-functional.
42
+
-**Restore normal operation:** To recover normal Tailscale operation, you must recreate the removed files manually or reinstall the `tailscale` package.
33
43
34
44
See [asvow/luci-app-tailscale#31](https://github.com/asvow/luci-app-tailscale/issues/31) for details.
35
45
46
+
### Solution
47
+
48
+
The goals of `luci-app-tailscale-ng` are:
49
+
50
+
- keep integration non-conflicting with the standard OpenWrt `tailscale` package
51
+
- make the OpenWrt Tailscale UI closer to the Tailscale management UI in pfSense and OPNsense
52
+
36
53
## How it works
37
54
38
55
**luci-app-tailscale-ng** takes a non-invasive approach:
@@ -57,9 +74,7 @@ This means you can install and remove the package at any time without breaking y
57
74
- Live status dashboard (tailscale status, IP, interface, netcheck, DNS)
58
75
- Automatic settings reapply on network interface changes via hotplug
59
76
60
-
## Current limitations
61
-
62
-
This package focuses on managing `tailscale up` command-line parameters. It does **not** automatically create network interfaces or firewall rules for Tailscale traffic - you may need to configure these manually if your setup requires it.
77
+
> **Right now** this package provides Tailscale management in LuCI (service control, `tailscale up` settings, and status visibility). It does **not** automatically create Tailscale interfaces or firewall rules yet. See [Roadmap](#roadmap) for planned automation.
63
78
64
79
## Roadmap
65
80
@@ -68,32 +83,24 @@ This package focuses on managing `tailscale up` command-line parameters. It does
68
83
- Backup and restore of the Tailscale state file
69
84
- Update Tailscale directly from the web UI (both standard and size-optimized builds for memory-constrained devices)
70
85
71
-
## Installation
86
+
## Manual Installation
72
87
73
-
### Quick install (auto-detects `opkg` / `apk`)
74
-
75
-
```shell
76
-
wget -qO- https://raw.githubusercontent.com/vad-b/luci-app-tailscale-ng/main/install.sh | sh
77
-
```
78
-
79
-
### Manual install (`opkg` / `.ipk`)
88
+
### Install with `opkg` (`.ipk`)
80
89
81
90
Download the latest `.ipk` package from [Releases](https://github.com/vad-b/luci-app-tailscale-ng/releases), upload it to the router's `/tmp` directory, then:
82
91
83
92
```shell
84
93
opkg install /tmp/luci-app-tailscale-ng_*.ipk
85
94
```
86
95
87
-
### Manual install (`apk`/ `.apk`)
96
+
### Install with `apk`(`.apk`)
88
97
89
98
Download the latest `.apk` package from [Releases](https://github.com/vad-b/luci-app-tailscale-ng/releases), upload it to the router's `/tmp` directory, then:
0 commit comments