源码安装

安装依赖

基本依赖

第三方包

请通过 gopmfile 查看完整的第三方包依赖列表。一般情况下只有在您为 Gogs 制作构建包的时候才会用到。

安装 Go 语言

如果您的系统已经安装要求版本的 Go 语言，可以跳过此小节。

下载

您可以通过以下方式安装 Go 语言到 /home/git/local/go 目录：

  1. sudo su - git
  2. cd ~
  3. # create a folder to install 'go'
  4. mkdir local
  5. # Download go (change go$VERSION.$OS-$ARCH.tar.gz to the latest release)
  6. wget https://storage.googleapis.com/golang/go$VERSION.$OS-$ARCH.tar.gz
  7. # expand it to ~/local
  8. tar -C /home/git/local -xzf go$VERSION.$OS-$ARCH.tar.gz

设置环境

请设置和您系统环境对应的路径：

  1. sudo su - git
  2. cd ~
  3. echo 'export GOROOT=$HOME/local/go' >> $HOME/.bashrc
  4. echo 'export GOPATH=$HOME/go' >> $HOME/.bashrc
  5. echo 'export PATH=$PATH:$GOROOT/bin:$GOPATH/bin' >> $HOME/.bashrc
  6. source $HOME/.bashrc

安装 Gogs

常用的安装方式：

  1. # 下载并安装依赖
  2. $ go get -u github.com/gogits/gogs
  4. # 构建主程序
  5. $ cd $GOPATH/src/github.com/gogits/gogs
  6. $ go build

构建 develop 分支版本

如果您想要安装 develop（或其它）分支版本，则可以通过以下命令：

  1. $ mkdir -p $GOPATH/src/github.com/gogits
  2. $ cd $GOPATH/src/github.com/gogits
  4. # 请确保没有使用 “https://github.com/gogits/gogs.git”
  5. $ git clone --depth=1 -b develop https://github.com/gogits/gogs
  6. $ cd gogs
  7. $ go build

测试安装

您可以通过以下方式检查 Gogs 是否可以正常工作：

  1. cd $GOPATH/src/github.com/gogits/gogs
  2. ./gogs web

如果您没有发现任何错误信息，则可以使用 Ctrl-C 来终止运行。

使用标签构建

Gogs 默认并没有支持一些功能，这些功能需要在构建时明确使用构建标签（build tags）来支持。

目前使用标签构建的功能如下：

  • sqlite3：SQLite3 数据库支持
  • pam：PAM 授权认证支持
  • cert：生成自定义证书支持
  • miniwinsvc：Windows 服务内置支持（或者您可以使用 NSSM 来创建服务）

例如，您需要支持以上所有功能，则需要先删除 $GOPATH/pkg/{GOOS_GOARCH}/github.com/gogits/gogs 目录，然后执行以下命令：

  1. $ go get -u -tags "sqlite pam cert" github.com/gogits/gogs
  2. $ cd $GOPATH/src/github.com/gogits/gogs
  3. $ go build -tags "sqlite pam cert"

安装完成后可继续参照 [配置与运行]。