3x-ui 安装与使用教程
简介
3x-ui 是一个支持多协议多用户的 xray 面板，基于 x-ui 开发，旨在帮助您更便捷地管理您的 VPS 服务器。本教程将指导您如何在 Ubuntu 系统上安装和使用 3x-ui。
系统要求
- 推荐 CentOS 7+, Ubuntu 16+, Debian 8+
- 推荐使用 CDN 进行使用域名访问面板
- 推荐 VPS 可以接入互联网
- 防火墙放行面板相关端口
安装步骤
方法一：使用官方一键安装脚本
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)
方法二：手动安装 (使用已编译好的二进制文件)
- 首先，从 GitHub Releases 页面下载适合您系统的压缩包
- 上传到服务器并解压
- 进入解压后的目录，赋予
x-ui执行权限cd /root/x-ui/ chmod +x x-ui - 运行安装脚本
./x-ui
使用方法
常用命令
# 显示菜单 (管理面板)
x-ui
# 启动 x-ui 面板
x-ui start
# 停止 x-ui 面板
x-ui stop
# 重启 x-ui 面板
x-ui restart
# 查看 x-ui 状态
x-ui status
# 显示后台日志
x-ui log
# 更新 x-ui 面板
x-ui update
# 安装 bbr (加速)
x-ui bbr
# 修改面板设置
x-ui setting
# 重置面板用户名和密码
x-ui reset
# 重置面板设置和清除所有数据
x-ui uninstall
首次访问面板
- 安装完成后，通过浏览器访问面板：
http://你的服务器IP:54321 - 默认用户名和密码均为：
admin - 强烈建议：首次登录后立即修改默认端口和用户名密码
面板功能介绍
1. 系统状态
- 查看系统负载、内存使用、CPU使用等信息
- 查看 xray 的运行状态和配置
2. 入站列表
- 创建、编辑、删除入站规则
- 支持的协议包括：
- VLESS
- VMESS
- Trojan
- Shadowsocks
- Dokodemo-door
- Socks
- HTTP
3. 面板设置
- 修改用户名和密码
- 修改面板端口
- 选择面板主题
- 设置 HTTPS 证书
4. xray 设置
- 修改 xray 配置模板
- 指定 xray 配置路径
5. TLS 证书申请
面板支持通过 acme.sh 自动申请和更新 TLS 证书：
- 在【面板设置】中设置【面板证书申请】部分
- 输入您的域名和邮箱
- 确保已正确解析域名到服务器 IP
- 点击【申请证书】按钮
流量统计与限制功能
3x-ui 支持流量限制和到期时间设置：
-
在添加/编辑入站规则时，可以设置：
- 总流量限制 (GB)
- 有效期 (天)
- 客户端限制数量
-
当用户流量超过限制或时间到期后，系统将自动禁用该入站规则
备份与还原
面板提供备份和还原功能：
- 在【面板设置】-【面板备份】中可以：
- 创建数据库备份
- 下载备份文件
- 上传并导入备份文件
安全建议
- 修改默认端口 (54321)
- 使用强密码
- 开启面板访问路径 (例如：/您自定义的路径)
- 如可能，使用 HTTPS 访问面板
- 配置防火墙，只允许必要的端口访问
故障排除
面板无法访问
- 检查服务状态：
x-ui status - 检查端口是否被防火墙阻止：
ufw status或firewall-cmd --list-ports - 检查日志：
x-ui log
xray 无法连接
- 检查 xray 状态：
x-ui status - 查看 xray 日志：
cat /usr/local/x-ui/bin/access.log和cat /usr/local/x-ui/bin/error.log - 检查端口是否被占用：
netstat -tlpn | grep 端口号
高级功能
1. 自定义 xray 配置模板
面板允许修改 xray 配置模板，可在【xray设置】中修改。
2. 流量提醒功能
可以设置当流量达到一定阈值时发送通知。
3. 支持多用户与多协议
一个面板可以管理多个入站规则，每个规则可以使用不同的协议和设置。
更新面板
使用以下命令即可更新到最新版：
x-ui update
卸载面板
如果需要卸载，执行以下命令：
x-ui uninstall
注意事项
- 安装完成后，会自动设置开机自启
- 如更改端口，请同时在防火墙中放行新端口
- 如忘记用户名或密码，可使用
x-ui reset命令重置 - 程序默认安装目录为
/usr/local/x-ui - 配置文件目录为
/usr/local/x-ui/db/x-ui.db
如有问题，可以参考 GitHub 项目页面 或提交 issue。