2015-02-10 03:32:22 +09: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 09:25:39 +09:00
|
|
|
|
=====================
|
|
|
|
|
|
2015-03-20 16:20:05 +09:00
|
|
|
|
Gogs (Go Git Service) 是一款可轻易搭建的自助 Git 服务。
|
2014-03-23 09:25:39 +09:00
|
|
|
|
|
|
|
|
|
## 开发目的
|
|
|
|
|
|
2014-07-26 16:02:46 +09:00
|
|
|
|
Gogs 的目标是打造一个最简单、最快速和最轻松的方式搭建自助 Git 服务。使用 Go 语言开发使得 Gogs 能够通过独立的二进制分发,并且支持 Go 语言支持的 **所有平台**,包括 Linux、Mac OS X 以及 Windows。
|
2014-03-23 09:25:39 +09:00
|
|
|
|
|
|
|
|
|
## 项目概览
|
|
|
|
|
|
2015-03-18 20:00:55 +09:00
|
|
|
|
- 有关项目设计、已知问题和变更日志,请通过 [使用手册](http://gogs.io/docs/intro/) 查看。
|
2014-03-26 12:53:01 +09:00
|
|
|
|
- 您可以到 [Trello Board](https://trello.com/b/uxAoeLUl/gogs-go-git-service) 跟随开发团队的脚步。
|
2015-02-10 03:32:22 +09:00
|
|
|
|
- 想要先睹为快?通过 [在线体验](https://try.gogs.io/unknwon/gogs) 或查看 **安装部署 -> 二进制安装** 小节。
|
2014-05-01 16:27:26 +09:00
|
|
|
|
- 使用过程中遇到问题?尝试从 [故障排查](http://gogs.io/docs/intro/troubleshooting.md) 页面获取帮助。
|
2015-03-18 20:00:55 +09:00
|
|
|
|
- 希望帮助多国语言界面的翻译吗?请立即访问 [详情页面](http://gogs.io/docs/features/i18n.html)!
|
2014-03-23 09:25:39 +09:00
|
|
|
|
|
|
|
|
|
## 功能特性
|
|
|
|
|
|
|
|
|
|
- 活动时间线
|
2014-05-16 12:03:26 +09:00
|
|
|
|
- 支持 SSH/HTTP(S) 协议
|
2014-06-22 06:57:59 +09:00
|
|
|
|
- 支持 SMTP/LDAP/反向代理 用户认证
|
2014-10-11 10:40:51 +09:00
|
|
|
|
- 支持反向代理子路径
|
2014-10-12 07:02:48 +09:00
|
|
|
|
- 支持 注册/删除/重命名 用户
|
|
|
|
|
- 支持 创建/管理/删除 组织以及团队管理功能
|
2014-11-06 13:30:04 +09:00
|
|
|
|
- 支持 创建/派生/迁移/镜像/删除/关注/重命名/转移 公开/私有 仓库
|
2014-10-12 07:02:48 +09:00
|
|
|
|
- 支持仓库 浏览/发布/工单管理
|
|
|
|
|
- 支持仓库和组织级别 Web 钩子
|
|
|
|
|
- 支持仓库 Git 钩子
|
|
|
|
|
- 支持 添加/删除 仓库协作者
|
|
|
|
|
- 支持 Gravatar 以及本地缓存
|
|
|
|
|
- 支持邮件服务(注册、Issue)
|
2014-03-23 09:25:39 +09:00
|
|
|
|
- 管理员面板
|
2014-09-02 20:11:39 +09:00
|
|
|
|
- Slack Web 钩子集成
|
2014-11-18 06:29:23 +09:00
|
|
|
|
- Drone CI 持续部署集成
|
2014-04-16 06:43:25 +09:00
|
|
|
|
- 支持 MySQL、PostgreSQL 以及 SQLite3 数据库
|
2014-04-14 10:00:12 +09:00
|
|
|
|
- 社交帐号登录(GitHub、Google、QQ、微博)
|
2015-07-14 19:35:38 +09:00
|
|
|
|
- 多语言支持([13 种语言]([more](https://crowdin.com/project/gogs)))
|
2014-03-23 09:25:39 +09:00
|
|
|
|
|
2014-04-26 16:22:22 +09:00
|
|
|
|
## 系统要求
|
|
|
|
|
|
|
|
|
|
- 最低的系统硬件要求为一个廉价的树莓派
|
2015-02-24 14:27:22 +09:00
|
|
|
|
- 如果用于团队项目,建议使用 2 核 CPU 及 1GB 内存
|
2014-04-26 16:22:22 +09:00
|
|
|
|
|
2015-07-07 14:51:28 +09:00
|
|
|
|
## 浏览器支持
|
|
|
|
|
|
|
|
|
|
根据 [Semantic UI](https://github.com/Semantic-Org/Semantic-UI/tree/1.x) 的要求:
|
|
|
|
|
|
|
|
|
|
- 最新两版的 FF、Chrome 和 IE 10+
|
|
|
|
|
- Safari 6
|
|
|
|
|
- IE 9+ (仅限浏览器前缀)
|
|
|
|
|
- Android 4
|
|
|
|
|
- Blackberry 10
|
|
|
|
|
|
|
|
|
|
尽管已经使用了 Internet Explorer 9 的浏览器前缀,但该版本的浏览器被没有被正式支持。
|
|
|
|
|
|
2015-07-24 05:50:05 +09:00
|
|
|
|
官方支持的最小 UI 尺寸为 1024*768,UI 不一定会在更小尺寸的设备上被破坏,但我们无法保证且不会修复。
|
|
|
|
|
|
2014-03-23 09:25:39 +09:00
|
|
|
|
## 安装部署
|
|
|
|
|
|
2014-05-01 16:27:26 +09:00
|
|
|
|
在安装 Gogs 之前,您需要先安装 [基本环境](http://gogs.io/docs/installation/)。
|
2014-03-23 09:25:39 +09:00
|
|
|
|
|
2014-05-13 00:02:36 +09:00
|
|
|
|
然后,您可以通过以下 5 种方式来安装 Gogs:
|
2014-03-23 09:25:39 +09:00
|
|
|
|
|
2014-10-10 19:15:27 +09:00
|
|
|
|
- [二进制安装](http://gogs.io/docs/installation/install_from_binary.md)
|
2014-05-01 16:27:26 +09:00
|
|
|
|
- [源码安装](http://gogs.io/docs/installation/install_from_source.md)
|
2014-05-13 00:02:36 +09:00
|
|
|
|
- [包管理安装](http://gogs.io/docs/installation/install_from_packages.md)
|
2014-09-06 06:28:09 +09:00
|
|
|
|
- [采用 Docker 部署](https://github.com/gogits/gogs/tree/master/docker)
|
2014-05-03 08:23:06 +09:00
|
|
|
|
- [通过 Vagrant 安装](https://github.com/geerlingguy/ansible-vagrant-examples/tree/master/gogs)
|
2014-03-23 09:25:39 +09:00
|
|
|
|
|
|
|
|
|
## 特别鸣谢
|
|
|
|
|
|
2014-11-22 00:58:08 +09:00
|
|
|
|
- 基于 [Macaron](https://github.com/Unknwon/macaron) 的路由与中间件机制。
|
2014-03-24 20:36:38 +09:00
|
|
|
|
- 基于 [WeTalk](https://github.com/beego/wetalk) 修改的邮件服务和模块设计。
|
|
|
|
|
- 基于 [GoBlog](https://github.com/fuxiaohei/goblog) 修改的系统监视状态。
|
2014-03-25 00:44:47 +09:00
|
|
|
|
- 感谢 [gobuild.io](http://gobuild.io) 提供二进制编译与下载服务。
|
2014-04-30 16:44:28 +09:00
|
|
|
|
- 感谢 [lavachen](http://www.lavachen.cn/) 和 [Rocker](http://weibo.com/rocker1989) 设计的 Logo。
|
2014-10-19 12:26:55 +09:00
|
|
|
|
- 感谢 [Crowdin](https://crowdin.com/project/gogs) 提供免费的开源项目本地化支持。
|
2014-03-23 09:25:39 +09:00
|
|
|
|
|
|
|
|
|
## 贡献成员
|
|
|
|
|
|
2014-11-23 00:22:53 +09:00
|
|
|
|
- 本项目的 [开发团队](http://gogs.io/team)。
|
|
|
|
|
- 您可以通过查看 [贡献者页面](https://github.com/gogits/gogs/graphs/contributors) 获取完整的贡献者列表。
|
|
|
|
|
- 您可以通过查看 [TRANSLATORS](conf/locale/TRANSLATORS) 文件获取完整的翻译人员列表。
|
2014-03-28 01:48:29 +09:00
|
|
|
|
|
|
|
|
|
## 授权许可
|
|
|
|
|
|
2015-02-24 14:27:22 +09:00
|
|
|
|
本项目采用 MIT 开源授权许可证,完整的授权说明已放置在 [LICENSE](https://github.com/gogits/gogs/blob/master/LICENSE) 文件中。
|