下载

下载 Localtonet

选择你的平台，下载 Localtonet 并开始使用。

选择你的平台

适用于 Windows 的 Localtonet

安装应用，或下载独立的 Windows 版本。

下载

使用你的令牌启动 Localtonet：
打开应用并在提示时粘贴你的 AuthToken，或从命令行启动。

在包含 localtonet 的文件夹中打开命令提示符或 PowerShell，然后运行：

localtonet --authtoken <YOUR_TOKEN>

这会将令牌保存在本地。完成认证后即可使用 Localtonet。

将 Localtonet 作为 Windows 服务运行（开机自启）：
将 Localtonet 安装为 Windows 服务，使其每次开机自动启动、注销后继续运行，且无需保持终端打开。请以管理员身份运行命令提示符或 PowerShell，然后执行：

localtonet --install-service --authtoken <YOUR_TOKEN>

localtonet --start-service --authtoken <YOUR_TOKEN>

可在 services.msc 中查看该服务。使用 --stop-service、--status-service 或 --remove-service 管理该服务。

文档 Windows 文档

适用于 macOS 的 Localtonet

下载 Intel 或 Apple Silicon 版本，或通过 Homebrew 安装。

下载

使用你的令牌启动 Localtonet：
打开应用并在提示时粘贴你的 AuthToken，或从命令行启动。

在包含 localtonet 的文件夹中打开终端，然后运行：

localtonet --authtoken <YOUR_TOKEN>

这会将令牌保存在本地。完成认证后即可使用 Localtonet。

通过 Homebrew 下载并启动：
使用我们的官方 tap 在 macOS 上安装 Localtonet

brew tap localtonet/tap

brew install localtonet

localtonet --version

关于 tap：Homebrew tap 会添加一个第三方仓库，让你可以从中安装和更新 formula。

手动下载：
如果你更喜欢直接下载，请获取适用于你的 Mac 的压缩包并手动安装

curl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip

unzip localtonet-osx-64.zip -d ~/localtonet

chmod 755 ~/localtonet/localtonet

#可选：移动到 PATH（可能需要 sudo） # sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet #认证

localtonet --authtoken <YOUR_TOKEN>

将 Localtonet 作为 launchd 服务运行（开机自启）：
将 Localtonet 安装为后台服务，使其每次开机自动启动、注销后继续运行，且无需保持终端打开。需要管理员/root 权限：

sudo localtonet --install-service --authtoken <YOUR_TOKEN>

sudo localtonet --start-service --authtoken <YOUR_TOKEN>

该任务注册在 ~/Library/LaunchAgents/ 下。使用 --stop-service、--status-service 或 --remove-service 管理该服务。

文档 macOS 文档

适用于 Linux 的 Localtonet

为你的架构选择对应版本，或使用快速安装脚本。

下载

使用你的令牌启动 Localtonet：
打开应用并在提示时粘贴你的 AuthToken，或从命令行启动。

在包含 localtonet 的文件夹中打开终端，然后运行：

localtonet --authtoken <YOUR_TOKEN>

这会将令牌保存在本地。完成认证后即可使用 Localtonet。

快速安装：
这条单行命令会检测你的 CPU/操作系统，下载正确的版本，并安装到 /usr/local/bin/localtonet

curl -fsSL https://localtonet.com/install.sh | sh

为什么可能需要 sudo：安装到 /usr/local/bin 以及管理系统服务通常需要管理员权限。

手动下载：
如果你更喜欢直接下载，请获取适用于你的 Linux 系统的压缩包并手动安装

wget https://localtonet.com/download/localtonet-linux-x64.zip

unzip localtonet-linux-x64.zip -d ~/localtonet

chmod 755 ~/localtonet/localtonet

#可选：移动到 PATH（需要 sudo） # sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet #认证

~/localtonet/localtonet --authtoken <YOUR_TOKEN>

将 Localtonet 作为 systemd 服务运行（开机自启）：
将 Localtonet 安装为 systemd 服务，使其每次重启后自动启动、注销后继续运行，且无需保持终端打开。需要 root 权限（必须有 systemd；不支持 Termux，请改用 Android 应用）：

sudo localtonet --install-service --authtoken <YOUR_TOKEN>

sudo localtonet --start-service --authtoken <YOUR_TOKEN>

单元文件创建于 /etc/systemd/system/localtonet.service。使用 systemctl status localtonet 查看状态，或使用 journalctl -u localtonet -f 查看实时日志。使用 --stop-service、--status-service 或 --remove-service 管理该服务。

文档 Linux 文档

Linux 软件包

适用于 x64 和 ARM64 的可安装 DEB 与 RPM 软件包。需要 systemd 247 或更高版本以及 OpenSSL 3，例如 Debian 12、Ubuntu 22.04+ 或 RHEL 9。

Debian / Ubuntu · x64
安装说明

1. 安装下载的软件包。在包含 localtonet-linux-x64.deb 的目录中打开终端。
```
sudo apt install ./localtonet-linux-x64.deb
```
2. 设置你的 AuthToken。以 root 身份编辑 /etc/localtonet/auth-token，将 DUMMY_AUTH_TOKEN 替换为你的令牌（单独一行）。然后保护该文件并检查配置：
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. 启动服务。配置检查通过后：
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
如需使用 VPN，请切换到 VPN 服务：
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
升级时，安装新的软件包并运行 sudo systemctl restart localtonet。你的配置会被保留。

如果你使用 VPN，请改为重启 localtonet-vpn.service。
Debian / Ubuntu · ARM64
安装说明

