企业官网建设流程全解析

ConvertX 完整部署指南：把闲置机器变成上千格式的文件转换站

【免费下载链接】ConvertX💾 Self-hosted online file converter. Supports 1000+ formats ⚙️项目地址: https://gitcode.com/GitHub_Trending/co/ConvertX

同事发来一份 .msg 格式的 Outlook 邮件存档，客户又催着要 HEIC 转 JPG，手头的转换工具一个个都不认这种格式。与其在网页转换器里来回上传、担心隐私，不如自己动手：用 ConvertX 在你自己的机器上搭一个自托管在线文件转换服务，一次部署，视频、文档、图片、电子书上千种格式通吃。整个服务用 Docker 一条命令就能跑起来，文件永远留在自己的硬盘上。

环境要求清单

部署 ConvertX 对硬件几乎没什么挑剔，一台旧笔记本甚至树莓派都能跑：

• 装有 Docker 的 Linux 机器（x86_64 或 ARM64 架构均可）
• 至少 2GB 可用磁盘空间（官方镜像内置 FFmpeg、LibreOffice 等转换工具）
• 1GB 以上可用内存，视频转码等重任务建议更多
• 3000 端口可访问（也可通过ports配置改为其他端口）
• 能拉取镜像的网络环境

最小部署步骤

全程只需要三条命令。先拉取项目代码备查：

git clone https://gitcode.com/GitHub_Trending/co/ConvertX

然后直接启动官方预构建镜像，把./data目录挂载进去保存转换记录：

docker run -d -p 3000:3000 -v ./data:/app/data --name convertx ghcr.io/c4illin/convertx

用浏览器访问http://localhost:3000创建账号，第一个注册的账号就是管理员，记得趁端口还没对外开放先完成这一步。

想确认服务是否就绪，可以敲一下健康检查接口：

curl http://localhost:3000/healthcheck

返回{"status":"ok"}就说明部署成功了，接下来就能上传文件开转。

三个真实使用场景

日常办公：拿到一批 .docx 报告要发给只收 PDF 的合作方？上传后交给 LibreOffice 转换器，批量转完直接打包下载。给容器加上- AUTO_DELETE_EVERY_N_HOURS=12还能让中间文件每 12 小时自动清理，不占硬盘。

内容创作：拍客设备录的 HEIC 照片、各种小众视频封装格式，FFmpeg 和 Vips 转换器都能接住。跑视频转码时加上- FFMPEG_ARGS=-preset veryfast，可以让编码速度明显快一档，适合小内存机器。

教学教务：教师整理课件常用 Calibre 转换器把 EPUB 电子书批量转成学生阅读器支持的格式，Pandoc 则能把 Markdown 讲义一键变成带排版的文档。班级共用服务时设置- ACCOUNT_REGISTRATION=true，让每个学生自己注册账号互不干扰。

值得关注的核心设计

📌 打开 src/converters/main.ts 会发现一个很有意思的调度设计：每个转换器只负责声明自己"能接收哪些扩展名、能输出哪些扩展名"，注册表启动时自动汇总成一张全局能力表。转换请求进来后，mainConverter按"源格式 + 目标格式"匹配到对应工具，网页上"选择目标格式"的下拉框内容也正是这张表生成的。想加新格式？只需新写一个转换器文件并声明 from/to 列表，派发逻辑一行不用改。

另一个设计在 Dockerfile：它用多阶段构建把 FFmpeg、LibreOffice、Pandoc、Inkscape 等二十来种命令行工具全部装进一个镜像，且明确区分了 x86_64 与 arm64 架构来安装对应二进制。这就是为什么"上千格式支持"能浓缩成一条docker run——工具链的复杂度被镜像封装吃掉了，使用者拿到的是一个开箱即用的完整服务。

踩坑速查表

登录页无法登录：服务默认只允许 localhost 或 HTTPS 连接登录。→ 在环境变量里加HTTP_ALLOWED=true（仅限内网环境）。

报 unable to open database file：./data挂载目录的属主与容器内运行用户不匹配。→ 执行chown -R $USER:$USER ./data后重启容器。

账号被陌生人抢先注册：首个注册的账号即为管理员，端口过早暴露会被人占位。→ 先本机创建账号，再配合反向代理把 HTTPS 做好后开放访问。

写在最后

回到开头那两个让人头大的文件：.msg 邮件存档丢给 msgconvert，HEIC 照片交给 Vips，上传、等待、下载，全程不出自己的机器。闲置硬件加上这个镜像，就是一个随叫随到、不上传云端的文件转换站。

日常维护一条命令就够：docker logs -f convertx实时查看转换日志，配合AUTO_DELETE_EVERY_N_HOURS设置，服务基本可以"无人值守"运行。

【免费下载链接】ConvertX💾 Self-hosted online file converter. Supports 1000+ formats ⚙️项目地址: https://gitcode.com/GitHub_Trending/co/ConvertX