# 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/`.