0


gogs安装与说明(docker)

前言:

作为一个开发,少不了和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:


基本应用设置:

**应用名称:**可以换成自定义名称

**仓库根目录:**使用默认就行了,默认/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,更多说明见后文


使用说明

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

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

例如:

创建完成之后大概是这样子的:

默认情况下是可以使用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:

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

首先,说明一下,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

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

ssh秘钥

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

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

保存后,我们就可以使用ssh://协议去clone了,

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


去掉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
标签: docker git github

本文转载自: https://blog.csdn.net/bbj12345678/article/details/122713883
版权归原作者 fastjson_ 所有, 如有侵权,请联系我们删除。

“gogs安装与说明(docker)”的评论:

还没有评论