在线文件转换器-ConvertX

1. 唠嗑

和大家分享一个自托管的在线文件转换器。支持超过一千种不同格式。使用 TypeScript、Bun 和 Elysia 编写。

2. ConvertX 简介

功能特性

将文件转换为不同格式
一次处理多个文件
密码保护
多个账户

支持转换的类型

Converter	Use case	Converts from	Converts to
Inkscape	Vector images	7	17
libjxl	JPEG XL	11	11
resvg	SVG	1	1
Vips	Images	45	23
libheif	HEIF	2	4
XeLaTeX	LaTeX	1	1
Calibre	E-books	26	19
LibreOffice	Documents	41	22
Dasel	Data Files	5	4
Pandoc	Documents	43	65
msgconvert	Outlook	1	1
VCF to CSV	Contacts	1	1
dvisvgm	Vector images	4	2
ImageMagick	Images	245	183
GraphicsMagick	Images	167	130
Assimp	3D Assets	77	23
FFmpeg	Video	~472	~199
Potrace	Raster to vector	4	11
VTracer	Raster to vector	8	1
Markitdown	Documents	6	1

3. 相关地址

官方 GitHub 地址：https://github.com/C4illin/ConvertX （目前 15.3k 个 star，欢迎大家去给项目点星星！）

当然如果你想自己用 docker 搭建一个，那我们就继续往下！

4. 搭建环境

服务器：咕咕这边用的香港的莱卡云服务器，建议服务器内存 1G 以上，当然你也可以选择其他高性价比的服务器。
系统：Debian 11 （DD 脚本非必需 DD，用原来的系统也 OK，之后教程都是用 Debian 或者 Ubuntu 搭建～）
安装好 Docker、Docker-compose（相关脚本）
【必需】域名一枚，并做好解析到服务器上（域名购买、域名解析视频教程）
【非必需】提前安装好宝塔面板海外版本 aapanel，并安装好 Nginx（安装地址）
【非必需本教程选用】安装好 Nginx Proxy Manager（相关教程）

5. 搭建视频（过俩周补充 = =）

5.1 YouTube

视频地址：

5.2 哔哩哔哩

哔哩哔哩：

6. 搭建方式

6.1 安装 Docker 与 Nginx Proxy Manager

可以直接参考这篇内容：

https://blog.laoda.de/archives/nginxproxymanager/

6.2 创建安装目录

创建一下安装的目录：

sudo -i

mkdir -p /root/data/docker_data/convertx

cd /root/data/docker_data/convertx

接着我们来编辑下docker-compose.yml

vim docker-compose.yml

services:
  convertx:
    image: ghcr.io/c4illin/convertx
    container_name: convertx
    restart: unless-stopped
    ports:
      - "3001:3000"
    environment:
      - JWT_SECRET=aLongAndSecretStringUsedToSignTheJSONWebToken123412 # will use randomUUID() if unset
      # - HTTP_ALLOWED=true # uncomment this if accessing it over a non-https connection 如果通过 http 访问的话取消这行注释
      - LANGUAGE=zh
    volumes:
      - ./data:/app/data

其中的左边的3001可以改成服务器上没有用过的端口。

修改完成之后，可以在英文输入法下，按 i 修改，完成之后，按一下 esc，然后 :wq 保存退出。

环境变量

所有都是可选的，但建议设置 JWT_SECRET。

Name	Default	Description
JWT_SECRET	when unset it will use the value from randomUUID()	用于签署 JSON Web Token 的一串密钥字符串
ACCOUNT_REGISTRATION	false	允许用户注册账户
HTTP_ALLOWED	false	允许 HTTP 连接，仅在本地部署的时候将它设置为 true
ALLOW_UNAUTHENTICATED	false	允许未认证用户使用该服务，仅在本地部署的时候将它设置为 true。
AUTO_DELETE_EVERY_N_HOURS	24	每 n 小时检查一次，删除超过 n 小时的文件，设置为 0 表示禁用。
WEBROOT		将根路径设置为 "/convert" 的地址将在 "example.com/convert/" 上提供网站。
FFMPEG_ARGS		传递给 ffmpeg 输入文件的参数，例如 `-hwaccel vaapi`。有关硬件加速的更多信息，请参见 #190。
FFMPEG_OUTPUT_ARGS		传递给 ffmpeg 输出的参数，例如 `-preset veryfast`
HIDE_HISTORY	false	隐藏历史页面
LANGUAGE	en	用于格式化日期字符串的语言，指定为 BCP 47 language tag
UNAUTHENTICATED_USER_SHARING	false	所有未经身份验证用户共享转换历史记录
MAX_CONVERT_PROCESS	0	允许的最大并发转换进程数量。设置为 0 表示无限制。

按需添加修改，修改完成之后，可以在英文输入法下，按 i 修改，完成之后，按一下 esc，然后 :wq 保存退出。

6.3 查看端口是否被占用

