同步管理控制台指南

LX Music Sync Server 包含一个 Web 管理控制台（位于系统根路径 /），主要用于查看服务状态、管理用户数据以及配置服务端功能。

登录与鉴权

访问管理控制台（默认 http://IP:9527）需要输入管理员密码。

• 默认密码：123456
• 修改密码：您可以通过设置环境变量 FRONTEND_PASSWORD 覆盖默认密码，或在首次登录后前往设置页面修改。密码会保存在服务端的 config.json 文件中。

功能模块说明

1. 仪表盘 (Dashboard)

显示当前服务的运行状态与基础统计信息：

• 基础指标：显示当前 WebSocket 连接的设备数量、Node.js 进程占用的内存 (RAM) 以及服务启动后的连续运行时间 (Uptime)。
• 用户统计：显示系统中已创建的用户总数。
• 运行日志：前端实时展示控制台日志输出，方便查看请求历史与报错信息。

2. 用户与设备管理 (Access & Devices)

用于管理多账户以及查看当前连接的客户端设备。

• 多账号分离：可以创建多个用户账号，各个账号对应的歌单数据和设置在服务端独立存放，互不影响。
• 设备管理：可以查看当前正在连接服务的客户端设备与 IP 来源，并支持强制断开指定的设备连结。
• 删除用户与清理数据：在删除用户账号时，可以选择同时清除该用户对应在服务器上的所有历史歌单数据和缓存文件。

3. 数据查看 (Data Tracker & Viewer)

用于在网页端直接查阅用户的同步数据。

• 歌单明细查看：可以浏览服务端所保存的所有分类音乐列表、歌曲信息与收藏记录。
• 快照与回滚：系统会在同步发生变更时自动保存歌单数据的历史快照（Snapshot）。当客户端发生误清理或异常覆盖时，可以在这里下载以前的完整数据，或者直接针对服务端进行一键回滚还原。

4. WebDAV 备份与同步 (WebDAV Backup)

用于将服务端数据定期打包传输到第三方 WebDAV 存储。

• 定期备份：配置并启用 WebDAV 账号后，服务端会开启定时任务（默认每 60 分钟），将当前的所有用户记录打包上传至指定网盘。
• 自动拉取恢复：当在一台全新空数据的服务器上初次启动时，若检测到填有 WebDAV 环境变量，服务端会先行从网盘下载最新备份文件并覆盖到本地，借此完成旧数据的导入和恢复。

5. 系统设置与维护

可以在网页执行常规的文件清理操作：

• 缓存清理：点击相关按钮即可命令服务端直接删除旧的媒体缓存文件或日志记录，从而释放磁盘空间。
• 导出日志：可打包下载服务端近期产生的运行异常日志，用于差错分析。