knight1988/gogs

Gogs 镜像文档

镜像概述

Gogs是一款轻量级自助Git服务，采用Go语言开发，具有体积小、资源占用低的特点。本镜像提供Gogs服务的容器化部署，便于快速搭建私有Git服务器，支持代码仓库管理、版本控制、用户权限管理及协作开发等核心功能。

核心功能与特性

• 轻量级架构：资源占用低，适合在低配置服务器或资源有限环境部署
• 完整Git功能：支持仓库创建、克隆、提交、分支管理等Git核心操作
• 用户权限管理：提供用户注册、角色分配及仓库访问权限控制
• 数据持久化：支持通过卷挂载实现数据备份与持久化存储
• Web管理界面：内置直观的Web界面，简化服务配置与日常操作

使用场景与适用范围

• 个人开发者搭建私有代码仓库
• 小型团队内部协作开发，管理代码版本
• 企业内部部署私有Git服务，保障代码数据安全
• 资源受限环境（如个人服务器、小型VPS）部署Git服务

使用方法与配置说明

基本部署命令

通过以下命令快速启动Gogs容器：

bash
docker run --name=gogs -p 3000:3000 -v /d/Docker/Volumes/backup:/backup knight1988/gogs

参数说明：

• --name=gogs：指定容器名称为"gogs"，便于识别和管理
• -p 3000:3000：端口映射，将主机3000端口映射到容器3000端口（Gogs默认Web访问端口）
• -v /d/Docker/Volumes/backup:/backup：卷挂载，将主机备份目录挂载到容器/backup目录，用于数据备份
• knight1988/gogs：使用的Docker镜像名称

访问与初始化配置

容器启动后，通过浏览器访问 http://<主机IP>:3000 进入Gogs初始化页面，根据引导完成以下配置：

1. 数据库设置（支持SQLite、MySQL、PostgreSQL等）
2. 管理员账户创建
3. 基础服务配置（如站点名称、URL等）

数据持久化优化

为确保仓库数据持久化，建议额外挂载Gogs数据目录（默认容器内路径为/data），修改部署命令如下：

bash
docker run --name=gogs -d -p 3000:3000 \
  -v /path/to/gogs/data:/data \
  -v /path/to/backup:/backup \
  knight1988/gogs

其中：

• /path/to/gogs/data：主机用于存储Gogs核心数据（仓库、配置等）的目录
• -d：后台运行容器

注意事项

• 首次启动需完成Web初始化配置，建议提前准备数据库（如使用MySQL需预先创建数据库）
• 生产环境中建议配置持久化卷，避免容器删除导致数据丢失
• 根据实际需求调整端口映射（如主机3000端口被占用，可修改为其他端口，如-p 8080:3000）