查看端口是否被占用（以 3001 为例），输入：

lsof -i:3001  #查看 3001 端口是否被占用，如果被占用，重新自定义一个端口

如果啥也没出现，表示端口未被占用，我们可以继续下面的操作了～

如果出现：

-bash: lsof: command not found

运行：

apt install lsof  #安装 lsof

如果端口没有被占用（被占用了就修改一下端口，比如改成 8381，注意 docker 命令行里和防火墙都要改）

6.4 启动 convertx

cd /root/data/docker_data/convertx

docker compose up -d   # 注意，老版本用户用 docker-compose up -d

镜像还是比较大的……

耐心等待拉取好镜像，出现 Created的字样之后，

理论上我们就可以输入 http://ip:3001 访问了。

但是我们部署在公网一定要考虑使用反向代理工具配置 SSL！

做反向代理前，你需要一个域名！

namesilo 上面 xyz 后缀的域名一年就 7 块钱，可以年抛。（冷知识，namesilo 上 6 位数字的 xyz 续费永远都是 0.99 美元 = =）

如果想要长期使用，还是建议买 com 后缀的域名，更加正规一些，可以输入 laodade 来获得 1 美元的优惠（不知道现在还有没有）

namesilo 自带隐私保护，咕咕一直在用这家，价格也是这些注册商里面比较低的，关键是他家不像其他家域名注册商，没有七七八八的套路！（就是后台界面有些丑古老 = =）

【域名购买】Namesilo 优惠码和域名解析教程（附带服务器购买推荐和注意事项）

我们接着往下看！

7. 反向代理

7.1 利用 Nginx Proxy Manager

在添加反向代理之前，确保你已经完成了域名解析，不会的可以看这个：域名一枚，并做好解析到服务器上（域名购买、域名解析视频教程）（名称改成你自己想要的域名前缀即可）

之后，登陆 Nginx Proxy Manager（不会的看这个：安装 Nginx Proxy Manager（相关教程））

注意：

Nginx Proxy Manager（以下简称 NPM）会用到 80、443 端口，所以本机不能占用（比如原来就有 Nginx）

直接丢几张图：

注意填写对应的 域名、IP 和 端口，按文章来的话，应该是 3001

IP 填写：

如果 Nginx Proxy Manager 和 convertx 在同一台服务器上，可以在终端输入：

ip addr show docker0

查看对应的 Docker 容器内部 IP。

否则直接填 convertx 所在的服务器 IP 就行。

然后访问域名就可以访问了！

7.2 利用宝塔面板

发现还是有不少小伙伴习惯用宝塔面板，这边也贴一个宝塔面板的反代配置：

直接新建一个站点，不要数据库，不要 php，纯静态即可。

然后打开下面的配置，修改 Nginx 的配置。

代码如下：

location / {
      proxy_pass http://127.0.0.1:3001/;       # 注意改成你实际使用的端口
      rewrite ^/(.*)$ /$1 break;
      proxy_redirect off;
      proxy_set_header Host $host;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header Upgrade-Insecure-Requests 1;
      proxy_set_header X-Forwarded-Proto https;
    }

此方法对 90% 的反向代理都能生效，然后就可以用域名来安装访问了。

有同学可能会问，为什么不直接用宝塔自带的反向代理功能。

也可以，不过咕咕自己之前遇到过当有多个网站需要反代的时候，在这边设置会报错的情况 = =

所以后来就不用了，直接用上面的方法来操作了。

8. 使用教程

非常简单，所见即所得。

先注册账号：

JPG 转换成 webp

MP4 转 AVI

正常转换。

转换历史：

服务器里还是能看到文件的，

8.1 更新 convertx

这个项目后续会持续有更新，所以提供一个更新的方式。

cd /root/data/docker_data/convertx

docker compose pull

docker compose up -d    # 请不要使用 docker compose stop 来停止容器，因为这么做需要额外的时间等待容器停止；docker compose up -d 直接升级容器时会自动停止并立刻重建新的容器，完全没有必要浪费那些时间。

docker image prune  # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像

提示：

WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N]

输入 y

利用 Docker 搭建的应用，更新非常容易～

8.2 卸载 convertx

同样进入安装页面，先停止所有容器。

cd /root/data/docker_data/convertx

docker compose down

cd ..

rm -rf /root/data/docker_data/convertx  # 完全删除

可以卸载得很干净。

9. 使用问题

大家使用上有什么心得或者问题，欢迎评论区交流～

10. 结尾

祝大家用得开心，有问题可以去 GitHub 提 Issues，也可以在评论区互相交流探讨。

同时，有能力给项目做贡献的同学，也欢迎积极加入到项目中来，贡献自己的一份力量！

最后，感谢作者 @C4illin 的辛苦付出，让我们能用到这么优秀的项目！欢迎大家都去给这个项目点个 star。

参考资料

官方 GitHub：https://github.com/C4illin/ConvertX