b6fan/gogs

Gogs Docker镜像文档

镜像概述

Gogs是一个轻量级自托管Git服务，采用Go语言开发，可通过独立二进制文件在Go支持的所有平台（包括Linux、Mac OS X、Windows及ARM）上运行。其核心目标是提供最简单、快速且低门槛的私有Git服务器搭建方案，适用于个人、小团队及企业内部代码管理。

核心功能与特性

• 多协议支持：SSH、HTTP及HTTPS协议
• 认证方式：支持SMTP、LDAP及反向代理认证
• 代码管理：完整的账户、组织及仓库管理功能
• 协作功能：仓库协作者管理、问题跟踪、拉取请求、Wiki及保护分支
• 自动化集成：仓库Webhook（支持Slack、***等）、Git钩子及部署密钥
• 数据迁移：支持仓库及Wiki的迁移与镜像
• 编辑工具：内置Web编辑器，支持仓库文件及Wiki编辑
• 安全特性：双因素认证、自定义头像源（Gravatar及联邦头像）
• 多数据库支持：兼容MySQL、PostgreSQL、SQLite3、MSSQL及TiDB（通过MySQL协议）
• 国际化：支持25种语言

硬件要求

• 入门级：Raspberry Pi或5***Digital Ocean Droplet（足够（可运行于64MB RAM的Docker环境）
• 团队级：2核CPU + 512MB RAM为基准配置
• 扩展建议：团队规模显著增长时可增加CPU核心，内存占用保持较低水平

浏览器支持

• 基于Semantic UI框架，支持主流浏览器最新版本
• 官方支持的最小分辨率为1024*768，更低分辨率可能存在兼容性问题

安装与使用

Docker部署

基本运行命令

bash
docker run -d --name=gogs -p 3000:3000 -p 2222:22 -v /var/gogs:/data gogs/gogs

• 参数说明：
  • -p 3000:3000：映射Web界面端口
  • -p 2222:22：映射SSH端口（避免与主机SSH冲突）
  • -v /var/gogs:/data：挂载数据卷，持久化存储仓库数据、配置及日志

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  gogs:
    image: gogs/gogs
    container_name: gogs
    ports:
      - "3000:3000"
      - "2222:22"
    volumes:
      - /var/gogs:/data
    restart: always

启动服务：

bash
docker-compose up -d

初始化配置

1. 访问http://<主机IP>:3000进入安装向导
2. 配置数据库（推荐MySQL/PostgreSQL，或使用内置SQLite3）
3. 设置应用基本信息（站点名称、域名、SSH端口等）
4. 创建管理员账户
5. 完成配置后重启容器

支持的软件与服务集成

• CI/CD：Drone、Jenkins
• DevOps：Fabric8
• 项目管理：Taiga、Kanboard
• 团队沟通：BearyChat、HiWork
• 演示工具：GitPitch
• 平台支持：Synology（Docker）、One Space（应用商店）

许可证

Gogs项目采用MIT许可证，详见https://github.com/gogits/gogs/blob/master/LICENSE%E3%80%82