Docker 一键搭建 3x-ui 面板（超详细翻墙教程，小白也能看懂）

一、教程简介

很多人觉得搭建科学上网环境很复杂，其实现在已经非常简单了。
本教程使用 Docker + 3x-ui 面板，只需要一条命令即可完成部署。

👉 优点：

• 一键安装，操作简单
• 可视化面板，方便管理
• 支持 VMESS / VLESS / Trojan 等协议

二、准备工作

在开始之前，你需要准备：

1️⃣ 一台服务器（VPS）

推荐：

• 系统：Ubuntu / Debian / CentOS
• 内存：≥ 1GB
• 已开放端口（建议 443 / 自定义端口）

2️⃣ 安装 Docker

如果还没安装 Docker，可以执行：

curl -fsSL https://get.docker.com | bash

启动 Docker：

systemctl enable docker
systemctl start docker

三、一键部署 3x-ui

直接执行你提供的命令👇

docker run -itd \
   -e XRAY_VMESS_AEAD_FORCED=false \
   -v /mnt/sda3/3xuidb/:/etc/x-ui/ \
   -v /root/ca/:/root/cert/ \
   --network=host \
   --restart=unless-stopped \
   --name 3x-ui \
   ghcr.io/mhsanaei/3x-ui:latest

四、命令详细解释（非常重要）

让你真正理解这条命令在干嘛👇

🔹 容器基础配置

• -itd
  后台运行容器
• --name 3x-ui
  给容器命名为 3x-ui
• --restart=unless-stopped
  开机自动启动

🔹 网络配置

• --network=host

👉 直接使用宿主机网络
优点：

• 性能最好
• 不需要额外端口映射

⚠️ 注意：
防火墙必须放行端口！

🔹 数据持久化（重点）

-v /mnt/sda3/3xuidb/:/etc/x-ui/

👉 面板数据库存储位置
👉 重启/删除容器不会丢数据

-v /root/ca/:/root/cert/

👉 存放 SSL 证书
👉 用于 HTTPS / TLS

🔹 环境变量

-e XRAY_VMESS_AEAD_FORCED=false

👉 关闭 VMESS 强制 AEAD
👉 提高兼容性（部分客户端需要）

五、访问面板

安装完成后，打开浏览器访问：

http://你的服务器IP:54321

默认信息：

• 用户名：admin
• 密码：admin

⚠️ 首次登录一定要修改密码！

六、创建节点（翻墙核心）

进入面板后：

1️⃣ 添加入站（Inbound）

选择协议：

• VMESS（推荐）
• VLESS（更先进）
• Trojan（更隐蔽）

2️⃣ 生成链接

创建后会得到：

• VMESS 链接
• 二维码

3️⃣ 导入客户端

推荐客户端：

• Windows：v2rayN
• Android：v2rayNG
• iOS：Shadowrocket

直接扫码即可使用 🚀

七、开启 HTTPS（可选但推荐）

如果你有域名：

1️⃣ 申请证书（Let’s Encrypt）
2️⃣ 放入：

/root/ca/

3️⃣ 在面板中启用 TLS

👉 优点：

• 更安全
• 更难被识别

八、常见问题

❓ 无法访问面板

检查：

docker ps

确认容器在运行

检查防火墙：

ufw allow 54321

❓ 连接不上节点

可能原因：

• 端口没开
• 配置错误
• 被墙（换端口/协议）

❓ 如何修改端口

进入面板直接修改即可
或重启容器

九、安全建议（必须看）

⚠️ 非常重要：

• 修改默认账号密码
• 不要用默认端口
• 建议开启 TLS
• 避免使用明显端口（如 10086）

十、总结

通过 Docker + 3x-ui：

👉 1 条命令
👉 3 分钟部署
👉 可视化管理

你就可以拥有一个完整的科学上网环境。