julianxhokaxhiu/gogs

Gogs

镜像概述和主要用途

Gogs（发音为/gɔgs/）是一个基于Go语言开发的自托管Git服务，旨在以最简单、无痛的方式搭建稳定且可扩展的私有代码仓库。它支持跨平台部署，包括Linux、macOS、Windows及ARM架构，适合个人、团队或组织搭建私有Git服务，实现代码的版本控制、协作管理和权限控制。

核心功能和特性

• 多协议支持：SSH、HTTP/HTTPS协议
• 认证方式：SMTP、LDAP、反向代理认证
• 仓库管理：支持账户、组织、仓库的创建与管理，可添加/移除仓库协作者
• 协作功能：仓库问题（Issues）、拉取请求（Pull Requests）、Wiki、保护分支
• 自动化工具：仓库Webhook（支持Slack、***等）、Git钩子、部署密钥
• 数据迁移：支持仓库及Wiki的迁移与镜像
• 编辑器支持：仓库文件和Wiki的在线Web编辑，支持Jupyter Notebook
• 安全特性：双因素认证、Gravatar及自定义头像源
• 多数据库支持：MySQL、PostgreSQL、SQLite3、MSSQL及TiDB（通过MySQL协议）
• 国际化：支持30种语言

使用场景和适用范围

• 个人开发者：搭建个人私有代码仓库，管理个人项目
• 小型团队：低成本实现团队内部代码协作与版本控制
• 资源有限环境：可在树莓派或低配置服务器（如512MB RAM）上运行
• 企业内部：部署私有Git服务，保障代码数据安全与自主可控

硬件要求

• 入门级：树莓派或5***Digital Ocean Droplet（64MB RAM即可运行）
• 团队协作基线：2核CPU、512MB RAM
• 大规模团队：增加CPU核心（内存占用仍保持较低水平）

浏览器支持

• 基于Semantic UI框架，支持主流浏览器最新版本
• 最低支持分辨率为1024*768（更低分辨率可能存在显示问题）

安装与使用方法

Docker部署

基本运行命令

bash
docker run -d --name=gogs -p 10022:22 -p 3000:3000 -v /var/gogs:/data docker.xuanyuan.run/gogs/gogs

参数说明

• -p 10022:22：映射SSH端口（宿主机***端口映射到容器22端口）
• -p 3000:3000：映射Web访问端口（宿主机3000端口映射到容器3000端口）
• -v /var/gogs:/data：挂载数据卷，持久化存储Gogs数据（包括仓库、配置等）

Docker Compose配置示例

yaml
version: '3'
services:
  gogs:
    image: docker.xuanyuan.run/gogs/gogs
    container_name: gogs
    ports:
      - "10022:22"
      - "3000:3000"
    volumes:
      - /var/gogs:/data
    restart: always

初始化配置

1. 启动容器后，访问http://<宿主机IP>:3000进入初始化页面
2. 配置数据库（支持MySQL、PostgreSQL等）、应用URL、管理员账户等
3. 完成配置后，即可创建用户、组织和仓库，开始使用

其他安装方式

除Docker外，Gogs还支持多种安装方式：

• https://gogs.io/docs/installation/install_from_binary.html
• https://gogs.io/docs/installation/install_from_source.html
• https://gogs.io/docs/installation/install_from_packages.html
• https://github.com/geerlingguy/ansible-vagrant-examples/tree/master/gogs
• https://github.com/helm/charts/tree/master/incubator/gogs

集成支持

Gogs可与多种工具和服务集成，包括：

• CI/CD：Drone、Jenkins
• 项目管理：Taiga、Kanboard
• 团队沟通：BearyChat、HiWork
• DevOps：Fabric8
• 演示文稿：GitPitch

许可证

Gogs基于MIT许可证开源，详见https://github.com/gogs/gogs/blob/master/LICENSE%E3%80%82