akilli/gogs

akilli/gogs 镜像文档

镜像概述

akilli/gogs 是一个基于 akilli/base 基础镜像构建的 Gogs 镜像。Gogs 是一款轻量级的自助 Git 服务，旨在提供简单、易用的 Git 仓库管理功能，适合个人或小型团队搭建私有 Git 服务。

核心功能与特性

• 轻量级设计：资源占用低，部署简单，适合各种规模的使用场景
• 完整 Git 功能：支持 Git 仓库的创建、克隆、分支管理、合并等核心操作
• 用户与权限管理：提供用户注册、角色分配及细粒度的仓库权限控制
• Web 界面：直观的 Web 管理界面，方便用户操作和管理 Git 仓库
• 基于 akilli/base：继承基础镜像的稳定运行环境，确保服务可靠性

使用场景与适用范围

• 个人开发者搭建私有 Git 仓库
• 小型团队内部代码管理与协作
• 对资源占用有要求的轻量级 Git 服务部署场景
• 需要快速搭建且易于维护的 Git 服务环境

使用方法与配置说明

基本部署

可参考官方提供的示例 https://github.com/akilli/docker/blob/master/gogs/compose.yml 作为配置起点，通过 Docker Compose 快速部署。

Docker Compose 配置示例

以下是基础配置框架（具体参数需参考官方示例文件调整）：

yaml
version: '3'
services:
  gogs:
    image: akilli/gogs
    ports:
      - "3000:3000"  # Web 访问端口
      - "2222:22"    # SSH 访问端口
    volumes:
      - ./data:/data  # 数据持久化目录
    environment:
      - GOGS_CUSTOM=/data/gogs  # 自定义配置目录
    restart: unless-stopped

启动服务

1. 下载示例 docker-compose.yml 文件
2. 根据实际需求调整端口映射、数据卷路径及环境变量
3. 执行以下命令启动服务：

   bash
   docker-compose up -d
   

访问与配置

服务启动后，通过 http://<服务器IP>:3000 访问 Gogs Web 界面，根据引导完成初始配置（如数据库设置、管理员账户创建等）。

注意事项

• 数据卷挂载确保数据持久化，避免容器重启导致数据丢失
• 根据实际需求调整端口映射，避免端口冲突
• 生产环境中建议配置 HTTPS 以保障数据传输安全