ivories/gogs Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Gogs Docker镜像文档

镜像概述

Gogs是一款基于Go语言开发的轻量级自助Git服务，该Docker镜像提供了便捷的部署方式，使个人或团队能够快速搭建私有Git服务器。它具备Web界面管理、仓库操作、用户权限控制等核心功能，且资源占用低，易于维护。

核心功能和特性

• Web界面管理：通过浏览器直观创建、管理Git仓库，支持仓库设置、分支管理等操作
• 仓库导入：支持从外部Git仓库（如GitHub、GitLab）导入现有项目
• 镜像推送：支持通过git push --mirror命令实现仓库镜像同步
• 用户与权限管理：支持多用户管理，可配置仓库访问权限（公开/私有、读写权限等）
• 轻量级设计：资源占用低，适合在低配置服务器或个人设备上部署

使用场景和适用范围

• 个人开发者：搭建个人私有代码仓库，管理个人项目
• 小型团队：团队内部协作开发，实现代码版本控制
• 企业内部：构建私有Git服务，保护敏感代码资产
• 教育场景：教学环境中搭建Git实践平台，学习版本控制

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name=gogs \
  -p 3000:3000 \
  -p 2222:22 \
  -v /path/to/gogs/data:/data \
  gogs/gogs

• -p 3000:3000：映射Web界面端口
• -p 2222:22：映射SSH端口（用于Git SSH操作）
• -v /path/to/gogs/data:/data：挂载数据卷，持久化存储仓库数据和配置

Docker Compose配置

yaml
version: '3'
services:
  gogs:
    image: gogs/gogs
    container_name: gogs
    ports:
      - "3000:3000"
      - "2222:22"
    volumes:
      - /path/to/gogs/data:/data
    restart: always

仓库操作示例

1. 通过Web界面创建仓库：

   • 访问http://<服务器IP>:3000，注册并登录账号
   • 点击"新建仓库"，填写仓库名称、描述等信息，完成创建

2. 导入现有仓库：

   • 在Web界面点击"导入仓库"，输入源仓库URL（如[***]），完成导入

3. 镜像推送仓库：

   bash
   # 克隆源仓库
   git clone --mirror [***]
   cd source-repo.git
   # 推送到Gogs仓库（需提前在Gogs创建目标仓库）
   git push --mirror ssh://git@<服务器IP>:2222/user/target-repo.git
   

环境变量配置

可通过环境变量自定义Gogs配置，常用变量包括：

• GOGS_CUSTOM: 自定义配置文件路径，默认/data/gogs/conf
• RUN_USER: 运行用户，默认git
• DISABLE_SSH: 是否禁用SSH，默认false
• HTTP_PORT: Web服务端口，默认3000
• SSH_PORT: SSH服务端口，默认22

示例（修改SSH端口）：

bash
docker run -d \
  --name=gogs \
  -p 3000:3000 \
  -p 33:22 \  # 将容器SSH端口22映射到主机33端口
  -v /path/to/gogs/data:/data \
  -e SSH_PORT=22 \
  gogs/gogs

注意事项

• 首次启动后，需通过Web界面完成初始配置（数据库设置、管理员账号等）
• 数据卷/data包含所有仓库数据和配置，需确保备份以防止数据丢失
• SSH端口映射需根据实际需求调整，避免与主机其他服务冲突