bitriory/gogs

Gogs Docker镜像文档

镜像概述和主要用途

Gogs Docker镜像是Gogs（一款轻量级Git服务）的非官方容器化部署方案，旨在简化Gogs的安装与运维流程。通过Docker容器，用户可快速搭建功能完整的Git服务，支持代码仓库管理、用户权限控制、Issue跟踪等核心功能，且数据可持久化存储在容器外部，确保服务升级或迁移时数据不丢失。

核心功能和特性

• 数据持久化：通过卷挂载将Git仓库及Gogs数据存储在宿主机，避免容器删除导致数据丢失
• 灵活端口映射：支持SSH和HTTP端口的自定义映射，适应不同网络环境
• 多存储方案：支持直接卷挂载、数据容器、Docker 1.9+卷命令等多种数据存储方式
• 环境变量配置：提供SOCAT_LINK和RUN_CROND等可选环境变量，满足高级管理需求
• 简易升级：通过拉取新镜像、重建容器即可完成版本升级，数据通过卷保持

使用场景和适用范围

• 个人开发者搭建私有代码仓库
• 小型团队内部协作开发
• 对服务器资源要求较低的Git服务部署
• 需要快速部署和迁移的Git服务场景

使用方法和配置说明

基础使用步骤

1. 拉取镜像

sh
docker pull gogs/gogs

2. 创建本地数据目录

sh
mkdir -p /var/gogs

3. 首次运行容器

sh
docker run --name=gogs -p 10022:22 -p 10080:3000 -v /var/gogs:/data gogs/gogs

• -p 10022:22：将容器内SSH服务端口22映射到宿主机***端口
• -p 10080:3000：将容器内HTTP服务端口3000映射到宿主机***端口
• -v /var/gogs:/data：将宿主机/var/gogs目录挂载到容器/data目录，用于数据持久化

4. 后续启动容器

sh
docker start gogs

注意：首次配置Gogs时，需正确设置SSH端口和URI。使用上述配置克隆仓库的示例命令：
git clone ssh://git@hostname:10022/username/myrepo.git

数据存储结构

宿主机/var/gogs目录包含以下内容：

/var/gogs
├── git
│   └── gogs-repositories  # Git仓库存储目录
├── ssh
│   └── # Gogs SSH密钥文件
└── gogs
    ├── conf               # 配置文件目录
    ├── data               # 应用数据目录
    └── log                # 日志文件目录

使用数据容器存储数据

创建数据容器

sh
docker run --name=gogs-data --entrypoint /bin/true gogs/gogs

使用数据容器运行Gogs

sh
docker run --name=gogs --volumes-from gogs-data -p 10022:22 -p 10080:3000 gogs/gogs

使用Docker 1.9+卷命令

创建Docker卷

sh
docker volume create --name gogs-data

使用卷运行Gogs

sh
docker run --name=gogs -p 10022:22 -p 10080:3000 -v gogs-data:/data gogs/gogs

配置说明

应用设置

首次访问Gogs Web界面时需完成初始配置，以下为Docker环境下的关键配置项说明：

完整配置说明参见Gogs配置手册

容器环境变量选项

升级方法

⚠️ 重要：确保已将数据卷挂载到容器外部，避免数据丢失 ⚠️

升级步骤：

1. 拉取最新镜像：

   sh
   docker pull gogs/gogs
   

2. 停止并删除旧容器：

   sh
   docker stop gogs
   docker rm gogs
   

3. 使用首次运行时的命令重新创建容器（保持相同的卷和端口映射）

已知问题

• 无法在Raspberry 1（armv6l）平台构建容器，因为基础镜像alpine未提供该平台的go包

有用链接

• 在Docker中运行的Gogs与本地系统共享22端口