信息
3X-UI 是 X-Ray 服务器的图形化管理面板。它支持 Shadowsocks-2022、VLESS(含 XTLS)以及其他功能。它是原版 X-UI 的增强版,可以轻松安装在 Docker 中,并提供英文界面选项。3X-UI 具备所有必要的功能,并且与其他类似面板相比,它拥有更高的稳定性和可靠性。3X-UI 与其他 VPN 服务的主要区别在于其高级设置和更高的数据安全性。我们建议有使用非屏蔽网站协议经验的用户使用 3X-UI。
部署功能¶
| ID | 软件名称 | 兼容操作系统 | 虚拟机 | BM | 虚拟GPU | GPU | 最低 CPU 核心数 | 最小内存(GB) | 最小硬盘/固态硬盘容量(GB) | 积极的 |
|---|---|---|---|---|---|---|---|---|---|---|
| 26 | 3X-UI VPN服务器 | Ubuntu 22.04 | + | + | + | + | 1 | 1 | - | 命令 |
部署 3X-UI 后的入门指南¶
订单付款完成后,服务器已准备就绪的通知邮件将发送至您注册时提供的邮箱地址。邮件中包含VPS的IP地址以及连接所需的登录名和密码。我公司客户可通过服务器控制面板和API接口(Invapi)管理设备。
您也可以在此处找到凭据,凭据可以在服务器控制面板的“信息>>标签”选项卡中找到,也可以在发送给您的电子邮件中找到:
- 访问 3X-UI 网络面板的链接:在 webpanel标签。表单的确切链接
https://3x-ui{Server_ID_from_Invapi}.hostkey.in:port会在服务器移交时通过电子邮件发送; - 登录:
root; - 密码:软件部署完成后,服务器准备就绪后,密码将发送到您的电子邮件地址。
笔记
访问后https://{serverID}.hostkey.in会跳转到一个看似是 3X-UI 的页面,这是另一项服务。
建立新连接¶
笔记
在我们的示例中,我们将通过 VLESS 协议建立一个新的连接。
信息
VLESS 是一种全新的协议,它不包含加密机制,仅允许“自身/外部”校验和数据填充。VLESS 修复了旧版 VMess 协议的多个漏洞,并且该协议正在积极开发中。例如,计划添加对 Zstd 算法压缩的支持。在建立连接时,客户端和服务器会交换协议版本和支持的功能列表。这确保了后续开发中的向后兼容性。总而言之,VLESS 是目前最新、最具前瞻性的协议。
-
登录 3X-UI 面板后,转到“入站”选项卡,然后单击
添加入站按钮:
-
请在打开的菜单中填写以下字段:
- 备注- 使用协议类型(例如 VLESS)或客户端组类型命名连接。此名称将显示在传入连接列表中;
- 协议- 协议选择默认设置
vless为,但可以根据需要手动更改和配置; - 监听 IP 地址- 如果将此字段留空,服务器将监听所有 IP 地址;
- 端口- 指定端口443。
笔记
“总流量(GB)”和“到期日期”字段为可选字段。

-
选择窗口底部“安全”下的“REALITY”选项卡。

-
进入客户设置,并在“客户”部分填写必要的字段。
- 电子邮件- 客户端 ID,必须唯一。如果输入电子邮件地址,则每个协议的电子邮件地址也必须唯一。如果您已有用户,请保留现有用户,或点击创建新用户。
电子邮件字段旁边有(刷新)图标。如果有多个用户,请设置一个易于理解的标识符,例如“用户”user1_dave@yahoo.com。 - ID - 用于标识传入连接的唯一标识符。ID 必须为 32 个字符,且只能包含数字和拉丁字母小写字母。点击以下按钮即可自动生成 ID:
关键输入字段前的(刷新)图标。 - 流量- 该值设置为
xtls-rprx-vision。

- 电子邮件- 客户端 ID,必须唯一。如果输入电子邮件地址,则每个协议的电子邮件地址也必须唯一。如果您已有用户,请保留现有用户,或点击创建新用户。
-
导航至 REALITY 设置,然后
chrome在uTLS字段中进行选择,或从列表中选择其他选项。 -
在Dest和SNI字段中输入要屏蔽的域名。默认选项为
yahoo.com.注意力
请考虑从提供的选项中选择其他域名,并在相应的字段中替换默认域名:
- 目标地址:www.microsoft.com:443和 SNI:www.microsoft.com
- 目标地址:dl.google.com:443和 SNI:dl.google.com
-
在ShortIds中,单击图标
(刷新)此操作将生成一个随机 ID。 -
点击
获取新证书按下按钮即可生成私钥和公钥的新密钥。
-
输入数据后,点击
创造按钮。
如果配置正确,您将拥有一个包含该协议的条目。

