ahj0/fairy-band

fairy-band Docker镜像文档

概述

fairy-band是一款轻量级Docker镜像，旨在为开发者提供开箱即用的开发环境，集成常用开发工具、运行时环境及依赖管理系统。该镜像通过标准化环境配置，解决跨平台开发中的"环境不一致"问题，帮助团队快速统一开发环境，提升协作效率。

核心功能与特性

• 环境标准化：预配置常用开发工具链，确保团队成员使用一致的开发环境
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低，启动速度快
• 多语言支持：集成多种编程语言运行时（如Node.js、Python等）及包管理工具
• 灵活扩展：支持通过环境变量和配置文件自定义开发环境参数
• 即开即用：无需复杂配置，拉取镜像后可直接启动开发环境

使用场景

• 个人开发者快速搭建项目开发环境
• 团队协作中统一开发环境配置
• 教学或演示环境的快速部署
• CI/CD流程中的开发环境容器化
• 多项目并行开发时的环境隔离

使用方法

基本使用

通过以下命令快速启动fairy-band开发环境：

bash
docker run -it --rm -v $(pwd):/workspace -w /workspace docker.xuanyuan.run/fairy-band

参数说明：

• -it：以交互模式运行并分配终端
• --rm：容器退出后自动删除
• -v $(pwd):/workspace：将当前目录挂载到容器内的/workspace工作目录
• -w /workspace：设置容器工作目录为/workspace

指定运行时环境

通过环境变量选择特定编程语言运行时：

bash
docker run -it --rm -e RUNTIME=node -v $(pwd):/workspace -w /workspace docker.xuanyuan.run/fairy-band

支持的运行时环境：

• node：Node.js环境（默认）
• python：Python环境
• java：Java开发环境
• go：Go开发环境

docker-compose配置示例

创建docker-compose.yml文件实现更复杂的开发环境配置：

yaml
version: '3.8'
services:
  dev-env:
    image: docker.xuanyuan.run/fairy-band
    volumes:
      - ./project:/workspace
    environment:
      - RUNTIME=node
      - NODE_VERSION=18
      - NPM_REGISTRY=https://registry.npm.taobao.org
    ports:
      - "3000:3000"
    working_dir: /workspace
    command: npm run dev

启动服务：

bash
docker-compose up -d

环境变量配置

注意事项

• 首次使用时镜像会自动拉取指定版本的运行时环境，可能需要较长时间
• 生产环境部署请使用对应语言的官方精简镜像，本镜像主要用于开发环境
• 挂载本地目录时注意文件权限问题，可通过添加-u $(id -u):$(id -g)参数解决权限冲突
• 如需持久化配置，可将配置文件挂载到容器内的/etc/fairy-band目录

常见问题

Q: 如何更换默认的包管理源？
A: 通过设置对应环境变量（如NPM_REGISTRY、PIP_INDEX_URL）指定镜像源

Q: 容器内无法访问本地网络服务怎么办？
A: 使用--network=host参数或添加--add-host=host.docker.internal:host-gateway参数

Q: 如何保存容器内的配置更改？
A: 建议通过Dockerfile基于fairy-band构建自定义镜像，或挂载配置目录进行持久化