orangecloudfoundry/gogs

Gogs Docker镜像文档

镜像概述和主要用途

Gogs是一款简单、稳定且可扩展的自托管Git服务，旨在以最轻松的方式完成搭建。本Docker镜像提供了Gogs的容器化部署方案，适用于在官方镜像修复前进行临时部署，支持Linux、macOS、Windows及ARM等多种平台，帮助个人或团队快速搭建私有Git仓库。

核心功能和特性

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

使用场景和适用范围

• 个人开发者：搭建私有Git仓库，管理个人项目代码
• 小型开发团队：团队内部代码协作、版本控制和项目管理
• 资源受限环境：适用于Raspberry Pi、低配置VPS等轻量环境
• 企业内部：作为内部代码托管平台，满足数据私有化需求

硬件要求

• 入门级：Raspberry Pi或5***Digital Ocean Droplet（64MB RAM即可运行）
• 团队基线：2核CPU、512MB RAM
• 扩展建议：团队规模扩大时增加CPU核心，内存占用保持较低水平

浏览器支持

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

使用方法和配置说明

前提条件

• 安装Docker Engine（1.13+推荐）
• 若使用外部数据库，需提前准备MySQL/PostgreSQL等数据库服务

Docker Run快速部署

bash
docker run -d \
  --name=gogs \
  -p 3000:3000 \  # Web访问端口
  -p 2222:22 \    # SSH访问端口（避免与主机SSH冲突）
  -v /var/gogs:/data \  # 数据持久化目录
  gogs/gogs

Docker Compose配置示例

yaml
version: '3'
services:
  gogs:
    image: gogs/gogs
    container_name: gogs
    ports:
      - "3000:3000"
      - "2222:22"
    volumes:
      - /var/gogs:/data
    restart: always
    environment:
      - TZ=Asia/Shanghai  # 设置时区

数据持久化

容器内/data目录包含所有Gogs数据（仓库、配置、数据库等），需通过卷挂载实现持久化，如示例中/var/gogs:/data。

配置说明

首次启动后，通过http://<主机IP>:3000访问Web界面完成初始化配置，主要包括：

• 数据库设置：选择数据库类型（SQLite3适合个人使用，MySQL/PostgreSQL适合团队）
• 应用基本设置：站点名称、域名、SSH端口（容器内为22，宿主机映射端口需对应）
• 管理员账号：设置初始管理员用户名和密码

环境变量配置

可通过环境变量预配置部分参数，常用变量：

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

示例（使用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=gogsuser \
  -e DB_PASSWD=gogspassword \
  gogs/gogs

相关资源

• 官方文档：Gogs Documentation
• 问题排查：Troubleshooting
• 用户论坛：Gogs Discuss
• 镜像地址：https://hub.docker.com/r/gogs/gogs