NeuroDebian Docker镜像文档

概述

镜像概述和主要用途

NeuroDebian是一个为Debian、Ubuntu及其他衍生操作系统提供神经科学研究软件的项目。该Docker镜像集成了NeuroDebian软件仓库及其GPG密钥，旨在为研究人员提供便捷、一致的神经科学研究环境，主要用途是快速部署包含AFNI、FSL、PyMVPA等热门神经科学工具的开发与分析平台。

核心功能与特性

• 丰富的软件集合：包含大量神经科学研究常用软件，如AFNI、FSL、PyMVPA等主流工具。
• 多发行版支持：基于Debian（bullseye、bookworm、trixie等）和Ubuntu（jammy、noble、plucky等）及其衍生版本构建。
• 仓库集成：预装NeuroDebian***仓库及GPG密钥，确保软件包的安全获取与验证。
• 版本区分：提供free（DFSG合规）和non-free（包含非DFSG合规软件）两种版本，满足不同许可需求。
• 轻量级设计：仅添加仓库配置，未预下载APT索引，需手动执行apt-get update后使用，保持镜像精简。
• 多架构兼容：支持amd64、arm64v8、i386等硬件架构。

支持的标签

以下是支持的镜像标签及其对应的Dockerfile链接：

使用场景

• 神经科学研究环境：快速部署AFNI、FSL等工具，支持神经影像数据处理与分析。
• 学术研究复现：提供一致的软件版本环境，减少因依赖差异导致的研究结果不一致。
• 教学与培训平台：在高校或研究机构中搭建统一的神经科学软件教学环境。
• 多架构适配：适用于amd64工作站、arm64v8嵌入式设备等不同硬件平台。
• 自动化工作流：集成到容器化分析流程（如Nextflow、Snakemake）中，支持批量数据处理。

使用方法

前提条件

• 已安装Docker引擎（参考Docker***安装指南）。

拉取镜像

根据需求拉取对应标签的镜像：

bash
# 拉取最新稳定版（Debian 13）
docker pull neurodebian:latest

# 拉取Ubuntu 24.04版本
docker pull neurodebian:noble

# 拉取非免费版本（包含非DFSG合规软件）
docker pull neurodebian:non-free

基础操作

交互式终端

运行容器并进入交互式bash终端：

bash
docker run -it --rm neurodebian:latest /bin/bash

注意：首次使用apt-get前需更新索引：

bash
apt-get update  # 在容器内执行

安装软件示例

更新索引后安装指定软件（如FSL）：

bash
# 一次性命令：拉取镜像、更新索引并安装FSL
docker run --rm neurodebian:latest bash -c "apt-get update && apt-get install -y fsl"

挂载数据卷

将本地数据目录挂载到容器，便于数据读写：

bash
# 挂载当前目录到容器的/data目录
docker run -it --rm -v $(pwd):/data neurodebian:latest /bin/bash

在容器内可通过/data访问本地文件。

运行软件命令

直接执行已安装软件的命令（如AFNI的3dinfo）：

bash
# 查看NIfTI文件信息（假设本地有example.nii.gz）
docker run --rm -v $(pwd):/data neurodebian:latest 3dinfo /data/example.nii.gz

配置说明

APT源配置

NeuroDebian仓库配置文件位于/etc/apt/sources.list.d/neurodebian.sources.list，默认启用main区域（DFSG合规软件）：

console
$ docker run --rm neurodebian:latest cat /etc/apt/sources.list.d/neurodebian.sources.list
deb [***] trixie main
deb [***] data main
#deb-src [***] trixie main

注：不同发行版标签的源配置中，发行版名称（如trixie、jammy）会相应变化。

自定义源配置

如需修改源（如切换国内镜像源或添加测试仓库），可挂载自定义配置文件：

bash
# 使用本地自定义的sources.list替换容器内配置
docker run -it --rm -v /path/to/custom.sources.list:/etc/apt/sources.list.d/neurodebian.sources.list neurodebian:latest /bin/bash

许可证信息

• 基础系统软件：遵循Debian自由软件指南（DFSG）。
• 非免费版本：-nonfree标签包含非DFSG合规软件，可能存在使用限制（如非商业用途）或缺乏原始代码，用户需自行确保合规。
• 镜像合规性：作为预构建镜像，用户有责任确保其使用符合所有包含软件的许可证要求。

更多许可证详情可参考repo-info仓库的neurodebian目录。

维护与支持

• 维护者：NeuroDebian团队
• 问题反馈：提交issue至neurodebian/dockerfiles
• 社区支持：Docker Community Slack、Server Fault、Unix & Linux Stack Exchange或Stack Overflow