用 Docker 搭建 3x-ui 面板：从 0 开始的小白教程
前言：
暂时不想折腾，直接想科学上网？
点击：最简科学上网
3x-ui 是什么？
3x-ui 是一个基于 xray-core 的图形化代理面板。
你可以把它理解成：
- 一个网页版后台
- 用来管理 vmess / vless / trojan 等协议
- 不需要你手写复杂 json 配置
- 支持一键生成订阅、二维码、节点
相比老版本 x-ui：
- 功能更多
- 支持 歇斯底里2 等等更多协议
一、加SWAP（新手忽略）
注意：此步骤新手可直接跳过，直接进行第二步
若服务器内存 ≤ 1G 可添加 swap虚拟内存，一般为内存的 1-2 倍即可
设置 SWAP 可以用脚本:
wget -O box.sh https://raw.githubusercontent.com/BlueSkyXN/SKY-BOX/main/box.sh && chmod +x box.sh && clear && ./box.sh
填写18后，选择1，填写2048或者1024，然后回车
二、更新工具
2.1、切换到 root 用户
sudo -i
2.2、升级 packages
apt update -y
2.3、安装常用的工具
apt install wget curl sudo vim git -y
这些工具用于：
| 工具 | 作用 |
|---|---|
| wget | 下载文件 |
| curl | 网络请求 |
| vim | 文本编辑 |
| git | 下载项目 |
三、安装 Docker 环境(非大陆)
此步为非大陆vps安装docker的步骤，
大陆服务器的 三、四 步骤请划至最下面 1.7、补充
3.1、安装
curl -fsSL https://get.docker.com | bash
3.2、查看 docker 版本
docker -v
如果出现类似：
Docker version 22.xx
说明安装成功。
3.3、设置开机自动启动
systemctl enable docker
四、安装 Docker-compose（非大陆）
4.1、安装 compose 插件
apt install docker-compose-plugin -y
Docker Compose 用于 管理多个容器服务。
例如这些都可以通过一个配置文件统一启动。
Halo
MySQL
Redis
4.2、查看版本
docker compose version #查看 docker compose 版本
4.3、修改 Docker 配置（可选，新手忽略并跳过此步）
增加一段自定义内网 IPv6 地址，开启容器的 IPv6 功能，以及限制日志文件大小，防止 Docker 日志塞满硬盘
cat > /etc/docker/daemon.json <<EOF
{
"log-driver": "json-file",
"log-opts": {
"max-size": "20m",
"max-file": "3"
},
"ipv6": true,
"fixed-cidr-v6": "fd00:dead:beef:c0::/80",
"experimental":true,
"ip6tables":true
}
EOF
4.4、重启docker
systemctl restart docker
五、安装项目（3x-ui）
3x-ui 是一个 基于 xray-core 的图形化代理面板
我们将使用：Docker部署
如果小伙伴是需要安装其他项目如halo，memos，wordpress等，主页搜索对应文章关键词即可
前3步骤 创建、进入、配置类似，第3步骤根据自己所建项目修改配置
5.1、创建目录
mkdir -p /root/data/docker_data/3x-ui
目录说明：
这样未来安装多个项目时目录不会混乱。
/root
└─ data
└─ docker_data
└─ 3x-ui
5.2、进入目录
cd /root/data/docker_data/3x-ui
5.3、配置
nano docker-compose.yml
💡 Nano 编辑器小贴士：
- 粘贴内容： 在终端点击鼠标右键，或使用快捷键
Shift + Insert- 保存修改： 按
Ctrl + O，然后按Enter确认文件名- 退出编辑器： 按
Ctrl + X- 注意： 如果你对文件做了改动，退出时会询问是否保存，输入
y(Yes) 即可
5.4、nano 编辑器输入：
services:
3x-ui:
image: ghcr.io/mhsanaei/3x-ui:latest
container_name: 3x-ui
restart: unless-stopped
# host模式网络性能更好
network_mode: host
environment:
XRAY_VMESS_AEAD_FORCED: "false"
volumes:
- ./db:/etc/x-ui
- ./cert:/root/cert
保存按 Ctrl + O，然后按 Enter 确认
退出按 Ctrl + X
5.5、启动 3x-ui
docker compose up -d
5.6、查看运行状态
docker ps
如果出现类似：
3x-ui Up xx seconds
说明启动成功
5.7、查看日志
docker logs 3x-ui
如果出现类似：
INFO - Web server running HTTP on [::]:2053
说明面板已经启动成功，这里 2053 就是 3x-ui 的后台端口
5.8、设置账号密码
进入容器：
docker exec -it 3x-ui sh
cd /app
再重置账号密码
./x-ui setting -username 你的用户名 -password 你的密码
例如：./x-ui setting -username admin -password 123456
5.9、修改端口
./x-ui setting -port 45678
5.10、然后重启容器
先退出
exit
docker restart 3x-ui
5.11、完成
此时打开浏览器输入：
http://vps_ip:你的端口
例如：
http://123.123.123.123:45678
即可打开你搭建的 3x-ui 面板。然后输入5.8步骤重置的账号密码即可
评论区