前言：

作为一个开发，少不了和git打交道，像github，gitee是很流行的git线上托管平台，而我们也搭建自己的git托管平台，有条件的可以使用gitlab，它对硬件有要求，像博主这种没条件用虚拟机的，推荐使用gogs。

Gogs 的是一个由 Go 语言开发的、可以简单、快速搭建自助 Git 服务。在宿主机上的安装可以参考官网：Gogs

不过在宿主机上直接安装会麻烦一点，需要自行安装git工具，如果使用ssh还要安装ssh服务器，如果使用源码安装，还可能需要go语言的编译环境，所以，如果是自己或者是小团队使用，推荐使用docker来安装

安装

首先，我们要安装docker，接着使用docker获取gogs的镜像：

# pull gogs镜像
sudo docker pull gogs/gogs

当然你也可以去Docker Hub上面下载需要的版本

Docker Hub

镜像中已经包换了git，ssh服务器等工具，无需我们安装，我们只需使用镜像创建容器即可：

# 在宿主机上创建挂在卷
$ mkdir  /home/gogs
# 创建并运行一个容器，
# 将宿主机的10022端口映射到容器的22端口，
# 将宿主机的13000端口映射到容器的3000端口，10022端口和13000端口可以根据自己的情况修改sudo docker run -d -p 10022:22 -p 13000:3000 -v /home/gogs:/data gogs/gogs

这里需要注意的是两点：

1、22端口是gogs的ssh服务端口，如果不开启ssh服务，可不做这个端口映射，3000是gogs应用服务端口，这两个端口可以修改，但是需要结合后续配置一同修改，这点在后面配置时来说明。2、这里做了一个卷映射，/data是容器内部gogs的数据目录，gogs后续的配置、git仓库等等都在这个目录中，我们将它映射到宿主中，方便数据保存以及配置的改动，比如我这里的/home/gogs，需要提前将目录创建好：sudo mkdir /home/gogs。

容器成功运行后，我们可以在浏览器通过宿主机的ip+13000端口打开gogs的首次运行安装程序 ，比如我这里是 http://192.168.209.128:13000

数据库设置

gogs目前支持3种数据库：MySQL、PostgreSQL、SQLite3

如果没有可用的数据库，可以选择SQLite3：

gogs安装与说明（docker）-编程之家

基本应用设置：

应用名称：可以换成自定义名称仓库根目录：使用默认就行了，默认/data/git/gogs-repositories，如果采用了数据卷映射，比如我这里因为/home/gogs映射/data，所以这个目录在宿主机中的地址是/home/gogs/git/gogs-repositories运行系统用户：不要修改，默认就是git用户，修改可能会有问题域名：使用ssh时使用的域名或者IP（看后文使用说明）SSH 端口号：gogs启用ssh时使用的端口号，默认22端口，如果修改了这个端口号，那么在上面创建容器时要对应的将10022端口映射到修改的端口号，如果不启用ssh，则置空HTTP 端口号：gogs应用启动的http端口，默认3000，如果修改了这个端口号，那么在上面创建容器时要对应的将13000端口映射到修改的端口号应用 URL：即打开应用的url地址，因为这里采用了docker，所以我们要修改成宿主机的地址转发去访问，比如这里我的宿主机地址：192.168.209.128，它的13000端口会转发到容器的3000端口，所以这里填：http://192.168.209.128:13000/日志路径：gogs的日志保存路径，默认就行了

注：更多配置在/data/gogs/conf/app.ini中，如果采用了数据卷映射，比如我这里因为/home/gogs映射/data，所以这个文件在宿主机中的/home/gogs/gogs/conf/app.ini，更多说明见后文

gogs安装与说明（docker）-编程之家

使用说明

安装完成之后，就可以使用了，默认情况下，我们需要自己注册一个账号，然后登陆：

gogs安装与说明（docker）-编程之家

 注册登录之后，我们可以在右上角的+号创建一个仓库：

gogs安装与说明（docker）-编程之家

例如：

gogs安装与说明（docker）-编程之家 创建完成之后大概是这样子的：

gogs安装与说明（docker）-编程之家

 默认情况下是可以使用http进行git clone的，当然我们也可以使用https，不过需要做更多的配置，这时需要修改/data/gogs/conf/app.ini文件中的配置了，因为没有cert证书，所以就不演示了。

另外，因为我们启用了ssh，我们也可以使用ssh来操作：

 其中，我们上面安装=》应用基础设置中的【域名】配置就是上图中红色方框中的 git@域名:XXXX/XXX 中的域名部分

注意，如果你直接使用这个ssh地址去clone，会让你输入git的密码：git@192.168.209.128's password:

gogs安装与说明（docker）-编程之家

这里可能你输入任何密码都是错的，哪怕输入对了密码，可能也提示目录不存在，什么原因？

首先，说明一下，ssh的连接地址是 user@host:path 格式，对于上面的demo仓库中，git是用户名，host是宿主机地址（192.168.209.128），test/demo.git是仓库路径。

那端口呢？熟悉ssh命令的话就会知道，ssh命令如果要指定端口，需要使用-p选项来指定，否则使用的是默认端口22.

再来看看，上面说过，因为我们的gogs是部署在docker上，对于ssh，我们使用宿主机的10022端口转发到容器的22端口，那使用ssh进行clone时，我们的宿主机地址是192.168.209.128，因为没有指定端口，所以连接的端口是宿主机的22端口，但是我们的宿主机的22端口没有办法到容器的22端口呀！！！所以他会认为git用户是宿主机的，如果宿主机没有创建git用户，那么输入任何密码都是错的，哪怕密码对了，也可能因为未在宿主机安装gogs或者路径不存在而访问失败。

那是不是说我们在docker上部署的gogs不能使用ssh?其实是可以的，你可以将宿主的22端口转发到容器的22端口。另外，还有一个做法，这里只是因为 git@域名:XXXX/XXX 这种格式进行clone不能指定端口而不能使用，我们可以使用另外一种类似http请求Url的ssh格式：ssh://user@host:port/path，

例如这里demo仓库：git clone ssh://git@192.168.209.128:10022/test/demo.git

gogs安装与说明（docker）-编程之家

不过这里我们clone还是失败了，大致的意思是，我们没有配置ssh秘钥。

ssh秘钥

ssh秘钥生成及使用参考：SSH公/私秘钥的生成及使用

创建完成后，我们打开.ssh目录下id_rsa.pub文件（公钥文件），复制里面的全部内容，然后打开gogs控制面板=》右上角用户配置=》SSH秘钥=》新增秘钥：

gogs安装与说明（docker）-编程之家 保存后，我们就可以使用ssh://协议去clone了,

如果想在另一台新电脑使用ssh，直接复制.ssh目录下公钥文件和私钥文件，到新电脑的.ssh目录下就可以使用ssh协议访问项目了

gogs安装与说明（docker）-编程之家

去掉gogs的注册按钮 

为了安全考虑，对外的情况下，建议去掉gogs的注册按钮 。

修改配置文件

/home/git/gogs/custom/conf 目录下的 app.ini文件
[service]
REGISTER_EMAIL_CONFIRM = false
ENABLE_NOTIFY_MAIL = true
DISABLE_REGISTRATION = false   ###  把此处的false改成 true，重启，搞定
ENABLE_CAPTCHA = true
REQUIRE_SIGNIN_VIEW = false

解决gogs网页打开慢 

在install的安装界面，禁用Gravatar服务；或者在配置文件中禁用gravatar服务，使用本地头像； 

vim gogs/conf/app.ini
[picture]
DISABLE_GRAVATAR        = true
ENABLE_FEDERATED_AVATAR = true