2016-11-03 08:50:44 -06:00
# Gitea - Git with a cup of tea
[![Build Status ](https://travis-ci.org/go-gitea/gitea.svg?branch=master )](https://travis-ci.org/go-gitea/gitea)
[![codecov ](https://codecov.io/gh/go-gitea/gitea/branch/master/graph/badge.svg )](https://codecov.io/gh/go-gitea/gitea)
[![Go Report Card ](https://goreportcard.com/badge/github.com/go-gitea/gitea )](https://goreportcard.com/report/github.com/go-gitea/gitea)
[![GoDoc ](https://godoc.org/github.com/go-gitea/gitea?status.svg )](https://godoc.org/github.com/go-gitea/gitea)
[![ ](https://images.microbadger.com/badges/image/gitea/gitea.svg )](http://microbadger.com/images/gitea/gitea "Get your own image badge on microbadger.com")
[![Join the chat at https://gitter.im/go-gitea/gitea ](https://badges.gitter.im/Join%20Chat.svg )](https://gitter.im/go-gitea/gitea?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)
2014-03-22 18:25:39 -06:00
2015-11-04 19:57:10 -07:00
Gogs (Go Git Service) 是一款极易搭建的自助 Git 服务。
2014-03-22 18:25:39 -06:00
## 开发目的
2015-11-04 16:34:08 -07:00
Gogs 的目标是打造一个最简单、最快速和最轻松的方式搭建自助 Git 服务。使用 Go 语言开发使得 Gogs 能够通过独立的二进制分发,并且支持 Go 语言支持的 **所有平台** ,包括 Linux、Mac OS X、Windows 以及 ARM 平台。
2014-03-22 18:25:39 -06:00
## 项目概览
2016-08-05 18:35:40 -06:00
- 有关基本用法和变更日志,请通过 [使用手册 ](https://gogs.io/docs/intro/ ) 查看。
2014-03-25 21:53:01 -06:00
- 您可以到 [Trello Board ](https://trello.com/b/uxAoeLUl/gogs-go-git-service ) 跟随开发团队的脚步。
2015-12-12 12:47:11 -07:00
- 想要先睹为快?直接去 [在线体验 ](https://try.gogs.io/gogs/gogs ) 。
2016-08-05 18:35:40 -06:00
- 使用过程中遇到问题?尝试从 [故障排查 ](https://gogs.io/docs/intro/troubleshooting.html ) 页面或 [用户论坛 ](https://discuss.gogs.io/ ) 获取帮助。
- 希望帮助多国语言界面的翻译吗?请立即访问 [详情页面 ](https://gogs.io/docs/features/i18n.html )!
2014-03-22 18:25:39 -06:00
## 功能特性
2015-08-10 09:38:46 -06:00
- 支持活动时间线
2015-10-25 01:30:16 -06:00
- 支持 SSH 以及 HTTP/HTTPS 协议
- 支持 SMTP、LDAP 和反向代理的用户认证
2014-10-10 19:40:51 -06:00
- 支持反向代理子路径
2015-08-10 09:38:46 -06:00
- 支持用户、组织和仓库管理系统
2016-08-15 03:12:18 -06:00
- 支持添加和删除仓库协作者
2015-08-10 09:38:46 -06:00
- 支持仓库和组织级别 Web 钩子(包括 Slack 集成)
- 支持仓库 Git 钩子和部署密钥
2015-12-06 21:07:02 -07:00
- 支持仓库工单( Issue) 、合并请求( Pull Request) 以及 Wiki
2016-08-15 03:12:18 -06:00
- 支持迁移和镜像仓库以及它的 Wiki
- 支持在线编辑仓库文件和 Wiki
2016-08-07 12:01:47 -06:00
- 支持自定义源的 Gravatar 和 Federated Avatar
2015-08-10 09:38:46 -06:00
- 支持邮件服务
- 支持后台管理面板
2015-11-04 19:57:10 -07:00
- 支持 MySQL、PostgreSQL、SQLite3 和 [TiDB ](https://github.com/pingcap/tidb )(实验性支持) 数据库
2016-09-15 18:03:36 -06:00
- 支持多语言本地化([19 种语言]([more](https://crowdin.com/project/gogs)))
2014-03-22 18:25:39 -06:00
2014-04-26 01:22:22 -06:00
## 系统要求
- 最低的系统硬件要求为一个廉价的树莓派
2015-02-23 22:27:22 -07:00
- 如果用于团队项目,建议使用 2 核 CPU 及 1GB 内存
2014-04-26 01:22:22 -06:00
2015-07-06 23:51:28 -06:00
## 浏览器支持
2015-08-29 02:07:02 -06:00
- 请根据 [Semantic UI ](https://github.com/Semantic-Org/Semantic-UI#browser-support ) 查看具体支持的浏览器版本。
- 官方支持的最小 UI 尺寸为 **1024*768** , UI 不一定会在更小尺寸的设备上被破坏,但我们无法保证且不会修复。
2015-07-23 14:50:05 -06:00
2014-03-22 18:25:39 -06:00
## 安装部署
2016-08-05 18:35:40 -06:00
在安装 Gogs 之前,您需要先安装 [基本环境 ](https://gogs.io/docs/installation )。
2014-03-22 18:25:39 -06:00
2014-05-12 09:02:36 -06:00
然后,您可以通过以下 5 种方式来安装 Gogs:
2014-03-22 18:25:39 -06:00
2016-08-05 18:35:40 -06:00
- [二进制安装 ](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 )
2016-11-03 06:29:56 -06:00
- [采用 Docker 部署 ](https://github.com/go-gitea/gitea/tree/master/docker )
2014-05-02 17:23:06 -06:00
- [通过 Vagrant 安装 ](https://github.com/geerlingguy/ansible-vagrant-examples/tree/master/gogs )
2014-03-22 18:25:39 -06:00
2015-10-29 01:21:59 -06:00
### 使用教程
2015-11-09 09:34:04 -07:00
- [使用 Gogs 搭建自己的 Git 服务器 ](https://mynook.info/blog/post/host-your-own-git-server-using-gogs )
2015-10-29 01:21:59 -06: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-01 17:53:19 -07:00
- [sloppy.io ](https://github.com/sloppyio/quickstarters/tree/master/gogs )
2016-02-05 08:19:37 -07:00
- [YunoHost ](https://github.com/mbugeia/gogs_ynh )
2016-05-06 17:44:05 -06:00
- [DPlatform ](https://github.com/j8r/DPlatform )
2015-10-29 01:21:59 -06:00
2015-12-05 11:50:43 -07:00
## 软件及服务支持
- [Drone ](https://github.com/drone/drone )( CI)
- [Fabric8 ](http://fabric8.io/ )( DevOps)
- [Taiga ](https://taiga.io/ )(项目管理)
2015-12-21 05:24:11 -07:00
- [Puppet ](https://forge.puppetlabs.com/Siteminds/gogs )( IT)
2016-01-13 23:28:07 -07:00
- [Kanboard ](http://kanboard.net/plugin/gogs-webhook )(项目管理)
- [BearyChat ](https://bearychat.com/ )(团队交流)
2016-03-13 15:37:44 -06:00
- [HiWork ](http://www.hiwork.cc/ )(团队交流)
2015-12-05 11:50:43 -07:00
2015-10-29 01:21:59 -06:00
### 产品支持
- [Synology ](https://www.synology.com )( Docker)
- [One Space ](http://www.onespace.cc )(应用商店)
2014-03-22 18:25:39 -06:00
## 特别鸣谢
2015-10-25 01:10:22 -06:00
- 基于 [Macaron ](https://github.com/go-macaron/macaron ) 的路由与中间件机制。
2014-03-24 05:36:38 -06:00
- 基于 [GoBlog ](https://github.com/fuxiaohei/goblog ) 修改的系统监视状态。
2016-08-15 03:12:18 -06:00
- 感谢 [Rocker ](http://weibo.com/rocker1989 ) 设计的 Logo。
2014-10-18 21:26:55 -06:00
- 感谢 [Crowdin ](https://crowdin.com/project/gogs ) 提供免费的开源项目本地化支持。
2015-11-05 12:40:22 -07:00
- 感谢 [DigitalOcean ](https://www.digitalocean.com ) 提供主站和体验站点的服务器赞助。
2016-07-23 05:22:43 -06:00
- 感谢 [KeyCDN ](https://www.keycdn.com/ ) 和 [七牛云存储 ](http://www.qiniu.com/ ) 提供 CDN 服务赞助。
2014-03-22 18:25:39 -06:00
## 贡献成员
2015-10-25 01:30:16 -06:00
- 前团队成员 [@lunny ](https://github.com/lunny )、[@fuxiaohei](https://github.com/fuxiaohei) 和 [@slene ](https://github.com/slene )。
2016-11-03 06:29:56 -06:00
- 您可以通过查看 [贡献者页面 ](https://github.com/go-gitea/gitea/graphs/contributors ) 获取完整的贡献者列表。
2015-09-04 03:54:22 -06:00
- 您可以通过查看 [TRANSLATORS ](conf/locale/TRANSLATORS ) 文件获取公开的翻译人员列表。
2014-03-27 10:48:29 -06:00
## 授权许可
2016-11-03 06:29:56 -06:00
本项目采用 MIT 开源授权许可证,完整的授权说明已放置在 [LICENSE ](https://github.com/go-gitea/gitea/blob/master/LICENSE ) 文件中。