✰全新安装或升级3x-ui版本流程步骤✰

项目地址：https://github.com/xeefei/3x-ui

【3X-UI】中文交流群：https://t.me/XUI_CN

声明： 此项目仅供个人学习、交流使用，请遵守当地法律法规，勿用于非法用途；请勿用于生产环境；

注意： 在使用此项目和〔教程〕过程中，若因违反以上声明使用规则而产生的一切后果由使用者自负。

✰〔3X-UI优化版〕跟原版3X-UI的区别？✰

大部分功能基于原版3X-UI进行汉化优化，主要的优化内容如下：

1、最大限度地汉化了面板项目，更适合中文宝宝体质，包括：

①优化在VPS中进行〔脚本安装过程〕的汉化提示，增加相应的安装中文提示，让中文用户能明白清楚自己安装到了哪个环节？在细节方面，增加了安装成功之后的〔用户设置信息〕提示，在脚本中加入〔面板登录地址〕显示，

②管理后台进行了相应的〔图标和按钮〕汉化，让中文宝宝能够看得懂，

③安装成功后〔自动更改〕后台管理界面和电报机器人界面默认为〔中文〕，

④在管理后台中〔设置证书处〕，增加了acme方式填入路径的提示；

2、优化了电报机器人响应〔按钮〕的名称和排序；

3、创建了〔3X-UI〕中文交流群，各位中文宝宝可以一起讨论交流；

4、管理后台中增加了〔实用导航〕页面，里面包含实用内容；

5、优化了后台〔二维码〕显示模式，点击打开会更加丝滑美观；

6、在创建reality协议时，更改uTLS指纹默认使用chrome；

7、更新README内容添加备份&恢复操作说明，以及更多其他图文介绍；

8、管理后台中增加〔端口检测〕和〔网络测速〕，点击可以跳转直达；

9、增加了详细的项目〔安装配置教程〕，解决小白用户不懂配置的烦恼。

✰如何从其他x-ui版本迁移到〔3X-UI优化版〕？✰

1、若你用的是伊朗老哥的原版3X-UI，是可以直接〔覆盖安装〕的，因为〔3X-UI优化版〕是fork了原版3X-UI的项目，基于原有的功能进行优化的，大功能是没有变化的，主要是进行了脚本的〔汉化处理〕，其他诸如数据库文件等位置是没有改变的，所以直接覆盖安装，并不会影响你〔原有节点及配置〕等数据；安装命令如下：

