3X-UI 图形面板¶
在这篇文章中
Information
3X-UI 是 X-Ray 服务器的图形面板。它支持 Shadowsocks-2022、带有 XTLS 的 VLESS 以及其他功能。它是原始 X-UI 的增强版分支,可以轻松安装在 Docker 中,并提供英文界面选项。3X-UI 具备所有必要的功能,与其他类似面板相比,它具有更高的稳定性和可靠性。3X-UI 与其他 VPN 服务的关键区别在于高级设置和增强的数据安全。我们建议有使用抗封锁协议经验的用户使用 3X-UI。
部署要求¶
| ID | 软件名称 | 兼容操作系统 | 虚拟机 | 物理机 | vGPU | GPU | 最低CPU(核) | 最低内存(GB) | 最低硬盘(GB) | 自定义域名 | 是否启用 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 26 | 3X-UI VPN-server | Ubuntu 22.04 | + | + | + | + | 1 | 1 | 50 | 否 | 订购 |
部署 3X-UI 后的入门指南¶
支付订单后,服务器准备就绪的通知将发送到注册时指定的电子邮件地址。其中将包含 VPS 的 IP 地址以及连接所需的登录名和密码。我司客户通过 服务器控制面板和 API - Invapi 管理设备。
您还可以在此处找到凭据,这些凭据可以在服务器控制面板的 Configuration >> Tags 选项卡中找到,也可以在发送给您的电子邮件中找到:
- 访问 3X-UI 网页面板的链接:位于 webpanel 标签中。确切链接格式为
https://3x-ui{Server_ID_from_Invapi}.hostkey.in:port,会在服务器交付时通过电子邮件发送; - 登录名:
root; - 密码:在软件部署完成且服务器准备就绪后,将发送到您的电子邮件地址。
备注
访问 https://{serverID}.hostkey.in 将带您进入一个看似 3X-UI 的页面,实际上是另一项服务。
设置新连接¶
备注
在我们的示例中,我们将通过 VLESS 协议设置新连接。
Information
VLESS 是一种新协议,不包含加密机制,仅允许“自有/外部”检查和数据填充。VLESS 修复了旧 VMess 协议的几个漏洞,并且该协议正在积极开发中。例如,计划添加对 Zstd 算法压缩的支持。在建立连接时,客户端和服务器交换协议版本和支持的功能列表。这确保了后续开发过程中的向后兼容性。总体而言,VLESS 是目前最新且最先进的协议。
-
登录 3X-UI 面板后,转到 Inbounds 选项卡并点击
Add Inbound按钮:
-
在打开的菜单中填写以下字段:
- Remark - 使用协议类型(例如 VLESS)或客户端组类型命名连接。此名称将显示在入站连接列表中;
- Protocol - 协议选择默认设置为
vless,但可以根据需要手动更改和配置; - Listen IP - 如果留空此字段,服务器将监听所有 IP 地址;
- Port - 指定端口 443。
备注
Total Flow (GB) 和 Expire Date 字段是可选的。

-
您需要选择 Stream 选项卡,并在 Security 字段中选择 reality 参数。

-
接下来,进行客户端设置。展开 Protocol 部分并填写所需字段:
- Email - 指定唯一的客户端 ID。您可以输入电子邮件地址,但它对于每个协议也必须是唯一的。如果您只有一个用户,请保留自动生成的 ID 或通过点击电子邮件输入字段旁边的
(刷新) 图标创建新 ID。如果您有多个用户,请分配一个可读的标识符,例如[email protected]。 - ID - 这是入站连接的唯一标识符。ID 必须由 32 个字符组成,且只能包含数字和小写拉丁字母。可以通过点击密钥输入字段旁边的
(刷新) 图标自动生成。 - Flow - 将值设置为
xtls-rprx-vision。

