x-ui-yg Docker

这是一个基于 Alpine Linux 的轻量级 x-ui-yg Docker 镜像。支持多架构 (amd64, arm64)，并使用我自设计的版本监测服务自动构建(按小时检测新版本)。

本项目遵循 MIT License。

• 极度轻量: 基于 Alpine 基础镜像构建，只包含必要依赖。
• 多架构支持: 同时支持 linux/amd64 和 linux/arm64。
• 数据持久化: 关键数据和配置挂载到宿主机。
• 自动更新: 通过 VerWatch按小时监测版本更新，GitHub Actions 进行构建，跟进上游更新。

我们通过 GitHub Container Registry 和 DockerHub 发布构建好的镜像。

GitHub Container Registry 镜像地址: ghcr.io/shaog-r/x-ui-yg-docker:alpine (或者 latest)

DockerHub 镜像地址: shaogme/x-ui-yg:alpine (或者 latest)

docker run -d \
    --name x-ui-yg \
    -p 54321:54321 \
    -v $(pwd)/data:/usr/local/x-ui \
    -e XUI_USER=myuser \
    -e XUI_PASS=mypassword \
    -e XUI_PORT=54321 \
    shaogme/x-ui-yg:alpine

创建或修改 docker-compose.yml 文件如下：

version: '3.8'
services:
  x-ui-yg:
    # 使用发布的镜像
    image: shaogme/x-ui-yg:alpine
    container_name: x-ui-yg
    restart: unless-stopped
    tty: true
    ports:
      - "54321:54321"
      - "10000-10005:10000-10005"
      - "10000-10005:10000-10005/udp"
    volumes:
      - ./data:/usr/local/x-ui
      #  - ./your_ssl_certs:/root/ygkkkca/ #  你的ssl 证书存放目录映射到/root/ygkkkca/，因为默认ssl目录位置在/root/ygkkkca/
    environment:
      - XUI_USER=myuser
      - XUI_PASS=mypassword
      - XUI_PORT=54321

然后运行：

docker-compose up -d

如果你希望自己在本地构建镜像：

docker build -t x-ui-yg:alpine .

docker run -d \
    --name x-ui-yg \
    -p 54321:54321 \
    -v $(pwd)/data:/usr/local/x-ui \
    -e XUI_USER=myuser \
    -e XUI_PASS=mypassword \
    -e XUI_PORT=54321 \ # 添加 -e XUI_PATH=/ 以确定web路径
    x-ui-yg:alpine

直接在源码目录下运行即可（默认使用本地构建）：

docker-compose up -d

若你在启动时未设置 XUI_USER 、 XUI_PASS 、 XUI_PORT 和 XUI_PATH，容器会自动随机生成。可以通过查看挂载目录下的 init.log 文件获取：

cat data/init.log

输出示例：

2025-12-08 13:56:05 [Info] Container entrypoint started.
2025-12-08 13:56:05 [Info] Syncing binary files...
2025-12-08 13:56:05 [Info] Binaries synced.
2025-12-08 13:56:05 [Info] Initializing configuration...
---------------------------------------------
x-ui Initial Login Info:
  Username: jkeiw3AV
  Password: WvOuqfWB
  Port    : 16543
  WebPath : /a8Z3s
---------------------------------------------
set username and password success
set port 16543 success
set webBasePath /a8Z3s success
2025-12-08 13:56:05 [Info] Configuration initialized.
2025-12-08 13:56:05 [Info] Starting x-ui process...

关于 init.log 的说明：

1. 该日志仅用于记录容器启动时的初始化过程。若未在环境变量设置 XUI_USER, XUI_PASS, XUI_PORT, XUI_PATH，容器会自动生成随机值（端口范围 10000-65535，Path 为 4-8 位随机字符）。
2. 日志滚动机制：为防止日志无限膨胀，当日志文件超过 50KB 时，旧的 init.log 会被重命名为 init.log.old，并创建新的日志文件。
3. 安全建议：获取到初始账号密码并登录修改后，为了安全起见，建议手动删除挂载目录下的 init.log 文件。

这样你就拥有了一个轻量级、基于 Alpine 的 x-ui-yg 容器版本，且数据可以持久化保存。