Singularity / Apptainer Docker 镜像源配置教程

1

关于 Singularity 和 Apptainer

Apptainer 是 Singularity 项目的社区分支，两者功能基本相同，命令也基本兼容。本教程同时适用于 Singularity 和 Apptainer。

请使用以下命令查看版本：

singularity --version

apptainer --version

2

安装 Singularity/Apptainer

如果您的系统尚未安装 Singularity 或 Apptainer，可以使用以下方法安装：

Ubuntu/Debian（推荐使用 Apptainer）：

sudo add-apt-repository ppa:apptainer/ppa -y
sudo apt update
sudo apt install -y apptainer

CentOS/RHEL：

sudo yum install -y epel-release
sudo yum install -y singularity

从源码编译安装：

# 从源码编译安装（适用于高级用户）
# 参考官方文档：https://apptainer.org/docs/admin/main/installation.html

3

使用 docker:// 协议指定专属域名

Singularity/Apptainer 支持通过 docker:// 协议直接指定镜像地址，这是最简单直接的方法，无需任何配置文件。

基本用法：

singularity pull myapp.sif docker://***.xuanyuan.run/library/nginx:alpine

或使用 Apptainer 命令：

apptainer pull myapp.sif docker://***.xuanyuan.run/library/nginx:alpine

多仓库镜像拉取示例：

# Docker Hub 镜像
singularity pull nginx.sif docker://***.xuanyuan.run/library/nginx:alpine

# GitHub Container Registry 镜像
singularity pull ghcr.sif docker://***-ghcr.xuanyuan.run/namespace/image:tag

# Google Container Registry 镜像
singularity pull gcr.sif docker://***-gcr.xuanyuan.run/project/image:tag

# Quay.io 镜像
singularity pull quay.sif docker://***-quay.xuanyuan.run/namespace/image:tag

# Kubernetes Registry 镜像
singularity pull k8s.sif docker://***-k8s.xuanyuan.run/namespace/image:tag

4

验证配置是否生效

拉取镜像后，可以通过以下方式验证是否使用了专属域名：

• 观察拉取速度，如果明显快于直接拉取官方源，说明配置生效
• 在网络抓包工具（如 tcpdump、wireshark）中查看是否访问了您的专属域名
• 在代理服务器日志中查看是否记录了专属域名的访问记录
• 检查镜像文件是否成功下载到本地

示例命令：

singularity pull test.sif docker://***.xuanyuan.run/library/alpine:latest

拉取成功后，可以使用 ls -lh test.sif 查看镜像文件。

5

常见问题