olavurmortensen/hms-beagle

HMS Beagle（第二次航行）Docker镜像文档

镜像概述

HMS Beagle是一个专为生物信息学设计的Docker容器镜像。该镜像基于Ubuntu Bionic系统，集成Jupyter Lab作为用户界面，提供终端访问、Python笔记本编写等功能，并通过conda包管理器管理实验和项目的软件依赖。此外，镜像还包含tmux、Vim和RStudio Server等工具，为生物信息学数据分析和编程提供完整环境。

核心功能与特性

• 用户界面：集成Jupyter Lab，支持交互式编程和数据分析
• 包管理：通过Miniconda安装conda包管理器，默认激活hms-beagle环境
• 终端工具：包含tmux终端复用器，前缀键修改为Ctrl+A以避免与浏览器/Jupyter快捷键冲突
• 文本编辑：预装Vim编辑器，配置有语法高亮等功能
• R语言支持：集成RStudio Server，支持R语言开发环境
• 系统基础：基于Ubuntu Bionic，包含完整的Ubuntu命令行工具集（无图形界面）

使用场景

• 生物信息学数据分析与处理
• Python/R语言编程环境搭建
• 可复现的生物信息学实验环境
• 远程生物信息学计算与协作

使用方法

运行容器

拉取镜像

从DockerHub拉取HMS Beagle镜像：

bash
sudo docker pull olavurmortensen/hms-beagle:second-voyage

启动容器

部署并运行容器：

bash
sudo docker run -it -p80:80 hms-beagle:second-voyage

从源码构建镜像

下载源码

bash
git clone https://github.com/olavurmortensen/hms-beagle.git

构建镜像

bash
cd hms-beagle
sudo docker build -t hms-beagle .

运行容器

bash
sudo docker run -it -p80:80 hms-beagle

运行tmux

在容器命令行中启动tmux终端复用器：

bash
tmux

运行Jupyter Lab

在容器命令行中启动Jupyter Lab：

bash
jupyter lab

Jupyter Lab服务器将运行在0.0.0.0:80。在浏览器中访问0.0.0.0，并输入命令输出日志中显示的token进行登录。

配置RStudio Server

创建用户

运行容器后，首先创建新用户：

bash
useradd [用户名]

设置密码

为新用户设置密码：

bash
passwd [用户名]

授权工作目录

授予用户对工作目录的访问权限：

bash
chown -R [用户名] [数据/工作目录路径]

启动RStudio Server

bash
rstudio-server start

在浏览器中通过0.0.0.0:80访问RStudio。

镜像详情

构建基础

镜像基于Ubuntu Bionic构建，Dockerfile定义了完整的构建流程，可在Docker Hub上自动构建。镜像包含完整的Ubuntu命令行工具集，但不包含图形用户界面。

配置文件

• bash配置：bashrc_extra文件会追加到容器的.bashrc中，配置bash终端环境
• tmux配置：tmux.conf文件配置tmux终端复用器
• Vim配置：vimrc文件配置Vim编辑器
• Jupyter配置：jupyter_lab_config.py文件配置Jupyter Lab
• conda环境：environment.yml文件定义hms-beagleconda环境

预装软件

Conda

通过Miniconda安装conda包管理器，默认激活hms-beagleconda环境（由environment.yml定义）。

tmux

安装并配置tmux终端复用器，将默认前缀键从Ctrl+B修改为Ctrl+A，避免与浏览器和Jupyter快捷键冲突。

Vim

安装Vim文本编辑器，配置文件提供语法高亮等增强功能。

Jupyter Lab

通过conda环境安装Jupyter Lab，配置参数：

• 绑定IP：0.0.0.0
• 端口：80
• 允许root用户运行：True

安装nb_conda_kernels包，支持在多个conda环境间切换Python内核。

RStudio Server

预装RStudio Server，需通过创建用户并启动服务后使用，访问地址为0.0.0.0:80。