cutekk/gogs

Gogs (ARM架构) Docker镜像文档

镜像概述

本镜像为适用于ARM架构的Gogs自助Git服务容器化部署方案。Gogs是一款轻量级、易部署的自助Git服务，旨在提供简单、高效的Git仓库管理功能，支持团队协作与代码版本控制。通过Docker容器化部署，可快速搭建稳定的私有Git服务器。

核心功能与特性

• 轻量级设计：资源占用低，适合ARM架构设备部署
• 完整Git功能：支持仓库创建、分支管理、提交历史、代码审查等核心Git操作
• 用户与权限管理：提供用户注册、组织管理及细粒度权限控制
• 多协议支持：支持HTTP/HTTPS及SSH协议访问仓库
• 数据持久化：通过数据卷挂载确保仓库数据与配置持久保存

使用场景

• 个人开发者搭建私有代码仓库
• 小型团队内部代码协作与版本控制
• ARM架构设备（如树莓派）上部署本地化Git服务
• 对资源占用有严格要求的轻量化Git服务场景

使用方法

快速部署

通过以下命令快速启动Gogs服务：

bash
docker run -d --restart=always --name=gogs -p 10022:22 -p 10080:3000 -v $PWD/data:/data cutekk/gogs

参数说明：

• -d：后台运行容器
• --restart=always：容器退出时自动重启
• --name=gogs：指定容器名称为"gogs"
• -p 10022:22：将容器内SSH端口(22)映射到主机***端口
• -p 10080:3000：将容器内HTTP端口(3000)映射到主机***端口
• -v $PWD/data:/data：挂载主机当前目录下的data文件夹到容器内/data目录，用于持久化数据

访问服务

部署完成后，通过浏览器访问 http://<主机IP>:10080 进入Gogs初始化配置页面。

配置说明

初始化配置页面中，部分设置需特别注意（容器环境特有）：

仓库根路径（Repository Root Path）

• 默认值：/home/git/gogs-repositories
• 说明：保持默认值，start.sh脚本已创建符号链接确保数据正确存储到挂载的/data目录

运行用户（Run User）

• 默认值：git
• 说明：保持默认值，build.sh已预先创建git用户，确保服务权限正确

域名（Domain）

• 配置值：
  • 仅本地访问：填写Docker容器IP（如192.168.99.100）
  • 跨物理机访问：填写Docker主机的hostname或IP地址

SSH端口（SSH Port）

• 配置值：使用Docker暴露的主机端口
• 示例：容器内SSH服务监听22端口，通过-p 10022:22映射到主机，则此处填写10022
• 注意：不推荐在Docker容器内使用内置SSH服务器

HTTP端口（HTTP Port）

• 配置值：使用容器内Gogs监听端口（默认3000）
• 说明：即使通过-p 10080:3000映射到主机其他端口，此处仍填写3000

应用URL（Application URL）

• 配置值：组合域名与暴露的HTTP端口
• 示例：http://192.168.99.100:10080/（格式为http://<Domain>:<暴露的HTTP端口>/）

完整配置文档

更多应用设置详情请参考Gogs官方配置指南。