wolfyuan/dolphin Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

🐬 Dolphin

一站式代码托管解决方案

Dolphin 仍在积极开发中，如遇到任何bug或有功能需求，请创建issue反馈

Dolphin 是一个集成了所有必要组件的容器镜像，为您的代码托管提供便利！

✨ 特性：

• 使用 s6-overlay 运行容器
• 模块化设计
• 支持多种编程语言
• 多基础镜像和CPU架构适配
• 以rootless进程运行代码

---

• 🏃 运行镜像
• 📦️ 容器镜像
  • 标签格式
• 🌎️ 环境变量与工作流程
  • 适用于所有镜像的变量
  • 特定镜像选项
• 💾 容器内数据持久化
• 🎩 RedHat Podman 支持
• 📽️ 显卡支持

🏃 运行镜像

bash
docker run --name dolphin-box -d \
  -e GIT_URL="https://domain.com" \
  --restart unless-stopped \
  docker.io/wolfyuan/dolphin:node

---

命令解析： -e GIT_URL="https://domain.com" - 用于控制容器的环境变量，完整列表见环境变量与工作流程

您可以添加多个变量，例如：

-e GIT_URL="https://domain.com" -e SYSTEM_PACKAGES="automake"

完整命令如下：

bash
docker run --name dolphin-box -d \
 -e GIT_URL="https://domain.com" \
 -e SYSTEM_PACKAGES="automake" \
 --restart unless-stopped \
 docker.io/wolfyuan/dolphin:node

--restart unless-stopped - 容器故障或机器重启时自动重启，除非手动停止容器

docker.io/wolfyuan/dolphin:node - 容器镜像，其中node表示针对该语言设计的镜像，完整列表见容器镜像

📦️ 容器镜像

除非另有说明，大多数镜像支持arm架构CPU。

标签格式

镜像标签格式为：[镜像标签]-[镜像变体]

例如，基于ubuntu的node镜像标签为：node-ubuntu

若未指定镜像变体，将默认拉取ubuntu基础镜像

例如，拉取node标签将自动拉取node-ubuntu镜像

🌎️ 环境变量与工作流程

适用于所有镜像的变量

环境变量：

工作流程：

1. 容器启动
2. 准备运行目录
3. 添加额外系统包
4. 通过GIT_URL克隆Git仓库

特定镜像选项

node

环境变量：

环境变量名称	描述
NODE_VERSION	需安装的Node.js版本，覆盖项目中的.nvmrc
NODE_START_SCRIPT	容器完成初始化脚本后运行的启动脚本

工作流程：

1. 容器启动
2. 基础镜像初始化
3. 通过NODE_VERSION或项目中的.nvmrc安装Node.js
4. 通过检测到的包管理器安装npm包
5. 若存在构建脚本，通过检测到的包管理器运行
6. 通过NODE_START_SCRIPT或package.json中的脚本（通过检测到的包管理器）启动Node.js进程

📝 注意
支持的包管理器：pnpm、yarn、npm

📝 注意
包管理器优先级：pnpm > yarn > npm
Node版本优先级：NODE_VERSION > .nvmrc

python

环境变量：

环境变量名称	描述
PYTHON_VERSION	需安装的Python版本，覆盖项目中的.python-version
PYTHON_BUILD_SCRIPT	安装Python包后运行的构建脚本
PYTHON_START_SCRIPT	容器完成初始化脚本后运行的启动脚本
PYTHON_START_FILE	容器完成初始化脚本后运行的启动文件

工作流程：

1. 容器启动
2. 基础镜像初始化
3. 通过PYTHON_VERSION或项目中的.python-version安装Python
4. 通过pip安装Python包
5. 通过PYTHON_START_SCRIPT和PYTHON_START_FILE（使用python3命令）启动Python进程

⚠️ 警告
由于pyenv切换Python版本的机制，建议持久化容器存储，详见容器内数据持久化

📝 注意
当PYTHON_START_SCRIPT和PYTHON_START_FILE同时存在时，将先运行PYTHON_START_SCRIPT，待其完成后再运行PYTHON_START_FILE

📝 注意
Python版本优先级：PYTHON_VERSION > .python-version

💾 容器内数据持久化

可将两种目录挂载到Dolphin容器：

• /home/dolphin：包含代码（space目录）及运行时二进制文件（如nvm、pyenv）

  需节省带宽时使用此目录

• /home/dolphin/space

  需避免项目重建时使用此目录

启动Docker容器时，添加以下参数挂载目录：

bash
-v /path/to/your/host/folder:/home/dolphin

或

bash
-v /path/to/your/host/folder:/home/dolphin/space

🎩 RedHat Podman 支持

理论上应该可以工作

📽️ 显卡支持

尚未测试，但应用将在rootless环境中运行，可能无法正常工作。