Mở ứng dụng và dán AuthToken khi được hỏi, hoặc khởi động từ dòng lệnh.
Mở Command Prompt hoặc PowerShell trong thư mục chứa localtonet, rồi chạy:
localtonet --authtoken <YOUR_TOKEN>
Lệnh này lưu token trên máy. Sau khi xác thực, Localtonet đã sẵn sàng để dùng.
Chạy Localtonet dưới dạng Windows Service (tự khởi động):
Cài đặt Localtonet dưới dạng Windows Service để nó tự khởi động mỗi lần bật máy, tiếp tục chạy sau khi đăng xuất và không cần mở terminal. Chạy Command Prompt hoặc PowerShell với quyền Administrator, rồi:
#Tùy chọn: chuyển vào PATH (có thể cần sudo) # sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet #Xác thực
localtonet --authtoken <YOUR_TOKEN>
Chạy Localtonet dưới dạng dịch vụ launchd (tự khởi động):
Cài đặt Localtonet dưới dạng dịch vụ nền để nó tự khởi động mỗi lần bật máy, tiếp tục chạy sau khi đăng xuất và không cần mở terminal. Yêu cầu quyền quản trị viên/root:
#Tùy chọn: chuyển vào PATH (cần sudo) # sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet #Xác thực
~/localtonet/localtonet --authtoken <YOUR_TOKEN>
Chạy Localtonet dưới dạng dịch vụ systemd (tự khởi động):
Cài đặt Localtonet dưới dạng dịch vụ systemd để nó tự khởi động sau mỗi lần khởi động lại, tiếp tục chạy sau khi đăng xuất và không cần mở terminal. Yêu cầu quyền root (cần systemd; không hỗ trợ Termux, hãy dùng ứng dụng Android thay thế):
Tệp unit được tạo tại /etc/systemd/system/localtonet.service. Kiểm tra trạng thái bằng systemctl status localtonet hoặc xem log trực tiếp bằng journalctl -u localtonet -f. Dùng --stop-service, --status-service hoặc --remove-service để quản lý dịch vụ.
1. Cài đặt gói đã tải. Mở terminal trong thư mục chứa localtonet-linux-x64.deb.
sudo apt install ./localtonet-linux-x64.deb
2. Đặt AuthToken của bạn. Sửa /etc/localtonet/auth-token với quyền root và thay DUMMY_AUTH_TOKEN bằng token của bạn trên một dòng duy nhất. Sau đó bảo vệ tệp và kiểm tra cấu hình:
1. Cài đặt gói đã tải. Mở terminal trong thư mục chứa localtonet-linux-arm64.deb.
sudo apt install ./localtonet-linux-arm64.deb
2. Đặt AuthToken của bạn. Sửa /etc/localtonet/auth-token với quyền root và thay DUMMY_AUTH_TOKEN bằng token của bạn trên một dòng duy nhất. Sau đó bảo vệ tệp và kiểm tra cấu hình:
1. Cài đặt gói đã tải. Mở terminal trong thư mục chứa localtonet-linux-x64.rpm.
sudo dnf install ./localtonet-linux-x64.rpm
2. Đặt AuthToken của bạn. Sửa /etc/localtonet/auth-token với quyền root và thay DUMMY_AUTH_TOKEN bằng token của bạn trên một dòng duy nhất. Sau đó bảo vệ tệp và kiểm tra cấu hình:
1. Cài đặt gói đã tải. Mở terminal trong thư mục chứa localtonet-linux-arm64.rpm.
sudo dnf install ./localtonet-linux-arm64.rpm
2. Đặt AuthToken của bạn. Sửa /etc/localtonet/auth-token với quyền root và thay DUMMY_AUTH_TOKEN bằng token của bạn trên một dòng duy nhất. Sau đó bảo vệ tệp và kiểm tra cấu hình:
IPK cho OpenWrt 24.10 · APK v3 cho 25.12+ · x64 và ARM64
Kiểm tra router trước khi cài đặt.
Chọn gói khớp với kiến trúc firmware và kiểm tra dung lượng lưu trữ cũng như RAM còn trống. Không hỗ trợ MIPS, MIPSEL và ARMv7. Các tệp APK này là gói OpenWrt, không phải ứng dụng Android.
Cài đặt gói
Chuyển tệp đã tải lên router, rồi mở phiên SSH với quyền root trong thư mục đó. Kiểm tra kiến trúc trước khi cài đặt.
Các gói chưa được ký và đang thử nghiệm. Hãy kiểm tra khả năng tương thích firmware, tunnel và VPN trên thiết bị của bạn. Không bao giờ ép cài kiến trúc không khớp.
Localtonet cho NAS / Home Assistant
Mẫu cài đặt
Kết nối NAS hoặc Home Assistant với các mẫu triển khai sẵn sàng cấu hình.
Synology Container Manager · QNAP Container Station · Home Assistant
Chọn cách cài đặt cho thiết bị của bạn.
Dùng Docker Compose trên NAS hỗ trợ Docker hoặc máy chủ Home Assistant Container / Core. Home Assistant OS / Supervised dùng mẫu ứng dụng cục bộ đi kèm.
Giải nén các mẫu
Tải về và giải nén tệp ZIP, rồi mở README.txt để xem hướng dẫn cài đặt đầy đủ. Tệp nén bao gồm cả mẫu cho NAS và Home Assistant.
Thiết lập thiết bị
NAS / Docker Compose
Sao chép nas/auth-token.example thành nas/auth-token, nhập AuthToken của bạn và giữ kín tệp này. Kiểm tra rằng tag image trong nas/compose.yaml có sẵn trên registry.
Nhập tệp Compose thành một project trong trình quản lý container, hoặc chạy lệnh này từ thư mục nas:
docker compose up -d
Home Assistant OS / Supervised
Làm theo các bước cài đặt ứng dụng cục bộ trong README.txt, rồi nhập AuthToken vào phần cấu hình ứng dụng.
Tài liệuHướng dẫn cài đặt đầy đủ có trong README.txt
Đây là các mẫu cài đặt, không phải trình cài đặt SPK / QPKG hay ứng dụng chính thức trên cửa hàng Home Assistant. Chúng dùng chế độ mạng host của Linux để truy cập LAN và không bật quyền VPN.
Localtonet cho Android
Tải ứng dụng Android từ Google Play hoặc tải tệp nén APK.