其他协议的连接也可以用同样的方法配置。
Shadowsocks 协议设置示例

从PC连接到3X-UI¶
可以使用多种客户端连接到 3X-UI,例如v2rayN、Invisible Man XRay、v2rayU、Nekoray等。对于 macOS 设备,建议使用 FoXray 客户端或 Hiddify。
笔记
在本例中,我们将使用面向初学者的Hiddify客户端和面向高级用户的Nekoray客户端。
在 Windows、Linux 或 macOS 上使用 Hiddify 客户端¶
注意力
在本地设备上建立连接之前,需要先在 3X-UI 图形面板中配置新连接。本例中,我们将以 Windows 客户端为例进行说明。
要使用 Hiddify 客户端连接到 3X-UI,请按照以下步骤操作:
-
下载带有标签的 Hiddify 版本
Latest,并安装适用于您操作系统的软件包或文件。 -
在资源管理器中,导航到安装路径(通常为
C:\Program Files\hiddify),从右键菜单中选择“属性” ,然后在打开的窗口中HiddifyNext.exe单击“兼容性”选项卡。点击
更改所有用户的设置勾选此框以管理员身份运行此程序,然后单击好的。
-
打开 Hiddify 客户端并配置以下设置:
- 进入设置,选择区域 - 其他。

- 进入设置>>配置选项,设置服务模式 - VPN(实验性)。

-
请按照以下步骤添加服务器数据:
-
使用 3X-UI 图形面板中的连接设置打开二维码:

-
将 3X-UI 图形面板中的二维码复制到剪贴板(只需点击即可);
-
导航至主页,然后选择以下任一方式建立与服务器的连接:
+ 新个人资料或者+图标位于右上角。 -
点击标有“从剪贴板添加”的面板:

数据添加成功后,将弹出一条消息,并将服务器配置文件添加到列表中:

-
要连接到 3X-UI,请按下大的圆形按钮。如果连接成功,图标将变为绿色并显示“已连接”。断开连接的方法相同,只需单击该按钮即可。

在 Windows 或 Linux 上使用 Nekoray 客户端¶
注意力
在本地设备上建立连接之前,需要先在 3X-UI 图形面板中配置新连接。本例中,我们将以 Windows 客户端为例进行说明。
要使用 Nekoray 客户端连接到 3X-UI,请按照以下步骤操作:
-
下载包含 Windows 程序的压缩包,或者下载并安装 Linux 软件包。
要在 Windows 上使用 Nekoray,请将
nekoray压缩包中的文件夹解压到磁盘上,然后nekoray.exe从该文件夹内运行。 -
首次启动客户端时,请指定内核。您可以在已安装的客户端中通过转到“首选项”>> “基本设置” >> “核心”
sing-box来更改内核。 -
添加服务器数据。具体操作如下:
-
使用 3X-UI 图形面板中的连接设置打开二维码:

-
不要最小化包含二维码的浏览器窗口,在 Nekoray 中转到“程序”菜单,然后选择“扫描二维码”:

或者
-
将 3X-UI 图形面板中的二维码复制到剪贴板(只需点击即可);
-
在 Nekoray 客户端中,选择“程序” >> “从剪贴板添加配置文件”。
-
-
勾选调谐模式旁边的复选框;
-
右键单击其名称并选择“开始”来启动连接:

安卓移动设备¶
使用 Hiddify 连接¶
注意力
要建立本地设备上的连接,首先在 3X-UI GUI 面板中配置新连接。
要使用 Hiddify 连接到 3X-UI,请按照以下步骤操作:
-
从Google Play下载并安装 FoXray Hiddify ,或者从开发者的网站下载适合您架构的 APK 文件。
-
要完成预设,请打开 Hiddify 应用:
- 转到菜单项“设置”
(汉堡)图标并选择“区域”-“其他”; - 在菜单中
(Burger),进入设置>>配置选项。然后,将服务模式设置为 VPN。

- 转到菜单项“设置”
-
请按照以下步骤添加服务器数据:
-
在服务器端的 3X-UI 图形面板中,使用连接设置打开二维码:

-
要在 Hiddify 应用中添加服务器连接,请导航至主屏幕并单击以下任一选项:
+ 新个人资料按钮或+点击右上角的图标。然后,选择“扫描二维码”并扫描二维码:
-
-
扫描成功后,屏幕上将显示一条消息,并将服务器配置文件添加到列表中。要连接到 3X-UI,请单击圆形大按钮。连接建立后,图标将变为绿色并显示“已连接”。要断开连接,只需再次单击该按钮即可。
-
要为特定应用程序启用代理模式,请转到
(Burger)>>设置,然后打开“应用级代理”开关。接下来,勾选应用旁边的代理模式复选框,选择需要代理的应用。
使用 v2rayNG 连接¶
注意力
要建立本地设备上的连接,首先在 3X-UI GUI 面板中配置新连接。
要使用 v2rayNG 连接到 3X-UI,请按照以下步骤操作:
-
从Google Play下载并安装 v2rayNG 。
-
打开 v2rayNG 应用程序并点击
(加号)按钮:

