文章总结： 文档介绍了在CentOS系统上安装ConvertX文件转换工具的完整流程，包括环境准备、下载安装、启动服务及防火墙配置。ConvertX作为开源自托管工具可保护文件隐私，安装需注意开放3000端口。步骤详细实用，适合技术人员参考部署。 综合评分： 86 文章分类： 安全工具,实战经验

Centos安装ConvertX文件转换

原创

TP微客

技术分享交流

2025年12月15日 17:53 福建

1 前言

   ConvertX 是一个完全开源、基于 TypeScript 和 Bun 开发的自托管文件转换工具，你只需要搭建一个本地环境，就能够高效、灵活地将文件从一种格式转换为另一种格式。它可以让你在你需要转换文件的时候不需要到处找各种转换网站，同时也不用担心文件隐私泄露问题。

2 环境搭建

(1)安装相关环境

以Centos系统为例，下载unzip安装的命令如下

先安装unzipyum install unzip  -y

再安装bun工具，使用如下命令：

 curl -fsSL https://bun.sh/install | bash

将bun加入到环境变量中，这个时候就可以直接使用bun命令：

[root@localhost ~]# source /root/.bash_profile[root@localhost ~]# bun --help

(2)下载ConvertX

可以在github中，直接下载，在以下网址中下载ConvertX：

https://github.com/C4illin/ConvertX

下载后解压到指定目录中，例如/opt目录下

也可以使用git在线下载，使用如下命令进行下载：

git clone https://github.com/C4illin/ConvertX.git

下载完成后，执行安装命令

bun install

安装之后的内容如下：

(3)启动ConvertX服务

使用以下命令启动服务，这里默认开启的端口是3000

bun run dev

查看监听口的状态，查看3000端口是否有开放

netstat -tulpn | grep 3000

但是看到的监听口是开放的，可是页面访问不到，我遇到了这个问题

于是排查之后发现是防火墙导致的，后面在防火墙中加入3000端口

查看端口列表，并加入3000端口

firewall-cmd --list-portsfirewall-cmd --zone=public --add-port=3000/tcp --permanentfirewall-cmd --reload

加入3000端口之后，页面就可以访问了

(4)注册账号

访问如下地址：

http://x.x.x.x:3000

会让你注册一个新的账号，那么通过使用邮箱和密码注册新的账号

使用新注册的账号登录

 登录之后的内容如下：

 那么到这里就可以使用了。

欢迎关注「技术分享交流」公众号 ，如果有建议或者疑问的话，欢迎大家评论留言，如果喜欢公众号文章的话可以点【在看】，您的鼓励就是我的动力哈！！！

查看原文：《Centos安装ConvertX文件转换》