aisflow/code

code-server + ML Dev 自定义Docker镜像

本镜像为基于CUDA的机器学习/数据科学实验提供自定义开发环境，集成code-server、Python生态系统、韩国语Mecab分词工具及多语言编程字体，优化开发流程与环境配置。

镜像概述和主要用途

该镜像专为ML/数据科学开发者设计，提供开箱即用的开发环境，包含：

• 基于CUDA的运行时环境，支持GPU加速计算
• 集成code-server实现浏览器端VS Code体验
• 预配置Python数据科学栈与常用库
• 内置韩国语Mecab分词工具及多语言字体
• 优化的权限管理与环境配置，减少开发障碍

核心功能和特性

使用场景和适用范围

• 机器学习/深度学习模型开发与实验
• 数据科学分析与可视化工作
• 中文/韩文NLP任务开发(含Mecab分词支持)
• 需要远程访问的开发环境
• 团队统一开发环境配置

Mecab符号链接相关说明

部分Python库(如python-mecab-ko)可能要求在系统路径(/usr/local/lib或/usr/lib)中存在Mecab二进制/库的符号链接。由于本容器将Mecab安装于/opt/mecab，需参考相关库的安装脚本或官方文档创建适当链接。

示例：

bash
sudo ln -sf /opt/mecab/bin/mecab /usr/local/bin/mecab

或在Python中直接指定配置：

py
mecab = MeCab.Tagger('-r /opt/mecab/etc/mecabrc -d /opt/mecab/share/mecab-ko-dic')

详细使用方法和配置说明

Docker镜像构建

bash
docker build -t aisflow/code:latest .

容器运行

bash
docker run -d \
  --name code-server \
  -p 8080:8080 \
  -v "$(pwd)":/home/code/project \
  aisflow/code:latest

参数说明：

• -p 8080:8080：code-server访问端口映射
• -v：挂载本地项目目录到容器内/home/code/project(推荐)
• 如需GPU支持，添加--gpus all参数

code-server访问

1. 在浏览器中访问http://<docker_host_ip>:8080
2. 初始密码可在/home/code/.config/code-server/config.yaml中查看
3. 可通过环境变量PASSWORD自定义密码：

   bash
   docker run -d \
     --name code-server \
     -p 8080:8080 \
     -e PASSWORD="your_custom_password" \
     -v "$(pwd)":/home/code/project \
     aisflow/code:latest
   

Python/venv使用方法

• 所有终端(包括VS Code终端)会自动激活/home/code/.venv虚拟环境，无需手动执行source activate
• VS Code已预配置使用/home/code/.venv/bin/python作为默认解释器

字体及可视化环境

• 已安装字体位于/usr/share/fonts/truetype
• matplotlib已配置支持韩语、日语等多语言显示，无需额外设置
• 添加新字体步骤：
  1. 将字体文件复制到/usr/share/fonts/truetype/
  2. 执行fc-cache -f -v更新字体缓存
  3. 如需自定义matplotlib配置，修改~/.config/matplotlib/matplotlibrc

Mecab使用

• Mecab安装路径：/opt/mecab
• 如需配置环境变量：

  sh
  export PATH="/opt/mecab/bin:$PATH"
  export LD_LIBRARY_PATH="/opt/mecab/lib:$LD_LIBRARY_PATH"
  

• Python中使用需安装相关库(如mecab-python3)

已安装的主要Python库

数据科学/机器学习

• pandas==2.2.3、pyarrow、numpy、scipy
• torch、jax、tensorflow
• transformers、datasets、seqeval、scikit-learn

Web/交互式工具

• gradio、dash、streamlit

数据库连接

• psycopg2、pymysql、pymongo、sqlalchemy、elasticsearch-dsl

韩语相关工具

• konlpy、dart-fss、opendartreader

Jupyter/笔记本工具

• jupyterlab、ipympl、jupyterlab-latex、ipydatagrid、jupyterlab-language-pack-ko-KR

性能分析

• line-profiler、memory-profiler

其他参考

• code-server扩展可通过Dockerfile中的EXTENSIONS列表管理
• 权限相关功能(用户/组管理、权限修复)由ENTRYPOINT和启动脚本支持