jaywoods/gogs

Gogs - Go Git Service

镜像概述和主要用途

Gogs（Go Git Service）是一款开源的自托管Git服务，采用Go语言开发，目标是提供最简单、快速且无痛苦的方式搭建私有Git服务器。它支持跨平台部署，包括Linux、Mac OS X、Windows及ARM架构设备，适合个人、团队或小型组织搭建内部代码仓库，实现代码的版本控制、协作管理和项目跟踪。

核心功能和特性

• 多协议支持：SSH、HTTP/HTTPS协议
• 认证方式：支持SMTP、LDAP及反向代理认证
• 全面的管理功能：账户、组织、仓库管理，添加/移除仓库协作者
• 协作工具：仓库/组织Webhook（含Slack集成）、Git钩子/部署密钥、issues、拉取请求和Wiki
• 数据迁移与镜像：支持仓库及其Wiki的迁移和镜像
• Web编辑功能：仓库文件和Wiki的在线编辑，支持Jupyter Notebook
• 头像支持：Gravatar、联邦头像及自定义头像源
• 邮件服务：集成邮件通知功能
• 管理面板：提供完整的系统管理功能
• 多数据库支持：MySQL、PostgreSQL、SQLite3及TiDB（实验性）
• 多语言支持：支持22种语言

使用场景和适用范围

• 个人开发者：搭建个人私有代码仓库，管理个人项目
• 小型团队：团队内部代码协作，版本控制和项目管理
• 教育机构：教学环境中搭建Git服务，用于学生项目管理
• 资源有限环境：树莓派等低配置设备即可运行基础功能，2核CPU和1GB内存可满足团队协作需求

系统要求

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

浏览器支持

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

安装与使用方法

Docker部署

基本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，进入Gogs初始化页面
2. 配置数据库（MySQL/PostgreSQL/SQLite3等）
3. 设置应用基本信息（站点名称、域名、SSH端口等）
4. 创建管理员账户
5. 完成配置后，即可开始使用Gogs服务

相关资源

• 官方文档：Gogs文档
• 在线演示：try.gogs.io
• 问题排查：故障排除指南
• 用户论坛：Gogs讨论论坛
• API文档：https://github.com/gogits/go-gogs-client/wiki

许可证

本项目采用MIT许可证，详情参见https://github.com/gogits/gogs/blob/master/LICENSE%E6%96%87%E4%BB%B6%E3%80%82