c4illin/convertx

ConvertX

!https://github.com/C4illin/ConvertX/raw/main/images/logo.png

https://github.com/C4illin/ConvertX/actions/workflows/docker-publish.yml/badge.svg?branch=main](https://github.com/C4illin/ConvertX/actions/workflows/docker-publish.yml) https://img.shields.io/badge/dynamic/json?logo=github&url=https%3A%2F%2Fipitio.github.io%2Fbackage%2FC4illin%2FConvertX%2Fconvertx.json&query=%24.downloads&label=ghcr.io%20pulls&cacheSeconds=***](https://github.com/C4illin/ConvertX/pkgs/container/ConvertX) https://img.shields.io/docker/pulls/c4illin/convertx?style=flat&logo=docker&label=dockerhub%20pulls&link=https%3A%2F%2Fhub.docker.com%2Frepository%2Fdocker%2Fc4illin%2Fconvertx%2Fgeneral](https://hub.docker.com/r/c4illin/convertx) !GitHub commits since latest release !GitHub repo size !Docker container size

镜像概述和主要用途

ConvertX是一个自托管的在线文件转换工具，支持超过一千种不同的格式。使用TypeScript、Bun和Elysia开发，可部署在本地服务器或私有云环境中，为用户提供安全、高效的文件格式转换服务。

核心功能和特性

• 支持多种文件格式转换
• 批量处理多个文件
• 密码保护功能
• 多账户支持

支持的转换器

注：FFmpeg支持的许多文件格式存在重复

使用场景和适用范围

ConvertX适用于以下场景：

1. 个人用户：需要频繁转换各种文件格式的个人用户，如学生、研究人员、设计师等。

2. 小型团队：团队内部需要共享和转换多种格式文件，如文档、图像、电子书等。

3. 教育机构：学校或培训机构需要处理各种教育材料格式转换。

4. 企业环境：企业内部文档管理系统的辅助工具，确保文档格式统一。

5. 隐私敏感场景：处理包含敏感信息的文件转换，避免使用公共在线转换服务带来的隐私泄露风险。

详细的使用方法和配置说明

Docker部署

[!WARNING] 如果无法登录，请确保通过localhost或https访问服务，否则需设置HTTP_ALLOWED=true

Docker Compose配置

yaml
# 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命令

bash
docker run -p 3000:3000 -v ./data:/app/data ghcr.io/c4illin/convertx

部署完成后，访问http://localhost:3000创建账户。请勿将未配置的服务暴露在公网，因为任何人都可以注册第一个账户。

如果遇到"无法打开数据库文件"错误，请对您选择的路径运行chown -R $USER:$USER path命令。

环境变量配置

所有环境变量均为可选，但建议设置JWT_SECRET以确保安全。

Docker镜像标签

提供latest标签（随每个发布更新）和main标签（随每次推送到主分支更新）。建议常规使用latest标签。

镜像可在https://github.com/C4illin/ConvertX/pkgs/container/ConvertX%E5%92%8Chttps://hub.docker.com/r/c4illin/convertx%E8%8E%B7%E5%8F%96%E3%80%82

!Release image size !Dev image size

界面预览

!https://github.com/C4illin/ConvertX/raw/main/images/preview.png

参与贡献

如有缺失的转换器支持，请提交issue或pull request！

开发指南：

1. 安装Bun和Git
2. 克隆仓库
3. 运行bun install安装依赖
4. 运行bun run dev启动开发服务器

欢迎提交pull request！可查看开放issue了解待办事项。标记为"converter request"的issue实现难度较低。文档改进和问题整理也非常欢迎！

提交信息请遵循conventional commits规范。

贡献者

https://github.com/C4illin/ConvertX/graphs/contributors

星标历史

https://github.com/C4illin/ConvertX/stargazers