打包分发

智档宝的交付包不是单一程序。一次正式分发通常同时包含前端页面、后端服务、桌面客户端、打印服务、数据库、中间件、搜索服务、文档解析服务和运行监控工具。

这篇文档用于说明当前稳定版本 fdmjj 的打包方式、参考仓库、推荐构建环境和发布检查项。

1. 这篇文档解决什么

打包分发文档面向研发、测试、实施和运维，重点回答四个问题：

问题	说明
包从哪里来	对应哪些 GitLab 仓库和脚本
包怎么命名	如何从包名判断前后端版本
用什么机器打	Linux 离线 Docker 包和 Windows 离线包分别需要什么环境
发出去前查什么	如何确认包能安装、能启动、能追溯版本

2. GitLab 参考仓库

仓库	用途
`fit-archive/fdmjj/docker-install`	Linux Docker 离线包构建脚本、离线 Docker 组件、各架构安装目录模板
`fit-archive/xc-install`	国产化 Linux 老手动安装方式，已弃用，仅作历史参考；之前由 `zks` 负责
`fit-archive/fdmjj/sdv-windows`	Windows 离线包打包脚本、`sdv-test` 运行目录模板、Windows 部署说明
`fit-archive/fdmjj/fit-archive-ng`	智档宝前端、Web dist、Electron 客户端、Linux 客户端包
`fit-archive/fdmjj/smart-doc-vault`	智档宝后端、SQL、Windows / Linux 可执行文件
`fit-archive/windows-service-monitor`	Windows 运行监控工具

这些仓库是打包时的来源，不代表所有定制线都应该从这里发版。历史线、新大屏、hzg、rfid 等版本关系见 3-开发流程。

3. 产物类型和命名规则

当前常见分发包分三类：

产物	命名规则	主要场景
Linux Docker 离线包	`sdv-linux-<arch>-<backend_hash>-<frontend_hash>-<timestamp>.tar.gz`	Linux 服务器、国产化设备、内网离线部署
Windows 离线包	`sdv-windows-<backend_hash>-<frontend_hash>-<timestamp>.zip`	Windows 主机一键安装本地服务
Windows 独立离线包	`fit-archive-ng-<frontend_hash>-<timestamp>.zip`、`smart-doc-vault-<backend_hash>-<timestamp>.zip`	只更新前端或只更新后端

包名中的 backend_hash 来自 smart-doc-vault，frontend_hash 来自 fit-archive-ng。这两个值都是 Git short hash，用于定位代码版本。

发布后需要在 https://fd-one.singzer.cn 的版本搜索里确认版本能反查到对应仓库和提交，避免现场只有压缩包但无法判断来源。

4. 最终发布地址

正式发布后的离线包放在公司网盘对应目录。现场实施和运维优先从这里取包，不直接从构建机临时目录取包。

版本	适配范围	下载地址
智档宝 Windows 版	Windows 主机、本地服务一体安装	智档宝 windows
智档宝 Linux 版	麒麟、UOS、统信、国产化、龙芯、arm64 等	智档宝 linux

发布目录按版本线和架构分层，不把临时包、测试包直接放在根目录。

text

智档宝windows/
└─ fdmjj/
   ├─ README.md
   ├─ sdv-windows-<backend_hash>-<frontend_hash>-<timestamp>.zip
   ├─ fit-archive-ng-<frontend_hash>-<timestamp>.zip
   └─ smart-doc-vault-<backend_hash>-<timestamp>.zip

智档宝linux/
└─ fdmjj/
   ├─ x86_64/
   │  ├─ README.md
   │  └─ sdv-linux-x86_64-<backend_hash>-<frontend_hash>-<timestamp>.tar.gz
   ├─ arm64/
   │  ├─ README.md
   │  └─ sdv-linux-arm64-<backend_hash>-<frontend_hash>-<timestamp>.tar.gz
   └─ loongarch/
      ├─ README.md
      └─ sdv-linux-loongarch-<backend_hash>-<frontend_hash>-<timestamp>.tar.gz

目录规范：

fdmjj 是当前稳定版本线，正式稳定包默认进入这个目录。
Linux 包必须进入对应架构目录，不同架构不要混放。
README.md 放在对应发布目录内，记录包名、构建时间、前端 hash、后端 hash 和更新说明。
临时测试包需要单独建 test、temp 或日期目录，验证通过后再移动到正式目录。

5. 推荐打包系统

