jvanderneutstulen/gogs

Gogs Docker镜像文档

镜像概述

Gogs（Go Git Service）是一款基于Go语言开发的轻量级自托管Git服务，旨在提供最简单、快速且低门槛的私有Git服务器搭建方案。该Docker镜像封装了Gogs核心功能，通过暴露基础配置参数，支持使用docker-compose快速部署，适用于Linux、Mac OS X、Windows及ARM等多种平台，满足个人、团队及小型企业的代码托管需求。

核心功能与特性

• 多协议支持：同时支持SSH和HTTP/HTTPS协议访问仓库
• 灵活认证：支持SMTP、LDAP及反向代理认证机制
• 全面管理：提供账户、组织、仓库的完整生命周期管理，支持添加/移除仓库协作者
• 协作工具：集成仓库/组织Web钩子（含Slack集成）、Git钩子及部署密钥
• 开发支持：内置仓库问题跟踪、拉取请求、Wiki功能，支持仓库及Wiki的迁移与镜像
• 在线编辑：提供Web界面编辑器，支持直接修改仓库文件和Wiki内容
• 个性化配置：支持Gravatar及联邦头像，允许自定义头像源
• 数据库兼容：支持MySQL、PostgreSQL、SQLite3及TiDB（实验性）
• 多语言界面：已支持18种语言，满足国际化需求

使用场景与适用范围

• 个人开发者：搭建个人代码托管平台，管理项目版本历史
• 小型团队：内部协作开发，实现代码共享与版本控制
• 企业内部：部署私有Git服务，保障代码资产安全与自主可控
• 低资源环境：树莓派等低端设备即可运行基础功能，2核CPU+1GB内存可满足团队协作需求

使用方法与配置说明

前提条件

• Docker Engine 1.13或更高版本
• Docker Compose（推荐用于简化部署）

快速启动（docker run）

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：持久化存储Gogs数据（配置、仓库、数据库等）

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  # 数据持久化目录
    restart: always
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      # 数据库配置（默认使用SQLite3，如需其他数据库需取消注释并配置）
      # - DB_TYPE=mysql
      # - DB_HOST=db:3306
      # - DB_NAME=gogs
      # - DB_USER=gogs
      # - DB_PASSWD=yourpassword

  # 可选：MySQL数据库服务（如使用MySQL需取消注释）
  # db:
  #   image: mysql:5.7
  #   volumes:
  #     - ./mysql-data:/var/lib/mysql
  #   environment:
  #     - MYSQL_ROOT_PASSWORD=rootpassword
  #     - MYSQL_DATABASE=gogs
  #     - MYSQL_USER=gogs
  #     - MYSQL_PASSWORD=yourpassword

启动服务：

bash
docker-compose up -d

初始化配置

1. 访问http://<主机IP>:3000进入Gogs初始化页面
2. 配置数据库（默认使用SQLite3，无需额外服务；如需MySQL/PostgreSQL需提前部署并填写对应信息）
3. 设置服务器基本信息（域名、HTTP端口、SSH端口等）
4. 创建管理员账户，完成初始化

核心配置参数

注意事项

• 数据卷/data包含所有关键数据（配置、仓库、数据库），需确保持久化存储
• SSH端口映射建议使用非22端口，避免与主机SSH服务冲突
• 生产环境推荐使用MySQL或PostgreSQL数据库，SQLite3适用于个人或测试场景
• 浏览器最低支持分辨率为1024*768，兼容主流现代浏览器（参考Semantic UI浏览器支持列表）
• 首次启动必须通过Web界面完成初始化配置，之后可通过app.ini文件修改配置