洛雪音乐数据同步服务端，本项目目前用于收藏列表数据同步，类似原来PC端的数据同步服务，只不过它现在是一个独立版的服务，可以将其部署到服务器上使用。
本项目需要有一些服务器操作经验的人使用，若遇到问题欢迎反馈。
由于服务本身不提供https协议支持，若将服务部署在公网，请务必使用Nginx之类的服务做反向代理，实现客户端到服务器之间的https连接。
- Node.js 16+
Cent OS可以运行以下命令安装：
yum install -y gcc-c++ make
curl -sL https://rpm.nodesource.com/setup_16.x | sudo -E bash -
sudo yum install nodejs -y安装完毕后输入以下命令正常情况下会显示Node.js的版本号
node -vPM2是一个Node.js服务管理工具，可以在服务崩溃时自动重启，更多使用方式请自行百度
npm i -g pm2若没有安装PM2，则后面pm2开头的命令都可以跳过
若安装依赖过程中出现因utf-8-validate包编译失败的错误，请尝试搜索相关错误解决，若实在无法解决，则可以编辑package.json文件删除dependencies下的utf-8-validate后，重新运行npm install --omit=dev或npm install即可
如果你是在release下载的压缩包，则解压后项目目录执行以下命令安装依赖：
npm install --omit=dev如果你是直接下载的源码，则在本目录中运行以下命令
npm install
npm run build按照文件中的说明配置好本目录下的config.js文件
可以在这里配置PM2的启动配置，具体根据你的需求配置
npm run prd若你没有安装PM2，则可以用npm start启动
pm2 logs若无报错相关的日志，则说明服务启动成功
注意： 该命令对Windows系统无效，Windows需用批处理的方式设置
pm2 save
pm2 startup到这里服务已搭建完成，但是为了你的数据安全，我们强烈建议使用Nginx之类的服务为同步服务添加 TLS 保护！
编辑Nginx配置文件，在server下添加 LX Sync 的代理规则：
location /xxx/ { # 该规则用于代理路径下的http请求
proxy_set_header X-Real-IP $remote_addr; # 该头部与config.ts文件的 proxy.header 对应
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_set_header Connection "";
proxy_set_header X-Nginx-Proxy true;
proxy_pass http://127.0.0.1:9527;
proxy_redirect default;
}
location /xxx { # 该规则用于代理路径下的ws请求
proxy_set_header X-Real-IP $remote_addr; # 该头部与config.ts文件的 proxy.header 对应
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header X-Nginx-Proxy true;
proxy_pass http://127.0.0.1:9527;
proxy_redirect default;
}
注：上面的xxx是你想要代理的路径（可以多级），注意$remote_addr的转发名字与config.ts中的proxy.header对应，同时启用proxy.enabled，这用于校验相同IP多次使用错误连接码连接时的封禁
| 变量名称 | 说明 |
|---|---|
PORT |
绑定的端口号，默认9527 |
BIND_IP |
绑定的IP地址，默认127.0.0.1，使用0.0.0.0将接受所有IP请求 |
PROXY_HEADER |
代理转发的请求头 原始IP，如果设置，则自动启用 |
CONFIG_PATH |
配置文件路径，默认使用项目目录下的config.js |
LOG_PATH |
服务日志保存路径，默认保存在服务目录下的logs文件夹内 |
DATA_PATH |
同步数据保存路径，默认保存在服务目录下的data文件夹内 |
MAX_SNAPSHOT_NUM |
公共最大备份快照数 |
SERVER_NAME |
同步服务名称 |
LIST_ADD_MUSIC_LOCATION_TYPE |
公共添加歌曲到我的列表时的方式可用值为 top、bottom |
LX_USER_ |
以LX_USER_开头的环境变量将被识别为用户配置，可用的配置语法为：1. LX_USER_user1='xxx'2. LX_USER_user1='{"password":"xxx"}'其中 LX_USER_会被去掉，剩下的user1为用户名，xxx为用户密码，配置方式1为简写模式，只指定用户名及密码，其他配置使用公共配置， 配置方式2为JSON字符串格式，配置内容参考 config.js，由于该方式在变量名指定了用户名，所以JSON里的用户名是可选的 |
- 查看服务列表：
pm2 list - 服务控制台的输出日志：
pm2 logs - 重启服务：
pm2 restart服务名称/编号 - 停止服务：
pm2 stop服务名称/编号
可以使用以下方式构建docker镜像（Dockerfile用的是源码构建）：
docker build -t lx-music-sync-server .