前言#

格式转换的日常痛点与开源工具的优势,对于想找款免费的且能转换多格式的文件工具,几乎都有付费且不完美,这个工具不但免费而且没那么多花里胡哨,而且可支持1000+格式的自托管神器,不管在哪里都可以用.

核心功能#

• 格式覆盖广：支持视频（MP4、AVI、MKV等）、文档（Markdown、PDF、Word等）、图像（PSD、PNG、WebP等）、3D模型等1000+格式互转；

• 隐私性强：支持Docker、NAS等本地部署方式，文件转换全程在本地完成，数据不外流；

• 便捷实用：支持批量上传转换、多用户管理、转换历史记录查询，还具备定时清理文件功能；

• 界面友好：采用Tailwind风格界面，操作简单直观，支持拖拽上传文件。

相关地址#

教程#

前提

已安装Docker和Docker Compose

1. 在这里拿我苹果电脑示范: 安装Docker和Docker Compose

1
---
2
# 更新 Homebrew 包索引（推荐先执行，避免安装失败）
3
brew update
4

5
# 安装 colima（会自动安装依赖如 qemu、lima 等）
6
brew install colima
7
---

2. 验证安装 安装完成后，执行以下命令检查版本，确认安装成功：

1
colima version

正常输出示例：

1
---
2
colima version 0.9.1
3
git commit: xxxxxxxxxxxxxxxxxxxxxxx2ff7d94a
4

5
runtime: docker
6
arch: aarch64
7
client: v29.1.3
8
server: v28.4.0
9
---

3. 启动 colima（首次使用）我使用默认配置:colima start 安装后需要启动 colima 才能使用容器功能：

1
---
2
# 启动默认配置的 colima（2核、2GB 内存）
3
colima start
4

5
# 自定义配置启动（例如 4核、8GB 内存）
6
colima start --cpu 4 --memory 8 --disk 60
7
---

4. 搭配 Docker CLI 使用（可选） 如果需要用 docker 命令操作容器，需安装 Docker CLI：

1
brew install docker

启动 colima 后，docker 命令会自动关联到 colima，可执行 docker ps 验证：

1
docker ps  # 无报错即表示关联成功

正式环节#

随便找个地方放docker-compose.yml,我直接放在桌面.

1. 打开终端,定位到桌面

1
mkdir docker_data  # 新建文件夹
2
cd docker_data
3
vim docker-compose.yml

2. 复制代码(本地版) 端口可以修改:左边的端口号可以修改,右边的端口号最好别改,反正我没试过右边修改😂 实例: -p 8001:3000 - 将 8001 端口映射到容器中的 3000 端口

1
---
2
services:
3
  convertx:
4
    image: ghcr.io/c4illin/convertx
5
    container_name: convertx
6
    restart: unless-stopped
7
    ports:
8
      - "3000:3000".     # 容器端口与主机端口映射
9
    environment:         # 设置环境变量
10
      - JWT_SECRET=aLongAndSecretStringUsedToSignTheJSONWebToken1234 # will use randomUUID() if unset
11
      - HTTP_ALLOWED=true # # 允许 HTTP 连接，仅在本地将其设置为 true
12
    volumes:
13
      - ./data:/app/data
14
---

3. -d 后台运行容器

1
docker compose up -d

大功告成#

在电脑打开浏览器输入: http://localhost:3000/

2. 复制代码(服务器版)

1
---
2
services:
3
  convertx:
4
    image: ghcr.io/c4illin/convertx
5
    container_name: convertx
6
    restart: unless-stopped
7
    ports:
8
      - "3000:3000"         # 容器端口与主机端口映射
9
    environment:            # 设置环境变量
10
      - JWT_SECRET=aLongAndSecretStringUsedToSignTheJSONWebToken1234 # will use randomUUID() if unset
11
      - HTTP_ALLOWED=false  # 允许 HTTP 连接，仅在本地将其设置为 true
12
    volumes:
13
      - ./data:/app/data
14
---

3. -d 后台运行容器

1
docker compose up -d

大功告成#

在电脑打开浏览器输入: http://localhost:3000/

作者的一些环境变量,需要的自行添加