solsson/gogs

Gogs Docker镜像文档

镜像概述

Gogs是一个基于Go语言开发的自托管Git服务，旨在以最简单、最无痛的方式搭建稳定且可扩展的私有Git服务器。通过Go语言的跨平台特性，Gogs可作为独立二进制文件在Linux、macOS、Windows及ARM等所有Go支持的平台上运行，适合个人、小型团队或企业内部搭建私有代码仓库。

核心功能与特性

• 多协议支持：SSH、HTTP/HTTPS访问协议
• 认证方式：支持SMTP、LDAP及反向代理认证
• 仓库管理：个人/组织/仓库全生命周期管理，包括协作者添加/移除
• 协作功能：issues跟踪、Pull Requests、Wiki、保护分支
• 自动化与集成：仓库/组织Webhook（支持Slack、***）、Git钩子、部署密钥
• 数据迁移：支持仓库及Wiki的迁移与镜像
• 编辑工具：内置Web文件编辑器及Wiki编辑器，支持Jupyter Notebook
• 安全特性：双因素认证、Gravatar及自定义头像源
• 多数据库支持：兼容MySQL、PostgreSQL、SQLite3、MSSQL及TiDB（通过MySQL协议）
• 国际化：支持30种语言

使用场景与适用范围

• 个人开发者：搭建私有代码仓库，管理个人项目
• 小型团队：协作开发代码，进行版本控制与代码审查
• 企业内部：部署私有Git服务，保护敏感代码资产
• 资源受限环境：在低配置设备（如树莓派、512MB RAM的VPS）上稳定运行

硬件要求

• 入门级：树莓派或5***Digital Ocean Droplet（64MB RAM即可运行）
• 团队协作基线：2核CPU、512MB RAM
• 大规模团队：增加CPU核心（内存占用仍保持较低水平）

浏览器支持

• 基于Semantic UI框架，支持主流浏览器最新版本
• 最低支持分辨率：1024*768（更低分辨率不保证兼容性）

安装与使用

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
    container_name: gogs
    ports:
      - "3000:3000"
      - "2222:22"
    volumes:
      - /var/gogs:/data
    restart: always

初始化配置

1. 启动容器后，访问http://<主机IP>:3000进入安装向导
2. 配置数据库（支持MySQL、PostgreSQL等，默认使用SQLite3）
3. 设置应用基本信息（站点名称、域名、SSH端口等）
4. 创建管理员账号
5. 完成配置后即可开始使用

环境变量配置

可通过环境变量自定义Gogs配置，常用变量包括：

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

示例：使用MySQL数据库的启动命令

bash
docker run -d \
  --name=gogs \
  -p 3000:3000 \
  -p 2222:22 \
  -v /var/gogs:/data \
  -e DB_TYPE=mysql \
  -e DB_HOST=mysql:3306 \
  -e DB_NAME=gogs \
  -e DB_USER=root \
  -e DB_PASSWD=password \
  gogs/gogs

安全注意事项

• 生产环境建议使用HTTPS加密传输
• 定期备份/data目录下的数据
• 敏感配置（如数据库密码）通过环境变量注入，避免硬编码
• 若发现安全漏洞，请通过u@gogs.io私下报告

相关资源

• 官方文档：[***]
• 在线演示：[***]
• 问题排查：Troubleshooting
• API文档：https://github.com/gogs/go-gogs-client/wiki

许可证

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