LuCI App for Tailscale (Community)

A community-maintained LuCI application for managing Tailscale on OpenWrt. This app provides a user-friendly web interface to view Tailscale status and configure its settings directly from LuCI.

[!TIP]

This application has been merged into the official OpenWrt LuCI repository. You can now install it directly via the official opkg source. See openwrt/luci#8018 for details.

[!IMPORTANT]

Recommended Version: OpenWrt 23.05 or later.

Note: This application uses ucode as the backend server. Older versions of OpenWrt primarily support Lua-based backends and cannot run the ucode backend logic used by this app.

Features

• Status Dashboard:

• Node Settings:

• Daemon Environment Settings:

Screenshots

Status Page !Status Page Screenshot

Settings Page !Settings Page Screenshot

Installation

Method 1: Official OpenWrt Software Source (Recommended)

If you are using OpenWrt Snapshot, Master, or a future stable release (strictly version > OpenWrt 25.12.0-rc3), you can install it directly from the official repository:

opkg update
opkg install luci-app-tailscale-community

[!TIP]

The tailscale package in official OpenWrt repositories is tied to specific OpenWrt releases and does not receive updates once a version is finalized. Given Tailscale's frequent update cycle, older versions may have security vulnerabilities. For a smaller binary size and timely updates, it is highly recommended to use the GuNanOvO/openwrt-tailscale repository. You can easily install a high-version, optimized Tailscale package by simply importing the key and adding the custom opkg source.

Method 2: Community Software Source (GitHub Pages)

If you are using an older version of OpenWrt or want to use the latest community-specific builds, you can add a custom repository. This method also supports automatic updates.

1. Add the software source:

# Download and add the public key
    wget https://Tokisaki-Galaxy.github.io/luci-app-tailscale-community/all/key-build.pub -O /tmp/key-build.pub
    opkg-key add /tmp/key-build.pub
    # Add the software source
    echo "src/gz tailscale_community https://Tokisaki-Galaxy.github.io/luci-app-tailscale-community/all" >> /etc/opkg/customfeeds.conf
    # Update the list
    opkg update

1. Install the plugin:

opkg install luci-app-tailscale-community

[!TIP]

After installing this way, you can update the plugin later using opkg upgrade luci-app-tailscale-community.

Method 3: Manual Installation (.ipk)

1. download the latest and stable . ipk software package from Github Release.

1. Transfer the .ipk file to your OpenWrt router (e.g., using scp).
2. Install the package using opkg:

opkg install luci-app-tailscale-community_*.ipk

After installation, you should find the "Tailscale" menu under the "Services" tab in LuCI.

Building from Source

You can also build the package yourself using the OpenWrt SDK. The build process is defined in the .github/workflows/build.yml file, which can be used as a reference.

1. Clone the OpenWrt SDK.
2. Clone this repository into the package/ directory of the SDK.
3. Run make menuconfig and select luci-app-tailscale-community under LuCI -> Applications.
4. Run make to compile the package.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.