包类型	推荐系统	说明
Linux `x86_64`	专用 Linux 构建机	最常用，适合构建 Docker 镜像和离线包
Linux `arm64`	原生 ARM Linux 或配置好的 buildx 构建机	原生环境更容易发现架构相关问题
Linux `loongarch`	原生龙芯 / LoongArch Linux	不建议完全依赖跨架构构建，现场兼容风险更高
Windows 离线包	Linux + Wine 构建机	推荐方式，客户端交叉编译最方便，适合统一拉代码、构建 Web、构建 Electron Windows 客户端和压缩上传
Windows 验收	Windows 10 / Windows Server 2019 及以上	用于验证 bat 服务注册、客户端 exe、运行监控和本地安装目录

建议把构建机和验收机分开。构建机负责拉代码、编译、压缩、上传；验收机只拿最终包安装，避免构建缓存、旧目录或本机环境掩盖缺文件问题。

6. Linux / Docker 离线包

Linux 离线包以 docker-install 仓库为准。主要脚本如下：

脚本	作用
`download-docker-offline.sh`	下载离线 Docker 和 Compose 组件
`setup-buildx.sh`	配置 Docker buildx 和镜像源
`build-linux-fdmjj.sh`	拉取前后端、编译、构建镜像、打包、上传

支持架构：

架构	说明
`x86_64`	常规 Intel / AMD 服务器
`arm64`	ARM 服务器、部分国产化硬件
`loongarch`	龙芯平台
`all`	顺序构建全部架构

构建机建议准备：

Git SSH 访问 GitLab。
Node.js、pnpm，用于构建 fit-archive-ng。
Go、just，用于构建 smart-doc-vault。
Docker、Docker Compose、buildx，用于构建和导出镜像。
aliyunpan-go 或公司当前发布工具，用于上传发布产物。
足够磁盘空间，离线镜像和最终包会明显大于源码目录。

Linux 包构建流程：

bash

./download-docker-offline.sh
./setup-buildx.sh
./build-linux-fdmjj.sh x86_64

实际构建中 build-linux-fdmjj.sh 会执行这些动作：

从 fit-archive/fdmjj 拉取 fit-archive-ng 和 smart-doc-vault。
前端执行依赖安装和生产构建，产出 Web dist。
后端按目标架构交叉或原生编译，产出 Linux 可执行文件。
构建 sdv-app:latest 等 Docker 镜像。
将后端二进制、前端 dist、Docker 镜像、安装脚本和 compose 文件放入对应架构目录。
生成 sdv-linux-<arch>-<backend_hash>-<frontend_hash>-<timestamp>.tar.gz。
上传到智档宝 Linux 发布目录，并更新版本记录。

Linux 离线包主要服务、端口和默认账号 / Token：

服务	Compose 服务 / 容器名	常见端口	运行形态	默认账号 / Token
智档宝主服务	`app` / `sdv-app`	80 / 8888	常驻，host 网络	`DOCKER_P=true`；安装脚本创建 `authorized` 空文件
MySQL	`mysql` / `sdv-mysql`	3307	常驻	`root` / `123456`；默认库 `tdpub`
Redis	`redis` / `sdv-redis`	6379	常驻	password 为空
Minio	`minio` / `sdv-minio`	9000 / 9001	常驻	`admin` / `admin123456`；bucket `fit`
InfluxDB	`influxdb` / `sdv-influxdb`	8086	常驻	`admin` / `admin123456`；token `abc123123123abc`；org/bucket `fit` / `sdv`
EMQX	`emqx` / `sdv-emqx`	1883 / 8083 / 8084 / 18083	常驻	Dashboard `admin` / `public`；MQTT 匿名连接
Tika	`tika` / `sdv-tika`	9998	常驻	无
DocumentConvert	`document-convert` / `sdv-document-convert`	7010	常驻，host 网络	无
Elasticsearch	`elasticsearch` / `sdv-es`	9200 / 9300	常驻	security `disabled`
ES 权限初始化	`es-chown` / `sdv-es-chown`	-	初始化任务	无
ES 索引初始化	`es-init` / `sdv-es-init`	-	初始化任务	无

安装验证至少要做：

目标机器以 root 权限执行安装脚本。
确认 Docker 服务正常启动。
确认镜像已 docker load。
确认 docker compose ps 中主要服务为运行状态。
访问 Web 页面和管理端。
新建或查询一条档案数据，确认数据库、对象存储、搜索和后端接口协作正常。

历史方式：国产化 Linux 手动安装

fit-archive/xc-install 是早期国产化 Linux 手动安装方式，之前由 zks 负责维护，已弃用。

这套方式主要用于 Docker 离线包成熟前的国产化环境交付，更多依赖人工准备系统环境、安装依赖服务、复制程序文件和调整配置。它的问题是步骤分散、环境差异大、可重复性弱，现场升级和问题回滚成本也更高。

