type
status
date
slug
summary
tags
category
icon
password
菜单级别
Place
Verification
Owner
3X-UI 是一个开源的 Xray 面板,提供了强大的可视化管理界面,支持多协议、流量统计、用户管理等功能。本教程将详细介绍如何部署 3X-UI。
项目信息
3X-UI 是 X-UI 的增强版本,提供了更好的稳定性和更多功能。
GitHub:https://github.com/MHSanaei/3x-ui
功能特性
- ✅ 系统状态监控
- ✅ 支持多用户和多协议(VMESS、VLESS、Trojan、Shadowsocks、TUIC、Hysteria 等)
- ✅ 支持 XTLS 协议(Vision、REALITY)
- ✅ 流量统计和限制
- ✅ 可自定义 Xray 配置
- ✅ HTTPS 访问支持
- ✅ 一键申请 SSL 证书
- ✅ Telegram Bot 通知
- ✅ Web 终端
- ✅ 数据库备份和恢复
系统要求
- 操作系统:Linux(Ubuntu、Debian、CentOS、Fedora 等)
- 架构:x86_64 或 ARM64
- 内存:至少 512MB RAM
- 存储:至少 1GB 可用空间
一键安装
方法一:使用官方脚本
安装过程中会提示:
- 选择安装或更新
- 设置面板端口(默认 2053)
- 设置管理员用户名和密码
- 设置面板访问路径(可选)
安全提示
建议修改默认端口,设置强密码,并配置自定义访问路径以提高安全性。
Docker 部署
使用 Docker CLI
使用 Docker Compose
创建
docker-compose.yml:启动服务:
初始配置
1. 访问管理面板
通过浏览器访问:`http://服务器IP:2053`
默认账号:
- 👤 用户名:
admin
- 🔑 密码:
admin
重要
首次登录后,立即在「面板设置」中修改用户名和密码!
2. 配置面板设置
在「面板设置」中配置:
- 面板端口:修改为非常用端口
- 面板路径:设置自定义访问路径(如
/secret-path/)
- 证书域名:配置域名用于 SSL
- 面板 URL:设置公网访问地址
3. 申请 SSL 证书
在「面板设置」→「证书管理」中:
- 选择「Acme 申请」
- 输入域名和邮箱
- 选择 DNS 或 HTTP 验证方式
- 点击申请
添加入站配置
1. 创建入站
在「入站列表」点击「+」添加:
基础设置:
- 备注:自定义名称
- 协议:选择协议(如 VLESS)
- 监听 IP:留空或填写
0.0.0.0
- 端口:设置端口号
传输设置:
- 网络类型:tcp / ws / grpc
- TLS:启用 TLS/XTLS
- 域名:填写您的域名
客户端设置:
- 点击「+」添加客户端
- 设置邮箱、UUID、流量限制等
2. REALITY 协议配置
REALITY 是新一代隐蔽协议,配置步骤:
- 协议选择:
VLESS
- 传输方式:
tcp
- 启用
REALITY
- 配置目标网站(如 `www.microsoft.com:443`)
- 生成密钥对
管理功能
流量统计
在「入站列表」可查看:
- 实时流量
- 总上传/下载量
- 客户端数量
- 在线状态
用户管理
为每个入站添加多个客户端:
- 设置流量限制
- 设置到期时间
- 启用/禁用客户端
- 重置流量统计
数据库备份
在「面板设置」→「备份与恢复」:
- 手动备份数据库
- 自动备份(定时任务)
- 导出/导入配置
Telegram Bot 配置
1. 创建 Bot
- 在 Telegram 搜索
@BotFather
- 发送
/newbot创建新 Bot
- 设置 Bot 名称
- 获取 Bot Token
2. 配置 Bot
在「面板设置」→「Telegram Bot」:
- 启用 Telegram Bot
- 填写 Bot Token
- 设置管理员 Chat ID
- 配置通知类型
获取 Chat ID:
- 向
@userinfobot发送消息
- 获取您的 Chat ID
升级 3X-UI
脚本升级
Docker 升级
常见问题
1. 无法访问面板
问题:浏览器无法打开管理界面
解决:
2. SSL 证书申请失败
问题:Acme 证书申请失败
解决:
- 确认域名 DNS 解析正确
- 检查 80/443 端口是否开放
- 尝试使用 DNS 验证方式
3. 客户端连接失败
问题:配置正确但无法连接
解决:
安全建议
1. 修改默认设置
- ✅ 更改默认端口
- ✅ 设置强密码
- ✅ 配置自定义访问路径
- ✅ 启用双因素认证(如果支持)
2. 定期备份
3. 监控日志
相关资源
- GitHub 项目:https://github.com/MHSanaei/3x-ui
总结
通过本教程,您已经学会了:
✅ 安装和部署 3X-UI 面板
✅ 配置入站和客户端
✅ 申请和配置 SSL 证书
✅ 设置 Telegram Bot 通知
✅ 管理用户和流量
✅ 处理常见问题
3X-UI 提供了强大而友好的 Xray 管理界面,让代理服务器的配置和维护变得简单高效。祝您使用愉快!🚀
- 作者:Orz
- 链接:https://blog.1567890.xyz/technology/3x-ui-deployment-guide
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。

