NeuroDebian Docker 镜像文档

镜像概述

注意：本仓库是 neurodebian 官方镜像 的 i386 架构专用仓库。有关更多信息，请参见官方镜像文档中的 "除 amd64 外的架构？" 和官方镜像 FAQ 中的 "镜像源在 Git 中变更后如何处理？"。

NeuroDebian 为 Debian、Ubuntu 及其他衍生系统提供大量神经科学研究软件，包括 AFNI、FSL、PyMVPA 等热门工具。本镜像基于 Debian 系统构建，预配置了 NeuroDebian 软件仓库及 GPG 密钥，便于快速部署神经科学研究环境。

核心功能与特性

核心功能

• 预配置仓库：镜像已集成 NeuroDebian 软件仓库及 GPG 密钥，无需手动添加。
• 多版本支持：基于 Debian 多个稳定版本（如 bullseye、bookworm、trixie 等）构建，满足不同系统兼容性需求。
• 自由/非自由版本分离：提供 -nonfree 标签版本，包含非 DFSG 合规的软件（可能有使用限制或缺少源代码）。

关键特性

• 轻量级基础：仅添加仓库配置，未预下载 apt 索引，需手动执行 apt-get update 后使用。
• 版本标签清晰：支持 Debian 版本代号（如 bookworm）、NeuroDebian 版本标识（如 nd120）及 latest 等标签，便于版本管理。

支持的标签

使用场景

• 神经科学研究环境：快速部署包含 AFNI、FSL、PyMVPA 等工具的研究环境。
• 软件测试与验证：在标准化 Debian 基础上测试神经科学软件的兼容性。
• 开发与教学：为开发或教学提供统一的软件环境，避免依赖配置差异。
• CI/CD 流程集成：作为持续集成/部署流程的基础镜像，自动化测试神经科学相关项目。

使用方法

前提条件

• 已安装 Docker 引擎（支持 i386 架构）。
• 网络连接正常（用于拉取镜像及软件包）。

基本使用（docker run）

1. 拉取镜像

docker pull i386/neurodebian:latest  # 拉取最新稳定版（trixie）
# 或指定版本，如 bookworm
docker pull i386/neurodebian:bookworm

2. 运行交互式容器

启动容器并进入交互式 shell，用于手动操作或安装软件：

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

注意：首次使用需先更新 apt 索引：

apt-get update  # 更新软件包索引

3. 安装神经科学软件示例

在容器内安装 AFNI（需先执行 apt-get update）：

apt-get install -y afni  # 安装 AFNI 软件包

Docker Compose 配置示例

创建 docker-compose.yml 文件，定义包含 NeuroDebian 镜像的服务：

version: '3'
services:
  neurodebian:
    image: i386/neurodebian:bookworm
    container_name: neurodebian-demo
    tty: true  # 保持容器运行
    command: bash  # 启动 bash shell
    volumes:
      - ./data:/data  # 挂载本地数据目录到容器

启动服务：

docker-compose up -d

进入容器：

docker-compose exec neurodebian bash

配置说明

APT 仓库配置

镜像已预设 NeuroDebian 仓库，配置文件路径：
/etc/apt/sources.list.d/neurodebian.sources.list

默认内容（以 wheezy 为例）：

deb [***] wheezy main
deb [***] data main
#deb-src [***] wheezy main

实际内容因镜像标签对应的 Debian 版本而异（如 bookworm、trixie 等）。

环境变量

镜像继承自 Debian 基础镜像，支持常见环境变量（如 DEBIAN_FRONTEND=noninteractive 用于非交互式安装）：

docker run -it --rm -e DEBIAN_FRONTEND=noninteractive i386/neurodebian:latest bash -c "apt-get update && apt-get install -y fsl"

许可证信息

基础软件许可

镜像中包含的软件许可信息请参见 Debian 社会契约。

-nonfree 版本注意事项

-nonfree 标签的镜像包含非 DFSG（Debian 自由软件指南）合规的软件，可能存在使用限制（如非商业用途）或缺少原始源代码。使用前请确保符合相关软件的许可协议。

其他软件许可

镜像可能包含基础系统（如 Bash）及依赖软件，其许可可能不同。部分自动检测的许可信息可在 repo-info 仓库的 neurodebian 目录 中查看。

用户责任：使用前需确保遵守镜像中所有软件的许可协议。

维护与支持

维护者

NeuroDebian 项目

支持的架构

• amd64：amd64/neurodebian
• arm64v8：arm64v8/neurodebian
• i386：i386/neurodebian（当前仓库）

获取帮助

• Docker 社区 Slack
• Server Fault
• Unix & Linux Stack Exchange
• Stack Overflow

问题反馈

提交 issue 至 NeuroDebian Dockerfiles 仓库

镜像更新

• 镜像更新跟踪：official-images 仓库的 library/neurodebian 标签
• 镜像定义文件：official-images 仓库的 library/neurodebian（含更新历史）

文档来源

本描述基于 docker-library/docs 仓库的 neurodebian 目录（含更新历史）。