使用Docker部署格式转换工具ConvertX0.17.0独家汉化版

秦曱凧

镜像是我(汉化)制作的，欢迎关注我B站账号 秦曱凧 (读作 qín yuē zhēng)
后面有新的项目，会在B站先发，欢迎关注。

项目介绍

ConvertX 是一个开源的在线文件格式转换工具，支持超过 1000 种主流文档、图片、音视频等多类型文件格式，不依赖第三方服务。它即装即用、操作便捷，并提供文件夹批量处理、实时进度条显示等功能。

截止 2026年01月14日 最新版 0.17.0 汉化完成，并支持 AMD64 和 ARM64 的 CPU 架构。

由于镜像有 1.3G 左右，体积较大，可能会拉取失败，因此我把镜像导出的 tar 格式文件压缩成 rar 的压缩包，并上传到了网盘上，之所以选择下面网盘，是因为这个免费空间最大，其他的网盘没有太大的空间，仅此而已。

https://pan.baidu.com/s/1gchmc3EgYKx0SOaKOX9UIg?pwd=q2ix

• 原项目地址
  • GitHub仓库 https://github.com/C4illin/ConvertX
• 我汉化和构建docker镜像的
  • GitHub仓库 https://github.com/Firfr/convertx-zh
  • Gitee仓库 https://gitee.com/firfe/convertx-zh
  • DockerHub https://hub.docker.com/r/firfe/convertx-zh

如果这个项目有帮到你。欢迎start。也厚颜期待您的打赏。

有需要帮忙部署这个项目的朋友,一杯奶茶,即可程远程帮你部署，需要可联系。
微信号 E-0_0-
闲鱼搜索用户 明月人间
或者邮箱 firfe163@163.com

视频教程

镜像

容器内部端口3000。

• 国内仓库
  • AMD64镜像

    swr.cn-north-4.myhuaweicloud.com/firfe/convertx-zh:0.17.0
    

  • ARM64镜像

    swr.cn-north-4.myhuaweicloud.com/firfe/convertx-zh:0.17.0-arm64
    

• DockerHub仓库
  • AMD64镜像

    firfe/convertx-zh:0.17.0
    

  • ARM64镜像

    firfe/convertx-zh:0.17.0-arm64
    

docker run 部署

docker run -d \
--name convertx-zh \
--network bridge \
--restart always \
--log-opt max-size=1m \
--log-opt max-file=1 \
-e HTTP_ALLOWED=true \
-e JWT_SECRET=c4illin_convertx \
-e LANGUAGE=zh \
-v ./data:/app/data \
-p 5148:3000 \
swr.cn-north-4.myhuaweicloud.com/firfe/convertx-zh:0.17.0

compose 文件部署 👍推荐

#version: '3'
name: convertx-zh
services:
  convertx-zh:
    container_name: convertx-zh
    image: swr.cn-north-4.myhuaweicloud.com/firfe/convertx-zh:0.17.0
    network_mode: bridge
    restart: always
    logging:
      options:
        max-size: 1m
        max-file: '1'
    environment:
      LANGUAGE: zh
      JWT_SECRET: c4illin_convertx
      HTTP_ALLOWED: true
      # 允许注册
      #ACCOUNT_REGISTRATION: true
    ports:
      - 5148:3000
    volumes:
      - ./data:/app/data

如果上面文件没有修改，启动成功后，访问http://ip:5148，注册一个账号，然后登录，就可以使用了

更多配置

可以通过环境变量进行更多配置。

名称	默认值	说明
JWT_SECRET	取消设置时，它将使用 randomUUID()	用于对 JSON Web 令牌进行签名的长而秘密的字符串
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。关于硬件加速的更多信息请参见 https://github.com/C4illin/ConvertX/issues/190
FFMPEG_OUTPUT_ARGS		传递给 ffmpeg 输出的参数，例如 -preset veryfast
HIDE_HISTORY	false	隐藏历史记录页面
LANGUAGE	en	用于格式化日期字符串的语言，指定为 BCP 47 语言标记
UNAUTHENTICATED_USER_SHARING	false	在所有未经身份验证的用户之间共享转换历史记录
MAX_CONVERT_PROCESS	0	允许的最大并发转换进程数量。无限设置为0。

效果图