DevOps历程-Gogs的安装与部署

1. 什么是 Gogs?

Gogs 是一款极易搭建的自助 Git 服务。

Gogs 的目标是打造一个最简单、最快速和最轻松的方式搭建自助 Git 服务。使用 Go 语言开发使得 Gogs 能够通过独立的二进制分发，并且支持 Go 语言支持的 所有平台，包括 Linux、Mac OS X、Windows 以及 ARM 平台。

2.整体安装步骤

2.1 安装包下载

首先去官网上下载二进制包

https://gogs.io/docs/installation/install_from_binary.html

2.2 安装启动

进行安装
检查环境要求是否已满足
上传文件到服务器解压压缩包即可，无需安装。（我把它放到/opt/下）

[root@localhost opt]# ll
-rw-r--r--. 1 root root 27495795 Jul 23 09:16 gogs_0.12.3_linux_amd64.tar.gz

[root@localhost opt]# tar -zxvf gogs_0.12.3_linux_amd64.tar.gz
gogs/
gogs/LICENSE
...
[root@localhost opt]# ll
drwxrwxr-x. 3 vagrant vagrant       85 Oct  7  2020 gogs
-rw-r--r--. 1 root    root    27495795 Jul 23 09:16 gogs_0.12.3_linux_amd64.tar.gz

[root@localhost opt]# cd gogs/
[root@localhost gogs]# ll
total 48916
-rwxrwxr-x. 1 vagrant vagrant 50067592 Oct  7  2020 gogs
-rw-rw-r--. 1 vagrant vagrant     1054 Oct  7  2020 LICENSE
-rw-rw-r--. 1 vagrant vagrant     7021 Oct  7  2020 README.md
-rw-rw-r--. 1 vagrant vagrant     5372 Oct  7  2020 README_ZH.md
drwxrwxr-x. 7 vagrant vagrant      195 Oct  7  2020 scripts
[root@localhost gogs]# ./gogs web

使用命令 cd /opt/gogs/ 进入到解压的目录。
执行命令 ./gogs web。
Gogs 默认会在端口 3000 启动 HTTP 服务，访问 /install 以进行初始配置（例如 http://localhost:3000/install ）。
安装完成后可继续参照 配置与运行。

#默认端口启动
./gogs web
#指定端口启动
./gogs web –port 33703 

使用这种方法属于前台启动，如果关闭终端会自动退出，也可以采用后台启动方法。

2.3 初始化配置

需要修改的不多，以下配置作为参考,如果默认3000端口已经被其他端口占用的话，使用后台启动的方式是无法正常启动的，因为在未进行前端安装的情况下，后台启动无法指定端口，只能在前端安装gogs之后才会生成相应的配置文件。
此时可以使用另外一种指定端口方式运行服务例如:./gogs web -port 33703
访问 http://localhost:3000/install 出现初始化页面

信息填写完毕，安装成功后，会出现以下界面：

2.4 设置开机自启

步骤一：创建 systemd 服务文件

创建 Gogs 的服务文件：

sudo vi /etc/systemd/system/gogs.service

内容如下：

[Unit]
Description=Gogs Git Service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/gogs
ExecStart=/opt/gogs/gogs web
Restart=always
Environment=USER=root HOME=/root

[Install]
WantedBy=multi-user.target

步骤二：重新加载 systemd 并启动 Gogs 服务

# 重新加载 systemd 配置
sudo systemctl daemon-reexec
sudo systemctl daemon-reload

# 启动 Gogs 服务
sudo systemctl start gogs

# 设置开机自启
sudo systemctl enable gogs

步骤三：检查服务状态

sudo systemctl status gogs

[root@localhost gogs]# vi  /etc/systemd/system/gogs.service
[root@localhost gogs]# sudo vi /etc/systemd/system/gogs.service
[root@localhost gogs]# sudo systemctl daemon-reexec
[root@localhost gogs]# sudo systemctl daemon-reload
[root@localhost gogs]# sudo systemctl start gogs
[root@localhost gogs]# sudo systemctl status gogs
● gogs.service - Gogs Git Service
   Loaded: loaded (/etc/systemd/system/gogs.service; disabled; vendor preset: disabled)
   Active: active (running) since Wed 2025-07-23 09:43:34 UTC; 5s ago
 Main PID: 4133 (gogs)
    Tasks: 4
   Memory: 39.8M
   CGroup: /system.slice/gogs.service
           └─4133 /opt/gogs/gogs web
Jul 23 09:43:34 localhost.localdomain gogs[4133]: 2025/07/23 09:43:34 [TRACE] Log mode: Console (Trace)
Jul 23 09:43:34 localhost.localdomain gogs[4133]: 2025/07/23 09:43:34 [TRACE] Work directory: /opt/gogs
Jul 23 09:43:35 localhost.localdomain gogs[4133]: 2025/07/23 09:43:35 [ INFO] Listen on http://0.0.0.0:3000
[root@localhost gogs]# 

3.安装完成后

安装完成后点击登录,输入你刚刚配置的管理员密码即可愉快的使用啦

作者博客： www.lstar.icu
开源地址
Gitee 地址： https://gitee.com/lxwise
Github 地址： https://github.com/lxwise