方法一 使用CloudFlare Pages部署#

1. 点击上面前端的Github链接，跳转到仓库，点击fork按钮，创建自己的仓库。
2. 登录CloudFlare，创建一个Pages项目，选择导入现有 Git 仓库，连接自己的Github账户。
3. 选择自己的仓库，选择master分支，使用环境变量，创建 VITE_API_BASE，输入自己的后端地址。
4. 完成部署，继续配置域名

方法二 自建服务器部署#

1. 克隆仓库代码，在服务器配置Nodejs22

1
git clone https://github.com/1812z/RunTime_Tracker_Web.git
2
cd Runtime_Tracker_Web

2. 修改配置文件，路径 src/config.js，将API地址改为后端地址（注意保留API）。
3. 运行以下指令进行构建项目，生成的 dist 目录下的文件则是构建好的静态文件。

1
npm install
2
npm run build

4. 发布网站到静态服务器。

后续更新#

CloudFlare Pages 会自动同步你仓库的更新，只需要到仓库点击 sync 即可。 如果是自建服务器，则需要自己手动进行构建同步。

Docker Compose 部署#

1. 替换必要文件

1
cp -r .example.env .env

2. 配置环境变量，编辑 .env 文件，修改以下配置：

3. 启动服务

1
# 启动所有服务
2
docker-compose up -d
3

4
# 查看服务状态
5
docker-compose ps
6

7
# 查看日志
8
docker-compose logs -f

4. 访问应用

• 访问 http://localhost:3000/ （若在服务器部署，将localhost替换为服务器IP，有需要也可以搭配反向代理使用）
• API 地址为 ,http://localhost:3000/api

通过Dockerfile部署#

依次运行以下指令

1
docker build -t runtime-tracker .
2
docker run -d -p 3000:3000 --name runtime-tracker runtime-tracker -e SECRET="<API密钥密码>" -e MONGODB_URI="mongodb://<用户名>:<密码>@<数据库地址>:<数据库端口>/<数据库名称>"

上面的docker run指令中，SECRET和MONGODB_URI的值需要根据实际情况进行修改。

手动安装#

1. 配置NodeJS 22 + mongodb 8 (推荐使用1panel或docker一键安装)
2. 编辑 .env 文件，设置好密钥，端口，数据库链接
3. 启动，开放对应端口(前端端口，后端端口)
4. 前端配置文件(config.js)填入后端API地址
5. 对应客户端接入后端API

Android (Macrodroid)#

无障碍+自启动保活，一般情况不会被杀后台，使用更方便。

1. 导入配置文件

• 设备信息上报.category

2. 点击 主屏幕 → 变量 → 右下角+号新建，新建一个SECRET变量和DEVICE_ID，类型为字符串，分别是API密钥和设备名
3. 激活宏，请给予相关权限（无障碍，读取应用列表等）

Windows#

暂时可以用main.py，不完善没有自启动 如果您也在使用这个工具接入Hass，只需要打开前台软件监听即可 PCTools