老手动方式的服务、端口和默认账号 / Token：

服务	旧容器 / 服务名	管理方式	常见端口	默认账号 / Token
后端主服务	`smart-doc-vault.service`	systemd	8888 / 80	后端不是容器，由 systemd 直接拉起
Docker	`docker.service`	systemd	-	手动安装 Docker 二进制并写入 systemd unit
MySQL	`gg-mysql-1`	`docker run`	3306	`root` / `123456`；默认库 `tdpub`
Redis	`gg-redis-1`	`docker run`	6379	password 为空
Minio	`gg-minio-1`	`docker run`	9000 / 9001	`admin` / `admin12345678`
InfluxDB	`gg-infulxdb`	`docker run`	8086	`admin` / `admin@123`；token `abc123123123abc`；org/bucket `fit` / `sdv`
Elasticsearch	`gg-es`	`docker run`	9201	security `disabled`
Tika	`gg-tika`	`docker run`	9998	无
OnlyOffice	`gg-onlyoffice-hack`	`docker run`	8991	`JWT_ENABLED=false`
Meilisearch	`gg-meilisearch-1`	`docker run`	7700	`MEILI_MASTER_KEY=meilisearch1234567`
MQTT	`gmqtt`	手动安装 / 进程服务	1883	历史文档只记录依赖来源，现场形态可能不同

排查老现场时，后端优先看 systemctl status smart-doc-vault.service 和 journalctl -u smart-doc-vault.service；依赖服务优先用 docker ps、docker logs <容器名> 查看。

当前推荐新项目统一使用 Linux / Docker 离线包。只有在追溯老现场、对比旧配置、查历史安装脚本或迁移旧项目时，才需要参考 xc-install。

7. Windows 离线包

Windows 离线包以 sdv-windows 仓库为准。稳定线使用 build-windows-sdv-fdmjj.sh，产物后缀为 .zip，内部主要是 sdv-test 运行目录。

Windows 离线包也推荐在 Linux 构建机上打，配合 Wine 做 Electron Windows 客户端交叉编译。这样前端 Web、Electron Windows 客户端、Electron Linux 客户端、Go Windows 后端和压缩上传都能在同一台构建机完成。Windows 机器主要用于最终安装验收，不建议把它作为唯一构建环境。

包内常见内容：

内容	说明
`SDV/smart-doc-vault.exe`	后端主程序
`SDV/config/dist/`	前端 Web 静态文件和客户端下载文件
`serviceMonitor.exe`	智档宝运行监控
`install.bat` / `uninstall.bat`	一键安装和卸载脚本
`*.bat` 服务脚本	MySQL、Redis、Minio、EMQX、Tika、ES、主程序等服务注册脚本
`DEPLOY.md`	Windows 部署说明
`Mysql`、`Redis`、`Minio`、`Influxdb`、`Emqx`、`es`、`tika`	本地依赖服务目录
客户端 exe、打印服务安装包	现场客户端和打印能力分发

Linux + Wine 构建 Windows 离线包流程：

从 fit-archive/fdmjj 拉取 fit-archive-ng。
准备 Node.js、pnpm、Go、just、Wine、7z/zip、upx 和发布上传工具。
执行 Web 构建，并执行 Electron Windows / Linux 客户端构建。
从 fit-archive/fdmjj 拉取 smart-doc-vault。
设置 GOOS=windows 构建后端 exe。
拉取并构建 windows-service-monitor。
将后端 exe、SQL、前端 dist、客户端安装包、打印服务和监控工具复制到 sdv-test。
压缩为 sdv-windows-<backend_hash>-<frontend_hash>-<timestamp>.zip。
上传主包、README、前端独立包和后端独立包。

Windows 验收机建议：

项目	建议
操作系统	Windows 10 / Windows Server 2019 及以上
权限	管理员权限
内存	最低 8GB，推荐 16GB
磁盘	至少 50GB 可用空间
网络	能访问现场内网设备和本机服务端口

Windows 安装验证：

解压 Windows 离线包到纯英文或现场约定目录。
以管理员权限运行 install.bat。
通过 services.msc 或 sc query 确认服务已注册并启动。
打开 serviceMonitor.exe，确认基础服务状态。
访问智档宝页面，执行登录、查询、新建或现场核心业务动作。
验证客户端 exe、打印服务、文档预览和全文搜索。

Windows 主要服务、端口和默认账号 / Token：

