热门搜索:
ghcr.io/c4illin/convertx:pr-474
ghcr.iolinux/amd64pr-474大小: 未知更新于 2026年6月6日
让 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 开发。
功能特性
- 将文件转换为不同格式
- 同时处理多个文件
- 密码保护
- 多账户支持
支持的转换器
| 转换器 | 用途 | 转换自 | 转换到 |
|---|---|---|---|
| Inkscape | 矢量图像 | 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 |
| XeLaTeX | LaTeX | 1 | 1 |
| Calibre | 电子书 | 26 | 19 |
| LibreOffice | 文档 | 41 | 22 |
| https://github.com/TomWright/dasel | 数据文件 | 5 | 4 |
| Pandoc | 文档 | 43 | 65 |
| https://github.com/mvz/email-outlook-message-perl | Outlook | 1 | 1 |
| VCF to CSV | 联系人 | 1 | 1 |
| dvisvgm | 矢量图像 | 4 | 2 |
| ImageMagick | 图像 | 245 | 183 |
| GraphicsMagick | 图像 | 167 | 130 |
| https://github.com/assimp/assimp | 3D 资源 | 77 | 23 |
| FFmpeg | 视频 | ~472 | ~199 |
| Potrace | 光栅图转矢量图 | 4 | 11 |
| https://github.com/visioncortex/vtracer | 光栅图转矢量图 | 8 | 1 |
| https://github.com/microsoft/markitdown | 文档 | 6 | 1 |
缺少所需转换器？请提交 issue 或拉取请求！
部署
[!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 表示无限制 |
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] 这些教程由其他人编写，可能已过时、不准确或存在错误。
法语教程：
中文教程：
波兰语教程：
截图
开发
- 安装 Bun 和 Git
- 克隆仓库
bun installbun run dev
欢迎提交拉取请求！请查看开放 issue 了解待办事项。标有“converter request”的 issue 实现难度较低。文档完善和 issue 整理方面的帮助也非常欢迎！
提交信息请使用 规范提交 格式。
贡献者
星标历史
镜像拉取常见问题
功能
排错
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"