常见问题

第一次接触？先看项目简介了解项目概况和前置要求。

安装

安装时出现 "failed log upload" 错误？

这是正常现象，可以忽略。不影响功能。

如何更新 Tailscale？

# APK（OpenWrt 25.12+）
apk update && apk upgrade tailscale

# OPKG（OpenWrt 24.10-）
opkg update && opkg upgrade tailscale

使用

Tailscale 不断重启？

可能是内存不足（OOM）导致的。参见内存优化。

可以和 LuCI 一起用吗？

可以！安装 luci-app-tailscale-community 获取图形化管理界面。详见 LuCI 管理界面。

更新/重装会影响 luci-app-tailscale-community 等依赖包吗？

不会。依赖按包名 tailscale 建立，本仓库保持包名不变；持久更新/重装使用强制重装并保留包记录，/etc/config/tailscale 配置不会被覆盖；模式切换期间 LuCI 仍可通过 /usr/sbin/tailscale 正常调用 CLI。

卸载时提示 "tailscale 仍被包管理器登记"？

说明有包依赖 tailscale（例如 luci-app-tailscale-community），包管理器拒绝了删除。脚本为避免破坏依赖包会中止卸载并恢复服务；请先卸载依赖它的包后重试：

# OpenWrt 25.12+
apk del luci-app-tailscale-community
# OpenWrt 24.10-
opkg remove luci-app-tailscale-community

构建

如何将最新版 Tailscale 编入自编译固件？

如果你自己编译 OpenWrt 固件，且官方 packages feed 只提供旧版 tailscale，有两种方式：

1. 预编译 ipk 直接安装（无需编译）：下载对应架构的 ipk 后 opkg install
2. 一键脚本 build_feed.sh：自动替换 Go 工具链、注册 feed、移除官方旧包并编译

详细步骤见自编译固件。

UPX 影响性能吗？

UPX 在启动时解压二进制。解压非常快（毫秒级），之后以原生速度运行。内存开销可以忽略。

还有问题？

• GitHub Issues — 搜索或提交新问题