服务	Windows 服务名	常见端口	作用	默认账号 / Token
主应用服务	`SDV`	8080	智档宝后端	无
MySQL	`SDVMysql`	3306	关系数据库	`root` / `123456`
Redis	`SDVRedis`	6379	缓存	password 为空
Minio	`SDVMinio`	9000 / 9001	对象存储	`admin` / `admin123456`；bucket `fit`
EMQX	`SDVEmqx`	1883 / 8083 / 8084	MQTT 消息服务	Dashboard `admin` / `public`；Management API `admin` / `public`；MQTT 匿名连接
InfluxDB	`SDVInfluxDB`	8086	时序数据库	`admin` / `12345678`；token `abc123123123abc`；org/bucket `fit` / `sdv`
Tika	`SDVTika`	9998	文档解析	无
DocumentConvert	`SDVDocumentConvert`	7010	文档格式转换	无
Elasticsearch	`elasticsearch-service-x64`	9200	全文搜索	按包内配置
Face	`SDVFace`	按现场配置	离线人脸识别	无

8. 环境配置细节

打包和分发要区分三类配置：

类型	示例	处理方式
构建配置	GitLab SSH 地址、目标架构、构建脚本参数	可以写入脚本或 README
运行配置	服务端口、数据目录、JVM 内存、Docker Compose 服务	可以写入部署文档，发布前按现场调整
密钥配置	GitLab token、钉钉 webhook、AI API key、数据库初始口令、对象存储口令	不写入文档和仓库，使用环境变量、CI Secret 或现场密钥表

Linux 数据目录通常由安装脚本创建，至少包括数据库、缓存、对象存储、时序数据库、搜索引擎和业务文件存储目录。Windows 数据目录在 sdv-test 下随服务目录组织，例如 Mysql\data、Redis\data、Minio\data、Influxdb\data、Emqx\data、es\...\data。

生产或客户现场需要检查：

不需要外部访问的端口不要暴露到公网或客户办公网。
Windows 服务安装路径要固定，避免解压目录移动后服务路径失效。
Elasticsearch、JVM、MySQL、Redis 的内存配置要按机器规格调整。
离线包 README 要记录包名、构建时间、前端 hash、后端 hash、目标架构和更新说明。

9. 发布前检查清单

检查项	Linux	Windows
包名包含前后端 hash	是	是
README 写入版本记录	是	是
能从版本搜索反查仓库	是	是
能在干净机器安装	是	是
主要服务能启动	`docker compose ps`	`sc query` / 运行监控
Web 能登录	是	是
核心业务能执行	是	是
默认密钥已替换或已标注内网限制	是	是
上传发布目录	智档宝 Linux 发布目录	智档宝 Windows 发布目录

发布记录至少包含：

包名。
架构或操作系统。
构建时间。
fit-archive-ng hash。
smart-doc-vault hash。
构建人。
验收机器。
验收结果。

10. 常见问题

包能启动，但现场不知道是哪版代码

先看包名中的两个 hash，再到版本搜索里查 飞度一体化平台 或对应版本号。如果搜索不到，回到发布 README 和 GitLab 仓库确认是否漏写版本记录。

Linux 上某个架构能打包，另一个架构失败

先确认后端 Go 目标架构、Docker 基础镜像、前端依赖和离线 Docker 组件是否都支持该架构。loongarch 优先使用原生构建和原生验收。

Windows 安装后服务启动失败

优先检查管理员权限、端口占用、解压路径、服务路径和数据目录。MySQL、Elasticsearch、InfluxDB 首次启动时间较长，不能只看脚本瞬时返回。

只需要更新前端或后端

优先使用独立包，但必须记录对应 hash。只替换前端时要确认后端 API 兼容；只替换后端时要确认数据库迁移、配置文件和前端页面兼容。

智档宝

1-产品视图

远程调试

智档宝系统前后端更新

数字孪生系统安装

登录后查看本文

打包分发

1. 这篇文档解决什么

2. GitLab 参考仓库

3. 产物类型和命名规则

4. 最终发布地址

5. 推荐打包系统

6. Linux / Docker 离线包

7. Windows 离线包

8. 环境配置细节

9. 发布前检查清单

10. 常见问题

1-产品视图

登录后查看本文

打包分发 ​

1. 这篇文档解决什么 ​

2. GitLab 参考仓库 ​

3. 产物类型和命名规则 ​

4. 最终发布地址 ​

5. 推荐打包系统 ​

6. Linux / Docker 离线包 ​

7. Windows 离线包 ​

8. 环境配置细节 ​

9. 发布前检查清单 ​

10. 常见问题 ​

打包分发

1. 这篇文档解决什么

2. GitLab 参考仓库

3. 产物类型和命名规则

4. 最终发布地址

5. 推荐打包系统

6. Linux / Docker 离线包

7. Windows 离线包

8. 环境配置细节

9. 发布前检查清单

10. 常见问题