3X-UI 部署配置指南（含Docker版）

3X-UI 部署与配置教程

Linux 服务器可视化面板搭建全流程（含Docker版）

STEP 01 前期环境准备

请确保你拥有一台 Linux 服务器（推荐 Ubuntu 20.04+ 或 Debian 11+），并使用 SSH 工具以 root 身份连接。

连接后，请先执行以下命令更新系统并安装必要组件：

apt update -y && apt upgrade -y && apt install curl -y

STEP 02-A 传统一键脚本安装

如果你习惯直接安装在宿主机上，可以复制下方的官方一键脚本，在终端中粘贴并回车执行：

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

安装过程中会询问是否自定义端口。建议输入 y 并设置一个非默认端口（如 12345）以提升安全性。

STEP 02-B Docker 容器化安装

如果你更喜欢干净、隔离的 Docker 环境，可以使用以下命令直接拉取并运行镜像（映射了默认的 2053 管理端口）：

docker pull catvb/app:3xui
docker run -d --name 3x-ui --net=host -v /etc/localtime:/etc/localtime:ro catvb/app:3xui

            提示：使用了 `--net=host` 模式，意味着容器直接使用宿主机的网络。如果你在云服务器上部署，记得去后台安全组放行 2053 端口（或者你在面板内自定义的其他节点端口）。
        

STEP 03 放行防火墙端口

如果无法访问面板，通常是因为端口被拦截。假设你的面板端口是 2053（Docker版默认）或 54321（脚本版常见），请执行：

sudo ufw allow 2053/tcp

            重要：如果你使用的是阿里云、腾讯云等云服务器，必须前往网页后台的“安全组”规则中，手动放行该 TCP 端口。
        

STEP 04 登录与节点创建

在浏览器输入 http://你的服务器IP:端口进入后台。默认账号密码通常为 admin/admin。登录后按以下步骤操作：

TIPS 开启 BBR 加速

为了提升网络传输速度，建议在 SSH 中执行以下命令开启 BBR 拥塞控制算法：

echo "net.core.default_qdisc=fq" >> /etc/sysctl.conf
echo "net.ipv4.tcp_congestion_control=bbr" >> /etc/sysctl.conf
sysctl -p

仅供技术学习与交流 · 请遵守当地法律法规

3x-ui面板配置教程