前言
3X-UI 是目前最流行的开源代理管理面板之一,基于 Xray 核心,支持 VLESS、VMess、Trojan、Shadowsocks 等多种协议,提供美观的 Web 可视化界面,让代理节点的管理变得极为简单。本文将手把手带你完成 3X-UI 的安装与基础配置。
⚠️ 本教程仅供学习研究网络技术使用,请遵守当地法律法规,合法合规使用。
一、准备工作
1.1 服务器要求
操作系统:Ubuntu 20.04 / 22.04(推荐)、Debian 10/11、CentOS 7/8
内存:最低 512MB,推荐 1GB 以上
硬盘:最低 5GB 可用空间
权限:需要 root 权限
网络:需要境外 VPS(国内服务器无法正常使用)
1.2 SSH 连接服务器
使用 SSH 工具连接到你的 VPS:
PLAINTEXT
ssh root@你的服务器IP输入密码后登录,建议先更新系统:
PLAINTEXT
# Ubuntu/Debian
apt update && apt upgrade -y
# CentOS
yum update -y二、安装 3X-UI
2.1 一键安装脚本
3X-UI 提供了官方一键安装脚本,执行以下命令即可:
PLAINTEXT
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)如果 GitHub 访问受限,可以使用镜像地址:
PLAINTEXT
bash <(curl -Ls https://ghproxy.com/https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)2.2 安装过程说明
脚本执行后会自动完成以下操作:
检测系统环境
安装依赖(curl、wget、tar 等)
下载并安装 3X-UI 最新版本
安装 Xray 核心
配置系统服务(开机自启)
设置初始用户名、密码和端口
安装完成后,终端会显示如下信息:
PLAINTEXT
3x-ui v2.x.x 安装成功
面板访问地址: http://你的IP:2053/
用户名: admin
密码: admin
面板路径: /
⚠️ 请务必记录好面板地址、用户名和密码!
2.3 管理命令
安装完成后,可以使用 x-ui 命令管理面板:
PLAINTEXT
# 查看面板状态
x-ui status
# 启动面板
x-ui start
# 停止面板
x-ui stop
# 重启面板
x-ui restart
# 查看日志
x-ui log
# 进入管理菜单
x-ui三、开放防火墙端口
3X-UI 默认使用 2053 端口,需要在服务器防火墙中开放。
3.1 Ubuntu/Debian(UFW)
PLAINTEXT
# 开放面板端口
ufw allow 2053/tcp
# 开放常用代理端口(根据实际配置调整)
ufw allow 443/tcp
ufw allow 80/tcp
# 重载防火墙
ufw reload
# 查看状态
ufw status3.2 CentOS(Firewalld)
PLAINTEXT
firewall-cmd --zone=public --add-port=2053/tcp --permanent
firewall-cmd --zone=public --add-port=443/tcp --permanent
firewall-cmd --reload3.3 云服务器安全组
如果使用 AWS、阿里云、腾讯云等云服务器,还需要在控制台的安全组中添加入站规则,开放对应端口(TCP 2053、443、80 等)。
四、登录并配置面板
4.1 首次登录
在浏览器访问:
http://你的服务器IP:2053输入默认用户名
admin,密码admin登录后立即修改默认密码(安全第一!)
4.2 修改面板设置(强烈建议)
进入「面板设置」,建议修改以下内容:
修改用户名和密码:避免使用默认的 admin/admin
修改面板端口:将 2053 改为其他不常用端口
修改面板路径:添加随机路径(如
/mypath123),增加安全性开启 HTTPS:配置 SSL 证书后开启,防止流量被监听
五、添加第一个入站节点
5.1 创建 VLESS + Reality 节点(推荐)
VLESS + Reality 是目前最推荐的协议组合,伪装性强、性能好。
点击左侧菜单「入站列表」→「添加入站」
填写配置:
备注:随意填写,如
VLESS-Reality协议:选择
vless监听端口:填写
443(推荐,伪装成 HTTPS 流量)传输方式:选择
tcp安全:选择
realitySNI:填写一个真实存在的境外域名,如
www.microsoft.comFingerprint:选择
chrome
点击「生成」按钮自动生成 Public Key 和 Short ID
点击「添加」保存配置
5.2 创建 VMess + WebSocket 节点
适合配合 CDN(如 Cloudflare)使用:
协议:
vmess端口:
80或8080传输方式:
ws(WebSocket)路径:填写随机路径,如
/ws
六、获取客户端配置
6.1 扫码或复制链接
节点创建完成后,在入站列表中点击对应节点的「操作」→「二维码」或「复制链接」,即可获取客户端配置。
6.2 推荐客户端
平台 | 推荐客户端 |
|---|---|
Windows | v2rayN、Clash Verge |
macOS | ClashX Pro、V2rayU |
iOS | Shadowrocket、Quantumult X |
Android | v2rayNG、Clash for Android |
Linux | v2ray-core、Clash |
七、配置 SSL 证书(可选但推荐)
配置 SSL 证书可以让面板通过 HTTPS 访问,更加安全。
7.1 申请免费证书(需要域名)
PLAINTEXT
# 安装 acme.sh
curl https://get.acme.sh | sh
# 申请证书(将 your-domain.com 替换为你的域名)
~/.acme.sh/acme.sh --issue -d your-domain.com --standalone
# 安装证书
~/.acme.sh/acme.sh --install-cert -d your-domain.com --key-file /root/cert/private.key --fullchain-file /root/cert/cert.crt7.2 在面板中配置证书
进入「面板设置」→「证书文件路径」,填写:
公钥文件路径:
/root/cert/cert.crt密钥文件路径:
/root/cert/private.key
保存后重启面板,即可通过 https://你的域名:2053 访问。
八、安全加固建议
立即修改默认密码:admin/admin 是公开的默认值,必须修改
修改面板端口和路径:避免被扫描器发现
开启 IP 限制:只允许特定 IP 访问面板
定期更新:执行
x-ui update保持最新版本开启 HTTPS:配置 SSL 证书,防止密码被明文传输
定期备份:在「面板设置」中导出配置备份
九、常见问题
Q:安装后无法访问面板?
检查:① 防火墙是否开放了 2053 端口;② 云服务器安全组是否配置;③ 执行 x-ui status 确认服务正在运行。
Q:如何更新 3X-UI?
PLAINTEXT
x-ui updateQ:如何备份和恢复配置?
在面板「设置」页面可以导出/导入配置文件,也可以直接备份数据库文件:
PLAINTEXT
# 备份数据库
cp /etc/x-ui/x-ui.db /root/x-ui-backup.db
# 恢复数据库
cp /root/x-ui-backup.db /etc/x-ui/x-ui.db
x-ui restartQ:如何卸载 3X-UI?
PLAINTEXT
x-ui uninstallQ:节点连接不上怎么办?
排查步骤:① 确认端口已开放;② 检查节点配置是否正确;③ 查看 Xray 日志:x-ui log;④ 尝试更换协议或端口。
十、升级到最新版本
3X-UI 持续更新,建议定期升级:
PLAINTEXT
# 方式一:使用管理命令
x-ui update
# 方式二:重新运行安装脚本(会保留配置)
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)总结
3X-UI 凭借其简洁的界面、丰富的协议支持和活跃的社区,已经成为自建代理节点的首选管理面板。通过本教程,你已经完成了:
✅ 3X-UI 面板安装
✅ 防火墙端口配置
✅ 面板登录与安全设置
✅ 第一个代理节点创建
✅ SSL 证书配置
✅ 安全加固
如有问题,欢迎在评论区留言,或访问 3X-UI 官方 GitHub:github.com/mhsanaei/3x-ui
⚠️ 再次提醒:请遵守当地法律法规,合法合规使用网络工具。