- Email - 指定唯一的客户端 ID。您可以输入电子邮件地址,但它对于每个协议也必须是唯一的。如果您只有一个用户,请保留自动生成的 ID 或通过点击电子邮件输入字段旁边的
-
进行 Stream 设置。在 uTLS 字段中,建议选择
chrome,但您可以从提供的列表中选择任何其他值。 -
在 Target 和 SNI 字段(v.2.1.0 之前界面中的 Server names)中,输入用于伪装的域名(或保留默认的
yahoo.com)。警告
建议选择与默认值不同的域名。从建议的选项中选择一个,并在相应字段中替换默认值:
- Dest: www.microsoft.com:443 和 SNI: www.microsoft.com
- Dest: dl.google.com:443 和 SNI: dl.google.com
-
在 Short IDs 中,点击
(刷新) 图标。此操作将生成一个随机 ID。 -
点击
Get New Cert按钮以生成 Private Key 和 Public Key 的新密钥。
-
输入数据后,点击
Create按钮。
如果配置正确,您将拥有一个带有协议的条目。

其他协议的连接可以以相同的方式配置。
Shadowsocks 协议设置示例

从 PC 连接到 3X-UI¶
可以使用各种客户端连接到 3X-UI:v2rayN、Invisible Man XRay、v2rayU、Nekoray 等。对于 macOS 设备,建议使用 Hiddify。
在 Windows、Linux 或 macOS 上使用 Hiddify 客户端¶
警告
在本地设备上设置连接之前,需要在 3X-UI 图形面板中配置新连接。在本示例中,我们考察的是 Windows 客户端。
要使用 Hiddify 客户端连接到 3X-UI,请按照以下步骤操作:
-
下载 带有
Latest标签的 Hiddify 版本,并安装适用于您操作系统的包或文件。 -
在资源管理器中,导航到安装路径(通常为
C:\Program Files\hiddify),从HiddifyNext.exe文件的右键菜单中选择 Properties,然后在打开的窗口中点击 Compatibility 选项卡。点击
Change settings for all users,勾选 Run this program as administrator 复选框,然后点击OK。
-
打开 Hiddify 客户端并配置以下设置:
- 转到 Settings 并选择 Region - Other。

- 转到 Settings >> Config Options 并设置 Service Mode - VPN (Experimental)。

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

-
从 3X-UI 图形面板复制带有连接名称的二维码到剪贴板(单击一次即可);

-
导航到 Home 页面,通过选择
+ New Profile或位于右上角的+图标来建立与服务器的连接。 -
点击标有 Add From Clipboard 的面板:

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

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

在 Windows 或 Linux 上使用 Nekoray 客户端¶
警告
在本地设备上设置连接之前,需要在 3X-UI 图形面板中配置新连接。在本示例中,我们考察的是 Windows 客户端。
要使用 Nekoray 客户端连接到 3X-UI,请按照以下步骤操作:
-
下载 包含 Windows 程序的存档,或在 Linux 上下载并安装包。
要在 Windows 上使用 Nekoray,从存档中提取
nekoray文件夹到您的磁盘,并从文件夹内运行nekoray.exe。 -
首次启动客户端时,指定内核 -
sing-box。您可以通过转到 Preference >> Basic settings >> Core 在已安装的客户端中更改内核。 -
添加服务器数据。为此:
-
在 3X-UI 图形面板中打开包含连接设置的二维码:


-
在不最小化带有二维码的浏览器窗口的情况下,转到 Nekoray 中的 Program 菜单并选择 Scan QR Code:

或
-
在 3X-UI 图形面板中复制二维码到剪贴板(只需点击它);
-
在 Nekoray 客户端中,选择 Program >> Add profile from clipboard。
-
-
勾选 Tun mode 旁边的复选框;
-
右键点击其名称并选择 Start 以启动连接:

