amd64/neurodebian

NeuroDebian Docker 镜像文档

1. 镜像概述和主要用途

amd64/neurodebian 是针对 amd64 架构的官方 NeuroDebian 镜像，基于 Debian、Ubuntu 及其衍生系统构建，提供了大量神经科学研究领域的常用软件。该镜像旨在为研究人员和开发者提供便捷的 Docker 环境，快速部署和运行神经科学工具（如 AFNI、FSL、PyMVPA 等），适用于神经科学研究、应用开发及相关实验场景。

2. 核心功能和特性

2.1 核心功能

• 预配置 NeuroDebian 仓库：集成 NeuroDebian 软件仓库及 GPG 密钥，直接访问神经科学专用软件包。
• 多发行版支持：基于 Debian（如 bullseye、bookworm）和 Ubuntu（如 jammy、noble）多个稳定版本构建。
• Free/Non-Free 版本分离：提供完全符合 DFSG 标准的 free 版本，以及包含非自由软件的 non-free 版本（可能有许可限制）。

2.2 关键特性

• 轻量级设计：仅添加仓库配置，不预下载 apt 索引，需手动执行 apt-get update 后使用。
• 版本标签清晰：标签包含发行版名称（如 jammy）和 NeuroDebian 版本标识（如 nd22.04），便于版本管理。
• 官方维护：由 NeuroDebian 团队维护，与上游 Debian/Ubuntu 版本同步更新。

3. 支持的标签及对应 Dockerfile

3. 使用场景和适用范围

3.1 适用用户

• 神经科学研究人员：需快速部署 AFNI、FSL、PyMVPA 等工具进行数据分析。
• 开发者：构建基于神经科学软件的应用或服务，确保环境一致性。
• 教育者：在教学或演示中提供标准化的神经科学工具环境。

3.2 典型场景

• 本地开发与测试：在隔离环境中运行神经科学软件，避免系统依赖冲突。
• 科研实验：通过 Docker 容器复现实验环境，确保结果可重复。
• 生产部署：作为神经科学应用的基础镜像，集成到 CI/CD 流程中。

4. 使用方法和配置说明

4.1 基本使用步骤

4.1.1 拉取镜像

根据需求选择标签拉取镜像（以 latest 为例，对应 Debian 13 Trixie）：

console
docker pull docker.xuanyuan.run/amd64/neurodebian:latest

如需非自由版本：

console
docker pull docker.xuanyuan.run/amd64/neurodebian:non-free

4.1.2 运行容器

启动交互式容器（需先更新 apt 索引）：

console
# 启动容器并进入终端
docker run -it --rm docker.xuanyuan.run/amd64/neurodebian:latest bash

# 在容器内更新 apt 索引并安装软件（如 FSL）
apt-get update && apt-get install -y fsl

4.1.3 挂载数据卷

挂载本地数据目录到容器，便于数据持久化和共享：

console
docker run -it --rm -v /本地数据目录:/data docker.xuanyuan.run/amd64/neurodebian:latest bash

4.2 Docker Compose 配置示例

创建 docker-compose.yml 文件，定义服务及数据卷：

yaml
version: '3'
services:
  neurodebian:
    image: docker.xuanyuan.run/amd64/neurodebian:latest
    volumes:
      - ./data:/data  # 挂载本地数据目录
      - ./scripts:/scripts  # 挂载脚本目录
    tty: true  # 保持终端连接
    command: bash -c "apt-get update && apt-get install -y afni && /bin/bash"  # 启动时安装 AFNI 并进入终端

启动服务：

console
docker-compose up -d
docker-compose exec neurodebian bash  # 进入容器终端

4.3 配置说明

4.3.1 仓库配置

镜像已预配置 NeuroDebian 仓库，配置文件路径：

/etc/apt/sources.list.d/neurodebian.sources.list

默认启用 main 区域（DFSG 合规软件），内容示例：

console
deb http://neuro.debian.net/debian trixie main
deb http://neuro.debian.net/debian data main
#deb-src http://neuro.debian.net/debian-devel trixie main

4.3.2 关键注意事项

• 必须手动更新 apt 索引：镜像未包含预下载的 apt 索引，首次使用前需执行 apt-get update。
• 非自由版本限制：-nonfree 标签包含非 DFSG 合规软件，可能有许可限制（如非商业使用），需用户自行确保合规。
• 架构限制：本镜像仅支持 amd64 架构，其他架构需参考 https://github.com/docker-library/official-images#architectures-other-than-amd64%E3%80%82

5. 许可证信息

5.1 基础软件许可证

镜像中基础系统（Debian/Ubuntu）及 DFSG 合规软件的许可证遵循 https://www.debian.org/social_contract#guidelines%E3%80%82

5.2 非自由版本说明

-nonfree 标签镜像包含非 DFSG 合规软件，可能受额外许可限制（如版权、非商业使用要求等），且可能缺乏原始源代码。用户需自行检查并确保使用符合相关软件的许可条款。

5.3 镜像整体合规性

Docker 镜像可能包含其他软件（如 Bash、基础系统工具等），其许可证需参考各自的分发条款。用户有责任确保对镜像的所有使用符合包含软件的相关许可证要求。

6. 维护与支持

• 维护方：https://github.com/neurodebian/dockerfiles
• 问题反馈：https://github.com/neurodebian/dockerfiles/issues
• 社区支持：Docker 社区 Slack、Server Fault、Unix & Linux Stack Exchange、Stack Overflow

参考链接

• NeuroDebian 官方网站
• https://github.com/neurodebian/dockerfiles
• https://github.com/docker-library/docs/tree/master/neurodebian