bash <(curl -Ls https://raw.githubusercontent.com/xeefei/3x-ui/master/install.sh)

2、若你之前用的是Docker方式安装，那先进入容器里面/命令：docker exec -it 容器id /bin/sh，再执行以上脚本命令直接【覆盖安装】即可，

3、若你用的是之前F佬的x-ui或者其他分支版本，那直接覆盖安装的话，并不能确保一定就能够兼容？建议你先去备份〔数据库〕配置文件，再进行安装〔3X-UI优化版〕。

✰以下为详细安装流程步骤✰

一、购买一台性能还不错的VPS，可通过本页底部链接购买，

PS：若你不想升级系统，则可以跳过此步骤。

1、若你需要更新/升级系统，Debian系统可用如下命令：

apt update
apt upgrade -y
apt dist-upgrade -y
apt autoclean
apt autoremove -y

2、查看系统当前版本：

cat /etc/debian_version

3、查看内核版本：

uname -r

4、列出所有内核：

dpkg --list | grep linux-image

5、更新完成后执行重新引导：

update-grub

6、完成以上步骤之后输入reboot重启系统。

二、全新安装或升级现有3x-ui版本，

1、【全新安装】请执行以下脚本：

bash <(curl -Ls https://raw.githubusercontent.com/xeefei/3x-ui/master/install.sh)

2、如果执行了上面的代码但是报错，证明你的系统里面没有curl这个软件，请执行以下命令先安装curl软件，安装curl之后再去执行上面代码，

apt update -y&&apt install -y curl&&apt install -y socat

3、若要对版本进行升级，可直接通过脚本选择【2】—–>【更新面板】，

PS：若要安装指定的版本，请将该版本添加到安装命令的末尾。 e.g., ver v2.3.9:

bash <(curl -Ls https://raw.githubusercontent.com/xeefei/3x-ui/master/install.sh) v2.3.9

• 若要对版本进行升级，可直接通过脚本选择【2】，如下图：  
• 在到这一步必须要注意：要保留旧设置的话，需要输入【n】 

三、如果你的VPS是默认安装了防火墙的，那么就要进入3x-ui脚本放行端口，搭建之后端口默认是关闭的，安装/创建入站完成之后请放行【指定端口】，一定要放行端口之后再去导入软件测试，

1、放行【面板登录端口】，

2、放行出入站管理协议端口，

3、如果要申请安装证书并每3个月【自动续签】证书，请确保80和443端口是放行打开的，

4、可通过此脚本的第【22】选项去安装防火墙进行管理，如下图： 

5、若要一次性放行多个端口或一整个段的端口，用英文逗号隔开。

PS：若你的VPS没有防火墙，则所有端口都是能够ping通的，可自行选择是否进入脚本安装防火墙保证安全，但安装了防火墙必须放行相应端口。

四、若需要开启https方式用域名登录访问管理面板，以及后期想要实现【偷自己】的功能，则需要安装证书；如果不需要以上功能或无域名，可以跳过这步，

1、把自己的域名托管到CF，并解析到自己VPS的IP，不要开启【小云朵】，

2、如果要申请安装证书并每3个月【自动续签】证书，请确保80和443端口是放行打开的，

3、输入x-ui命令进入面板管理脚本，通过选择第【18】选项去进行安装，

4、记录好已经安装证书的【路径】，位置在：/root/.acme.sh/（域名）_ecc，后续需要用到，

5、进入后台【面板设置】—–>【常规】中，去分别填入刚才已经记录的证书公钥、私钥路径，

6、点击左上角的【保存】和【重启面板】，即可用自己域名进行登录管理；也可按照后续方法实现【自己偷自己】。

五、登录面板进行【常规】设置，特别是如果在安装过程中，全部都是默认【回车键】安装的话，用户名/密码/访问路径是随机的，而面板监听端口默认是2053，最好进入面板更改，

PS：若你在正确完成了上述步骤之后，你没有安装证书的情况下，去用IP+端口号/路径的方式却不能访问面板，那请检查一下是不是你的浏览器自动默认开启了https模式，需要手动调整一下改成http方式，把“s”去掉，即可访问成功。

六、创建【入站协议】和添加【客户端】，并测试上网，

✰备份与恢复/迁移数据库流程（以Debian系统为例）✰

✰如何保护自己的IP不被墙被封？✰

1、使用的代理协议要安全，加密是必备，推荐使用vless+reality+vision协议组合，

2、因为有时节点会共享，在不同的地区，多个省份之间不要共同连接同一个IP，

3、连接同一个IP就算了，不要同一个端口，不要同IP+同端口到处漫游，要分开，

4、同一台VPS，不要在一天内一直大流量去下载东西使用，不要流量过高要切换，

5、创建【入站协议】的时候，尽量用【高位端口】，比如40000–65000之间的端口号。

提醒：为什么在特殊时期，比如：两会，春节等被封得最严重最惨？

尼玛同一个IP+同一个端口号，多个省份去漫游，跟开飞机场一样！不封你，封谁的IP和端口？

总结：不要多终端/多省份/多个朋友/共同使用同一个IP和端口号！使用3x-ui多创建几个【入站】，

多做几条备用，各用各的！各行其道才比较安全！GFW的思维模式是干掉机场，机场的特征个人用户不要去沾染，自然IP就保护好了。

✰安装完成后如何设置调整成【中文界面】？✰

方法一：通过管理后台【登录页面】调整，登录时可以选择，如下图： 

方法二：通过在管理后台–>【面板设置】中去选择设置，如下图： 

【TG机器人】设置中文：通过在管理后台–>【面板设置】–>【机器人配置】中去选择设置，并建议打开数据库备份和登录通知，如下图： 

✰用3x-ui如何实现【自己偷自己】？✰

• 其实很简单，只要你为面板设置了证书，
• 开启了HTTPS登录，就可以将3x-ui自身作为Web Server，
• 无需Nginx等，这里给一个示例：
• 其中目标网站（Dest）请填写面板监听端口，
• 可选域名（SNI）填写面板登录域名，
• 如果您使用其他web server（如nginx）等，
• 将目标网站改为对应监听端口也可。
• 需要说明的是，如果您处于白名单地区，自己“偷”自己并不适合你；
• 其次，可选域名一项实际上可以填写任意SNI，只要客户端保持一致即可，不过并不推荐这样做。
• 配置方法如下图所示： 

✰〔子域名〕被墙针对特征✰

网络表现：

1、可以Ping通域名和IP地址，

2、子域名无法打开3X-UI管理界面，

3、什么都正常就是不能上网；

问题：

你的子域名被墙针对了：无法上网！

解决方案：

1、更换为新的子域名，

2、解析新的子域名到VPS的IP，

3、重新去安装新证书，

4、重启3X-UI和服务器，

5、重新去获取链接并测试上网。

PS：若通过以上步骤还是不能正常上网，则重装VPS服务器OS系统，以及3X-UI面板全部重新安装，之后就正常了！

✰在自己的VPS服务器部署【订阅转换】功能✰

如何把vless/vmess等协议转换成Clash/Surge等软件支持的格式？

要使用 ACME 管理 SSL 证书：

1. 确保您的域名已正确解析到服务器，

2. 输入“x-ui”命令并选择“SSL 证书管理”，

3. 您将看到以下选项：

   • 获取证书 —-获取SSL证书
   • 吊销证书 —-吊销现有的SSL证书
   • 续签证书 —-强制续签SSL证书
   • 显示所有证书 —-显示服务器中所有能用的证书
   • 设置面板证书路径 —-指定面板要使用的证书

安装和使用 Certbot：

apt-get install certbot -y
certbot certonly --standalone --agree-tos --register-unsafely-without-email -d yourdomain.com
certbot renew --dry-run

管理脚本具有用于 Cloudflare 的内置 SSL 证书应用程序。若要使用此脚本申请证书，需要满足以下条件：

• Cloudflare 邮箱地址
• Cloudflare Global API Key
• 域名已通过 cloudflare 解析到当前服务器

如何获取 Cloudflare全局API密钥:

1. 在终端中输入“x-ui”命令，然后选择“CF SSL 证书”。
2. 访问链接: Cloudflare API Tokens.
3. 点击“查看全局 API 密钥”（如下图所示）： 
4. 您可能需要重新验证您的帐户。之后，将显示 API 密钥（请参见下面的屏幕截图）： 

使用时，只需输入您的“域名”、“电子邮件”和“API KEY”即可。示意图如下： 

1. 若要将最新版本的压缩包直接下载到服务器，请运行以下命令：

ARCH=$(uname -m)
case "${ARCH}" in
  x86_64 | x64 | amd64) XUI_ARCH="amd64" ;;
  i*86 | x86) XUI_ARCH="386" ;;
  armv8* | armv8 | arm64 | aarch64) XUI_ARCH="arm64" ;;
  armv7* | armv7) XUI_ARCH="armv7" ;;
  armv6* | armv6) XUI_ARCH="armv6" ;;
  armv5* | armv5) XUI_ARCH="armv5" ;;
  s390x) echo 's390x' ;;
  *) XUI_ARCH="amd64" ;;
