slf4j/avalon-admin-ui repository overview

⁠Avalon Admin UI

Avalon Admin UI 是 Avalon 管理后台前端的 Docker 镜像。

该镜像内置了 Vue 3 应用的生产构建产物，并通过 nginx 提供静态资源服务。

⁠镜像提供的能力

• 开箱即用的管理后台 Web UI 容器
• 基于 nginx 的静态文件托管
• 单页应用路由回退到 index.html
• 对 /assets/* 提供长期缓存头

⁠镜像不提供的能力

• 后端服务
• 数据库
• 运行时环境变量注入

这个镜像只负责前端页面展示，仍然需要你单独部署Avalon 后端服务⁠。

⁠支持的标签

• latest
• 版本标签，例如 0.0.1

⁠快速开始

启动容器，并将容器内的 80 端口映射到宿主机的 80：

docker run -d \
  --name avalon-admin-ui \
  -p 80:80 \
  slf4j/avalon-admin-ui:latest

然后访问：

http://localhost:80

⁠Docker Compose 示例

services:
  avalon-admin-ui:
    image: slf4j/avalon-admin-ui:latest
    container_name: avalon-admin-ui
    ports:
      - '80:80'
    restart: unless-stopped

⁠后端接入要求

这个镜像是纯静态前端容器，默认要求后端 API 能够通过同源路径访问。

实际部署时，建议放在反向代理或网关之后，并确保：

• 前端页面通过 / 提供访问
• 后端 API 在同一个域名下暴露

⁠反向代理说明

容器内部已经包含一个用于静态资源服务的 nginx。在生产环境中，仍然建议在它前面再放一层反向代理，用于处理：

• TLS 终止
• 域名路由
• 后端 API 转发
• 访问日志

⁠端口

• 容器端口：80

⁠数据持久化

该容器是无状态的。

正常使用时不需要挂载持久化卷。

⁠升级方式

拉取新镜像并重新创建容器：

docker pull slf4j/avalon-admin-ui:latest
docker rm -f avalon-admin-ui
docker run -d \
  --name avalon-admin-ui \
  -p 80:80 \
  slf4j/avalon-admin-ui:latest

⁠参考链接

• 前端源码⁠
• 后端源码⁠
• 项目文档⁠

⁠许可证

AGPL-3.0