srgmc/gogs

自托管Git服务Docker镜像

镜像概述

本Docker镜像提供了一个零配置、易部署的自托管Git服务解决方案，旨在帮助用户快速搭建私有Git仓库，无需复杂的环境配置，即可实现代码的版本控制与管理。

核心功能与特性

• 一键部署：简化的启动流程，无需手动配置依赖环境
• 完整Git功能：支持标准Git协议（HTTP/HTTPS、SSH）
• Web管理界面：内置直观的Web界面，方便仓库管理与代码浏览
• 数据持久化：支持数据卷挂载，确保仓库数据安全不丢失
• 轻量级设计：优化的镜像体积，资源占用低，适合各种环境部署

使用场景与适用范围

• 个人开发者搭建私有代码仓库
• 小型团队内部代码协作与版本控制
• 对数据隐私有要求，需本地托管代码的场景
• 教学或测试环境中快速部署Git服务

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name git-service \
  -p 80:80 \
  -p 22:22 \
  -v /path/to/local/git/data:/var/git/data \
  your-image-name:latest

Docker Compose配置

yaml
version: '3'
services:
  git-service:
    image: your-image-name:latest
    container_name: git-service
    ports:
      - "80:80"   # Web界面与HTTP协议端口
      - "22:22"   # SSH协议端口
    volumes:
      - /path/to/local/git/data:/var/git/data  # 持久化仓库数据
    restart: unless-stopped

环境变量配置

数据持久化

通过挂载数据卷/var/git/data到本地目录，确保容器重启或升级时仓库数据不丢失：

bash
-v /your/local/path:/var/git/data

访问方式

• Web界面：通过http://<服务器IP>访问，使用初始账号密码登录
• Git克隆：git clone http://<服务器IP>/username/repo.git 或 git clone ssh://git@<服务器IP>:22/username/repo.git

注意事项

• 首次启动后建议立即修改默认管理员密码
• 生产环境中建议配置HTTPS（可通过反向代理实现）
• 确保宿主机端口（80、22）未被其他服务占用，或通过环境变量修改默认端口