esac


wget https://github.com/xeefei/3x-ui/releases/latest/download/x-ui-linux-${XUI_ARCH}.tar.gz

2. 下载压缩包后，执行以下命令安装或升级 x-ui：

ARCH=$(uname -m)
case "${ARCH}" in
  x86_64 | x64 | amd64) XUI_ARCH="amd64" ;;
  i*86 | x86) XUI_ARCH="386" ;;
  armv8* | armv8 | arm64 | aarch64) XUI_ARCH="arm64" ;;
  armv7* | armv7) XUI_ARCH="armv7" ;;
  armv6* | armv6) XUI_ARCH="armv6" ;;
  armv5* | armv5) XUI_ARCH="armv5" ;;
  s390x) echo 's390x' ;;
  *) XUI_ARCH="amd64" ;;
esac

cd /root/
rm -rf x-ui/ /usr/local/x-ui/ /usr/bin/x-ui
tar zxvf x-ui-linux-${XUI_ARCH}.tar.gz
chmod +x x-ui/x-ui x-ui/bin/xray-linux-* x-ui/x-ui.sh
cp x-ui/x-ui.sh /usr/bin/x-ui
cp -f x-ui/x-ui.service /etc/systemd/system/
mv x-ui/ /usr/local/
systemctl daemon-reload
systemctl enable x-ui
systemctl restart x-ui

