thekudlacz/gogs

Gogs - Go Git Service

镜像概述和主要用途

Gogs是一个轻量级自托管Git服务，采用Go语言开发，致力于提供最简单、快速且低门槛的Git服务搭建方案。通过独立二进制分发，可在Go支持的所有平台（包括Linux、Mac OS X、Windows及ARM架构）上运行，适用于个人、小型团队或企业搭建私有Git仓库，实现代码管理、版本控制和团队协作。

核心功能和特性

• 多协议支持：SSH和HTTP/HTTPS协议
• 认证方式：支持SMTP、LDAP及反向代理认证
• 管理功能：账户、组织及仓库全生命周期管理
• 协作工具：仓库/组织Webhooks（含Slack集成）、Git钩子、部署密钥、问题跟踪和拉取请求
• 用户体验：活动时间线、Gravatar及自定义头像、邮件服务
• 管理面板：提供完整的系统管理功能
• CI集成：支持Drone CI
• 数据库兼容：MySQL、PostgreSQL、SQLite3及TiDB（实验性）
• 多语言支持：已支持14种语言

使用场景和适用范围

• 个人开发者：搭建个人代码仓库，管理项目版本
• 小型团队：轻量化代码协作平台，资源占用低
• 教育机构：教学环境中的Git实践平台
• 资源受限环境：树莓派等低配置设备可满足基本功能需求
• 私有部署需求：对数据隐私有要求，需完全控制代码存储的场景

系统要求

• 最低配置：树莓派级设备即可满足基本功能
• 推荐配置：团队使用建议2核CPU、1GB RAM

浏览器支持

• 基于Semantic UI框架，支持主流浏览器（具体版本参考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端口（主机端口222映射容器内22端口）
• -v /var/gogs:/data：持久化数据存储（包含仓库、配置、数据库等）

Docker Compose配置示例

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

配置说明

容器首次启动后，访问http://<主机IP>:3000进入Web安装向导，需配置以下关键项：

• 数据库设置：选择MySQL、PostgreSQL、SQLite3或TiDB，填写对应连接信息
• 应用基本设置：站点名称、仓库根目录、运行用户、域名、SSH端口等
• 管理员账户：可选择在安装时创建管理员账户

数据持久化

所有数据（仓库、配置、数据库文件等）均存储在/data目录，通过挂载主机目录实现持久化，确保容器重启或升级后数据不丢失。

进阶使用

反向代理配置

若需通过域名访问并启用HTTPS，可配合Nginx反向代理：

nginx
server {
    listen 80;
    server_name git.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name git.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

环境变量配置

部分常用配置可通过环境变量设置（完整列表参考官方文档）：

• GOGS_DB_TYPE：数据库类型（mysql/postgres/sqlite/tidb）
• GOGS_DB_HOST：数据库主机地址
• GOGS_DB_NAME：数据库名称
• GOGS_DB_USER：数据库用户名
• GOGS_DB_PASSWD：数据库密码
• GOGS_RUN_USER：运行用户（默认git）
• GOGS_SSH_PORT：SSH服务端口（容器内）

版本信息

当前版本：0.7.0 Beta

许可证

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