Android 移动设备¶
使用 Hiddify 连接¶
警告
要在本地设备上设置连接,首先需要在 3X-UI GUI 面板中配置新连接。
要使用 Hiddify 连接到 3X-UI,请按照以下步骤操作:
-
从 Google Play 下载并安装 Hiddify,或从 开发者网站 下载适用于您架构的相应 APK。
-
要完成预设,打开 Hiddify 应用:
- 转到
(Menu) 图标下的菜单项 Settings 并选择 Region - Other; - 在菜单
(Menu) 中,转到 Settings >> Config Options。在那里,设置 Service Mode - VPN。

- 转到
-
按照以下步骤包含服务器数据:
-
在服务器的 3X-UI 图形面板中打开包含连接设置的二维码:


-
要在 Hiddify 应用中添加服务器连接,请导航到主屏幕并点击
+ New Profile按钮或位于右上角的+图标。接下来,选择 Scan QR Code 并扫描二维码:
-
-
成功完成扫描后,将显示消息,并且服务器配置文件将添加到列表中。要连接到 3X-UI,请点击大圆形按钮。建立连接后,图标将变为绿色并显示 Connected。要断开连接,只需再次点击按钮即可。
-
要为特定应用启用代理模式,请转到
(Menu) >> Settings 并打开 Per-app Proxy 开关。然后,通过勾选它们旁边的代理模式复选框来选择您想要的应用。
使用 v2rayNG 连接¶
警告
要在本地设备上设置连接,首先需要在 3X-UI GUI 面板中配置新连接。
要使用 v2rayNG 连接到 3X-UI,请按照以下步骤操作:
-
从 Google Play 下载并安装 v2rayNG。
-
打开 v2rayNG 应用并点击
(Plus) 按钮:

- 在菜单中,选择 Import profile from QR code 选项并扫描 3X-UI 图形面板中的二维码:

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


- 激活连接。

iOS 移动设备¶
警告
要在本地设备上设置连接,首先需要在 3X-UI GUI 面板中配置新连接。
在我们的示例中,我们将使用 Hiddify 客户端 (https://apps.apple.com/us/app/hiddify-proxy-vpn/id6596777532)。或者,您可以使用 v2box 或 Shadowrocket 客户端。要连接到 3X-UI,请遵循 与 Android 上类似的说明
更新 3X-UI¶
要将控制面板更新到最新版本,通过 SSH 或 Native Console 连接到您的服务器并输入 root 密码:
重置 3X-UI 的用户名和密码¶
要重置网页面板的用户名和密码,请使用以下算法:
-
以 root 身份通过 SSH 登录服务器并安装必要的包:
-
生成新的密码哈希:
python3 -c "import bcrypt; print(bcrypt.hashpw(b'new_password', bcrypt.gensalt(rounds=10)).decode())"警告
密码应仅使用拉丁字母、数字和特殊字符设置。
复制输出(例如
$2b$10$ld5ru8ozYTOUX51uvwwXNuoue/G7l3Jp4irSXZuWO3IejUvBvReIW) -
将密码添加到 x-ui 数据库。为此,运行:
然后在
sqlite>处输入命令更改用户名和密码然后通过输入
.quit或按 Ctrl+D 退出 sqlite3 控制台。
3X-UI 的关键功能¶
- 流量加密:VLESS、Shadowsocks-2022 和 XRay (XTLS) 允许加密用户流量,使互联网服务提供商或其他第三方无法读取或监控。
- 多因素认证:支持多因素认证增强了安全性,并保护用户数据免受未经授权的访问。
- 灵活设置:能够配置连接的参数,如加密类型、端口和协议。它提供了连接设置的灵活性和易用性。
- 速度优化:针对快速网络连接进行优化。它们可以使用各种技术,如 TCP Fast Open 和拥塞控制,以加速数据传输并提高连接质量。
- 支持各种操作系统: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:-
要停止容器,运行命令:
-
要启用容器,需要运行命令:
-
备注
除非另有说明,默认情况下我们从开发者网站或操作系统存储库安装软件的最新发布版本。