2015-02-10 02:32:22 +08:00
|
|
|
|
Gogs - Go Git Service [![Build Status](https://travis-ci.org/gogits/gogs.svg?branch=master)](https://travis-ci.org/gogits/gogs)
|
2014-03-23 08:25:39 +08:00
|
|
|
|
=====================
|
|
|
|
|
|
2015-11-05 10:57:10 +08:00
|
|
|
|
Gogs (Go Git Service) 是一款极易搭建的自助 Git 服务。
|
2014-03-23 08:25:39 +08:00
|
|
|
|
|
|
|
|
|
## 开发目的
|
|
|
|
|
|
2015-11-05 07:34:08 +08:00
|
|
|
|
Gogs 的目标是打造一个最简单、最快速和最轻松的方式搭建自助 Git 服务。使用 Go 语言开发使得 Gogs 能够通过独立的二进制分发,并且支持 Go 语言支持的 **所有平台**,包括 Linux、Mac OS X、Windows 以及 ARM 平台。
|
2014-03-23 08:25:39 +08:00
|
|
|
|
|
|
|
|
|
## 项目概览
|
|
|
|
|
|
2015-11-05 10:57:10 +08:00
|
|
|
|
- 有关基本用法和变更日志,请通过 [使用手册](http://gogs.io/docs/intro/) 查看。
|
2014-03-26 11:53:01 +08:00
|
|
|
|
- 您可以到 [Trello Board](https://trello.com/b/uxAoeLUl/gogs-go-git-service) 跟随开发团队的脚步。
|
2015-09-04 05:25:33 +08:00
|
|
|
|
- 想要先睹为快?通过 [在线体验](https://try.gogs.io/gogs/gogs) 或查看 **安装部署 -> 二进制安装** 小节。
|
2015-10-10 03:41:08 +08:00
|
|
|
|
- 使用过程中遇到问题?尝试从 [故障排查](http://gogs.io/docs/intro/troubleshooting.html) 页面获取帮助。
|
2015-03-18 19:00:55 +08:00
|
|
|
|
- 希望帮助多国语言界面的翻译吗?请立即访问 [详情页面](http://gogs.io/docs/features/i18n.html)!
|
2014-03-23 08:25:39 +08:00
|
|
|
|
|
|
|
|
|
## 功能特性
|
|
|
|
|
|
2015-08-10 23:38:46 +08:00
|
|
|
|
- 支持活动时间线
|
2015-10-25 15:30:16 +08:00
|
|
|
|
- 支持 SSH 以及 HTTP/HTTPS 协议
|
|
|
|
|
- 支持 SMTP、LDAP 和反向代理的用户认证
|
2014-10-11 09:40:51 +08:00
|
|
|
|
- 支持反向代理子路径
|
2015-08-10 23:38:46 +08:00
|
|
|
|
- 支持用户、组织和仓库管理系统
|
|
|
|
|
- 支持仓库和组织级别 Web 钩子(包括 Slack 集成)
|
|
|
|
|
- 支持仓库 Git 钩子和部署密钥
|
2015-12-07 12:07:02 +08:00
|
|
|
|
- 支持仓库工单(Issue)、合并请求(Pull Request)以及 Wiki
|
2015-10-25 15:30:16 +08:00
|
|
|
|
- 支持添加和删除仓库协作者
|
2015-08-10 23:38:46 +08:00
|
|
|
|
- 支持 Gravatar 以及自定义源
|
|
|
|
|
- 支持邮件服务
|
|
|
|
|
- 支持后台管理面板
|
2015-11-05 10:57:10 +08:00
|
|
|
|
- 支持 MySQL、PostgreSQL、SQLite3 和 [TiDB](https://github.com/pingcap/tidb)(实验性支持) 数据库
|
2015-08-10 23:38:46 +08:00
|
|
|
|
- 支持多语言本地化([14 种语言]([more](https://crowdin.com/project/gogs)))
|
2014-03-23 08:25:39 +08:00
|
|
|
|
|
2014-04-26 15:22:22 +08:00
|
|
|
|
## 系统要求
|
|
|
|
|
|
|
|
|
|
- 最低的系统硬件要求为一个廉价的树莓派
|
2015-02-24 13:27:22 +08:00
|
|
|
|
- 如果用于团队项目,建议使用 2 核 CPU 及 1GB 内存
|
2014-04-26 15:22:22 +08:00
|
|
|
|
|
2015-07-07 13:51:28 +08:00
|
|
|
|
## 浏览器支持
|
|
|
|
|
|
2015-08-29 16:07:02 +08:00
|
|
|
|
- 请根据 [Semantic UI](https://github.com/Semantic-Org/Semantic-UI#browser-support) 查看具体支持的浏览器版本。
|
|
|
|
|
- 官方支持的最小 UI 尺寸为 **1024*768**,UI 不一定会在更小尺寸的设备上被破坏,但我们无法保证且不会修复。
|
2015-07-24 04:50:05 +08:00
|
|
|
|
|
2014-03-23 08:25:39 +08:00
|
|
|
|
## 安装部署
|
|
|
|
|
|
2015-10-25 15:10:22 +08:00
|
|
|
|
在安装 Gogs 之前,您需要先安装 [基本环境](http://gogs.io/docs/installation)。
|
2014-03-23 08:25:39 +08:00
|
|
|
|
|
2014-05-12 23:02:36 +08:00
|
|
|
|
然后,您可以通过以下 5 种方式来安装 Gogs:
|
2014-03-23 08:25:39 +08:00
|
|
|
|
|
2015-10-10 03:41:08 +08:00
|
|
|
|
- [二进制安装](http://gogs.io/docs/installation/install_from_binary.html)
|
|
|
|
|
- [源码安装](http://gogs.io/docs/installation/install_from_source.html)
|
|
|
|
|
- [包管理安装](http://gogs.io/docs/installation/install_from_packages.html)
|
2014-09-06 05:28:09 +08:00
|
|
|
|
- [采用 Docker 部署](https://github.com/gogits/gogs/tree/master/docker)
|
2014-05-03 07:23:06 +08:00
|
|
|
|
- [通过 Vagrant 安装](https://github.com/geerlingguy/ansible-vagrant-examples/tree/master/gogs)
|
2014-03-23 08:25:39 +08:00
|
|
|
|
|
2015-10-29 15:21:59 +08:00
|
|
|
|
### 使用教程
|
|
|
|
|
|
2015-11-10 00:34:04 +08:00
|
|
|
|
- [使用 Gogs 搭建自己的 Git 服务器](https://mynook.info/blog/post/host-your-own-git-server-using-gogs)
|
2015-10-29 15:21:59 +08:00
|
|
|
|
- [阿里云上 Ubuntu 14.04 64 位安装 Gogs](http://my.oschina.net/luyao/blog/375654)
|
|
|
|
|
|
|
|
|
|
### 云端部署
|
|
|
|
|
|
|
|
|
|
- [OpenShift](https://github.com/tkisme/gogs-openshift)
|
|
|
|
|
- [Cloudron](https://cloudron.io/appstore.html#io.gogs.cloudronapp)
|
|
|
|
|
- [Scaleway](https://www.scaleway.com/imagehub/gogs/)
|
|
|
|
|
- [Portal](https://portaldemo.xyz/cloud/)
|
|
|
|
|
- [Sandstorm](https://github.com/cem/gogs-sandstorm)
|
2015-12-02 08:53:19 +08:00
|
|
|
|
- [sloppy.io](https://github.com/sloppyio/quickstarters/tree/master/gogs)
|
2015-10-29 15:21:59 +08:00
|
|
|
|
|
2015-12-06 02:50:43 +08:00
|
|
|
|
## 软件及服务支持
|
|
|
|
|
|
|
|
|
|
- [Drone](https://github.com/drone/drone)(CI)
|
|
|
|
|
- [Fabric8](http://fabric8.io/)(DevOps)
|
|
|
|
|
- [Taiga](https://taiga.io/)(项目管理)
|
|
|
|
|
|
2015-10-29 15:21:59 +08:00
|
|
|
|
### 产品支持
|
|
|
|
|
|
|
|
|
|
- [Synology](https://www.synology.com)(Docker)
|
|
|
|
|
- [One Space](http://www.onespace.cc)(应用商店)
|
|
|
|
|
|
2014-03-23 08:25:39 +08:00
|
|
|
|
## 特别鸣谢
|
|
|
|
|
|
2015-10-25 15:10:22 +08:00
|
|
|
|
- 基于 [Macaron](https://github.com/go-macaron/macaron) 的路由与中间件机制。
|
|
|
|
|
- 基于 [WeTalk](https://github.com/beego/wetalk) 修改的模块设计。
|
2014-03-24 19:36:38 +08:00
|
|
|
|
- 基于 [GoBlog](https://github.com/fuxiaohei/goblog) 修改的系统监视状态。
|
2014-04-30 15:44:28 +08:00
|
|
|
|
- 感谢 [lavachen](http://www.lavachen.cn/) 和 [Rocker](http://weibo.com/rocker1989) 设计的 Logo。
|
2014-10-19 11:26:55 +08:00
|
|
|
|
- 感谢 [Crowdin](https://crowdin.com/project/gogs) 提供免费的开源项目本地化支持。
|
2015-11-06 03:40:22 +08:00
|
|
|
|
- 感谢 [DigitalOcean](https://www.digitalocean.com) 提供主站和体验站点的服务器赞助。
|
2014-03-23 08:25:39 +08:00
|
|
|
|
|
|
|
|
|
## 贡献成员
|
|
|
|
|
|
2015-10-25 15:30:16 +08:00
|
|
|
|
- 前团队成员 [@lunny](https://github.com/lunny)、[@fuxiaohei](https://github.com/fuxiaohei) 和 [@slene](https://github.com/slene)。
|
2014-11-22 23:22:53 +08:00
|
|
|
|
- 您可以通过查看 [贡献者页面](https://github.com/gogits/gogs/graphs/contributors) 获取完整的贡献者列表。
|
2015-09-04 17:54:22 +08:00
|
|
|
|
- 您可以通过查看 [TRANSLATORS](conf/locale/TRANSLATORS) 文件获取公开的翻译人员列表。
|
2014-03-28 00:48:29 +08:00
|
|
|
|
|
|
|
|
|
## 授权许可
|
|
|
|
|
|
2015-02-24 13:27:22 +08:00
|
|
|
|
本项目采用 MIT 开源授权许可证,完整的授权说明已放置在 [LICENSE](https://github.com/gogits/gogs/blob/master/LICENSE) 文件中。
|