Gogs

Gogs 是一款极易搭建的自助 Git 服务。

项目愿景

Gogs（/gɑgz/）项目旨在打造一个以最简便的方式搭建简单、稳定和可扩展的自助 Git 服务。使用 Go 语言开发使得 Gogs 能够通过独立的二进制分发，并且支持 Go 语言支持的 所有平台，包括 Linux、macOS、Windows 和基于 ARM 的操作系统。

概览

• 请移步官网查看用户使用文档
• 请通过 CHANGELOG.md 文件查看各个版本的变更历史
• 想要先睹为快？直接去在线体验吧！
• 使用过程中遇到问题？尝试故障排查或者前往用户论坛获取帮助
• 希望帮助多国语言的翻译吗？请查看本地化文档
• 准备搞点事情？请阅读开发指南配置开发环境
• 想调用 API 吗？请查看文档吧

主要特性

• 控制面板、用户页面以及活动时间线
• 通过 SSH、HTTP 和 HTTPS 协议操作仓库
• 管理用户、组织和仓库
• 仓库和组织级 Webhook，包括 Slack、Discord 和钉钉
• 仓库 Git 钩子、部署密钥和 Git LFS
• 仓库工单（Issue）、合并请求（Pull Request）、Wiki、保护分支和多人协作
• 从其它代码平台迁移和镜像仓库以及 Wiki
• 在线编辑仓库文件和 Wiki
• Jupyter Notebook 和 PDF 的渲染
• 通过 SMTP、LDAP、反向代理、GitHub.com 和 GitHub 企业版进行用户认证
• 开启两步验证（2FA）登录
• 自定义 HTML 模板、静态文件和许多其它组件
• 多样的数据库后端，包括 PostgreSQL、MySQL、SQLite3 和 TiDB
• 超过 31 种语言的本地化

硬件要求

• 最低的系统硬件要求为一个廉价的树莓派
• 如果用于团队项目管理，建议使用 2 核 CPU 及 512MB 内存
• 当团队成员大量增加时，可以考虑添加 CPU 核数，内存占用保持不变

浏览器支持

• 请根据 Semantic UI 查看具体支持的浏览器版本。
• 官方支持的最小 UI 尺寸为 1024*768，UI 不一定会在更小尺寸的设备上被破坏，但我们无法保证且不会修复。

安装部署

在安装 Gogs 之前，您需要先安装 基本环境。

然后，您可以通过以下 6 种方式来安装 Gogs：

• 二进制安装
• 源码安装
• 包管理安装
• 采用 Docker 部署
• 通过 Vagrant 安装
• 通过基于 Kubernetes 的 Helm Charts

云端部署

• OpenShift
• Cloudron
• Scaleway
• Sandstorm
• sloppy.io
• YunoHost
• DPlatform
• LunaNode

使用教程

• 使用 Gogs 搭建自己的 Git 服务器
• 阿里云上 Ubuntu 14.04 64 位安装 Gogs

软件、服务以及产品支持

• Fabric8（DevOps）
• Jenkins（CI）
• Taiga（项目管理）
• Puppet（IT）
• Kanboard（项目管理）
• BearyChat（团队交流）
• GitPitch（Markdown 演示）
• Synology（Docker）
• Syncloud（应用商店）

特别鸣谢

• 感谢 Egon Elbre 设计的 Logo。
• 感谢 DigitalOcean 和 MonoVM 提供服务器赞助。
• 感谢 Crowdin 提供免费的开源项目本地化支持。
• 感谢 Buildkite 提供免费的开源项目 CI/CD 支持。

贡献成员

• 您可以通过查看 贡献者页面 获取 TOP 100 的贡献者列表。
• 您可以通过查看 TRANSLATORS 文件获取公开的翻译人员列表。

授权许可

本项目采用 MIT 开源授权许可证，完整的授权说明已放置在 LICENSE 文件中。