luminize/gogs

Gogs - Go Git Service Docker镜像

镜像概述

Gogs是一个基于Go语言开发的自托管Git服务，旨在提供最简单、快速且无痛苦的方式搭建私有Git服务器。通过Docker镜像，用户可以轻松部署和运行Gogs，无需复杂的环境配置，支持Linux、Mac OS X、Windows及ARM等多种平台。

核心功能与特性

• 多协议支持：SSH和HTTP/HTTPS协议
• 认证方式：SMTP、LDAP及反向代理认证
• 全面的管理功能：账户、组织、仓库管理
• 协作工具：仓库问题(Issues)、拉取请求(Pull Requests)和维基(Wiki)
• 自动化集成：仓库/组织Webhook（支持Slack）、Git钩子和部署密钥
• 多数据库支持：MySQL、PostgreSQL、SQLite3及TiDB（实验性）
• 多语言支持：18种语言界面
• 个性化功能：Gravatar头像、自定义头像源、邮件服务
• 管理面板：完整的管理员功能界面

使用场景与适用范围

• 个人开发者：搭建个人私有代码仓库，管理项目版本
• 小型团队：团队内部协作开发，共享代码和文档
• 企业环境：部署内部Git服务，保障代码安全和隐私
• 资源受限环境：低配置设备（如树莓派）也可运行基础功能

系统要求

• 最低配置：树莓派级设备即可满足基础功能需求
• 推荐配置：2核CPU、1GB内存（适用于团队协作场景）

浏览器支持

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

使用方法

Docker快速部署

基本运行命令

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

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

Docker Compose配置示例

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

配置说明

1. 首次访问http://<主机IP>:3000，进入安装向导
2. 数据库配置：选择MySQL、PostgreSQL或SQLite3
3. 应用基本设置：设置站点名称、仓库根目录、运行用户等
4. 服务器和其他服务设置：配置域名、SSH端口、邮件服务等

数据持久化

通过-v /var/gogs:/data挂载的数据卷包含以下内容：

• 仓库数据
• 用户上传的头像
• 配置文件
• 日志文件

相关资源

• 官方文档
• https://github.com/gogits/gogs/tree/master/docker
• 问题排查
• 用户论坛

许可证

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