Ganymede
自托管的 Twitch VOD 与直播存档平台,带实时聊天回放和 Web 管理界面,基于 Docker 部署。
智能下载
前往项目主页
该项目暂未提供安装包,请直接访问源代码仓库
一键存档 Twitch 视频和聊天,随时回看。
核心功能
- 实时聊天回放:同步显示 VOD 或直播时的聊天记录,并可渲染为独立视频
- 自动监控频道:设置关注频道后自动存档新直播或过往 VOD,支持过滤参数
- 完整管理后台:支持频道、用户、存档的增删改查,管理播放列表和进度保存
- 友好文件结构:视频和聊天数据以标准格式存储,不依赖 Ganymede 即可播放
- 自定义处理:支持 FFmpeg 后处理参数、聊天渲染样式、Webhook 通知等
避坑指南
- •存储空间消耗大:建议至少 50GB 空闲空间,直播存档会持续消耗。
- •必须拥有 Twitch 开发者应用:需要到 dev.twitch.tv 注册应用并获取 Client ID 和 Secret。
- •默认密码安全风险:首次登录后务必立即修改默认管理员密码或创建新用户并删除初始账户。
- •中文界面支持有限:前端的翻译文件需要自行添加,默认只有英文。
- •Docker 环境要求:不支持 Windows 原生运行,建议使用 Linux 或 WSL2。
适用场景
- Twitch 主播或观众用于永久保存直播内容及互动聊天
- 内容创作者从 Twitch 下载素材进行二次剪辑,保留弹幕氛围
- 档案爱好者搭建私有视频库,管理多频道历史直播
详细介绍
Ganymede 是一款自托管的 Twitch VOD 与直播存档平台,支持实时聊天回放功能。它提供完整的 Web 管理界面,可用于管理存档、频道和用户,并支持自动监控频道以抓取新内容。所有文件以标准格式存储(视频 + JSON 聊天记录),即使脱离 Ganymede 也能直接播放。高级特性包括 SSO/OAuth 认证、自定义 FFmpeg 后处理参数、Webhook 通知以及可恢复的任务队列。部署仅需两个 Docker 容器(服务端 + Postgres 数据库),要求 Linux 环境和一个 Twitch 应用开发者密钥。项目持续维护,拥有详尽的 Wiki 文档和定期更新。
常见问题与排障 (1)
故障排除运行获取JWKS任务时如何修复'unsupported protocol scheme ""'错误?
发生错误是因为 OAUTH_PROVIDER_URL 环境变量为空或缺少协议方案。请将 OAUTH_PROVIDER_URL 设置为以 http:// 或 https:// 开头的有效 URL(例如 https://sso.example.com)。更新该变量后重新启动容器。
标签
快速上手
安装软件
双击下载的安装程序,按提示完成安装
步骤1:在 Linux 服务器上安装 Docker 和 Docker Compose。
步骤2:从项目 GitHub 下载 docker-compose.yml 文件,并编辑环境变量(数据库信息、Twitch 客户端ID/密钥等)。
步骤3:运行 docker compose up -d 启动服务。
- 步骤1:在 Linux 服务器上安装 Docker 和 Docker Compose。
- 步骤2:从项目 GitHub 下载 docker-compose.yml 文件,并编辑环境变量(数据库信息、Twitch 客户端ID/密钥等)。
- 步骤3:运行 docker compose up -d 启动服务。
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载,并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止容器:docker compose down,删除容器数据目录(默认 /data)。若需彻底清理,还需删除 Docker 镜像和卷。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
1 FAQ