i386/neurodebian

NeuroDebian Docker 镜像文档

镜像概述

注意：本仓库是 https://hub.docker.com/_/neurodebian 的 i386 架构专用仓库。有关更多信息，请参见官方镜像文档中的 https://github.com/docker-library/official-images#architectures-other-than-amd64 和官方镜像 FAQ 中的 https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

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. 拉取镜像

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

2. 运行交互式容器

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

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

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

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

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

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

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

Docker Compose 配置示例

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

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

启动服务：

bash
docker-compose up -d

进入容器：

bash
docker-compose exec neurodebian bash

配置说明

APT 仓库配置

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

默认内容（以 wheezy 为例）：

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

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

环境变量

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

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

许可证信息

基础软件许可

镜像中包含的软件许可信息请参见 https://www.debian.org/social_contract#guidelines%E3%80%82

-nonfree 版本注意事项

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

其他软件许可

镜像可能包含基础系统（如 Bash）及依赖软件，其许可可能不同。部分自动检测的许可信息可在 https://github.com/docker-library/repo-info/tree/master/repos/neurodebian 中查看。

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

维护与支持

维护者

https://github.com/neurodebian/dockerfiles

支持的架构

• amd64：https://hub.docker.com/r/amd64/neurodebian/
• arm64v8：https://hub.docker.com/r/arm64v8/neurodebian/
• i386：https://hub.docker.com/r/i386/neurodebian/%EF%BC%88%E5%BD%93%E5%89%8D%E4%BB%93%E5%BA%93%EF%BC%89

获取帮助

• https://dockr.ly/comm-slack
• Server Fault
• https://unix.stackexchange.com/help/on-topic
• https://stackoverflow.com/help/on-topic

问题反馈

提交 issue 至 https://github.com/neurodebian/dockerfiles/issues

镜像更新

• 镜像更新跟踪：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fneurodebian
• 镜像定义文件：https://github.com/docker-library/official-images/blob/master/library/neurodebian%EF%BC%88%E5%90%AB%E6%9B%B4%E6%96%B0%E5%8E%86%E5%8F%B2%EF%BC%89

文档来源

本描述基于 https://github.com/docker-library/docs/tree/master/neurodebian%EF%BC%88%E5%90%AB%E6%9B%B4%E6%96%B0%E5%8E%86%E5%8F%B2%EF%BC%89%E3%80%82