etcet/gogs

Gogs - Go Git Service

!https://github.com/gogits/gogs/blob/master/public/img/gogs-large-resize.png?raw=true

镜像概述和主要用途

Gogs（Go Git Service）是一个轻量级自托管Git服务，其核心目标是提供最简单、快速且无痛苦的方式搭建私有Git服务器。通过Go语言开发，Gogs可作为独立二进制分发，支持Linux、Mac OS X、Windows及ARM等所有Go语言支持的平台，适用于个人、小团队或企业搭建私有代码仓库，实现代码的版本控制、协作管理和项目跟踪。

核心功能和特性

• 多协议支持：SSH和HTTP/HTTPS协议
• 认证方式：SMTP、LDAP及反向代理认证
• 组织与权限管理：账户、组织及仓库的完整管理功能
• 协作功能：仓库问题（Issues）、拉取请求（Pull Requests）和Wiki
• 自动化集成：仓库/组织Webhook（含Slack集成）、Git钩子和部署密钥
• 用户体验：活动时间线、贡献者管理、Gravatar及自定义头像
• 系统集成：邮件服务、管理面板
• 数据库支持：MySQL、PostgreSQL、SQLite3及TiDB（实验性）
• 多语言支持：18种语言本地化

系统要求与浏览器支持

系统要求

• 基础功能：树莓派级别的硬件即可满足
• 团队协作：建议至少2核CPU和1GB内存

浏览器支持

• 基于Semantic UI框架，支持主流浏览器（具体版本参考https://github.com/Semantic-Org/Semantic-UI#browser-support%EF%BC%89
• 官方支持最小分辨率为1024*768，更小分辨率可能存在UI适配问题

使用场景和适用范围

• 个人开发者：搭建私有代码仓库，管理个人项目
• 小团队：轻量级协作平台，替代GitHub/GitLab的自托管方案
• 企业内部：私有代码管理，保护知识产权
• 教育机构：教学环境中的版本控制实践平台
• 嵌入式设备：ARM架构支持，可部署在树莓派等小型设备

安装与使用方法

安装前提

需先安装必要依赖。

安装方式

Gogs提供5种安装途径：

1. 二进制安装
2. 源码安装
3. 包管理安装
4. https://github.com/gogits/gogs/tree/master/docker
5. https://github.com/geerlingguy/ansible-vagrant-examples/tree/master/gogs

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配置

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

初始化配置

1. 启动容器后，访问http://localhost:3000进入安装向导
2. 配置数据库（MySQL/PostgreSQL/SQLite3）
3. 设置站点名称、管理员账户等基础信息
4. 完成配置后即可创建仓库和用户

相关资源

• 官方文档
• 在线演示
• 问题排查
• 用户论坛
• https://github.com/gogits/go-gogs-client/wiki

许可证

Gogs基于MIT许可证开源，详见https://github.com/gogits/gogs/blob/master/LICENSE%E3%80%82