# 无源标靶上位机

## 本地开发

### 启动开发服务器

```bash

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

```

### 环境配置

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

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

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

## 部署说明

### 部署步骤

**打包**
```shell
npm run pack
```

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


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

1. 从项目的 [release](https://gitea.anxinyun.cn/qinjian/wuyuanbiaoba_web/releases) 页面下载最新的打包文件,如 `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`

### 离线版本说明
离线部署包构建指令
```shell
npm run build:offline
```
该指令执行后会连接到某个远程的linux环境，进行部署包的构建：详情请查看 `script/package-app-offline.sh` 文件

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

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

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



## 构建打包

```bash

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

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