1. 安装Docker

   bash <(curl -sSL https://get.docker.com)

2. 克隆项目仓库

   git clone https://github.com/xeefei/3x-ui.git
   cd 3x-ui

3. 启动服务：

   docker compose up -d

   添加 --pull always 标志使 docker 在拉取更新的镜像时自动重新创建容器。有关更多信息，请参阅：https://docs.docker.com/reference/cli/docker/container/run/#pull

   或

   docker run -itd \
      -e XRAY_VMESS_AEAD_FORCED=false \
      -v $PWD/db/:/etc/x-ui/ \
      -v $PWD/cert/:/root/cert/ \
      --network=host \
      --restart=unless-stopped \
      --name 3x-ui \
      ghcr.io/xeefei/3x-ui:latest

4. 更新至最新版本

   cd 3x-ui
   docker compose down
   docker compose pull 3x-ui
   docker compose up -d

5. **从Docker中删除3x-ui **

   docker stop 3x-ui
   docker rm 3x-ui
   cd --
   rm -r 3x-ui

• Ubuntu 20.04+
• Debian 11+
• CentOS 8+
• OpenEuler 22.03+
• Fedora 36+
• Arch Linux
• Manjaro
• Armbian
• AlmaLinux 8.0+
• Rocky Linux 8+
• Oracle Linux 8+
• OpenSUSE Tubleweed
• Amazon Linux 2023

我们的平台提供与各种架构和设备的兼容性，确保在各种计算环境中的灵活性。以下是我们支持的关键架构：

• amd64: 这种流行的架构是个人计算机和服务器的标准，可以无缝地适应大多数现代操作系统。

• x86 / i386: 这种架构在台式机和笔记本电脑中被广泛采用，得到了众多操作系统和应用程序的广泛支持，包括但不限于 Windows、macOS 和 Linux 系统。

• armv8 / arm64 / aarch64: 这种架构专为智能手机和平板电脑等当代移动和嵌入式设备量身定制，以 Raspberry Pi 4、Raspberry Pi 3、Raspberry Pi Zero 2/Zero 2 W、Orange Pi 3 LTS 等设备为例。

• armv7 / arm / arm32: 作为较旧的移动和嵌入式设备的架构，它仍然广泛用于Orange Pi Zero LTS、Orange Pi PC Plus、Raspberry Pi 2等设备。

• armv6 / arm / arm32: 这种架构面向非常老旧的嵌入式设备，虽然不太普遍，但仍在使用中。Raspberry Pi 1、Raspberry Pi Zero/Zero W 等设备都依赖于这种架构。

• armv5 / arm / arm32: 它是一种主要与早期嵌入式系统相关的旧架构，目前不太常见，但仍可能出现在早期 Raspberry Pi 版本和一些旧智能手机等传统设备中。

• English（英语）
• Farsi（伊朗语）
• Simplified Chinese（简体中文）
• Traditional Chinese（繁体中文）
• Russian（俄语）
• Vietnamese（越南语）
• Spanish（西班牙语）
• Indonesian （印度尼西亚语）
• Ukrainian（乌克兰语）
• Turkish（土耳其语）
• Português (葡萄牙语)

• 系统状态查看与监控
• 可搜索所有入站和客户端信息
• 深色/浅色主题随意切换
• 支持多用户和多协议
• 支持多种协议，包括 VMess、VLESS、Trojan、Shadowsocks、Dokodemo-door、Socks、HTTP、wireguard
• 支持 XTLS 原生协议，包括 RPRX-Direct、Vision、REALITY
• 流量统计、流量限制、过期时间限制
• 可自定义的 Xray配置模板
• 支持HTTPS访问面板（自备域名+SSL证书）
• 支持一键式SSL证书申请和自动续签证书
• 更多高级配置项目请参考面板去进行设定
• 修复了 API 路由（用户设置将使用 API 创建）
• 支持通过面板中提供的不同项目更改配置。
• 支持从面板导出/导入数据库

• 端口
  • 2053
• 用户名 & 密码 & 访问路径
  • 当您跳过设置时，这些信息会随机生成，
  • 您也可以在安装的时候自定义访问路径。
• 数据库路径：
  • /etc/x-ui/x-ui.db
• Xray 配置路径：
  • /usr/local/x-ui/bin/config.json
• 面板链接（无SSL）：
  • http://ip:2053/访问路径/panel
• 面板链接（有SSL）：
  • https://你的域名:2053/访问路径/panel

对于版本 v2.1.0 及更高版本：

WARP 是内置的，无需额外安装；只需在面板中打开必要的配置即可。

如果要在 v2.1.0 之前使用 WARP 路由，请按照以下步骤操作：

1. 在 SOCKS Proxy Mode 模式中安装Wrap

• Account Type (free, plus, team): Choose the appropriate account type.
• Enable/Disable WireProxy: Toggle WireProxy on or off.
• Uninstall WARP: Remove the WARP application.

2. 如果您已经安装了 warp，您可以使用以下命令卸载：

warp u

3. 在面板中打开您需要的配置

配置:

• Block Ads
• Route Google, Netflix, Spotify, and OpenAI (ChatGPT) traffic to WARP
• Fix Google 403 error

注意： 使用 IP 隧道时，IP 限制无法正常工作。

• 对于 v1.6.1之前的版本 ：

  • IP 限制 已被集成在面板中。

• 对于 v1.7.0 以及更新的版本：

  • 要使 IP 限制正常工作，您需要按照以下步骤安装 fail2ban 及其所需的文件：

    1. 使用面板内置的 x-ui 指令
    2. 选择 IP Limit Management.
    3. 根据您的需要选择合适的选项。

  • 确保您的 Xray 配置上有 ./access.log 。在 v2.1.3 之后，我们有一个选项。

    "log": {
      "access": "./access.log",
      "dnsLog": false,
      "loglevel": "warning"
    },

  • 您需要在Xray配置中手动设置〔访问日志〕的路径。

Web 面板通过 Telegram Bot 支持每日流量、面板登录、数据库备份、系统状态、客户端信息等通知和功能。要使用机器人，您需要在面板中设置机器人相关参数，包括：

• 电报令牌
• 管理员聊天 ID
• 通知时间（cron 语法）
• 到期日期通知
• 流量上限通知
• 数据库备份
• CPU 负载通知

参考：

• 30 \* \* \* \* \* – 在每个点的 30 秒处通知
• 0 \*/10 \* \* \* \* – 每 10 分钟的第一秒通知
• @hourly – 每小时通知
• @daily – 每天通知 (00:00)
• @weekly – 每周通知
• @every 8h – 每8小时通知

• 定期报告
• 登录通知
• CPU 阈值通知
• 提前报告的过期时间和流量阈值
• 如果将客户的电报用户名添加到用户的配置中，则支持客户端报告菜单
• 支持使用UUID（VMESS/VLESS）或密码（TROJAN）搜索报文流量报告 – 匿名
• 基于菜单的机器人
• 通过电子邮件搜索客户端（仅限管理员）
• 检查所有入库
• 检查服务器状态
• 检查耗尽的用户
• 根据请求和定期报告接收备份
• 多语言机器人

• 与 Botfather 对话： 

• 使用 /newbot 创建新机器人：你需要提供机器人名称以及用户名，注意名称中末尾要包含“bot” 

• 启动您刚刚创建的机器人。可以在此处找到机器人的链接。 

• 输入您的面板并配置 Telegram 机器人设置，如下所示： 

在输入字段编号 3 中输入机器人令牌。 在输入字段编号 4 中输入用户 ID。具有此 id 的 Telegram 帐户将是机器人管理员。 （您可以输入多个，只需将它们用“ ，”分开即可）

• 如何获取TG ID? 使用 bot， 启动机器人，它会给你 Telegram 用户 ID。 

• /login 使用 POST 用户名称 & 密码： {username: '', password: ''} 登录
• /panel/api/inbounds 以下操作的基础：

• 使用clientId 项应该填写下列数据：

• client.id for VMESS and VLESS

• client.password for TROJAN

• client.email for Shadowsocks

• API 文档

• 

变量Type默认XUI_LOG_LEVEL"debug" | "info" | "warn" | "error""info"XUI_DEBUGbooleanfalseXUI_BIN_FOLDERstring"bin"XUI_DB_FOLDERstring"/etc/x-ui"XUI_LOG_FOLDERstring"/var/log"

例子：

XUI_BIN_FOLDER="bin" XUI_DB_FOLDER="/etc/x-ui" go build main.go