使用已有 dist 打包（跳过前端构建）

# 打包说明

更新日期：2026-07-31

版本：v1.1.0

打包脚本

项目根目录的 build-package.ps1 是一键打包脚本。

用法

# 使用已有 dist 打包（跳过前端构建）
powershell -ExecutionPolicy Bypass -File build-package.ps1 -SkipFrontendBuild

# 重新构建前端并打包
powershell -ExecutionPolicy Bypass -File build-package.ps1

产物

• 路径：dist/tracker-analytics-v1.1.0.zip
• 大小：约 0.25 MB
• 文件数：57 个

包结构

tracker-analytics-v1.1.0/
├── backend/              # 后端代码
│   ├── api/              # 12 个 API 模块
│   ├── app.py            # Flask 入口
│   ├── config.py         # 配置
│   ├── database.py       # ClickHouse 连接池
│   ├── user_store.py     # 用户存储（SQLite）
│   ├── gunicorn.conf.py  # 生产 WSGI 配置
│   ├── requirements.txt  # Python 依赖
│   └── data/             # 运行时数据目录（空）
├── frontend/dist/        # 前端构建产物（已构建）
├── deploy/               # 部署配置
│   ├── Dockerfile        # 单镜像方案
│   ├── docker-compose.yml
│   ├── .env.example      # 环境变量模板
│   ├── scripts/          # 启动/停止脚本
│   ├── DEPLOY.md         # 部署指南
│   ├── UPGRADE.md        # 升级指南
│   └── VERSION           # 版本号
└── README.md             # 交付说明

打包排除项

• pycache/ — Python 缓存
• venv/ — 虚拟环境
• users.db — 用户数据库（运行时生成）
• *.pyc — 编译字节码

运维人员操作步骤

1. 解压 ZIP 包
2. cd deploy && cp .env.example .env
3. 编辑 .env 配置 ClickHouse
4. docker-compose up -d --build
5. 访问 http://localhost:5000（admin / clklog）

重新打包

如需重新打包（例如前端代码更新后），在项目根目录执行：

powershell -ExecutionPolicy Bypass -File build-package.ps1

如果 Node.js 可用，脚本会自动重新构建前端；否则使用已有的 frontend/dist/。

版本历史

版本	日期	说明
v1.1.0	2026-07-31	初始打包版本，包含全部功能