fafson/gogs

镜像概述

本镜像基于https://github.com/jbaez001/gogs%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%98%AFGogs%E8%BD%BB%E9%87%8F%E7%BA%A7%E8%87%AA%E5%8A%A9Git%E6%9C%8D%E5%8A%A1%E7%9A%84%E5%AE%9A%E5%88%B6%E7%89%88%E6%9C%AC%E3%80%82%E6%A0%B8%E5%BF%83%E4%BF%AE%E6%94%B9%E4%B8%BA%E5%AF%B9%E6%9C%AA%E7%99%BB%E5%BD%95%E7%94%A8%E6%88%B7%E9%9A%90%E8%97%8F%22Explore%22%E9%A1%B5%E9%9D%A2%EF%BC%8C%E9%98%B2%E6%AD%A2%E6%9C%AA%E6%8E%88%E6%9D%83%E7%94%A8%E6%88%B7%E6%B5%8F%E8%A7%88%E4%BB%93%E5%BA%93%E5%88%97%E8%A1%A8%EF%BC%8C%E5%A2%9E%E5%BC%BA%E7%A7%81%E6%9C%89%E4%BB%A3%E7%A0%81%E4%BB%93%E5%BA%93%E7%9A%84%E8%AE%BF%E9%97%AE%E5%AE%89%E5%85%A8%E6%80%A7%E3%80%82Gogs%E6%9C%AC%E8%BA%AB%E6%98%AF%E4%B8%80%E6%AC%BE%E7%AE%80%E5%8D%95%E6%98%93%E7%94%A8%E3%80%81%E8%BD%BB%E9%87%8F%E7%BA%A7%E7%9A%84Git%E6%9C%8D%E5%8A%A1%EF%BC%8C%E9%80%82%E5%90%88%E4%B8%AA%E4%BA%BA%E6%88%96%E5%B0%8F%E5%9E%8B%E5%9B%A2%E9%98%9F%E6%90%AD%E5%BB%BA%E7%A7%81%E6%9C%89%E4%BB%A3%E7%A0%81%E6%89%98%E7%AE%A1%E5%B9%B3%E5%8F%B0%E3%80%82

核心功能和特性

基础功能

• 完整继承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）使用，增强安全性和性能