1. 安装下载的软件包。在包含 localtonet-linux-arm64.deb 的目录中打开终端。
```
sudo apt install ./localtonet-linux-arm64.deb
```
2. 设置你的 AuthToken。以 root 身份编辑 /etc/localtonet/auth-token，将 DUMMY_AUTH_TOKEN 替换为你的令牌（单独一行）。然后保护该文件并检查配置：
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. 启动服务。配置检查通过后：
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
如需使用 VPN，请切换到 VPN 服务：
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
升级时，安装新的软件包并运行 sudo systemctl restart localtonet。你的配置会被保留。

如果你使用 VPN，请改为重启 localtonet-vpn.service。
Fedora / RHEL · x64
安装说明

1. 安装下载的软件包。在包含 localtonet-linux-x64.rpm 的目录中打开终端。
```
sudo dnf install ./localtonet-linux-x64.rpm
```
2. 设置你的 AuthToken。以 root 身份编辑 /etc/localtonet/auth-token，将 DUMMY_AUTH_TOKEN 替换为你的令牌（单独一行）。然后保护该文件并检查配置：
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. 启动服务。配置检查通过后：
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
如需使用 VPN，请切换到 VPN 服务：
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
升级时，安装新的软件包并运行 sudo systemctl restart localtonet。你的配置会被保留。

如果你使用 VPN，请改为重启 localtonet-vpn.service。
Fedora / RHEL · ARM64
安装说明

1. 安装下载的软件包。在包含 localtonet-linux-arm64.rpm 的目录中打开终端。
```
sudo dnf install ./localtonet-linux-arm64.rpm
```
2. 设置你的 AuthToken。以 root 身份编辑 /etc/localtonet/auth-token，将 DUMMY_AUTH_TOKEN 替换为你的令牌（单独一行）。然后保护该文件并检查配置：
```
sudo chmod 600 /etc/localtonet/auth-token
sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
```
3. 启动服务。配置检查通过后：
```
sudo systemctl enable --now localtonet.service
sudo journalctl -u localtonet.service
```
如需使用 VPN，请切换到 VPN 服务：
```
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service
```
升级时，安装新的软件包并运行 sudo systemctl restart localtonet。你的配置会被保留。

如果你使用 VPN，请改为重启 localtonet-vpn.service。

适用于 OpenWrt 的 Localtonet

实验性

使用与你的固件和架构匹配的软件包，在路由器上运行 Localtonet。

下载

OpenWrt 24.10 使用 IPK · 25.12+ 使用 APK v3 · x64 与 ARM64

安装前请检查你的路由器。 确保软件包与固件架构匹配，并检查可用存储空间和内存。不支持 MIPS、MIPSEL 和 ARMv7。这些 APK 文件是 OpenWrt 软件包，而不是 Android 应用。

安装软件包

将下载的文件传到路由器，然后在该目录中打开 root SSH 会话。安装前请确认架构。

opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk
添加你的 AuthToken

以 root 身份编辑 /etc/localtonet/auth-token。将 DUMMY_AUTH_TOKEN 替换为你的令牌（单独一行），然后保护该文件并验证配置。

chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config
启用开机自启

配置检查通过后，启用服务并查看其日志。

uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonet

升级时，安装新的软件包并重启服务即可。你的配置会被保留。

文档软件包安装说明

软件包未签名，属于实验性质。请在你的设备上验证固件兼容性、隧道和 VPN。切勿强制安装架构不匹配的软件包。

适用于 NAS / Home Assistant 的 Localtonet

部署模板

使用开箱即可配置的部署模板，连接你的 NAS 或 Home Assistant。

部署模板 ZIP · AMD64 / ARM64

下载

Synology Container Manager · QNAP Container Station · Home Assistant

为你的设备选择部署方式。 在支持 Docker 的 NAS 或 Home Assistant Container / Core 主机上使用 Docker Compose。Home Assistant OS / Supervised 使用随附的本地应用模板。

解压模板

下载并解压 ZIP 文件，然后打开 README.txt 查看完整的安装说明。压缩包中同时包含 NAS 和 Home Assistant 模板。
配置你的设备

NAS / Docker Compose

将 nas/auth-token.example 复制为 nas/auth-token，填入你的 AuthToken 并妥善保管该文件。确认 nas/compose.yaml 中的镜像标签在镜像仓库中可用。

在容器管理器中将 Compose 文件导入为项目，或在 nas 目录中运行以下命令：

docker compose up -d

Home Assistant OS / Supervised

按照 README.txt 中的本地应用安装步骤操作，然后在应用配置中填入你的 AuthToken。

文档完整安装指南见 README.txt

这些是部署模板，不是 SPK / QPKG 安装包，也不是 Home Assistant 官方商店中上架的应用。模板使用 Linux 主机网络以访问局域网，不会启用 VPN 权限。

适用于 Docker 的 Localtonet

使用官方 Docker 镜像在容器中运行 Localtonet。

前往 Docker Hub

使用你的令牌启动 Localtonet：
确保你使用的是最新版本的 Localtonet

docker pull localtonet/localtonet

启动容器并传入你的令牌。

docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

这会将令牌保存在本地。完成认证后即可使用 Localtonet。

文档 Docker 文档

下载 Localtonet

适用于 Windows 的 Localtonet

适用于 macOS 的 Localtonet

适用于 Linux 的 Localtonet

Linux 软件包

适用于 OpenWrt 的 Localtonet

安装软件包

添加你的 AuthToken

启用开机自启

适用于 NAS / Home Assistant 的 Localtonet

解压模板

配置你的设备

NAS / Docker Compose

Home Assistant OS / Supervised

适用于 Android 的 Localtonet

适用于 Docker 的 Localtonet

免安装 SSH