openneuro/app

OpenNeuro Frontend 镜像文档

镜像概述和主要用途

OpenNeuro Frontend镜像是OpenNeuro.org平台的官方前端容器，用于部署和运行OpenNeuro平台的Web用户界面。该镜像封装了平台所需的前端资源、交互逻辑及界面组件，主要用途是为用户提供直观的Web操作界面，支持与OpenNeuro后端服务的交互，实现神经影像数据的管理、分析、共享等核心功能。

核心功能和特性

• 完整Web界面：包含OpenNeuro平台所有用户交互页面，如数据上传/下载、项目管理、分析流程配置等
• 响应式设计：支持桌面端和移动端访问，适配不同设备屏幕尺寸
• 后端集成：预置与OpenNeuro后端API服务的通信配置，实现前后端数据交互
• 静态资源优化：包含预编译的前端资源（HTML/CSS/JS），支持高效加载和缓存
• 可配置性：支持通过环境变量自定义后端服务地址、端口等关键参数

使用场景和适用范围

• OpenNeuro平台部署：作为OpenNeuro完整部署架构的前端组件，配合后端服务实现完整平台功能
• 本地开发测试：供开发人员在本地环境搭建前端开发/测试环境
• 科研机构自建实例：支持科研单位、高校等搭建私有OpenNeuro实例，管理内部神经影像数据
• 云端服务部署：适用于AWS、GCP、Azure等云平台容器服务，构建弹性扩展的前端服务

使用方法和配置说明

基本运行方式

通过docker run命令启动容器：

bash
docker run -d \
  --name openneuro-frontend \
  -p 80:80 \
  docker.xuanyuan.run/openneuro/frontend:latest

环境变量配置

支持通过以下环境变量自定义配置（通过-e参数传入）：

示例（自定义后端地址）：

bash
docker run -d \
  --name openneuro-frontend \
  -p 8080:80 \
  -e BACKEND_URL="https://api.my-openneuro.org" \
  -e PORT=80 \
  docker.xuanyuan.run/openneuro/frontend:latest

卷挂载

如需自定义前端配置文件或静态资源，可通过卷挂载覆盖容器内文件：

bash
docker run -d \
  --name openneuro-frontend \
  -p 80:80 \
  -v /local/custom-config:/usr/share/nginx/html/config \  # 挂载自定义配置
  -v /local/static-assets:/usr/share/nginx/html/assets  # 挂载自定义静态资源
  openneuro/frontend:latest

Docker Compose配置示例

yaml
version: '3'
services:
  frontend:
    image: docker.xuanyuan.run/openneuro/frontend:latest
    ports:
      - "80:80"
    environment:
      - BACKEND_URL=http://backend:8000
      - PORT=80
    depends_on:
      - backend
    restart: unless-stopped

  backend:
    image: docker.xuanyuan.run/openneuro/backend:latest
    # 后端服务配置...

注意事项

• 需确保前端容器与OpenNeuro后端服务网络互通，可通过Docker网络或环境变量BACKEND_URL指定正确的后端地址
• 生产环境建议配合反向代理（如Nginx）使用，实现HTTPS加密和负载均衡
• 镜像版本需与后端服务版本匹配，避免API兼容性问题