csmax/gource
csmax
这是一个Docker化的Gource可视化工具，无需GPU即可生成Git仓库开发历史的高分辨率视频，支持自定义配置、多种模板及头像展示，适用于展示项目演进过程。
下载次数: 0状态：社区镜像维护者：csmax仓库类型：镜像最近更新：6 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Envisaged - Docker化的Gource可视化工具
https://img.shields.io/docker/automated/utensils/envisaged.svg](https://hub.docker.com/r/utensils/envisaged/) https://img.shields.io/docker/pulls/utensils/envisaged.svg](https://hub.docker.com/r/utensils/envisaged/) https://img.shields.io/docker/stars/utensils/envisaged.svg](https://hub.docker.com/r/utensils/envisaged/) https://images.microbadger.com/badges/image/utensils/envisaged.svg](https://microbadger.com/images/utensils/envisaged "Get your own image badge on microbadger.com") https://images.microbadger.com/badges/version/utensils/envisaged.svg](https://microbadger.com/images/utensils/envisaged "Get your own version badge on microbadger.com")
基于 https://github.com/utensils/docker-opengl（Alpine 3.10）构建。无需GPU，可在任何机器上运行，如标准EC2实例或其他VPS。
镜像概述
该工具通过Gource程序、FFmpeg和h.264编解码器，生成Git仓库开发历史的高分辨率（最高4K 60fps）视频可视化。容器采用无头运行模式，结合Xvfb和Mesa 3D Gallium llvmpipe驱动，无需实际GPU，且不会占用大量磁盘空间。通过命名管道同时运行Gource模拟和FFmpeg编码，易于在AWS等环境部署。支持“border”模板（添加边框并隔离日期和关键信息）或“none”模板（默认Gource输出）。
核心功能
- 生成Git仓库开发历史的动态视频可视化
- 支持最高4K 60fps的高分辨率输出
- 无头运行，无需GPU，适配各类环境
- 提供模板自定义视频外观
- 支持添加项目Logo和作者头像
- 通过HTTP交付生成的视频
- 可合并多个仓库进行统一可视化
使用场景
- 展示开源项目的演进过程
- 团队内部项目开发历程回顾
- 技术分享或演示中的项目可视化素材
- 分析代码提交模式和团队协作情况
部署示例
示例1：生成Kubernetes仓库可视化（含Logo）
shelldocker run --rm -p 8080:80 --name envisaged \ -e GIT_URL=https://github.com/kubernetes/kubernetes.git \ -e LOGO_URL=https://raw.githubusercontent.com/kubernetes/kubernetes/master/logo/logo.png \ -e GOURCE_TITLE="Kubernetes开发历程" \ csmax/gource
示例2：本地Git仓库可视化
shelldocker run --rm -p 8080:80 --name envisaged \ -v /本地仓库路径:/visualization/git_repo:ro \ -e GOURCE_TITLE="你的项目开发历程" \ csmax/gource
示例3：多仓库合并可视化
shelldocker run --rm -p 8080:80 --name envisaged \ -v /多个仓库所在目录:/visualization/git_repos:ro \ -e GOURCE_TITLE="多项目合并可视化" \ csmax/gource
示例4：添加作者头像
shelldocker run --rm -p 8080:80 --name envisaged \ -v /本地仓库路径:/visualization/git_repo:ro \ -v /头像目录:/visualization/avatars:ro \ -e GOURCE_TITLE="带作者头像的项目可视化" \ csmax/gource
（头像文件名需与作者ID匹配，如utensils.gif）
生成完成后，访问 http://localhost:8080/ 即可获取视频链接。
配置说明
| 变量名 | 默认值 | 描述 |
|---|---|---|
GIT_URL | <Docker仓库的GitHub地址> | 需克隆和分析的Git仓库URL |
LOGO_URL | <Docker Logo> | 视频右下角覆盖显示的Logo URL |
H264_PRESET | medium | h.264编码预设，参考https://trac.ffmpeg.org/wiki/Encode/H.264 |
H264_CRF | 23 | h.264编码的恒定速率因子（CRF），参考https://trac.ffmpeg.org/wiki/Encode/H.264 |
H264_LEVEL | 5.1 | h.264编码级别，参考https://trac.ffmpeg.org/wiki/Encode/H.264 |
VIDEO_RESOLUTION | 1080p | 输出视频分辨率，可选值：2160p、1440p、1080p、720p |
GOURCE_FPS | 60 | 输出视频帧率 |
TEMPLATE | border | 模板脚本，可选值：border（带边框）、none（无模板） |
GOURCE_TITLE | Software Development | 视频左下角显示的标题 |
OVERLAY_FONT_COLOR | 0f5ca8 | 覆盖层（仅日期）的字体颜色（十六进制） |
GOURCE_CAMERA_MODE | overview | 相机模式：overview（概览）、track（跟踪） |
GOURCE_SECONDS_PER_DAY | 0.1 | 模拟速度（每秒对应天数） |
GOURCE_TIME_SCALE | 1.5 | 模拟时间缩放因子 |
GOURCE_USER_SCALE | 1.5 | 用户头像缩放因子 |
GOURCE_AUTO_SKIP_SECONDS | 0.5 | 无操作时自动跳过的秒数 |
GOURCE_BACKGROUND_COLOR | 000000 | 背景颜色（十六进制） |
GOURCE_HIDE_ITEMS | usernames,mouse,date,filenames | 隐藏的显示元素（多个用逗号分隔） |
GOURCE_DIR_DEPTH | 3 | 显示目录名称的深度 |
GOURCE_FILENAME_TIME | 2 | 文件名在屏幕上保留的时间（≥2.0秒） |
GOURCE_MAX_USER_SPEED | 500 | 用户每秒最大移动速度 |
INVERT_COLORS | false | 是否反转可视化颜色 |
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull csmax/gource:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"