logoli/gogs

Gogs Docker镜像文档

镜像概述

Gogs是一款轻量级自助Git服务，类似于GitHub，旨在提供简单、稳定的私有Git仓库管理解决方案。本Docker镜像（logoli/gogs:1）封装了Gogs服务，便于快速部署和使用，适用于个人开发者或小型团队搭建私有代码仓库。

核心功能与特性

• 完整Git服务：支持Git仓库的创建、克隆、提交、分支管理等核心功能
• Web界面管理：通过3000端口提供直观的Web管理界面，支持用户、组织、仓库管理
• SSH访问支持：通过22端口提供SSH协议访问Git仓库，支持密钥认证
• 数据持久化：通过挂载数据卷实现仓库数据、配置文件等持久化存储
• 数据库集成：需链接外部数据库（如MySQL、PostgreSQL等）存储元数据

使用场景

• 个人开发者搭建私有Git仓库，管理个人项目代码
• 小型开发团队构建内部代码协作平台，实现代码版本控制
• 企业内部搭建独立的Git服务，保障代码数据安全与隐私

使用方法与配置说明

前置要求

• 已安装Docker环境
• 已部署数据库服务（如MySQL、PostgreSQL），并创建对应的数据库和用户

基本部署命令

bash
docker run --name=gogs --link database -p 10022:22 -p 10080:3000 -v /data/gogs:/data logoli/gogs:1

参数说明

• --name=gogs：指定容器名称为gogs
• --link database：链接名为"database"的数据库容器（需确保数据库容器已启动）
• -p 10022:22：将容器的22端口（SSH）映射到主机的***端口
• -p 10080:3000：将容器的3000端口（Web界面）映射到主机的***端口
• -v /data/gogs:/data：将主机的/data/gogs目录挂载到容器的/data目录，用于持久化存储数据

访问服务

1. Web界面：通过浏览器访问 http://主机IP:10080，首次访问需完成初始配置（如数据库连接、管理员账号设置等）
2. SSH访问：使用Git客户端通过 ssh://git@主机IP:10022/用户名/仓库名.git 克隆或操作仓库

数据持久化

容器的/data目录包含以下关键数据，通过挂载主机目录可确保数据不丢失：

• Git仓库数据
• Gogs配置文件
• 用户上传的附件
• 日志文件

数据库配置（初始设置）

首次访问Web界面时，需配置数据库连接信息：

• 数据库类型：根据实际使用的数据库选择（MySQL、PostgreSQL等）
• 数据库主机：由于使用--link参数，可填写database（容器名）
• 数据库端口：数据库默认端口（如MySQL为3306）
• 数据库名称：预先创建的数据库名
• 数据库用户：数据库用户名
• 数据库密码：数据库用户密码

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  gogs:
    image: logoli/gogs:1
    container_name: gogs
    ports:
      - "10022:22"
      - "10080:3000"
    volumes:
      - /data/gogs:/data
    links:
      - database
    depends_on:
      - database
    restart: always

  database:
    image: mysql:5.7
    container_name: database
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DATABASE=gogs
      - MYSQL_USER=gogsuser
      - MYSQL_PASSWORD=gogspassword
    volumes:
      - /data/mysql:/var/lib/mysql
    restart: always

启动服务：

bash
docker-compose up -d