无源标靶上位机

本地开发

启动开发服务器

# 本地开发模式（使用 localdev 环境标识）
npm run start:dev

环境配置

项目使用 config.cjs 进行配置，支持以下环境变量：

• NODE_ENV: 运行环境（development | production）
• PORT: 服务端口（默认 5000）
• API: API 代理目标地址

本地开发模式（npm run start:dev）会自动设置 FS_FLAG=localdev 环境变量。

部署说明

部署步骤

打包

npm run pack

特别注意 版本更新记得更改 package.json 文件中的版本号

确保下位机已经安装了 nodejs 环境,并且版本在 20 以上(推荐v20.19.3)，注意，nodejs 环境必须是 root 用户可用的，服务自启动需要 systemd 的操作权限。

1. 从项目的 release 页面下载最新的打包文件,如 wuyuanbiaoba-web-x.x.x.tar.gz
2. 上传到服务器的临时目录,如 ~/deploy/(这里最好建立一个新的目录存放压缩文件)
3. 进入该目录,解压文件 tar -xzf wuyuanbiaoba-web-x.x.x.tar.gz
4. 进入解压后的目录 cd wuyuanbiaoba-web-x.x.x
5. 运行部署脚本 sudo ./deploy.sh
6. 脚本会自动停止现有服务,备份旧版本,安装新版本,并启动服务
7. 部署完成后,可以通过 sudo systemctl status wuyuanbiaoba-web.service 查看服务状态
8. 查看日志 journalctl -u wuyuanbiaoba-web.service -f

离线版本说明

离线部署包构建指令

npm run build:offline

该指令执行后会连接到某个远程的linux环境，进行部署包的构建：详情请查看 script/package-app-offline.sh 文件

在线版本与离线版本的区别： 针对设备无法联网的情况，提供离线安装包，离线安装包包含了所有的依赖包，无需联网即可完成安装。

！！！！注意，依然需要nodejs环境

离线安装包的部署步骤与在线版本相同，只需下载离线安装包 wuyuanbiaoba-web-x.x.x-offline.tar.gz 即可。

构建打包

# 打包在线部署版本
npm run pack

# 打包离线部署版本
npm run pack:offline

发行

将修改版本提交至gitea的版本发布即可，或进行其他的管理