# 数科在线预览（不含签章）升级手册
北京致远互联软件股份有限公司
2026年5月
# 前言
由于数科部署维护手册内容过多，特此将升级操作抽离单独维护，方便项目参考手册快速操作。
本手册适用于已安装数科在线预览转换（不含签章）用户，升级到数科在线预览转换（不含签章）最新版本场景。带签章场景见其它手册。
# 数科1030/0228升级最新版本说明
如项目上已安装数科2024-1030或2025-0228不带签章版本，本次需要升级到最新不带签章版本，参考本章节操作：
升级思路为：停止旧服务 → 原目录改名备份 → 解压260409 → 安装新版本 → 恢复配置和字体 → 验证授权和预览。
以下命令默认安装目录为 /data/suwell/suwell-viewer-weboffice。如果现场目录不同，请按实际路径替换。
# 升级前停服和备份
升级前停服和备份关键文件：
# 1.停止旧版本，删除残留的`swslc`容器，并将旧目录改名保留
cd /data/suwell/suwell-viewer-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/suwell-viewer-weboffice/suwell.env /data/backup_suwell/suwell.env
cp -r /data/suwell/suwell-viewer-weboffice/config/all_fonts/extfonts /data/backup_suwell/extfonts
# 3.将旧版本重命名备份，backup0228对应0228旧版本，如旧版本是1030则建议命名为backup1030，方便后续维护
cd /data/suwell
mv suwell-viewer-weboffice backup0228-suwell-viewer-weboffice
# 解压最新版本程序并执行安装
# 将最新版本程序上传到/data/suwell目录（当前示例为X86包，如ARM架构需上传aarch64包）
mv /tmp/suwell-viewer-weboffice-x86-260409.tar.gz /data/suwell
# 解压新版程序
cd /data/suwell
tar -zxvf suwell-viewer-weboffice-x86-260409.tar.gz
# 执行新版程序安装
cd suwell-viewer-weboffice
bash suwell_install.sh install
# 还原老版本配置和扩展字体
# 还原备份的字体
cd suwell-viewer-weboffice
cp -r /data/backup_suwell/extfonts /data/suwell/suwell-viewer-weboffice/config/all_fonts/
# 参考备份的老版本配置文件 /data/backup_suwell/suwell.env 修改新版本 suwell.env 配置：
# 还原老版本关键配置：slc_name授权文件名、wo_domain、Endpoint、nginx_port、ssl_port等信息
vim /data/suwell/suwell-viewer-weboffice/suwell.env
# 重启数科服务使配置生效
# 字体和配置还原后，重启服务使配置和字体生效
cd /data/suwell/suwell-viewer-weboffice
bash suwell_install.sh restart
# 检查授权和测试功能
安装完成后，访问数科授权管理地址http://数科服务IP:8180/检查授权状态，并在协同OA侧验证在线预览、转换、Excel预览等功能是否正常。
关于数科授权问题：1030/0228老版本授权可继续沿用到最新版本，只需要确保如下信息正确即可：
1、确保升级前后不要手动删除/data/suwell/slc目录，该目录存放了数科授权信息
2、升级后，确保最新配置 /data/suwell/suwell-viewer-weboffice/suwell.env 文件中的slc_name与老版本一致（如不一致就拷贝老版本slc_name替换，修改之后重启数科服务，等待几分钟后即可正常）
3、如果还不生效，可以尝试在数科授权管理http://数科服务IP:8180/中点击更新授权，或删除再上传授权。再测试功能是否正常。
# 数科0716旧版卸载升级思路
如项目上安装数科最早期的0716版本，本次需要升级最新的数科版本，需参考本章节手册，具体执行逻辑为：完整卸载0716版本，然后重新安装最新版本。
1、备份旧版本的配置和文件，主要包含：
- 备份调整过的端口及配置，主要位于suwell-viewer-weboffice下的docker-compose.yml和etcd.sh文件
- 备份添加的字体文件
- 使用https用户，备份ssl证书及配置
2、参考旧版手册，备份及卸载0716数科服务：
# 访问到部署目录
cd /data/suwell/suwell-viewer-weboffice
# 卸载应用服务
docker-compose -f docker-compose.yml down
# 卸载基础服务
docker-compose -f docker-compose-tools.yml down
# 注意新版本(1030)开始不能用以上命令卸载
# 新版本卸载停止时必须跟环境变量参数文件，例：docker-compose --env-file=../suwell.env -f docker-compose.yml down
# 删除docker中的数科images（如同一个docker还被别的服务使用，需要慎重，由专业工程师来处理）
docker rmi $(docker images | grep -v "iwebeditor/documentsystem" | awk 'NR>1{print $3}')
# 删除suwell下的suwell-viewer-weboffice目录
rm -rf ./suwell-viewer-weboffice
# 如果删除出现"FORBIDDEN/01: Operation not permitted"这类提示，表示文件权限不足，还要进一步删除一下：
# 赋予文件权限
chattr -R -i /data/suwell/suwell-viewer-weboffice/lic/.FORBIDDEN/
# 再做一次删除
cd /data/suwell/
rm -rf ./suwell-viewer-weboffice
卸载如提示Network suwell-viewer-xxx Error，遇到这个网络服务错误不影响，可忽略继续操作：
如果当前服务器由数科服务独占，并且您发现当前的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旧版本正式授权文件无法复用到数科新版本，卸载并安装数科最新版本后，需要参考本手册“授权申请”章节，由客户经理重新申请数科正式授权。更新授权一般不涉及额外成本，具体以商务审核结果为准。
# 数科241030升级250228版本说明（过时）
如项目上需要从1030升级到0228版本，可参考本章节操作（250228已过时，建议安装更高版本）：
1、备份旧版本的配置和文件，主要包含：suwell.env、字体目录suwell-viewer-weboffice/config/all_fonts/extfonts
- 主要涉及suwell.env中修改过的端口、地址配置、ssl配置、slc_name
2、停止当前的1030版本，删除slc容器（请按实际部署路径执行以下命令）
cd /data/suwell/suwell-viewer-weboffice
./suwell_install.sh stop
docker ps -a | grep swslc | awk '{print $1}' | xargs docker rm -f
cd /data/suwell
mv suwell-viewer-weboffice backup1030-suwell-viewer-weboffice
3、解压并进入0228版本目录，执行安装：
tar zxvf suwell-viewer-weboffice-250228.tar.gz
cd suwell-viewer-weboffice
bash suwell_install.sh install
4、拷贝1030版本增加的扩展字体到新版本目录extfonts，还原1030个性化配置：
cp -r /data/suwell/backup1030-suwell-viewer-weboffice/config/all_fonts/extfonts /data/suwell/suwell-viewer-weboffice/config/all_fonts/
# 参考备份的老版本配置文件 /data/suwell/backup1030-suwell-viewer-weboffice/suwell.env 修改新版本 suwell.env 配置：
# 还原老版本关键配置：slc_name授权文件名、wo_domain、Endpoint、nginx_port、ssl_port等信息
vim /data/suwell/suwell-viewer-weboffice/suwell.env
5、安装完成即可登录slc地址查看授权及功能验证是否正常。
快速跳转
