hoperj/quickstart

镜像介绍

本Docker镜像旨在为深度学习初学者提供便捷的开发环境，省去复杂的软件配置过程。所有版本均预装sudo、pip、conda、wget、curl、vim等常用工具，并配置了pip和conda的国内镜像源以加快下载速度。此外，集成了zsh及命令自动补全、语法高亮、目录跳转工具z等实用插件，预装jupyter notebook和jupyter lab并将默认终端设为zsh，优化了容器内中文显示避免乱码，还预配置了Hugging Face国内镜像地址。

更新记录

2024.12.2：关闭oh-my-zsh自动更新提示

版本说明

• base版本：基于pytorch/pytorch:2.5.1-cuda11.8-cudnn9-devel，占用15.5GB存储空间，默认Python版本3.11.10，可通过conda install python==版本号修改。
• dl版本：在base版本基础上额外安装深度学习框架和常用工具，占用19.3GB存储空间，具体内容见安装清单。

使用说明

base版本启动命令

bash
docker run --gpus all -it --name <替换为容器名称> docker.xuanyuan.run/hoperj/quickstart:base-torch2.5.1-cuda11.8-cudnn9-devel /bin/zsh

dl版本启动命令

bash
docker run --gpus all -it --name <替换为容器名称> docker.xuanyuan.run/hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel /bin/zsh

再次运行容器

bash
docker start <容器名称>
docker exec -it <容器名称> /bin/zsh

更新镜像

base版本更新

bash
docker pull docker.xuanyuan.run/hoperj/quickstart:base-torch2.5.1-cuda11.8-cudnn9-devel

dl版本更新

bash
docker pull docker.xuanyuan.run/hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel

直接使用主机网络

容器直接使用主机网络配置，无需单独映射端口。若需映射指定端口，将--network host替换为-p port:port。

bash
docker run --gpus all -it --name ai --network host docker.xuanyuan.run/hoperj/quickstart:dl-torch2.5.1-cudnn9-devel /bin/zsh

设置代理

如需使用代理，可通过-e设置环境变量（假设HTTP/HTTPS端口7890，SOCKS5端口7891）：

bash
docker run --gpus all -it \
  --name ai \
  --network host \
  -e http_proxy=http://127.0.0.1:7890 \
  -e https_proxy=http://127.0.0.1:7890 \
  -e all_proxy=socks5://127.0.0.1:7891 \
  docker.xuanyuan.run/hoperj/quickstart:dl-torch2.5.1-cudnn9-devel \
  /bin/zsh

常用操作提示

• 启动容器：docker start <容器名>
• 进入容器：docker exec -it <容器名> /bin/zsh（退出用Ctrl+D或exit）
• 停止容器：docker stop <容器名>
• 删除容器：docker rm <容器名>

安装清单

手动安装额外库

如需安装其他库，可使用以下命令（设置120秒超时避免下载失败）：

bash
pip install --timeout 120 <库名>