anapsix/gogs

Gogs 容器镜像

镜像概述

Gogs是一款简单易用的自托管Git服务，本镜像基于AlpineLinux构建，是对codeskyblue/docker-gogs镜像的轻量化改编，体积仅为原镜像的约1/10（约68MB），资源占用低，部署便捷。

核心功能与特性

• 完整Git服务：提供自托管Git仓库的全部核心功能，包括代码管理、版本控制、分支管理等
• 轻量级设计：基于AlpineLinux，镜像体积约68MB，启动快速，资源消耗低
• 简化部署：容器化封装，一键启动，无需复杂环境配置
• 多端口支持：同时提供Web访问（3000端口）和SSH访问（22端口）

使用场景

适用于个人开发者、小型开发团队搭建私有Git仓库，满足代码版本控制、团队协作开发、私有项目管理等需求。

使用方法与配置说明

快速启动

1. 启动容器：

   bash
   docker run -it --rm -p 3000:3000 -p 3022:22 anapsix/gogs
   

   • 参数说明：
     • -p 3000:3000：映射Web界面访问端口
     • -p 3022:22：映射SSH访问端口（主机3022端口映射到容器22端口）
     • --rm：容器停止后自动清理（仅建议测试环境使用）

2. 访问Web界面： 打开浏览器访问 http://localhost:3000

3. 完成安装配置：

   • 按照Web界面的安装向导填写配置信息
   • 文件/目录路径需使用绝对路径，例如：
     • 数据库文件路径：/data/gogs.db
     • 仓库存储路径：/data/gogs-repositories

4. 登录系统： 使用安装过程中创建的管理员账户登录，开始使用Git服务。

数据持久化配置（生产环境推荐）

为避免容器重启导致数据丢失，建议通过数据卷挂载持久化存储：

bash
docker run -d -p 3000:3000 -p 3022:22 -v /host/path/data:/data --name gogs anapsix/gogs

• 参数说明：
  • -d：后台运行容器
  • -v /host/path/data:/data：将主机目录 /host/path/data 挂载到容器 /data 目录，持久化存储数据库和仓库数据
  • --name gogs：指定容器名称，便于后续管理（如启动、停止、重启）

注意：首次启动后需通过Web界面完成初始配置，配置时文件路径请使用容器内绝对路径（如/data/...）。