
官网地址:3x-ui/README.zh_CN.md at main · MHSanaei/3x-ui · GitHub
1、安装 & 升级
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)
2、通过Docker安装
1、安装Docker:
bash <(curl -sSL https://get.docker.com)
2、克隆仓库:
git clone https://github.com/MHSanaei/3x-ui.git
cd 3x-ui
3、运行服务:
docker compose up -d
或者
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/mhsanaei/3x-ui:latest
4、docker-compose.yml
3x-ui/docker-compose.yml at main · MHSanaei/3x-ui · GitHub
---
version: "3"
services:
3x-ui:
image: ghcr.io/mhsanaei/3x-ui:latest
container_name: 3x-ui
hostname: yourhostname #设置容器内部的主机名为 yourhostname(需替换为实际域名或主机名)
volumes:
- $PWD/db/:/etc/x-ui/ #将宿主机的 当前目录/db/ 映射到容器的 /etc/x-ui/,用于存储 X-UI 的配置文件、数据库等
- $PWD/cert/:/root/cert/ #将宿主机的 当前目录/cert/ 映射到容器的 /root/cert/,用于存放 SSL 证书文件(如 HTTPS 证书)
environment:
XRAY_VMESS_AEAD_FORCED: "false" #设置为 false,允许兼容旧版 VMess 协议(不强制使用 AEAD 加密)
X_UI_ENABLE_FAIL2BAN: "true" #设置为 true,启用 Fail2Ban 安全工具,自动封禁多次登录失败的 IP
tty: true #分配伪终端,便于某些应用交互(非必须,但部分镜像可能需要)。
network_mode: host #容器直接使用宿主机的网络栈,无需端口映射
restart: unless-stopped #自动重启策略:除非手动停止,否则容器退出后始终自动重启
3、更新至最新版本
cd 3x-ui
docker compose down
docker compose pull 3x-ui
docker compose up -d
4、从Docker中删除3x-ui
docker stop 3x-ui
docker rm 3x-ui
cd --
rm -r 3x-ui