yonh/gogs

gogs_dep Docker镜像文档

镜像概述

gogs_dep是一个用于通过Docker部署Gogs的镜像，当前Gogs版本为0.11.19（更新日期：2017-08-07）。Gogs是一款轻量级Git服务，该镜像提供了便捷的部署方式，支持HTTP和SSH两种访问方式，适用于个人或团队快速搭建私有Git仓库。

核心功能和特性

• 服务端口：公开3000端口（HTTP服务）和22端口（SSH服务）
• 数据持久化：支持通过挂载宿主机目录实现数据持久化，避免容器重启导致数据丢失
• 灵活部署：支持直接运行镜像或自定义构建，满足不同环境需求
• 版本兼容：提供清晰的升级流程，确保数据安全迁移

使用场景

• 个人开发者搭建私有Git仓库
• 小型团队内部代码管理和协作
• 需要快速部署Git服务的开发环境或测试环境

使用方法

1. 下载镜像

bash
docker pull yonh/gogs

2. 基本启动

bash
docker run -d \
  -p 3000:3000 \  # 映射HTTP服务端口
  -p 2222:22 \    # 映射SSH服务端口（宿主机端口可自定义）
  yonh/gogs

启动后，通过访问 server_name:3000 进入Gogs安装页面完成初始化配置。

3. 自定义构建镜像

如需基于源码构建镜像：

bash
docker build -t yonh/gogs .

4. 服务器部署（数据持久化）

为确保数据持久化，需将容器内 /home/git 目录挂载到宿主机：

bash
docker run -d \
  -p 3000:3000 \
  -p 2222:22 \
  -v /opt/git:/home/git \  # 宿主机目录/opt/git映射到容器内/home/git
  yonh/gogs

注意：使用SQLite数据库时，数据文件默认存储在Gogs程序的data目录，需确保该目录位于挂载的 /home/git 下以实现持久化。

升级Gogs

升级步骤：

1. 数据备份：

   • 若使用SQLite数据库，需备份 gogs-repositories 目录和 gogs.db 文件
   • 非SQLite数据库（如MySQL、PostgreSQL）可忽略数据库文件备份

2. 停止旧容器：

   bash
   docker stop [旧容器ID或名称]
   

3. 创建新容器： 执行服务器部署命令（带数据挂载）重新创建容器

4. 重新配置：

   • 访问 server_name:3000 进入安装页面
   • 配置库目录为 /home/git/gogs-repositories
   • 配置SQLite数据库路径为 /home/git/gogs.db
   • 无需重新填写管理员账户信息（原数据已通过挂载目录保留）

5. 验证：使用原账号登录，确认数据完整。