LuCI App for Tailscale (社区版)

一个社区维护的 LuCI 应用，用于在 OpenWrt 上管理 Tailscale。此应用提供了一个友好的 Web 界面，让您可以直接从 LuCI 查看 Tailscale 状态和配置其设置。

[!TIP] 本应用已被 OpenWrt 官方 LuCI 仓库收录，推荐直接使用官方 opkg 源进行安装。详情参见 openwrt/luci#8018。

[!IMPORTANT] 推荐版本: OpenWrt 23.05 及以上。

说明: 本应用使用 ucode 作为后端服务器。低版本 OpenWrt 仅支持 Lua 后端，无法运行基于 ucode 的后端逻辑。

功能特性

• 状态仪表盘:
• 查看 Tailscale 服务的运行状态。
• 显示设备的 Tailscale IPv4 和 IPv6 地址。
• 查看您的 Tailnet 域名。

• 详细的网络设备（节点）列表，包括：

  • 在线/离线状态。
  • 主机名和 DNS 名称。
  • Tailscale IP 地址。
  • 操作系统。
  • 连接类型（例如，直连、中继）。
  • 离线设备的最后在线时间。

• 节点设置:

• 使用 tailscale set 命令即时应用设置，无需重启服务。
• 切换 接受路由。
• 切换 作为出口节点。
• 配置 广播路由。
• 设置要使用的特定 出口节点。
• 在使用出口节点时切换 允许访问 LAN。
• 启用/禁用子网路由的 SNAT。
• 启用/禁用内置 SSH 服务器。
• 切换 Shields Up 模式。

• 设置自定义主机名。

• 守护进程环境设置:

• 为 Tailscale 守护进程配置环境变量（需要重启服务）。
• 为有问题的网络设置自定义 MTU。
• 为资源受限的设备启用内存优化模式。

界面截图

状态页面

设置页面

安装

方式 1：官方 OpenWrt 软件源 (推荐)

如果您使用的是 OpenWrt Snapshot、Master 或未来的稳定版本（要求版本 > OpenWrt 25.12.0-rc3），可以直接从官方仓库安装：

opkg update
opkg install luci-app-tailscale-community

[!TIP] OpenWrt 官方软件源中的 tailscale 软件包版本通常随发行版固化，一旦发布便不再提供更新。鉴于 Tailscale 的更新频率极高，旧版本可能存在安全漏洞且占用空间较大。为了获得更小的包体积和及时的安全更新，强烈建议参考 GuNanOvO/openwrt-tailscale 的安装方法。该仓库提供的方式仅需导入密钥并添加自定义 opkg 源，即可安装高版本、小体积的 tailscale 软件包。

方式 2：社区软件源 (GitHub Pages)

如果您使用的是旧版本 OpenWrt 或希望能通过添加自定义软件源方便地使用 opkg 进行安装和自动更新，可以执行以下步骤：

1. 添加软件源: 在路由器终端执行以下命令： bash # 下载并添加公钥 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 # 添加软件源 echo "src/gz tailscale_community https://Tokisaki-Galaxy.github.io/luci-app-tailscale-community/all" >> /etc/opkg/customfeeds.conf # 更新列表 opkg update

2. 安装插件: bash opkg install luci-app-tailscale-community

[!TIP] 这种方式安装后，以后可以直接通过 opkg upgrade luci-app-tailscale-community 来更新插件。

方式 3：手动安装 (.ipk)

1. 从 Github Release 下载最新稳定的 .ipk 软件包。
2. 如果有特殊需求，也可以从GitHub Actions artifacts 下载最新的基于调试用途的 .ipk 软件包。
3. 将 .ipk 文件传输到您的 OpenWrt 路由器（例如，使用 scp）。
4. 使用 opkg 安装软件包：

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

安装后，您应该能在 LuCI 的“服务”选项卡下找到“Tailscale”菜单。

从源码构建

您也可以使用 OpenWrt SDK 自行构建此软件包。构建过程在 .github/workflows/build.yml 文件中定义，可作为参考。

1. 克隆 OpenWrt SDK。
2. 将此仓库克隆到 SDK 的 package/ 目录下。
3. 运行 make menuconfig 并在 LuCI -> Applications 下选择 luci-app-tailscale-community。
4. 运行 make 编译软件包。

许可证

本项目采用 Apache 2.0 许可证。详情请参阅 LICENSE 文件。# luci-app-tailscale-community