|
|
文档转换服务器使用说明.rar
(626.69 KB, 下载次数: 0, 售价: 50 金币)
文档转换服务器使用说明
目录
一、 功能简介 ............................................................................................. 2
二、 环境部署和使用................................................................................... 2
2.1 安装........................................................................................................................................ 2
2.2 卸载........................................................................................................................................ 6
2.3 服务器配置转换地址........................................................................................................... 6
2.4 参数设置................................................................................................................................ 7
2.5 开启调试................................................................................................................................ 8一、功能简介
文档转换服务器是一种文档格式转换服务，支持将 Office 及 WPS 文档转换为 PDF 或
HTML 实现预览。该服务主要用于在 HarmonyOS NEXT 系统的安全查看器预览文件时，
提供格式转换支持。
二、环境部署和使用
2.1 安装
右键以管理员身份运行 DocConverter.exe 进行安装，具体步骤如下：
1、右键以管理员身份运行 DocConverter.exe，选择安装界面语言，点击【确定】；
2、系统会弹出欢迎安装的界面，点击【下一步】继续；
3、系统会提示阅读认可协议，勾选我同意用户协议和我同意隐私政策，点击【下一步】；
4、进入到设置安装路径页面，管理员可以自行设置安装的路径；
5、选择组件，默认勾选文档转换服务器，点击【下一步】；
6、选择开始菜单的快捷方式的目录，点击【下一步】；
7、协议端口设置界面，可以勾选文档转换服务器的访问协议
（HTTP 协议默认已勾选，HTTPS 协议默认未勾选，需勾选后才会启动），
若同时设置访问协议的端口，HTTP 默认端口为 80，HTTPS 默认端口为 443，
支持自定义 HTTP 和 HTTPS 协议的端口。点击【下一步】；
1）若上一步勾选了【设置 HTTPS 协议端口】，会有导入证书和 KEY 文件页面，有两种
方式:
若已有证书和 KEY 文件，可以选择【选择已有证书和 KEY 文件】，点击【浏览】手动
导入证书文件 server.crt 和 KEY 文件 server.key，点击【下一步】；2）选择【生成并使用自签证书和 KEY 文件】，然后点击【下一步】，
在弹出的窗口输中，“请输入当前 ip 或域名”输入当前文档转换服务器 ip 或域名，
“可选名称”根据需要填写，点击【下一步】；等待证书生成，生成证书和 KEY 文件成功，安装包会自动导入，点击【下一步】；
8、白名单配置界面，填写要访问文档转换服务器的相关地址，
如“内网 ip:端口,外网 ip 端口,域名:端口”，多个用英文逗号分隔，
点击【下一步】；（支持通配符*和?）
不填写白名单配置，则不限制任何地址访问文档转换服务器。
填写白名单配置后，只有相应白名单访问文档转换服务器，才能正常访问，否则访问返回 404 错误码。
填写安装后，在.....\Apache\conf\httpd.conf（HTTP 配置文件）和..\Apache\conf\extra\httpd-ssl.conf
（HTTPS 配置文件）有相关白名单配置。
9、准备安装，点击【安装】，直到完成。安装完成后，无托盘图标，文档转换服务器程序，名称为：IP-guard DocConverter。
文档转换服务器 服务名为：OcularDocConverterServer。2.2 卸载
通过开始菜单栏找到“卸载 文档转换服务器”程序，点击运行即可执行卸载。卸载不
会删除安装目录下的所有文件，残留文件需要手动删除。
2.3 服务器配置转换地址
HarmonyOS NEXT 系统的安全查看器连接文档转换服务器实现预览功能，需在 IPG 服
务器安装目录下的 oserver3.ini 文件中添加以下配置（重启app或点击强制更新策略生效）：
[MOBILE_CONFIG]
CONVERT_SERVER_ADDR=转换服务器 IP/域名:端口号
关键字
值CONVERT_SERVER_ADDR 转换服务器地址，填写转换服务器 IP/域名:端口号。
端口号是指文档转换服务器安装时设置的端口号（默认是
80），默认端口不需要填写亦可；非默认端口，IP/域名后面
必须填写端口；
支持 http 协议（http 可不写）和 https 协议（https 必须写），
但要支持 https 协议的话需要手动配置 Apache；
没有配置或者配置非法则安全查看器无法打开 Office\WPS
文件。
转换服务器地址填写的例子：
1、IP+默认端口 80： CONVERT_SERVER_ADDR=192.168.2.203
2、IP+非默认端口 8080：CONVERT_SERVER_ADDR =192.168.2.203:8080
3、域名+映射端口：CONVERT_SERVER_ADDR =tecyexh.oicp.net:10941
4、前面加 http： CONVERT_SERVER_ADDR =http://192.168.2.203
5、前面加 https：CONVERT_SERVER_ADDR =https://192.168.2.203（https 必须写）
2.4 参数设置
在…\www\docconverter\config.ini 文件中，可调整以下配置（即使生效）：
转换文件保留天数
单文件大小限制
存储容量上限
默认配置如下：
[convert]
expire_days = 30 ；转换文件保留期 30 天，单位天；
file_size = 200 ；单个文件大小限制 200M，单位 MB;
capacity_limit = 50 ；总容量 50GB(路径…DocConverter\www\docconverter\files),单位 GB
关键字
值
expire_days
转换文件保留天数，单位天，默认 30 天；
过期目录（以日期命名如 20250301）会在下一次转换新文件时清理；
file_size
单个文件大小限制，单位 MB，默认 200M,
超过此大小的文件，不能转换；
如：安全查看器打开文件大小超过此参数限制，会提示“文件大小超过限
制，请联系管理员”；
capacity_limit 存 储 容 量 上 限 ， 单 位
GB, 默 认
50GB; 路
径…DocConverter\www\docconverter\files 文件夹；
超过限制时，按过期时间逐次清理，清理直到所占空间小于限制容量的80%。
2.5 开启调试
日志默认屏蔽，要开启记录日志，需要修改…/www/docconverter/config.ini 配置文
件，把 log_threshold 改为等于 1/2/3/4，即开始输出日志；默认 0，关闭输出日志。日
志记录在…\www\docconverter\application\logs 文件夹下。
[debug_log]
log_threshold = 2
;0 = 关闭
;1 = 仅显示 error 日志
;2 = 仅显示 error、debug 日志
;3 = 显示 error、debug、info 日志
;4=显示全部日志
|
|
发表于 2025-9-30 23:40:26