jellydeck/moocup

视觉截图编辑器 Docker 镜像文档

镜像概述

该Docker镜像封装了一款轻量级视觉编辑器，专注于提供便捷的截图创建与美化功能。通过容器化部署，用户可快速获得完整的截图编辑环境，无需复杂的本地软件配置，适用于各类需要高质量截图的场景。

核心功能与特性

• 直观图形界面：提供简洁易用的可视化操作界面，零技术门槛即可上手
• 全面编辑工具集：包含截图裁剪、尺寸调整、文字标注（支持多种字体与样式）、图形标注（箭头、矩形、圆形等）、滤镜效果（亮度、对比度、饱和度调节）
• 多格式导出：支持PNG、JPG、WebP等主流图片格式导出，满足不同场景需求
• 轻量化设计：容器体积小，资源占用低，启动速度快，兼容各类Docker运行环境
• 跨平台访问：通过浏览器即可访问编辑界面，支持Windows、Linux、macOS等系统

使用场景与适用范围

• 内容创作：博客作者、自媒体运营者制作教程截图、文章配图
• 软件开发：开发者为API文档、用户手册或bug报告创建标注清晰的界面截图
• 教学培训：教师制作教学课件中的步骤说明截图，提升教学直观性
• 设计预览：设计师快速编辑和导出设计稿截图，用于初步展示与沟通

使用方法与配置说明

1. 前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 网络环境可访问Docker镜像仓库（如使用私有仓库需配置访问权限）

2. 获取镜像

从Docker仓库拉取镜像（请替换<image-name>为实际镜像名称）：

bash
docker pull <image-name>

3. 启动容器

基础启动命令

bash
docker run -d \
  --name screenshot-editor \
  -p 8080:80 \
  <image-name>

• 参数说明：
  • -d：后台运行容器
  • --name screenshot-editor：指定容器名称，便于后续管理
  • -p 8080:80：端口映射，将容器内80端口映射到主机8080端口（可根据需要修改主机端口）

带数据持久化的启动（推荐）

如需保存编辑项目和导出文件，可挂载本地目录：

bash
docker run -d \
  --name screenshot-editor \
  -p 8080:80 \
  -v /本地保存路径:/app/workspace \
  <image-name>

• /本地保存路径：替换为本地用于存储项目文件的绝对路径，如/home/user/screenshot-data

4. 访问编辑器

容器启动后，在浏览器中访问：
http://<主机IP或localhost>:8080
即可打开视觉编辑器界面，开始截图创建与编辑工作。

5. 容器管理

• 停止容器：docker stop screenshot-editor
• 启动容器：docker start screenshot-editor
• 删除容器：docker rm -f screenshot-editor（需先停止容器）

注意事项

• 如遇端口冲突，可修改-p参数中的主机端口（如-p 8081:80使用8081端口）
• 持久化目录需确保本地有读写权限，避免文件保存失败
• 镜像默认配置适用于大多数场景，如需自定义配置（如语言、默认导出格式），请参考镜像官方文档获取环境变量参数说明