ConvertX

!ConvertX

![Docker]([] ![ghcr.io Pulls]([] ![Docker Pulls]([] ![GitHub Release]([] !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标签。

镜像可在GitHub Container Registry和Docker Hub获取。

!Release image size !Dev image size

界面预览

!ConvertX Preview

参与贡献

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

开发指南：

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

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

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

贡献者

星标历史