Lazy loaded image
3X-UI 面板部署完全指南:强大的 Xray 可视化管理工具
字数 1323阅读时长 4 分钟
2025-11-29
2025-11-30
type
status
date
slug
summary
tags
category
icon
password
菜单级别
Place
Verification
Owner
3X-UI 是一个开源的 Xray 面板,提供了强大的可视化管理界面,支持多协议、流量统计、用户管理等功能。本教程将详细介绍如何部署 3X-UI。
ℹ️
项目信息 3X-UI 是 X-UI 的增强版本,提供了更好的稳定性和更多功能。 GitHubhttps://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 可用空间

一键安装

方法一:使用官方脚本

安装过程中会提示:
  1. 选择安装或更新
  1. 设置面板端口(默认 2053)
  1. 设置管理员用户名和密码
  1. 设置面板访问路径(可选)
⚠️
安全提示 建议修改默认端口,设置强密码,并配置自定义访问路径以提高安全性。

Docker 部署

使用 Docker CLI

使用 Docker Compose

创建 docker-compose.yml
启动服务:

初始配置

1. 访问管理面板

通过浏览器访问:`http://服务器IP:2053`
默认账号
  • 👤 用户名:admin
  • 🔑 密码:admin
🔐
重要 首次登录后,立即在「面板设置」中修改用户名和密码!

2. 配置面板设置

在「面板设置」中配置:
  • 面板端口:修改为非常用端口
  • 面板路径:设置自定义访问路径(如 /secret-path/
  • 证书域名:配置域名用于 SSL
  • 面板 URL:设置公网访问地址

3. 申请 SSL 证书

在「面板设置」→「证书管理」中:
  1. 选择「Acme 申请」
  1. 输入域名和邮箱
  1. 选择 DNS 或 HTTP 验证方式
  1. 点击申请

添加入站配置

1. 创建入站

在「入站列表」点击「+」添加:
基础设置
  • 备注:自定义名称
  • 协议:选择协议(如 VLESS)
  • 监听 IP:留空或填写 0.0.0.0
  • 端口:设置端口号
传输设置
  • 网络类型:tcp / ws / grpc
  • TLS:启用 TLS/XTLS
  • 域名:填写您的域名
客户端设置
  • 点击「+」添加客户端
  • 设置邮箱、UUID、流量限制等

2. REALITY 协议配置

REALITY 是新一代隐蔽协议,配置步骤:
  1. 协议选择:VLESS
  1. 传输方式:tcp
  1. 启用 REALITY
  1. 配置目标网站(如 `www.microsoft.com:443`
  1. 生成密钥对

管理功能

流量统计

在「入站列表」可查看:
  • 实时流量
  • 总上传/下载量
  • 客户端数量
  • 在线状态

用户管理

为每个入站添加多个客户端:
  • 设置流量限制
  • 设置到期时间
  • 启用/禁用客户端
  • 重置流量统计

数据库备份

在「面板设置」→「备份与恢复」:
  • 手动备份数据库
  • 自动备份(定时任务)
  • 导出/导入配置

Telegram Bot 配置

1. 创建 Bot

  1. 在 Telegram 搜索 @BotFather
  1. 发送 /newbot 创建新 Bot
  1. 设置 Bot 名称
  1. 获取 Bot Token

2. 配置 Bot

在「面板设置」→「Telegram Bot」:
  • 启用 Telegram Bot
  • 填写 Bot Token
  • 设置管理员 Chat ID
  • 配置通知类型
获取 Chat ID:
  1. @userinfobot 发送消息
  1. 获取您的 Chat ID

升级 3X-UI

脚本升级

Docker 升级


常见问题

1. 无法访问面板

问题:浏览器无法打开管理界面
解决

2. SSL 证书申请失败

问题:Acme 证书申请失败
解决
  • 确认域名 DNS 解析正确
  • 检查 80/443 端口是否开放
  • 尝试使用 DNS 验证方式

3. 客户端连接失败

问题:配置正确但无法连接
解决

安全建议

1. 修改默认设置

  • ✅ 更改默认端口
  • ✅ 设置强密码
  • ✅ 配置自定义访问路径
  • ✅ 启用双因素认证(如果支持)

2. 定期备份

3. 监控日志


相关资源


总结

通过本教程,您已经学会了:
✅ 安装和部署 3X-UI 面板 ✅ 配置入站和客户端 ✅ 申请和配置 SSL 证书 ✅ 设置 Telegram Bot 通知 ✅ 管理用户和流量 ✅ 处理常见问题
3X-UI 提供了强大而友好的 Xray 管理界面,让代理服务器的配置和维护变得简单高效。祝您使用愉快!🚀
上一篇
哪吒探针(Nezha Monitor)部署完全指南
下一篇
Bitwarden Docker 部署与升级完全指南