ghcr.io/c4illin/convertx:latest
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
ConvertX
一款自托管的在线文件转换器。支持超过一千种不同格式。使用TypeScript、Bun和Elysia编写。
功能特性
- 将文件转换为不同格式
- 同时处理多个文件
- 密码保护
- 多账户支持
支持的转换器
| 转换器 | 用例 | 转换自 | 转换至 |
|---|---|---|---|
| https://inkscape.org/ | 矢量图像 | 7 | 17 |
| https://github.com/libjxl/libjxl | JPEG XL | 11 | 11 |
| https://github.com/RazrFalcon/resvg | SVG | 1 | 1 |
| https://github.com/libvips/libvips | 图像 | 45 | 23 |
| https://github.com/strukturag/libheif | HEIF | 2 | 4 |
| https://tug.org/xetex/ | LaTeX | 1 | 1 |
| Calibre | 电子书 | 26 | 19 |
| https://www.libreoffice.org/ | 文档 | 41 | 22 |
| https://github.com/TomWright/dasel | 数据文件 | 5 | 4 |
| https://pandoc.org/ | 文档 | 43 | 65 |
| https://github.com/mvz/email-outlook-message-perl | Outlook | 1 | 1 |
| VCF to CSV | 联系人 | 1 | 1 |
| dvisvgm | 矢量图像 | 4 | 2 |
| https://imagemagick.org/ | 图像 | 245 | 183 |
| http://www.graphicsmagick.org/ | 图像 | 167 | 130 |
| https://github.com/assimp/assimp | 3D资源 | 77 | 23 |
| https://ffmpeg.org/ | 视频 | 约472 | 约199 |
| https://potrace.sourceforge.net/ | 光栅图转矢量图 | 4 | 11 |
| https://github.com/visioncortex/vtracer | 光栅图转矢量图 | 8 | 1 |
| https://github.com/microsoft/markitdown | 文档 | 6 | 1 |
缺少所需转换器？请提交issue或pull request！
部署
[!WARNING] 如果无法登录，请确保通过localhost或https访问服务，否则设置HTTP_ALLOWED=true
# docker-compose.yml
services:
convertx:
image: ghcr.io/c4illin/convertx
container_name: convertx
restart: unless-stopped
ports:
- "3000:3000"
environment:
- JWT_SECRET=aLongAndSecretStringUsedToSignTheJSONWebToken1234 # 未设置时将使用randomUUID()
# - HTTP_ALLOWED=true # 如果通过非https连接访问，请取消此行注释
volumes:
- ./data:/app/data
或
docker run -p 3000:3000 -v ./data:/app/data ghcr.io/c4illin/convertx
然后在浏览器中访问http://localhost:3000并创建您的账户。不要让它处于未配置且开放的状态，因为任何人都可以注册第一个账户。
如果遇到无法打开数据库文件的问题，请在您选择的路径上运行chown -R $USER:$USER path。
环境变量
所有环境变量均为可选，建议设置JWT_SECRET。
| 名称 | 默认值 | 描述 |
|---|---|---|
| JWT_SECRET | 未设置时将使用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。有关硬件加速的更多信息，请参见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表示无限制 |
| PORT | 3000 | 应用程序监听端口 |
Docker镜像
提供:latest标签（随每次发布更新）和:main标签（随每次推送到main分支更新）。:latest推荐用于常规使用。
镜像可在https://github.com/C4illin/ConvertX/pkgs/container/ConvertX和https://hub.docker.com/r/c4illin/convertx获取。
| 镜像 | 说明 |
|---|---|
image: ghcr.io/c4illin/convertx | ghcr上的最新发布版本 |
image: ghcr.io/c4illin/convertx:main | ghcr上的最新提交版本 |
image: c4illin/convertx | Docker Hub上的最新发布版本 |
image: c4illin/convertx:main | Docker Hub上的最新提交版本 |
教程
[!NOTE] 这些教程由其他人编写，可能已过时、不准确或存在错误。
法语教程：
中文教程：
波兰语教程：
截图
开发
- 安装https://bun.sh/和Git
- 克隆仓库
bun installbun run dev
欢迎提交拉取请求！请查看开放问题以获取待办事项列表。标有“converter request”的问题相对容易处理。帮助完善文档和清理问题也非常欢迎！
提交信息请使用https://www.conventionalcommits.org/en/v1.0.0/#summary格式。
贡献者
星标历史
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"