XXTLanControl 启动指南 Startup Guide

提示 / Note：
在启动 XXTLanControl 后端之前，请先阅读本说明完成环境准备。启动成功后，可通过后端托管的 Web 文档获取更多信息。
Read this guide before launching the XXTLanControl backend. Once the service is online, additional documentation is available via the hosted web console.

解压与准备

Windows

  1. 将发行包解压到目标路径（例如 D:\XXTLanControl）。
  2. 双击 XXTLanControl-tray-windows-amd64.exe 启动托盘程序。
  3. 托盘区出现 XXTLanControl 图标后，说明托盘程序与后台服务均已就绪。

macOS

  1. 解压发行包后，将 XXTLanControl.app 拖入应用程序文件夹
  2. 下载 Sentinel，打开 Sentinel 并将 XXTLanControl.app 拖入 Sentinel 窗口的 "Allow unsigned app to launch" 区域以放行未签名应用。
  3. 右键点击 XXTLanControl.app，选择 打开。如果出现 “XXTLanControl.app 已损坏，无法打开。您应该将它移到废纸篓” 的提示，请先执行 步骤 2。
  4. 系统托盘（通常是上方菜单栏）出现 XXTLanControl 图标后表示托盘与后台服务已启动。

Linux

  1. 解压发行包后，进入解压目录。
  2. 根据主机架构执行 ./start-backend.sh（脚本会自动选择 XXTLanControl-backend-linux-amd64 或 ...-arm64）。
  3. 若需将服务常驻，可将脚本整合进系统服务管理器或手动保持终端开启。

打开 Web 控制台

  1. 托盘菜单选择“打开控制台”，或访问 http://127.0.0.1:46990/。
  2. Web 界面默认中文，可通过右上角切换英文。
  3. 若中控部署在局域网服务器，请改用服务器 IP，例如 http://192.168.1.100:46990/。

Unpack and Prepare

Windows

  1. Extract the release package to your target path (for example D:\\XXTLanControl).
  2. Double-click XXTLanControl-tray-windows-amd64.exe to launch the tray app.
  3. When the XXTLanControl icon appears in the system tray, both the tray app and backend service are ready.

macOS

  1. After extracting the release, drag XXTLanControl.app into the Applications folder.
  2. Download Sentinel, open Sentinel, and drag XXTLanControl.app into the Sentinel window to allow the unsigned app.
  3. Right-click XXTLanControl.app and choose Open. If you see the prompt “XXTLanControl.app is damaged and can’t be opened. You should move it to the Trash,” complete step 2 first.
  4. Once the XXTLanControl icon appears in the menu bar, the tray app and backend service are running.

Linux

  1. Extract the release package and enter the directory.
  2. Run ./start-backend.sh; the script automatically chooses XXTLanControl-backend-linux-amd64 or ...-arm64 based on the host architecture.
  3. To keep the service persistent, integrate the script with your service manager or keep the terminal session open.

Open the Web Console

  1. Choose “Open Console” from the tray menu or visit http://127.0.0.1:46990/.
  2. The web UI defaults to Simplified Chinese; use the top-right toggle to switch to English.
  3. If the control center runs on a LAN server, use that server’s IP instead—for example http://192.168.1.100:46990/.