fabric8/gogs

Gogs (Go Git Service) Docker镜像

最新版本：0.6.1（https://registry.hub.docker.com/u/fabric8/gogs/%EF%BC%89

镜像概述

本镜像运行Gogs服务，提供SSH和Web访问方式。Gogs是一款基于Go语言开发的轻量级Git服务，具备代码仓库管理、用户权限控制、代码审查等功能，适合个人或团队搭建私有Git服务器。

核心功能与特性

灵活的配置方式

• 配置文件挂载：可将自定义配置文件挂载至/opt/gogs/custom/conf/app.ini进行配置
• 环境变量配置：通过环境变量配置所有选项，格式为GOGS_SECTION_NAME__KEY_NAME（双下划线分隔section与key）
• 配置优先级：指定配置文件后环境变量将不生效，配置不进行合并

环境变量配置规则

所有以GOGS_为前缀的环境变量将用于生成/opt/gogs/custom/conf/app.ini文件：

• section名称可选，key名称为必填项
• section与key之间使用双下划线（__）分隔
• 若section名称包含点（.），需替换为下划线（_），例如oauth.google section对应OAUTH_GOOGLE前缀

初始管理员用户创建

支持通过环境变量自动创建初始管理员用户，便于自动化部署：

• ADMIN_USER_CREATE：是否创建管理员用户（默认：true）
• ADMIN_USER_NAME：管理员用户名（默认：gogsadmin）
• ADMIN_USER_PASSWORD：管理员密码（默认：admin123）
• ADMIN_USER_EMAIL：管理员***（默认：gogs@fabric8.local）

配置参考链接

各配置section对应的环境变量前缀及官方文档：

• 无section（前缀：GOGS_*）：全局配置
• Repository section（前缀：GOGS_REPOSITORY__*）：仓库配置
• Server section（前缀：GOGS_SERVER__*）：服务器配置
• Database section（前缀：GOGS_DATABASE__*）：数据库配置
• Security section（前缀：GOGS_SECURITY__*）：安全配置
• Service section（前缀：GOGS_SERVICE__*）：服务配置
• Webhook section（前缀：GOGS_WEBHOOK__*）：Webhook配置
• Mailer section（前缀：GOGS_MAILER__*）：邮件配置
• OAuth section（前缀：GOGS_OAUTH__*）：OAuth配置
• Cache section（前缀：GOGS_CACHE__*）：缓存配置
• Session section（前缀：GOGS_SESSION__*）：会话配置
• Picture section（前缀：GOGS_PICTURE__*）：图片配置
• Log section（前缀：GOGS_LOG__*）：日志配置

使用方法

基本运行命令

bash
docker run -d -p 3000:3000 -p 22:22 --name gogs fabric8/gogs:0.6.1

环境变量配置示例

设置运行用户和数据库参数：

bash
docker run -d -p 3000:3000 -p 22:22 \
  -e GOGS_RUN_USER=git \
  -e GOGS_DATABASE__DB_TYPE=mysql \
  -e GOGS_DATABASE__HOST=mysql:3306 \
  -e GOGS_DATABASE__NAME=gogs \
  -e GOGS_DATABASE__USER=root \
  -e GOGS_DATABASE__PASSWD=password \
  --name gogs fabric8/gogs:0.6.1

配置文件挂载示例

bash
docker run -d -p 3000:3000 -p 22:22 \
  -v /path/to/app.ini:/opt/gogs/custom/conf/app.ini \
  --name gogs fabric8/gogs:0.6.1

自定义管理员用户

bash
docker run -d -p 3000:3000 -p 22:22 \
  -e ADMIN_USER_NAME=admin \
  -e ADMIN_USER_PASSWORD=securepassword \
  -e ADMIN_USER_EMAIL=admin@example.com \
  --name gogs fabric8/gogs:0.6.1

Docker Compose配置示例

yaml
version: '3'
services:
  gogs:
    image: fabric8/gogs:0.6.1
    ports:
      - "3000:3000"
      - "22:22"
    environment:
      - GOGS_RUN_USER=git
      - GOGS_DATABASE__DB_TYPE=mysql
      - GOGS_DATABASE__HOST=mysql:3306
      - GOGS_DATABASE__NAME=gogs
      - GOGS_DATABASE__USER=root
      - GOGS_DATABASE__PASSWD=password
      - ADMIN_USER_NAME=admin
      - ADMIN_USER_PASSWORD=securepassword
      - ADMIN_USER_EMAIL=admin@example.com
    depends_on:
      - mysql
  mysql:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=password
      - MYSQL_DATABASE=gogs

使用场景

• 个人私有Git服务器搭建
• 团队内部代码仓库管理
• CI/CD流程中的代码托管服务
• 开发环境中的本地Git服务测试