CGit

本项目是 alpine-cgit 的分支，后续将独立维护。主仓库托管在 cnb.cool/mmdjiji/cgit，请在该平台提交 Issue 和 Pull Request。GitHub 仅为只读镜像。

English | 简体中文

基于 Alpine 和 Nginx 的超快 Git 仓库 Web 前端。CGit 是一个用 C 编写的 Git 仓库 Web 界面（CGI）。

• 基本仓库浏览（日志、差异、目录树等）
• 生成的 HTML 缓存
• 支持 HTTP 协议克隆
• Commit 订阅（Atom 格式）
• 自动发现 Git 仓库
• 按需生成 tag 和 commit 的归档文件
• 插件支持（如语法高亮）
• 并排差异对比
• 简单的时间/作者统计
• 简单的虚拟主机支持（宏展开）
• 兼容 GitWeb 项目列表
• 识别 Git 配置中的 gitweb.owner
• 支持脚本或内置 Lua 解释器的过滤框架
• 支持 HTTP Basic Auth 鉴权
• 支持 LFS 在线预览
• 丰富的主题支持

docker run -itd --name cgit -p 8787:80 -v $PWD/repos:/srv/git/:ro docker.cnb.cool/mmdjiji/cgit:latest

Dockerfile

FROM docker.cnb.cool/mmdjiji/cgit:latest

以上路径均可通过 Bind Mounts 或 Docker Volumes 覆盖。

用户也可通过页面头部的下拉菜单在运行时切换主题，选择将保存在浏览器中。

同时设置 BASIC_AUTH_USER 和 BASIC_AUTH_PASS 即可启用 HTTP Basic 认证，未设置则不启用。认证覆盖网页浏览和 Git 克隆。

启用后，Git 克隆时需要携带凭据：

git clone https://admin:12345678@your-host/repo-name

通过挂载文件即可替换默认的 Logo 和 Favicon：

volumes:
  - ./logo.png:/usr/share/webapps/cgit/cgit.png:ro
  - ./logo.ico:/usr/share/webapps/cgit/favicon.ico:ro

提示： 建议使用正方形图片。Favicon 通常以 16x16 或 32x32 像素显示，为获得最佳浏览器兼容性，建议将图片转换为 .ico 格式。

默认情况下，镜像使用 cgit.conf 模板文件，启动时替换上述环境变量。

如需使用自定义 /etc/cgitrc：

1. 设置环境变量 USE_CUSTOM_CONFIG=true
2. 挂载自定义配置文件，例如 --volume my-config:/etc/cgitrc
3. 配置文件中需包含 cache-root=/var/cache/cgit
4. 配置文件中需包含 scan-path=/srv/git
5. 挂载仓库目录，例如 --volume my-repos:/srv/git

详细配置项请参阅 cgitrc man page。

本项目托管在 cnb.cool/mmdjiji/cgit，GitHub 仅为只读镜像。请在 CNB 上提交 Pull Request 或创建 Issue。

除非您明确声明另有规定，否则您有意提交以纳入当前作品的任何贡献（如 Apache-2.0 许可证中所定义）将按如下所述进行双重许可，且不附加任何条款或条件。

本项目主要使用 MIT 和 Apache 2.0 双重许可证分发。

• © 2021-2026 Jose Quintana
• © 2026-present JiJi