You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

113 lines
5.9 KiB

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