woahbase/alpine-cgit

alpine-cgit## 镜像概述

alpine-cgit是一个多架构Docker镜像，基于Alpine Linux构建，集成S6进程管理、cGit（Git仓库Web前端）和SSHD服务，专为网络本地Git仓库管理设计。该镜像提供轻量级、高效的解决方案，适用于在本地网络环境中搭建和维护Git仓库。

核心功能与特性### 多架构支持

• 支持多种硬件架构，包括x86_64、aarch64、armv7l、armhf、i386、ppc64le、riscv64、s390x等，适配不同设备需求。

轻量级基础

• 基于Alpine Linux，镜像体积小，资源占用低，启动速度快。

完整组件集成

• S6进程管理：提供可靠的服务进程监控与管理，确保cGit和SSHD服务稳定运行。
• cGit：Git仓库Web前端，支持通过浏览器浏览仓库、查看提交历史、文件内容等。
• SSHD：支持SSH协议访问Git仓库，实现安全的远程仓库操作（如clone、push、pull）。

使用场景

• 本地网络Git仓库：适用于小型开发团队在局域网内搭建内部代码仓库，实现代码共享与版本控制。
• 个人代码管理：个人用户在本地网络中管理多个Git项目，通过Web界面便捷浏览，通过SSH进行仓库操作。
• 局域网资源共享：作为局域网内的代码资源节点，提供轻量级、易部署的Git服务。

使用方法与配置说明### 基本运行命令

通过以下命令快速启动镜像，默认映射Web端口（80）和SSH端口（22），并挂载本地目录存储仓库数据：

bash
docker run -d \
  --name alpine-cgit \
  -p 80:80 \
  -p 22:22 \
  -v /path/to/local/git/repos:/var/lib/git \
  woahbase/alpine-cgit:x86_64

注：根据实际架构替换标签（如aarch64、armv7l等）。

数据持久化

• Git仓库目录：推荐将/var/lib/git目录挂载到宿主机本地路径（如/path/to/local/git/repos），确保仓库数据持久化。
• 配置文件：如需自定义cGit或SSHD配置，可挂载配置目录：

  bash
  -v /path/to/cgit/config:/etc/cgit \
  -v /path/to/sshd/config:/etc/ssh
  

访问方式

• Web界面：通过浏览器访问http://<宿主机IP>，即可通过cGit界面浏览仓库。
• SSH访问：使用Git客户端通过SSH协议访问仓库，例如：

  bash
  git clone ssh://git@<宿主机IP>/var/lib/git/your-repo.git
  

注意事项

• 首次运行时，镜像会自动初始化基础环境，建议提前在挂载的仓库目录中准备Git仓库（或通过SSH上传初始化）。
• 如需修改SSH访问权限（如添加用户密钥），可通过挂载/etc/ssh/authorized_keys文件实现。