hobbyfarm/ui

HobbyFarm 用户界面镜像

概述

HobbyFarm用户界面镜像是开源培训平台HobbyFarm的官方前端组件，提供直观的Web界面，支持学员和管理员与HobbyFarm后端服务交互，实现实验环境管理、用户权限控制及培训课程配置等核心功能。

核心功能与特性

• 多角色支持：为学员提供实验环境访问界面，为管理员提供平台配置与监控功能
• 实验环境管理：可视化创建、启动、暂停和终止实验环境实例
• 课程与任务管理：浏览培训课程目录，查看实验任务说明及进度跟踪
• 响应式设计：适配桌面端与移动端，支持多种设备访问
• 无缝后端集成：与HobbyFarm API服务实时通信，同步用户状态与资源数据

使用场景

• 学员访问：通过Web浏览器参与HobbyFarm培训实验，操作分配的实验环境
• 管理员运维：配置培训课程模板、管理用户角色权限及监控平台资源使用
• 企业培训平台：作为内部技术培训平台的前端入口，集成至企业内网系统

使用方法与配置说明

前提条件

• 已部署HobbyFarm后端API服务（推荐版本v2.0+）
• Docker引擎20.10+或兼容容器运行时环境
• 网络可访问后端API服务端点

快速启动（docker run）

bash
docker run -d \
  --name hobbyfarm-ui \
  -p 80:80 \
  -e API_URL=http://hobbyfarm-api:8080 \
  -e PORT=80 \
  hobbyfarm/ui:latest

环境变量配置

Docker Compose示例

yaml
version: '3.8'
services:
  hobbyfarm-ui:
    image: hobbyfarm/ui:latest
    container_name: hobbyfarm-ui
    restart: unless-stopped
    ports:
      - "80:80"
    environment:
      - API_URL=http://hobbyfarm-api:8080
      - AUTH_MODE=oidc
      - LOG_LEVEL=warn
    depends_on:
      - hobbyfarm-api

  hobbyfarm-api:
    image: hobbyfarm/api:latest
    container_name: hobbyfarm-api
    restart: unless-stopped
    ports:
      - "8080:8080"
    # 后端服务配置（示例）
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/hobbyfarm

访问与验证

1. 启动容器后，通过浏览器访问 http://<主机IP或域名>:<映射端口>（如 http://localhost）
2. 验证界面加载正常，且"API连接状态"显示为"已连接"（通常在页面底部状态栏）
3. 使用HobbyFarm用户账户登录，确认可正常访问实验列表或管理功能

注意事项

• 生产环境配置：建议通过反向代理（如Nginx）配置HTTPS，避免明文传输
• 版本兼容性：UI镜像版本需与后端API版本匹配（查看HobbyFarm官方版本矩阵）
• 资源限制：单实例建议配置至少128MB内存，高并发场景可水平扩展多个实例
• 数据持久化：前端无本地存储，所有状态通过后端API与数据库交互实现持久化