文章总结： 文档介绍了在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
会让你注册一个新的账号，那么通过使用邮箱和密码注册新的账号
使用新注册的账号登录
登录之后的内容如下：
那么到这里就可以使用了。
欢迎关注「技术分享交流」公众号 ，如果有建议或者疑问的话，欢迎大家评论留言，如果喜欢公众号文章的话可以点【在看】，您的鼓励就是我的动力哈！！！
免责声明：
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。
任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。
本文转载自：技术分享交流 TP微客《Centos安装ConvertX文件转换》