sagemath/sagemath Docker 镜像 - 轩辕镜像

SageMath Docker 镜像文档

镜像概述与主要用途

SageMath 简介

SageMath 是一款免费开源的数学软件系统，基于 GPL 许可证分发。它构建于众多现有开源软件包之上，包括 NumPy、SciPy、matplotlib、SymPy、Maxima、GAP、FLINT、R 等，通过统一的 Python 语言接口或直接通过包装器/接口提供这些工具的综合功能。

使命：创建一个可行的免费开源替代方案，以替代 Magma、Maple、Mathematica 和 Matlab 等商业数学软件。

Docker 镜像用途

SageMath Docker 镜像提供了预配置的 SageMath 运行环境，无需手动安装依赖，可快速部署用于数学计算、教学、研究及开发场景。

支持的标签

核心功能与特性

• 多工具集成：整合 NumPy、SciPy、SymPy、Maxima 等数十个开源数学库，提供一站式数学计算能力。
• 统一接口：通过 Python 语言接口访问所有工具，或直接使用原生接口/wrapper。
• 开源免费：基于 GPLv3 许可证，完全开源，无商业使用限制。
• 多场景支持：支持命令行交互、脚本运行及 Jupyter Notebook 可视化。

镜像内容与版本

SageMath Docker 镜像提供两种主要版本：

1. sagemath/sagemath

• 功能：包含命令行运行 SageMath 所需的全部组件。
• 镜像大小：![image size]([***]
• 适用场景：日常数学计算、脚本执行、Jupyter Notebook 运行。

2. sagemath/sagemath-dev

• 功能：包含 SageMath 源码构建 artifacts，用于快速重建 Sage（当前存在问题，见 #34241）。
• 适用场景：仅推荐 SageMath 开发者用于源码开发与调试。

使用方法

1. 命令行运行 SageMath

使用 sagemath/sagemath 镜像启动命令行交互环境：

bash
docker run -it sagemath/sagemath:latest

2. 启动 Jupyter Notebook

通过以下命令启动 Jupyter Notebook，访问 http://localhost:8888 进行可视化交互：

bash
docker run -p 8888:8888 sagemath/sagemath:latest sage-jupyter

运行后，根据终端输出的提示（含访问链接与令牌）访问 Notebook。

3. 开发环境使用（sagemath-dev）

启动开发环境并进入 shell：

bash
docker run -it sagemath/sagemath-dev:develop

镜像中 Git 仓库为空以节省空间。如需使用 Git，执行以下命令恢复源码：

bash
git fetch origin
git reset $(cat docker/.commit)  # 恢复至构建镜像时的提交版本

构建自定义镜像

基于 Sage 源码仓库中的 Dockerfile 构建自定义镜像，步骤如下：

1. 克隆 Sage 源码仓库：

   bash
   git clone [***]
   cd sage
   

2. 执行构建命令，指定目标版本（TARGET 为 sagemath 或 sagemath-dev）：

   bash
   docker build -f docker/Dockerfile --build-arg ARTIFACT_BASE=sagemath/sagemath-dev:develop --target TARGET .
   

镜像更新机制

当前镜像通过 GitHub 工作流 在每个版本发布时自动生成，基于源码仓库中的 Dockerfile 构建。

问题反馈与支持

• Bug 报告：通过 Issue Tracker 提交问题。
• 邮件列表：通过 sage-support（用户支持）或 sage-devel（开发讨论）联系。

许可证

SageMath 软件分发整体采用 GNU 通用公共许可证第 3 版（GPLv3）。详见 COPYING.txt。