saracen9/coder

saracen9/coder

镜像概述和主要用途

saracen9/coder是一个基于https://github.com/cdr/code-server%E7%9A%84%E5%AE%9A%E5%88%B6%E5%8C%96Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%8F%AF%E5%9C%A8Web%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%AD%E8%BF%90%E8%A1%8C%E7%9A%84VS Code IDE环境。该镜像专为在iPad Pro等设备上进行开发设计，支持包含Python和Vue在内的通用技术栈。

核心功能和特性

开发环境配置

• Python环境：通过Pyenv配置Python 3.9（稳定版3.9.11）和3.10（最新版）
• 字体支持：VS Code中配置FiraCode字体及连字功能
• Shell环境：Zsh作为主要shell，集成Oh-My-Zsh，包含：
  • Starship主题
  • 自动建议功能
  • 语法高亮

预安装VS Code扩展

• 核心开发扩展：
  • Python
  • Docker
  • Jupyter
  • Vetur（Vue 3支持）
• 其他实用扩展：
  • Auto Close Tag
  • Auto Rename Tag
  • Better Comments
  • Code Spell Checker
  • Colorize
  • Community Material Theme
  • DotENV
  • GitLens
  • Live Server
  • Markdown All in One
  • Markdown Preview Enhanced
  • Markdown Table Prettifier
  • Markdown Lint
  • Material Theme
  • Material Theme Icons
  • Path Intellisense
  • Peacock
  • Prettier
  • Settings Sync
  • SQLTools（含MySQL/MariaDB、MS SQL、PostgreSQL、SQLite驱动）
  • TODO Highlight
  • TODO Tree

使用场景和适用范围

• 在iPad Pro等移动设备上进行代码开发
• 需要通过Web浏览器访问VS Code IDE的场景
• Python和Vue技术栈的开发工作
• 需要统一开发环境配置的团队或个人使用

使用方法和配置说明

基本运行命令

以下命令将启动code-server容器，暴露在[***]

bash
# 创建配置目录
mkdir -p ~/.config

# 启动容器
docker run -it --name code-server -p 127.0.0.1:8080:8080 \
  -v "$HOME/.config:/home/coder/.config" \
  -v "$PWD:/home/coder/project" \
  -u "$(id -u):$(id -g)" \
  -e "DOCKER_USER=$USER" \
  -e PASSWORD=mypassword \
saracen9/coder --cert

参数说明：

• -p 127.0.0.1:8080:8080：将容器的8080端口映射到本地8080端口
• -v "$HOME/.config:/home/coder/.config"：挂载本地配置目录，确保code-server配置可在容器外访问/修改
• -v "$PWD:/home/coder/project"：将当前目录挂载为容器内的项目目录
• -u "$(id -u):$(id -g)"：设置容器内用户ID/组ID，确保文件系统操作与宿主机用户一致
• -e "DOCKER_USER=$USER"：设置Docker用户环境变量
• -e PASSWORD=mypassword：设置访问密码
• --cert：启用HTTPS（自签名证书）

带Docker守护进程访问的运行命令

如需在VS Code终端中使用Docker命令（如构建镜像），可挂载宿主机Docker守护进程：

bash
mkdir -p ~/.config
docker run -it --name code-server -p 127.0.0.1:8080:8080 \
  -v "$HOME/.config:/home/coder/.config" \
  -v "$PWD:/home/coder/project" \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /usr/bin/docker:/usr/bin/docker \
  -u "$(id -u):$(id -g)" \
  -e "DOCKER_USER=$USER" \
  -e PASSWORD=mypassword \
saracen9/coder --cert

注意：挂载Docker守护进程存在安全风险，请确保了解相关安全影响。

证书注意事项

为确保扩展功能（如需要服务工作器的功能）和远程资源加载正常，建议使用浏览器信任的证书（如Let's Encrypt）。自签名证书可能导致部分功能受限。

开发路线图

以下是计划实现但尚未完成的功能：

• 语言支持
  • Python 3
  • Vue 3（JavaScript）
    • Vue 3
    • Vite（构建和开发服务器）
    • Vitest（测试）
    • Pinia（状态管理）
    • Tailwind CSS
• 支持在IDE内使用Docker进行构建
• 安装适当的VS Code扩展
• 通过环境变量设置git配置

参考资料

• https://github.com/cdr/code-server
• 如何使用Code-server在VPS上托管VS Code