chruth/alpine-cgit-gitolite

alpine-cgit-gitolite Docker镜像

概述

alpine-cgit-gitolite是一个轻量级Docker镜像，基于Alpine Linux构建，整合了cgit、Gitolite和lighttpd，提供完整的自托管Git服务器解决方案。该镜像将Git仓库管理、Web界面浏览和访问控制功能集于一体，适合个人或小型团队快速部署私有Git服务。

核心功能和特性

• 轻量级设计：基于Alpine Linux，镜像体积小，资源占用低
• 完整Git服务：集成Gitolite，提供强大的Git仓库管理和访问控制
• Web界面：包含cgit Web界面，可通过浏览器浏览Git仓库内容
• 多协议支持：同时支持HTTP和SSH协议访问Git仓库
• 数据持久化：支持外部卷挂载，确保Git数据持久化存储
• 简单配置：提供直观的配置方式，便于快速设置和自定义

使用场景和适用范围

• 个人开发者需要自托管Git仓库
• 小型团队内部代码管理和版本控制
• 需要私有Git服务但不想依赖第三方托管服务的场景
• 资源受限环境下部署Git服务器
• 开发或测试环境中快速搭建临时Git服务

使用方法和配置说明

基本部署

使用以下命令快速启动容器：

bash
docker run -d -p 22:22 -p 80:80 --name git-server chruth/alpine-cgit-gitolite

持久化数据

为确保数据不会因容器重启而丢失，建议挂载数据卷：

bash
docker run -d \
  -p 22:22 \
  -p 80:80 \
  -v /path/to/gitolite-data:/git \
  -v /path/to/ssh-host-keys:/etc/ssh/host_keys \
  --name git-server \
  chruth/alpine-cgit-gitolite

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  git-server:
    image: chruth/alpine-cgit-gitolite
    ports:
      - "2222:22"   # SSH端口
      - "8080:80"   # HTTP端口
    volumes:
      - gitolite-data:/git
      - ssh-host-keys:/etc/ssh/host_keys
    restart: unless-stopped

volumes:
  gitolite-data:
  ssh-host-keys:

启动服务：

bash
docker-compose up -d

初始配置

1. 获取管理员SSH公钥：

bash
docker exec git-server cat /git/admin.pub

2. 将公钥添加到本地SSH配置：

bash
mkdir -p ~/.ssh
docker exec git-server cat /git/admin.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

3. 克隆Gitolite管理仓库进行配置：

bash
git clone ssh://git@localhost:2222/gitolite-admin.git

配置cgit

cgit配置文件位于容器内的/etc/cgitrc，可通过卷挂载自定义配置：

bash
docker run -d \
  -p 22:22 -p 80:80 \
  -v /path/to/your/cgitrc:/etc/cgitrc \
  -v gitolite-data:/git \
  --name git-server \
  chruth/alpine-cgit-gitolite

环境变量

访问服务

• Web界面：通过浏览器访问 http://localhost:8080
• SSH访问：git clone ssh://git@localhost:2222/your-repo.git
• HTTP访问：git clone http://localhost:8080/your-repo.git

管理仓库

1. 添加新仓库：编辑Gitolite管理仓库中的conf/gitolite.conf文件
2. 添加用户：将用户公钥添加到keydir/目录下，然后提交更改
3. 应用配置：提交并推送Gitolite管理仓库的更改

bash
cd gitolite-admin
# 编辑配置文件
git add .
git commit -m "Add new repository or user"
git push origin master