# 数科在线预览转换电子签章产品升级手册
北京致远互联软件股份有限公司
2026年5月
# 前言
由于数科部署维护手册内容过多，特此将升级操作抽离单独维护，方便项目参考手册快速操作。
本手册适用于已安装数科在线预览转换含电子签章产品用户，升级到数科在线预览转换含电子签章最新版本场景。不带签章场景见其它手册。
# 数科1030/0228升级最新版本说明
如项目上已安装数科2024-1030或2025-0228带电子签章版本，本次需要升级到260409带电子签章版本，参考本章节操作：
整体执行思路为：停止旧服务 → 原目录改名备份 → 解压最新版本程序 → 安装新版本 → 还原旧版本配置、更新授权和菜单权限。
以下命令默认安装目录为 /data/suwell/dzqz-weboffice。如果现场目录不同，请按实际路径替换。
# 升级前停服和备份
停止当前旧版本并删除残留的swslc容器、备份关键文件：
# 1.停止当前旧版本并删除残留的`swslc`容器：
cd /data/suwell/dzqz-weboffice
bash suwell_install.sh stop
docker ps -a | grep swslc | awk '{print $1}' | xargs -r docker rm -f
# 2.备份关键配置和数据
mkdir -p /data/backup_suwell && rm -rf /data/backup_suwell/*
cp -r /data/suwell/dzqz-weboffice/suwell.env /data/backup_suwell/suwell.env
cp -r /data/suwell/dzqz-weboffice/config/all_fonts/extfonts /data/backup_suwell/extfonts
cp -r /data/suwell/dzqz-weboffice/dzqz-weboffice/mysql-data /data/backup_suwell/mysql-data
cp -r /data/suwell/dzqz-weboffice/dzqz-weboffice/minio /data/backup_suwell/minio
# 3.重命名老版本程序名
cd /data/suwell
# 将旧版本重命名备份，backup0228对应0228旧版本，如旧版本是1030则建议命名为backup1030，方便后续维护
mv dzqz-weboffice backup0228-dzqz-weboffice
# 解压最新版本并还原数据
1、解压260409安装包：
cd /data/suwell
tar -zxvf dzqz-weboffice-x86-20260409.tar.gz
2、用旧版本备份的mysql-data和minio替换最新版本解压程序：
# 备份最新的文件到bak
cd /data/suwell/dzqz-weboffice/dzqz-weboffice
mkdir -p bak
mv mysql-data bak/
mv minio bak/
cp -r /data/backup_suwell/mysql-data ./
cp -r /data/backup_suwell/minio ./
3、必须替换minio-server镜像。
本步在升级安装前必须执行： 带签章老版本升级最新版本并恢复旧版本minio数据目录时，必须进入旧版本目录查看minio-server镜像，并将新版本docker-compose-tools.yml中的minio-server镜像替换为旧版本镜像。否则可能出现旧签章附件、印章图片或历史数据无法正常读取的问题。
OLD_VERSION=1030 # 如旧版本为0228，则改为 OLD_VERSION=0228
cd /data/suwell/backup1030-dzqz-weboffice/dzqz-weboffice
# 直接寻找docker-compose-tools.yml文件中的minio-server:下的images:将其值拷贝出来
grep -C5 'minio-server:' docker-compose-tools.yml
# 将上一步老版本的minio-server:下的images:值拷贝替换到新版本程序中并保存（必须做！）
cd /data/suwell/dzqz-weboffice/dzqz-weboffice
vim docker-compose-tools.yml
# 执行数科新版本安装
提醒：必须先完成上一步mysql、minio、image的还原，才能执行本步操作，否则升级失败！
cd /data/suwell/dzqz-weboffice
bash suwell_install.sh install
# 还原老版本配置字体和其它信息
1、还原字体、老版本配置：
# 还原备份的字体
cp -r /data/backup_suwell/extfonts /data/suwell/dzqz-weboffice/config/all_fonts/
# 参考备份的老版本配置文件 /data/backup_suwell/suwell.env 修改新版本 suwell.env 配置：
# 还原老版本关键配置：slc_name授权文件名、wo_domain、Endpoint、nginx_port、ssl_port等信息
vim /data/suwell/dzqz-weboffice/suwell.env
2、仅1030签章版本升级场景需要操作： 如果旧版本是1030带签章版本，安装升级最新版本后需要将数科提供的 168-180update.sql 上传到数科的MySQL容器中，并在电子签章MySQL容器中执行。0228升级260409通常不需要执行本步骤，除非数科交付包或现场支持人员另有要求。
# 找到mysql的实例ID
docker ps -a | grep mysql
# 示例：ef537bf757ba ss.suwell.com/dzqz-x86/mysql:8.0.36 为电子签章mysql容器
# 将下载的update.sql拷贝到mysql实例中
docker cp 168-180update.sql ef537bf757ba:/opt
# 运行实例
docker exec -it ef537bf757ba bash
cd /opt
mysql -u root -p --default-character-set=utf8 manager_center_prd < /opt/168-180update.sql
# 提示输入密码后输入：Suwell@Abcd123
exit
# 升级后更新授权和菜单权限
1、恢复旧版.slc并用其中的slc_name更新新版本suwell.env：
cp -f /data/suwell/backup1030-dzqz-weboffice/.slc /data/suwell/dzqz-weboffice/.slc
cat /data/suwell/dzqz-weboffice/.slc
# 除了迁移.slc之外，还要修改suwell.env中的slc_name确保跟老版本一致
vim /data/suwell/dzqz-weboffice/suwell.env
2、重启授权服务和数科服务：
cd /data/suwell/dzqz-weboffice/docker_compose_yaml
docker-compose -f docker-compose-slc.yml restart
cd /data/suwell/dzqz-weboffice
bash suwell_install.sh restart
3、登录授权后台重新导入上一版本申请过的原始授权文件。
- 授权后台地址：
http://IP:8180/static/#/login - 1030版本默认账号密码：
admin/123456 - 0228及更高版本默认账号密码：
admin/SuWell@123.com! - 如果现场已修改密码，以现场实际密码为准。
4、重新登录三员系统刷新角色菜单权限。
- 三员系统地址：
http://服务器ip:81/managementCenter/login - 使用
xtadmin登录，在“系统管理 -> 直接编辑”中点击“更新菜单” - 使用
aqadmin登录，在“角色管理 -> 直接编辑”中取消并重新勾选菜单权限后保存 - 默认密码一般为
123456（具体操作可见 《数科预览、转换、签章服务安装维护手册（Linux和信创）-电子签章章节 (opens new window)》 ），如已修改密码，以现场实际密码为准
# 数科0716旧版卸载升级思路
如项目上安装数科最早期的0716版本，本次需要升级最新的数科版本，需参考本章节手册，具体执行逻辑为：完整卸载0716版本，然后重新安装最新版本。
如项目上现已安装数科0716的旧版本，本次需要使用最新的数科版本，可参考本章节备份数据并删除卸载服务，再安装新版本并恢复相关配置。
1、备份旧版本的配置和文件，主要包含：
- 备份调整过的端口及配置，主要位于dzqz-weboffice/dzqz下的docker-compose.yml
- 添加的字体文件
- 使用https用户，备份ssl证书及配置
2、参考旧版手册，备份及卸载0716含数科签章版本的数科服务：
# 备份数据：到数科服务目录下
cd /data/suwell/dzqz-weboffice/dzqz/
# 备份mysql-data, 这里面存储的是签章服务的数据
cp -r mysql-data /data/backup_suwell/mysql-data
# 卸载服务dzqz
cd /data/suwell/dzqz-weboffice/dzqz
# 卸载应用服务
docker-compose -f docker-compose.yml down
# 卸载基础服务
docker-compose -f docker-compose-base.yml down
# 卸载服务suwell-viewer-weboffice
cd /data/suwell/dzqz-weboffice/suwell-viewer-weboffice
# 卸载应用服务
docker-compose -f docker-compose.yml down
# 卸载基础服务
docker-compose -f docker-compose-tools.yml down
# 删除docker中的数科images（如当前服务器docker还被别的服务使用，需要慎重）
docker rmi $(docker images -q)
# 删除suwell下的dzqz-weboffice目录
rm -rf /data/suwell/dzqz-weboffice
# 部分文件清不干净，可赋予文件权限
chattr -R -i /data/suwell/dzqz-weboffice/dzqz/license/api5/.FORBIDDEN/
chattr -R -i /data/suwell/dzqz-weboffice/dzqz/license/reader/.FORBIDDEN/
# 再做一次删除
rm -rf /data/suwell/dzqz-weboffice
如果当前服务器由数科服务独占，并且您发现当前的docker版本低于26.1.0版本，则可以卸载docker和docker-compose组件，随后取数科最新安装包，自动安装最新的docker版本：
# （非必须，如果数科独占docker并且docker版本低于26.1.0使用）删除docker服务，docker-compose工具
systemctl stop docker
rm /usr/bin/docker* -f
rm /etc/systemd/system/docker* -f
rm /usr/local/bin/docker-compose -f
rm /usr/bin/containerd* -f
rm /usr/bin/ctr -f
rm /usr/bin/runc -f
rm /usr/lib/systemd/system/docker* -f
rm /var/run/docker -rf
rm /etc/docker -rf
systemctl daemon-reload
3、以上完成后，等于数科0716旧版服务和文件完全清空，下一步就可以参考本手册“服务部署”章节，安装部署最新版的数科服务。
4、安装完成后需要更新授权，0716旧版本正式授权文件无法复用到数科新版本，卸载并安装数科最新版本后，需要参考本手册“授权申请”章节，由客户经理重新申请数科正式授权。更新授权一般不涉及额外成本，具体以商务审核结果为准。
5、还原电子签章数据： 安装最新版本数科服务后，需要将0716版本的签章备份文件拷贝到新版数科服务下，如参考上面步骤备份的数据，旧版备份文件位于/data/backup_suwell/mysql-data，如参考本手册部署的新版数科，新版的签章数据存储于/data/suwell/dzqz-weboffice/dzqz-weboffice/mysql-data。还原数据后，进行一次服务先停、后起，并且还要到签章的后台点击一下保存！
快速跳转
