ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

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

ConvertX 完整部署指南:把闲置机器变成上千格式的文件转换站 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_HOURS12还能让中间文件每 12 小时自动清理不占硬盘。内容创作拍客设备录的 HEIC 照片、各种小众视频封装格式FFmpeg 和 Vips 转换器都能接住。跑视频转码时加上- FFMPEG_ARGS-preset veryfast可以让编码速度明显快一档适合小内存机器。教学教务教师整理课件常用 Calibre 转换器把 EPUB 电子书批量转成学生阅读器支持的格式Pandoc 则能把 Markdown 讲义一键变成带排版的文档。班级共用服务时设置- ACCOUNT_REGISTRATIONtrue让每个学生自己注册账号互不干扰。值得关注的核心设计 打开 src/converters/main.ts 会发现一个很有意思的调度设计每个转换器只负责声明自己能接收哪些扩展名、能输出哪些扩展名注册表启动时自动汇总成一张全局能力表。转换请求进来后mainConverter按源格式 目标格式匹配到对应工具网页上选择目标格式的下拉框内容也正是这张表生成的。想加新格式只需新写一个转换器文件并声明 from/to 列表派发逻辑一行不用改。另一个设计在 Dockerfile它用多阶段构建把 FFmpeg、LibreOffice、Pandoc、Inkscape 等二十来种命令行工具全部装进一个镜像且明确区分了 x86_64 与 arm64 架构来安装对应二进制。这就是为什么上千格式支持能浓缩成一条docker run——工具链的复杂度被镜像封装吃掉了使用者拿到的是一个开箱即用的完整服务。踩坑速查表登录页无法登录服务默认只允许 localhost 或 HTTPS 连接登录。→ 在环境变量里加HTTP_ALLOWEDtrue仅限内网环境。报 unable to open database file./data挂载目录的属主与容器内运行用户不匹配。→ 执行chown -R $USER:$USER ./data后重启容器。账号被陌生人抢先注册首个注册的账号即为管理员端口过早暴露会被人占位。→ 先本机创建账号再配合反向代理把 HTTPS 做好后开放访问。写在最后回到开头那两个让人头大的文件.msg 邮件存档丢给 msgconvertHEIC 照片交给 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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表