如何自行托管 HRConvert2 文件转换器
在自己的 VPS 上部署 HRConvert2,让客户文件不经过免费转换网站。本文涵盖 Docker 或 Apache 安装、bubblewrap 沙箱、上传限制、临时目录与清理,并提醒固定版本标签。
为何自托管文件转换器
自托管文件转换器会将文件保存在您自己的磁盘上。这就是运行它的全部理由。免费转换网站会接收您上传的文件,但不会告诉您之后如何处理这些文件。如果文件是已签署的客户合同或扫描的医疗记录,那么上传本身就是一次安全事件。HRConvert2 是一个使用 PHP 编写、采用 GPLv3 许可证的拖放式文件转换服务器。本指南基于 2026 年 8 月 18 日发布的 3.7.4 版本编写。此后项目快速迭代:截至 2026 年 11 月 8 日,最新版本是 11 月 6 日发布的 v4.0.0,项目声称支持超过 490 种格式。该版本包含安全修复,因此在将旧版本安装暴露到公网之前,请先进行评估。
它不使用数据库、账户或 Cookie。用户对应一个临时目录。每次转换都由本地命令行工具执行:文档使用 LibreOffice,音频和视频使用 FFmpeg,图像使用 ImageMagick,光学字符识别(OCR)使用 Tesseract,其余格式则依赖许多规模较小的工具。HRConvert2 负责上传页面、处理流水线以及相关清理工作。
它可以将文件从一种格式转换为另一种格式。它不是浏览器办公套件。如果您需要的是让用户在浏览器标签页中编辑文档,请改为比较 自托管的 OnlyOffice 和 Collabora。它也不是存储系统。转换后的输出文件应当删除,因此如果文件需要长期保存,应使用 自托管文件管理器。
所需条件
Debian 或 Ubuntu、Apache 2.4、PHP 8 或更高版本,以及 bubblewrap。Bubblewrap(bwrap)用于提供沙箱:使用 $RequireSandbox = TRUE 时,如果无法创建沙箱,v3.7.4 的手动安装会拒绝执行需要沙箱的转换。文档转换使用沙箱外部的持久监听器。上游 README 表示,Raspberry Pi Model B+ 已足够运行该系统;对于 PHP 部分确实如此。转换器二进制文件决定实际的硬件需求,后文将对此进一步说明。
有两种部署方式。Docker 镜像可以立即运行。Apache 和 PHP 的安装需要一个晚上,但能让您清楚了解服务器上的具体内容。
使用 Docker 在今晚运行
该镜像包含所有转换器二进制文件,因此体积较大:固定的 amd64 镜像压缩后约为 3 GB。拉取前检查可用磁盘空间。
这里标签很重要。本指南固定使用 v3.7.2。v3.7.4 于 18 August 发布。截至 8 November 2026,最新的 GitHub release 是 v4.0.0(6 November 2026),Docker Hub 的 latest 标签指向与 v4.0.0 相同的镜像。latest 标签会发生变化,而此应用的解析器攻击面较大,因此应固定版本并有计划地升级。
docker pull zelon88/hrconvert2:v3.7.2
docker run -d --name hrconvert2 \
-p 127.0.0.1:8080:80 \
--security-opt seccomp=unconfined \
zelon88/hrconvert2:v3.7.2docker ps
curl -I http://127.0.0.1:8080/健康的容器会保持在 Up 状态,curl 返回 HTTP/1.1 200 OK。持续重启的容器存在启动问题,因此在进行其他更改前先查看 docker logs hrconvert2。
有两个标志很重要。-p 127.0.0.1:8080:80 将端口发布到主机的 loopback 地址,因此 Docker 主机无需代理即可直接访问转换器。28.0.0 之前的 Docker release 还允许同一 L2 网段上的主机访问发布到 localhost 的端口,例如连接到同一网络交换机的主机。在依赖此绑定实现外部隔离前,请使用 Docker 28.0.0 或更高版本。项目当前的示例映射 -p 8080:80;该端口监听所有接口,包括公网接口。添加 --security-opt seccomp=unconfined 是因为 bubblewrap 使用 user namespace 和 mount 系统调用构建其沙箱,而 Docker 的默认 seccomp 配置文件会阻止这些调用。3.7 config.php 注释补充说明,某些主机还需要 --security-opt apparmor=unconfined。如果没有这些标志,容器无法构建沙箱;受影响的转换是否失败取决于 $RequireSandboxOnDocker。
这个标志确实会带来权衡。您放宽了容器的系统调用过滤器,使应用能够在容器内构建更严格的沙箱。决定行为的两个设置是 $RequireSandbox 和 $RequireSandboxOnDocker,位于 Resources/config.php 中。v3.7.4 release 将它们设为 TRUE 和 FALSE。本指南固定使用的 v3.7.2 标签将两者都设为 FALSE,因为其中的注释说明,容器必须关闭 $RequireSandbox,并让 $RequireSandboxOnDocker 决定行为。由于 Docker 要求默认关闭,没有 seccomp 标志的容器可能完全不使用沙箱进行转换。设置该标志后,将 $RequireSandboxOnDocker = TRUE; 设为拒绝需要不可用沙箱的转换。此设置不会为 3.7 document listener 提供沙箱。
较新的镜像启动方式不同。项目在 v3.8.0(25 August 2026)中更改了 Docker 进程。当前 README 和 Docker Hub 页面使用 --cap-add SYS_ADMIN 运行容器,而不是使用 seccomp 选项,并声明没有该选项时会拒绝转换。如果将固定版本改为更新的标签,请使用该镜像文档中说明的标志。该功能的权限范围较大,因此保留 127.0.0.1 端口绑定。
如果这台机器刚开始使用 Docker,请先配置 daemon。在 VPS 上运行 Docker介绍安装过程、存储驱动,以及 Docker 写入自身防火墙规则的方式。
改为在 Apache 和 PHP 上安装
在 v3.7.4 及更早版本中,仓库里的文件 Documentation/INSTALLATION_INSTRUCTIONS.txt 将安装过程列为 9 个手动步骤。本节按照该安装流程展开。自 v3.8.0 起,同一文件改为介绍安装脚本。请在克隆的仓库中运行 sudo bash Documentation/Build/hrconvert2-setup.sh。该脚本会安装依赖项,将 PHP 设置写入 drop-in 文件,而不是编辑 php.ini,并为它自带的 bubblewrap 副本安装专用 AppArmor 配置文件。然后,php convertCore.php -v 和 sudo php convertCore.php --status 会验证结果。手动安装耗时更长,但您可以确切知道它在服务器上执行了哪些操作。整体流程如下。先安装 Web 服务器、语言运行时和沙箱:
sudo apt update
sudo apt install -y apache2 php libapache2-mod-php php-all-dev php8.3-zip php8.3-gd bubblewrapphp8.3-* 中的名称与 Ubuntu 24.04 匹配。运行 php -v,并使用与您版本匹配的前缀,因为这些软件包名称会随每个 PHP 版本变化。前缀错误会导致 Unable to locate package。
接下来安装转换器。这些软件包覆盖文档、图像、音频、视频和 OCR,这些是用户实际转换的大多数内容:
sudo apt install -y imagemagick ffmpeg libreoffice-common libreoffice-java-common \
default-jre ghostscript poppler-utils libgxps-utils tesseract-ocr inkscape \
xvfb clamav curl tar libxcb-cursor0归档格式、3D 模型、电子书和可启动 ISO 镜像需要更多软件包,其中一些位于 Ubuntu 的 multiverse 组件中。在 v3.7.4 中,官方说明的第 3 步列出了完整的 apt 软件包清单,第 5 步介绍了从源代码构建的方法。当前指南不再提供软件包清单。安装程序会读取清单 Resources/Contract/depends.php,而 php convertCore.php --setup --check-depends 会输出当前清单及其状态。还有两个依赖项可以从源代码构建。仓库提供 Documentation/Build/ffmpeg-build.sh,用于补充软件包版 FFmpeg 缺少的编码器;还提供 Documentation/Build/build-imagemagick-v7.sh,用于在 Ubuntu 22.04 或 24.04 上安装 ImageMagick 7,因为这些版本仍提供 6.9 分支的软件包。Ubuntu 25.10 和 26.04 LTS 提供 ImageMagick 7.1 软件包。电子书支持来自 calibre 自带的安装程序。3.7 版说明将其写成一行命令:
sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin该命令会将供应商脚本通过管道传给 root shell 执行。这是上游提供的方法,但属于可选步骤:跳过它后,唯一缺少的是电子书转换功能。
接下来设置 PHP 的限制。转换过程较慢,文件也较大,因此默认值过小。3.7 版说明在 php.ini 中设置了这些参数:
max_execution_time = 1200
max_input_time = 90
memory_limit = 512M
post_max_size = 5000M
upload_max_filesize = 5000M
max_file_uploads = 100
display_errors = Off
zlib.output_compression = On这些数值适用于资源充足的机器。在小型 VPS 上使用前,应先将其调低。post_max_size = 5000M 会将整个 POST 请求体限制在约 4.88 GiB,其中包括所有上传文件和表单开销;max_file_uploads = 100 不会将该限制按文件数量相乘。并发请求、临时文件和转换输出仍需要额外的磁盘空间。重启 Apache,并检查命令行中的 PHP 设置,因为 Apache 可能加载了不同的配置:
sudo service apache2 restart
php -i | grep -E "upload_max_filesize|post_max_size|memory_limit"现在设置工作目录。$ConvertLoc 在 Resources/config.php 中指定该目录,默认值为 /DATA/HRConvert2。该目录必须归 Web 服务器用户所有:
sudo mkdir -p /DATA/HRConvert2
sudo chmod -R 0755 /DATA/HRConvert2
sudo chown -R www-data:www-data /DATA/HRConvert2将发行版解压到 Apache 文档根目录下。默认布局会将其放在 HRProprietary/HRConvert2 目录中,而 $InstLoc 在 Resources/config.php 中必须指定您实际使用的路径。然后运行内置诊断。这是发现缺少依赖项的最快方法,可以在用户发现问题前定位错误:
sudo php /path/to/HRConvert2/convertCore.php -v-v 会检查整个安装:核心版本、依赖项、沙箱状态和语言包。命令行不支持文件转换,因此这组参数仅用于管理。
全新 Ubuntu 24.04 安装后,为什么每次转换都会失败?
Ubuntu 24.04 默认通过 AppArmor 限制非特权用户命名空间。Bubblewrap 需要用户命名空间来构建其沙箱,因此被阻止的 bwrap 会导致依赖它的转换失败。在 v3.7.4 中,文档转换使用沙箱外的持久监听器,因此不受此要求限制。
直接检查:
bwrap --ro-bind / / --dev /dev /bin/true && echo sandbox ok如果出现 permission denied 错误,表示用户命名空间被阻止。解决方法是为 bwrap 二进制文件创建 AppArmor 配置文件。首先列出 ABI 文件,并记录现有文件中的最大编号:
ls /etc/apparmor.d/abi/然后写入 /etc/apparmor.d/bwrap,将 4.0 替换为该最大编号:
abi <abi/4.0>,
include <tunables/global>
profile bwrap /usr/bin/bwrap flags=(unconfined) {
userns,
include if exists <local/bwrap>
}加载配置文件:
sudo apparmor_parser -r /etc/apparmor.d/bwrap没有输出表示配置文件已加载。再次运行 bwrap 检查命令,应该会输出 sandbox ok。之后转换即可正常工作。
Debian 12 不存在此问题。其内核允许非特权用户命名空间,并且 bubblewrap 软件包会在启动时将 kernel.unprivileged_userns_clone 设置为 1,因此无需配置文件,上述检查也会通过。当前的安装脚本会为其自带的 bubblewrap 副本安装应用专用的 AppArmor 配置文件。
公共转换器就是暴露给陌生用户的解析器
本文其余内容都是为本节服务的。互联网上可访问的文件转换器会接收匿名用户提供的任意文件,再将其交给 LibreOffice、ImageMagick、FFmpeg 或 Ghostscript。这些软件都包含规模庞大的 C 和 C++ 代码库,并且长期存在解析器漏洞。上传者选择文件格式,也就决定了运行哪个解析器,以及解析器内部执行哪条代码路径。
HRConvert2 v3.7.4 会将 Tesseract、pdftotext、ImageMagick 和其他转换工具置于沙箱中,但其文档转换引擎使用的是位于该沙箱之外的持久 LibreOffice 监听器。沙箱中的命令会获得一个只读输入目录和一个可写输出目录;如果两个文件位于同一目录,该目录会以可写方式挂载。除非调用方显式启用网络访问,否则网络命名空间不会共享网络。这个限制的重要性超出直觉。ImageMagick 和 Ghostscript 都接受可获取 URL 的引用,因此转换器可能变成服务器端请求伪造(SSRF)工具,从网络内部访问云元数据端点。命名空间没有网络访问时,就无法执行该获取操作。
拒绝执行是另一半机制:启用沙箱后,如果服务器无法构建沙箱,就会拒绝依赖沙箱的转换。本文固定的版本会豁免文档转换。这也是上文的 AppArmor 步骤不可省略的原因,也是您在公开容器前应检查 $RequireSandboxOnDocker 的原因。
使用 policy.xml 加固 ImageMagick
ImageMagick 自带的策略文件是沙箱之外的第二层防护,值得配置。在 Ubuntu 24.04 和 ImageMagick 6 中,该文件位于 /etc/ImageMagick-6/policy.xml。先查看当前生效的策略:
identify -list policy项目在 Documentation/Build/policy.xml 提供了一个策略文件,可作为良好范例。该策略禁止 PS、PS2、PS3、EPS、XPS 和 MVG 编解码器,并禁止 URL、HTTPS、HTTP 和 gs 委托,同时允许 PDF:
<policy domain="coder" rights="none" pattern="PS" />
<policy domain="coder" rights="none" pattern="MVG" />
<policy domain="delegate" rights="none" pattern="URL" />
<policy domain="delegate" rights="none" pattern="gs" />
<policy domain="coder" rights="read|write" pattern="PDF" />gs 行最重要。ImageMagick 不会自行解析 PostScript,而是调用 Ghostscript。禁止该委托后,即使允许 PDF 编解码器,也会阻止依赖 Ghostscript 的标准 PDF 到图像转换。
同一策略还会设置资源上限,用于防止经过构造的图像耗尽系统资源:
<policy domain="resource" name="memory" value="256MiB"/>
<policy domain="resource" name="map" value="512MiB"/>
<policy domain="resource" name="disk" value="1GiB"/>
<policy domain="resource" name="width" value="16KP"/>
<policy domain="resource" name="height" value="16KP"/>
<policy domain="resource" name="area" value="128MP"/>解压缩炸弹是一个声明了超大尺寸的小文件。width 和 height 限制会拒绝尺寸超过这些上限的图像。area 限制控制缓存在内存中的图像区域大小;较大的图像会使用磁盘缓存,而不会仅因超过该限制就被拒绝。
反过来也存在一个问题。如果当前策略直接禁止 PDF 编解码器,PDF 处理会因 attempt to perform an operation not allowed by the security policy 'PDF' 而失败。该字符串表示策略正在正常生效。是否重新允许该编解码器,应由您明确决定;重新允许时,仍应保持禁止 gs 委托。
小型 VPS 上的依赖链成本
空闲时,这些组件都不会消耗太多资源。文档监听器可以在转换任务之间持续运行,因此转换器二进制文件并不会在空闲时全部退出。主要开销发生在文件到达时。
文档转换通过持久运行的监听器调用 LibreOffice。根据上述策略,图像转换的像素缓存上限分别为 256 MiB 内存和 512 MiB 内存映射;这些是上限,不是固定分配。FFmpeg 的视频线程数取决于编解码器及其多线程支持。PHP 自身的 memory_limit 在项目配置中为 512M。这些资源会在单个任务期间叠加,还要加上操作系统和 Web 服务器的开销。
不要使用 1 GB 的 VPS 执行文档转换。事后可通过 dmesg -T | grep -i "killed process" 检查是否发生过内存不足终止。
以下是容量规划建议,不是基准测试:4 GB 内存和 2 个核心足以让小型团队舒适运行;如果负载主要是文档和图像,并且可以接受等待,2 GB 内存配合交换文件也能工作。交换文件不会加快转换速度。它可以让突发负载变慢,而不是直接失败;这决定了结果是页面卡住还是服务中断。磁盘空间应预留得比直觉所需更多,因为 3 GB 的图像、较大的上传限制以及转换后的输出文件,会在其他资源耗尽之前就占满磁盘。
转换任务本身具有突发性。两个人同时上传视频时,会相互争用 CPU,也会与其他请求争用 CPU。在 v3.7.4 中,前面没有任务队列,因此唯一可用的控制手段就是限制。
设置限制,防止单次上传占满磁盘
先降低 PHP 的限制值。对于共享的 4 GB 服务器,upload_max_filesize = 512M、post_max_size = 512M 和 max_file_uploads = 20 可以作为合理的起点。POST 限制包含所有文件和 multipart 开销,因此单个文件必须小于该限制。max_execution_time = 1200 设置的是 20 分钟的脚本执行限制,而不是上传超时;在 Linux 上的标准非 ZTS PHP 构建中,外部转换命令占用的时间也不计入该限制。v3.7.4 核心还会调用 set_time_limit(0),从而移除该执行限制。输入处理超时和 Web 服务器超时是独立的控制项。
然后在代理层强制执行大小和速率限制,使请求在到达 PHP 前就受到限制:
limit_req_zone $binary_remote_addr zone=convert:10m rate=6r/m;
server {
listen 443 ssl;
server_name convert.example.com;
client_max_body_size 512M;
client_body_timeout 300s;
location / {
limit_req zone=convert burst=4 nodelay;
proxy_pass http://127.0.0.1:8080;
proxy_read_timeout 1200s;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}client_max_body_size 限制整个请求正文的大小,其中包括 multipart 开销,因此应将其设置为高于要转换的最大文件大小,否则 nginx 会返回 413 Request Entity Too Large,PHP 将永远收不到该上传请求。proxy_read_timeout 必须能够覆盖上游不返回数据的最长间隔。会定期发送数据的转换任务,其总运行时间可以超过该超时时间;但如果上游保持静默并超过该时间,连接就会断开。client_body_timeout 同样测量请求正文两次读取之间的间隔,而不是整个上传持续时间。该 server block 的其余配置,包括 TLS(传输层安全)终止,详见逐行解析的 nginx 反向代理配置。
删除转换后的文件
每次转换都会在 Web 服务器可读取的目录中留下敏感文件副本。清理机制决定了转换器是临时工具,还是保存所有人曾经转换过的内容的档案库。
$DeleteThreshold(位于 Resources/config.php 中)表示会话过期前的分钟数,默认值为 60。处理敏感内容时,应将其缩短为 15 分钟。清理操作本身是核心程序的命令行参数,v3.7.4 的实现要求使用 root:
sudo php /path/to/HRConvert2/convertCore.php -c
sudo php /path/to/HRConvert2/convertCore.php -c=15-c 使用配置的阈值,从两个数据位置清除已过期的会话。-c=15 仅对本次运行使用 15 分钟。-c=now 会删除所有会话,不论其已存在多久,包括用户当时正在使用的会话,因此仅应在维护时使用。通过 docker exec 在容器内使用相同的参数。
将清理操作加入定时器,避免清理依赖有人加载页面。在 /etc/cron.d/hrconvert2 中添加一行即可:
*/10 * * * * root php /path/to/HRConvert2/convertCore.php -c几分钟后使用 ls /DATA/HRConvert2 检查,并监控旧会话目录是否消失。由于该目录归 Web 服务器用户所有,被利用的解析器获得的正是这个账户,因此该账户不应拥有其他有价值的权限。VPS 上的最小权限用户账户 是通用做法,在这里尤其适用。
除非目标是公开提供,否则应放在身份验证之后
默认安装按设计不包含任何账户。任何能够访问该页面的人都可以上传文件并运行您的转换器二进制文件,速率限制只能降低攻击速度。因此,请先确定您属于哪种情况。
如果只有您和几位同事使用,请不要将其公开暴露。按上文所示将容器绑定到 loopback,并通过私有网络或 SSH 隧道访问。使用 Docker 28.0.0 或更高版本且未配置公网代理时,这种 loopback 发布方式可阻止远程主机直接访问转换器。如果同事需要在浏览器中打开它,而您又不想发布主机名或开放端口,将其作为 v3 onion 服务提供可以让转换器继续绑定到 loopback,同时为他们提供可访问的地址。
如果必须通过浏览器访问,请在代理前配置身份验证。Basic auth 只需执行两个命令,即可避免陌生人看到上传表单:
sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/.htpasswd alicelocation / {
auth_basic "Converter";
auth_basic_user_file /etc/nginx/.htpasswd;
proxy_pass http://127.0.0.1:8080;
}重新加载 nginx,然后打开页面。出现提示表示配置已生效;没有提示则表示您编辑的 location 块并不是处理该请求的配置块。若要使用独立账户而不是共享密码,请在单点登录提供商处终止身份验证:自托管 Authentik SSO 服务器可以在没有自带登录功能的应用前提供转发身份验证。
如果目标确实是公开提供转换服务,则必须接受其含义并提前规划。假设攻击者会探测沙箱。固定镜像标签,严格限制 ImageMagick policy,设置较小的上传限制,并将其运行在不存放其他重要数据的 VPS 上。
故障模式及您将看到的字符串
需要沙箱的转换会立即失败。 沙箱无法构建。在 Ubuntu 24.04 上,检查 AppArmor 配置文件。在固定版本的 3.7 Docker 镜像中,检查 --security-opt seccomp=unconfined,并在需要时检查 --security-opt apparmor=unconfined。拒绝执行取决于 $RequireSandbox 或 $RequireSandboxOnDocker;固定版本的容器默认允许不使用沙箱的转换。在这些版本中,文档转换不要求使用沙箱。
只有图像转换失败。 Bubblewrap is missing or non functional, so this image conversion cannot be isolated! 表示 bwrap 不存在,或不在 Web 服务器用户可访问的 PATH 中。
一种格式失败,其他格式正常。 这表示缺少二进制文件,错误信息会直接报告这一点:ImageMagick may not be installed, or may not be reachable on the system path used by the web server user. FFmpeg 和 LibreOffice 也会显示相同类型的信息。运行 convertCore.php -v,查看安装环境能够找到哪些程序,并注意 Apache worker 的 PATH 与您登录 shell 的 PATH 不同。
PDF 处理因策略错误失败。 attempt to perform an operation not allowed by the security policy 'PDF' 来自 ImageMagick 的 policy.xml,不是来自 HRConvert2。
大文件上传返回 413。 nginx 的 client_max_body_size 小于请求正文大小。整个链路有 3 个限制:nginx 中的 1 个限制和 PHP 中的 2 个限制,最终以最小值为准。
转换停止,但没有明显的配置变化。 The device where data is stored has an insufficient amount of storage space available. 检查可用磁盘空间,并确认清理任务确实在运行。
日志中出现清理错误。 Could not clean the temporary location! 和 Could not clean the convert location! 表示路径或权限存在问题。检查临时位置和 $ConvertLoc;Web 服务器用户需要对这两者具有读写权限。
FAQ
将自托管文件转换器暴露到互联网是否安全?
只有将其视为暴露给陌生人的解析器时,它才算足够安全。每个上传的文件都会交给 LibreOffice、ImageMagick、FFmpeg 或 Ghostscript 处理,而由上传者选择使用哪一个工具。在 v3.7.4 中,bubblewrap 会隔离许多转换工具,但持久运行的文档监听器仍在该沙箱之外运行。启用 sandboxing 要求后,如果无法进行隔离,受影响的转换会被拒绝;该设置不涵盖文档监听器。仍应要求身份验证、严格限制上传大小,并在不存放其他重要数据的 VPS 上运行它。
为什么在全新安装的 Ubuntu 24.04 上每次转换都会失败?
Ubuntu 24.04 通过 AppArmor 限制非特权用户命名空间,而 bubblewrap 需要用户命名空间来构建其沙箱。无法启动用户命名空间时,需要该功能的转换会失败;v3.7.4 文档转换不受此限制。为 /usr/bin/bwrap 编写包含 flags=(unconfined) 的 AppArmor 配置文件,使用 sudo apparmor_parser -r /etc/apparmor.d/bwrap 加载,然后通过 bwrap --ro-bind / / --dev /dev /bin/true 确认。Debian 12 默认允许非特权用户命名空间,因此不需要此步骤。
为什么在 Docker 中转换失败,而在常规安装中可以正常工作?
Docker 的默认 seccomp 配置会阻止 bubblewrap 使用的系统调用,因此无法在容器内创建沙箱。对于此处固定使用的 3.7 镜像,请使用 --security-opt seccomp=unconfined 启动容器;该版本的 config.php 注释要求这样配置。从 v3.8.0 开始,项目改为记录 --cap-add SYS_ADMIN。请注意,固定的 3.7 镜像中,$RequireSandboxOnDocker 默认值为 FALSE,因此未设置相关标志的容器可能完全不使用沙箱就执行转换。配置 seccomp 标志后,将其设置为 TRUE。
文件转换服务器需要多少 RAM?
空闲时占用很小,但执行实时转换时并非如此。LibreOffice 使用持久监听器;在随软件发布的策略下,ImageMagick 的像素缓存上限为 256 MiB 内存和 512 MiB 映射,PHP 自身的限制为 512M。这些限制不是固定分配,也不能作为总内存使用量的基准。小型团队建议规划 4 GB 内存和 2 个 CPU 核心;如果转换无提示退出,请检查 dmesg -T | grep -i "killed process"。
转换后的文件存放在哪里,何时会删除?
它们会进入 Resources/config.php 中由 $ConvertLoc 指定的工作目录,默认值为 /DATA/HRConvert2。$DeleteThreshold 设置会话过期所需的分钟数,默认值为 60。以 root 身份从命令行运行清理任务:sudo php convertCore.php -c 清除已过期的会话,-c=now 立即清除所有会话,包括活动会话。将 -c 添加到 root 的 cron 条目或 systemd timer 中,确保删除操作不依赖任何人访问站点。