- 在菜单中,选择“从二维码导入配置文件”选项,然后在 3X-UI 图形面板中扫描二维码:

您需要使用 3X-UI 图形面板中的连接设置扫描二维码:

- 激活连接。

iOS移动设备¶
注意力
要建立本地设备上的连接,首先在 3X-UI GUI 面板中配置新连接。
在本示例中,我们将使用 FoXray 客户端。您也可以使用 v2box 或 Shadowrocket 客户端。要使用 FoXray 连接到 3X-UI,请按照以下步骤操作:
- 从App Store下载并安装 FoXray 。

- 打开 FoXray 应用程序并点击
(加号)按钮(允许您手动添加配置)或扫描 3X-UI 图形面板中的二维码:

- 点击
玩点击按钮,允许应用将 VPN 配置添加到设备:

更新 3X-UI¶
要将控制面板更新到最新版本,请通过 SSH 或HTML5 控制台连接到您的服务器并输入root密码:
ssh root@<server_IP_address>
然后运行以下命令:
cd 3x-ui
docker compose down
docker compose pull 3x-ui
docker compose up -d
重置 3X-UI 的用户名和密码¶
要重置网页控制面板的用户名和密码,请使用以下方法:
-
以root用户身份通过SSH登录服务器,并安装必要的软件包:
apt update apt install sqlite3 python3 python3-pip pip install bcrypt -
生成新的密码哈希值:
python3 -c "import bcrypt; print(bcrypt.hashpw(b'new_password', bcrypt.gensalt(rounds=10)).decode())"注意力
密码只能使用拉丁字母、数字和特殊字符设置。
复制输出结果(例如
$2b$10$ld5ru8ozYTOUX51uvwwXNuoue/G7l3Jp4irSXZuWO3IejUvBvReIW) -
将密码添加到 x-ui 数据库。为此,请运行:
sqlite3 /data/3x-ui/db/x-ui.db然后通过输入命令来更改用户名和密码。
sqlite>UPDATE users SET username = 'root', password = 'hash_generated_earlier' WHERE id = 1;然后输入
.quit或按Ctrl+D退出 sqlite3 控制台。
3X-UI 主要特性¶
- 流量加密:VLESS、Shadowsocks-2022 和 XRay (XTLS) 允许加密用户的流量,使互联网服务提供商或其他第三方无法读取或监控流量。
- 多因素身份验证:支持多因素身份验证可增强安全性并保护用户数据免受未经授权的访问。
- 灵活设置:可配置连接的参数,例如加密类型、端口和协议。这为连接设置提供了灵活性,也使使用更加便捷。
- 速度优化:优化网络连接速度。它们可以使用多种技术,例如 TCP 快速打开和拥塞控制,以加快数据传输速度并提高连接质量。
- 支持多种操作系统:Windows、MacOS、Linux、Android 和 iOS。这确保了产品在任何平台上的通用性和易用性。
- 开源:它为开发者提供了研究代码并进行自己修改的机会,这有助于改进产品及其功能。
- 可靠性和稳定性:VLESS、Shadowsocks-2022 和 XRay (XTLS) 都是可靠稳定的协议。它们提供高速稳定的连接,并能保护用户数据。
部署功能¶
- 在类似 RHEL 的操作系统中,VLESS 和 Shadowsocks-2022 协议默认只在 443 端口上开放。
- 安装时间为 15-20 分钟,包括操作系统。
- 在 hostkey.in 区域中以容器化方式安装 3X-UI + SSL。
- 已安装软件:
- Docker CE
- Docker Compose。
- Xray Panel - Telegram 上的开发者小组频道。
- 构建MHSanaei/3x-ui。
- 使用的容器:
ghcr.io/mhsanaei/3x-uijonasal/nginx-certbot:latest
- 前往
compose:/root/3x-ui。 - 挂载目录的路由:
/data. -
要自定义安装,您需要进行更改,
/root/3x-ui/compose.yml然后通过以下命令重启 Compose:-
要停止容器,请运行以下命令:
docker compose -f /root/3x-ui/compose.yml down -
要启用容器,您需要运行以下命令:
docker compose -f /root/3x-ui/compose.yml -d up
-

