面对多样的文件格式，在线转换工具常伴有广告与隐私风险。ConvertX作为一款开源自托管的万能格式转换工具，能部署在NAS或服务器上，将数据完全掌控在自己手中。本篇内容将详细讲解其部署与使用方法，助你轻松搭建一个安全、私有的文件格式转换站。
智能速览
ConvertX是开源自托管工具，支持上千种格式。
通过Docker部署，数据保留在本地，安全可控。
部署需配置端口、JWT密钥等关键环境变量。
操作简单，通过浏览器选择文件和目标格式即可转换。
对中文办公文档（如Word转PDF）支持不佳，可能出现乱码。
精华内容
想要将这款强大的工具收入囊中，部署过程其实并不复杂。通过Docker Compose，只需几步配置，就能让它在你的NAS上稳定运行。
Docker部署准备
部署前，需在Docker目录下为ConvertX创建专用的文件夹，例如`convertx/data`，用于持久化存储数据。核心是编写`docker-compose.yml`文件。配置中，`ports`项定义了外部访问端口，默认为3000，如被占用可自行修改。`volumes`项则需将容器内的`/app/data`路径映射到宿主机刚创建的`data`文件夹，确保文件数据不会因容器重启而丢失。
安全与访问设置
环境变量的正确设置至关重要。`JWT_SECRET`是用于生成登录令牌的密钥，必须修改为一串复杂的自定义字符串，否则每次重启容器都会导致所有用户被强制下线。如果仅在局域网内使用且未配置HTTPS，则需要取消`HTTP_ALLOWED`前的注释，允许HTTP访问，否则将无法正常打开页面。
格式转换实测
部署完成后，通过浏览器访问`IP:端口号`即可进入ConvertX界面。其操作逻辑非常直观：点击选择文件上传后，系统会自动识别源格式，用户只需在搜索框中输入或选择目标格式，点击转换即可。整个过程在本地完成，速度较快。实测将JPG图片转换为PNG格式，功能正常，可在线预览并下载结果。
中文兼容性考量
尽管ConvertX功能强大，但在处理中文办公文档时存在明显短板。在实际测试中，将包含中文内容的Word文档转换为PDF，转换后的文件中文内容全部显示为乱码，无法正常阅读。因此，如果核心需求是处理中文文档，ConvertX可能不是最佳选择，需要考虑其他替代方案。
ConvertX为NAS用户提供了一个功能全面且注重隐私的文件格式转换方案，尤其适合处理音视频、图片等格式的转换需求。虽然在中文文档支持上尚有不足，但其开源自托管的特性依然使其具有很高的价值。对于追求数据完全掌控的用户来说，它无疑是值得尝试的工具。
