robertofilho/gogs

Gogs Docker镜像文档

镜像概述和主要用途

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

核心功能和特性

• 活动时间线：记录仓库和用户的活动历史
• 多协议支持：SSH和HTTP/HTTPS协议
• 多种认证方式：SMTP、LDAP、反向代理认证
• 反向代理支持：支持带子路径的反向代理配置
• 全面的管理功能：账户、组织、仓库管理
• 协作功能：添加/移除仓库协作者
• Webhook支持：仓库/组织Webhook（包括Slack和***）
• Git钩子与部署密钥：仓库级别的Git钩子和部署密钥
• 完整的仓库功能：issues、拉取请求、Wiki和保护分支
• 仓库迁移与镜像：支持仓库及其Wiki的迁移和镜像
• Web编辑器：仓库文件和Wiki的在线编辑功能
• Jupyter Notebook支持
• 双因素认证：增强账户安全性
• 头像支持：Gravatar、联邦头像及自定义头像源
• 邮件服务：通知和提醒功能
• 管理面板：系统管理功能
• 多数据库支持：MySQL、PostgreSQL、SQLite3、MSSQL和TiDB（通过MySQL协议）
• 多语言支持：支持23种语言

使用场景和适用范围

硬件要求

• 入门级：树莓派或5***Digital Ocean Droplet即可满足基本需求，甚至可在64MB RAM的Docker环境中运行
• 团队协作基线：2个CPU核心和512MB RAM
• 大规模团队：需增加CPU核心，内存占用保持较低水平

适用场景

• 个人私有代码仓库
• 小型开发团队内部代码协作
• 企业内部Git服务搭建
• 对数据隐私有较高要求的组织

使用方法和配置说明

前提条件

确保已安装Docker环境。

Docker部署示例

基本运行命令

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

docker-compose配置示例

yaml
version: '3'
services:
  gogs:
    image: gogs/gogs
    container_name: gogs
    ports:
      - "3000:3000"  # Web界面端口
      - "23:22"      # SSH端口（默认23）
    volumes:
      - /var/gogs:/data  # 数据持久化目录
    restart: always

配置说明

环境变量

Gogs支持通过环境变量进行配置，常用变量包括：

• GOGS_CUSTOM：自定义配置文件目录，默认/data/gogs/conf
• DB_TYPE：数据库类型，可选mysql、postgres、sqlite3、mssql
• DB_HOST：数据库主机地址
• DB_NAME：数据库名称
• DB_USER：数据库用户名
• DB_PASSWD：数据库密码
• RUN_USER：运行用户，默认git

数据持久化

通过-v /var/gogs:/data将容器内/data目录映射到宿主机，确保数据持久化，包含：

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

初始化设置

容器启动后，访问http://<宿主机IP>:3000进入Web安装界面，按照引导完成以下配置：

1. 数据库设置（根据实际环境选择数据库类型并填写连接信息）
2. 应用基本设置（站点名称、仓库根目录、运行用户等）
3. 管理员账户设置（可选）

浏览器支持

• 具体支持的浏览器版本参考https://github.com/Semantic-Org/Semantic-UI#browser-support
• 官方支持的最小分辨率为1024*768，更低分辨率可能仍可使用但不保证兼容性