rockstorm/gitweb

GitWeb Docker镜像

轻量级Docker镜像，包含Nginx Web服务器，用于通过https://git-scm.com/book/zh/v2/在服务器上的-Git-GitWeb可视化git仓库，并通过HTTP提供只读访问。

镜像源码：https://github.com/rockstorm101/gitweb-docker

基本使用场景

bash
docker run -v /path/to/repos:/srv/git:ro -p 80:80 docker.xuanyuan.run/rockstorm/gitweb

您的仓库将可在http://localhost查看。

您可以像这样克隆/获取/拉取仓库：

bash
git clone http://localhost/your-repo.git

自定义配置

提供的nginx.conf和gitweb.conf文件分别是Nginx Web服务器和https://git-scm.com/book/zh/v2/在服务器上的-Git-GitWeb（仓库可视化工具）的默认配置。要覆盖这些配置，只需将自定义文件挂载到以下位置：

yaml
services:
  gitweb:
    ...
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
      - ./gitweb.conf:/etc/gitweb.conf:ro

默认提供了非常基础的Nginx配置。有关更高级的配置选项，请参考Nginx官方文档。

应用主题

要为GitWeb应用主题（如Stefan的https://github.com/kogakure/gitweb-theme）：

1. 将主题文件挂载到某个位置：

   yaml
   services:
     gitweb:
     ...
       volumes:
         - /path/to/theme/folder:/usr/share/gitweb/theme:ro
   

2. 在您的gitweb.conf文件中添加相关行：

   our @stylesheets = "theme/gitweb.css";
   our $logo = "theme/git-logo.png";
   our $favicon = "theme/git-favicon.png";
   

标签和变体

此镜像使用基于Alpine的Nginx稳定版Docker镜像。

• 'X.Y-bZ'：不可变标签。指向特定的镜像构建，不会重复使用。

• 'X.Y'：特定Git主版本和次版本的稳定标签。它跟踪Git版本X.Y的最新构建，因此会在每次补丁更新（如1.2.3到1.2.4）、Nginx变更或基础Alpine镜像变更时更新。

• 'latest'：此标签跟踪最新构建，不考虑任何主/次版本。

许可证

查看https://github.com/rockstorm101/gitweb-docker/blob/master/LICENSE了解此镜像中包含的软件。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（如基础发行版中的git等，以及包含的主要软件的任何直接或间接依赖项）。

对于任何预构建镜像的使用，镜像用户有责任确保对此镜像的任何使用都符合其中包含的所有软件的相关许可证。

致谢

此镜像深受Kostya的https://github.com/KostyaEsmukov/docker-gitweb-readonly启发，但更简单、更轻量。

GitWeb配置提示感谢https://wiki.archlinux.org/title/gitweb#Nginx。