ixis/gogs

Gogs - Go Git Service

镜像概述和主要用途

Gogs是一个基于Go语言开发的自托管Git服务，其核心目标是提供最简单、最快且最无痛苦的方式搭建自托管Git服务。通过Go语言的跨平台特性，Gogs可作为独立二进制分发到所有Go支持的平台，包括Linux、Mac OS X、Windows和ARM架构，适用于个人、团队或企业搭建私有Git仓库，实现代码版本管理与协作。

核心功能和特性

• 多协议支持：同时支持SSH和HTTP/HTTPS协议访问仓库
• 灵活认证：支持SMTP、LDAP和反向代理认证方式
• 全面管理：提供账户、组织及仓库的完整管理功能
• 协作工具：包含仓库/组织webhooks（支持Slack集成）、Git钩子、部署密钥、issues跟踪、拉取请求和wiki功能
• 用户协作：支持添加/移除仓库协作者，实现团队协作
• 个性化配置：支持Gravatar及自定义头像源
• 邮件服务：内置邮件通知功能，及时推送系统事件
• 管理面板：提供完整的管理员控制面板，方便系统维护
• 数据库兼容：支持MySQL、PostgreSQL、SQLite3和TiDB（实验性）
• 多语言支持：已支持15种语言，满足国际化需求

使用场景和适用范围

• 个人开发者：搭建个人私有Git仓库，安全管理代码版本
• 小型团队：团队内部代码协作，无需依赖第三方Git服务
• 企业环境：需数据本地化的企业，构建内部Git服务
• 资源受限场景：对硬件要求低，可在Raspberry Pi等低配置设备运行
• 跨平台部署：支持Linux、Mac OS X、Windows及ARM架构，适应多样化部署环境

详细使用方法和配置说明

前提条件

• 已安装Docker环境
• 如需数据持久化，建议准备专用数据卷或挂载目录

Docker部署示例

1. 使用docker run命令

基本部署（SQLite3数据库）：

bash
# 数据存储在当前目录的gogs-data文件夹
docker run -d --name=gogs -p 3000:3000 -p 2222:22 -v $(pwd)/gogs-data:/data gogs/gogs

使用MySQL数据库：

bash
# 需先启动MySQL容器
docker run -d --name=mysql -e MYSQL_ROOT_PASSWORD=password -e MYSQL_DATABASE=gogs -e MYSQL_USER=gogs -e MYSQL_PASSWORD=gogspassword mysql:5.7

# 启动Gogs并连接MySQL
docker run -d --name=gogs -p 3000:3000 -p 2222:22 -v $(pwd)/gogs-data:/data \
  -e DB_TYPE=mysql \
  -e DB_HOST=mysql:3306 \
  -e DB_NAME=gogs \
  -e DB_USER=gogs \
  -e DB_PASSWD=gogspassword \
  --link mysql:mysql \
  gogs/gogs

2. 使用docker-compose配置

创建docker-compose.yml文件：

yaml
version: '3'

services:
  gogs:
    image: gogs/gogs
    container_name: gogs
    ports:
      - "3000:3000"  # Web界面端口
      - "2222:22"    # SSH访问端口
    volumes:
      - ./gogs-data:/data  # 数据持久化目录
    environment:
      - DB_TYPE=postgres
      - DB_HOST=postgres:5432
      - DB_NAME=gogs
      - DB_USER=gogsuser
      - DB_PASSWD=gogspassword
    depends_on:
      - postgres

  postgres:
    image: postgres:13
    container_name: gogs-postgres
    environment:
      - POSTGRES_USER=gogsuser
      - POSTGRES_PASSWORD=gogspassword
      - POSTGRES_DB=gogs
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

启动服务：

bash
docker-compose up -d

配置说明

环境变量配置

Gogs支持通过环境变量自定义配置，常用参数：

数据持久化

容器内/data目录包含所有Gogs数据（仓库、配置、数据库文件等），建议通过-v参数挂载到宿主机目录，确保数据不会因容器重建而丢失。

访问与初始化

部署完成后，通过http://<服务器IP>:3000访问Gogs Web界面。首次访问将进入初始化配置向导，需完成数据库设置、管理员账户创建等步骤，配置完成后即可开始使用。

系统要求

• 最低配置：Raspberry Pi级设备可满足基本功能需求
• 推荐配置：2 CPU核心 + 1GB RAM，适合团队协作场景

浏览器支持

• 基于Semantic UI框架，支持主流浏览器最新版本
• 官方支持最小屏幕尺寸为1024*768， smaller尺寸可能存在显示兼容性问题

许可证

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