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

镜像概述

本镜像基于jbaez001/gogs项目构建，是Gogs轻量级自助Git服务的定制版本。核心修改为对未登录用户隐藏"Explore"页面，防止未授权用户浏览仓库列表，增强私有代码仓库的访问安全性。Gogs本身是一款简单易用、轻量级的Git服务，适合个人或小型团队搭建私有代码托管平台。

核心功能和特性

基础功能

• 完整继承Gogs原生功能，包括Git仓库管理、用户/组织管理、权限控制、代码提交/分支管理、问题跟踪、Wiki等
• 支持HTTP/HTTPS访问和SSH协议，兼容标准Git客户端操作

增强特性

• 访问控制强化：默认对未登录用户禁用"Explore"页面，仅登录用户可查看仓库列表
• 轻量级部署：保持Gogs原有的低资源占用特性，支持在单机、容器集群等多种环境部署
• 数据持久化：支持通过数据卷挂载保存配置、仓库数据和用户信息，确保服务重启后数据不丢失

使用场景和适用范围

• 个人开发者：搭建私有Git服务，管理个人项目代码
• 小型团队：构建团队内部代码托管平台，控制代码访问权限
• 私有部署需求：需要限制公开访问、防止未授权用户浏览仓库的场景
• 资源受限环境：适合在低配置服务器或边缘设备上部署的轻量级Git服务

使用方法和配置说明

基本部署（docker run）

bash
docker run -d \
  --name gogs-custom \
  -p 3000:3000 \  # Web访问端口
  -p 222:22 \      # SSH访问端口（可自定义）
  -v /path/to/local/data:/data \  # 数据持久化目录
  jbaez001/gogs

docker-compose配置示例

yaml
version: '3'
services:
  gogs:
    image: jbaez001/gogs
    container_name: gogs-custom
    restart: always
    ports:
      - "3000:3000"  # Web界面端口
      - "2222:22"    # SSH端口（宿主端口可自定义）
    volumes:
      - ./gogs-data:/data  # 本地数据目录，需提前创建
    environment:
      - TZ=Asia/Shanghai  # 设置时区（可选）

配置说明

端口映射

• 3000/tcp：Web管理界面访问端口，必须映射以通过浏览器访问
• 22/tcp：SSH协议端口，用于Git客户端通过SSH方式操作仓库，可根据宿主环境端口占用情况调整映射（如示例中的222或2222）

数据持久化

• 必须挂载/data目录到宿主机目录（如/path/to/local/data或./gogs-data），该目录包含：
  • 仓库数据（Git repositories）
  • 用户配置和数据库
  • 日志文件

初始配置

1. 启动容器后，通过http://<宿主机IP>:3000访问Web界面
2. 按照引导完成初始配置（数据库设置、站点URL、管理员账户等）
3. 配置完成后，未登录用户访问时将无法看到"Explore"页面，仅登录用户可浏览仓库列表

注意事项

• 首次启动需通过Web界面完成初始配置，建议提前规划数据库类型（支持SQLite、MySQL、PostgreSQL）
• 如需启用HTTPS，需在初始配置时设置SSL相关参数并提供证书
• 生产环境建议配合反向代理（如Nginx）使用，增强安全性和性能