xiyuanzchloe/guanaco

guanaco-viz 镜像文档

镜像概述

guanaco-viz 是一款专注于单细胞数据可视化的Docker镜像，旨在为用户提供便捷的单细胞数据分析与展示能力。通过简单的配置即可快速部署可视化服务，支持数据持久化存储和灵活的参数调整，适用于生物信息学研究、单细胞数据分析等场景。

核心功能与特性

• 单细胞数据可视化：提供直观的单细胞数据展示界面，支持多种可视化图表
• 配置灵活：通过配置文件（config.json）自定义可视化参数和展示方式
• 数据持久化：支持本地数据卷挂载，确保分析数据不丢失
• 环境变量控制：可通过环境变量调整后端模式和工作进程数，优化性能
• 端口映射：支持自定义端口映射，方便集成到现有工作流

使用场景

• 单细胞测序数据分析结果可视化
• 生物信息学研究中的数据展示与分享
• 教学或学术报告中的单细胞数据演示
• 需要快速部署单细胞可视化服务的场景

使用方法

基本部署命令

通过以下docker run命令快速启动服务：

bash
docker run -p 8080:8080 \
    -v ./:/app/data \
    -v ./guanaco_sim.json:/app/config.json \
    -e GUANACO_BACKED_MODE=false \
    -e GUANACO_WORKERS=2 \
    guanaco-viz

参数说明

docker-compose 配置示例

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  guanaco-viz:
    image: guanaco-viz
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
      - ./config/guanaco_sim.json:/app/config.json
    environment:
      - GUANACO_BACKED_MODE=false
      - GUANACO_WORKERS=4
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 确保挂载的配置文件（guanaco_sim.json）格式正确，否则可能导致服务启动
• 根据主机性能调整GUANACO_WORKERS参数，避免资源占用过高
• 数据卷目录需有读写权限，确保数据正常持久持久