Centos8怎么安装Gogs托管服务

发布时间：2022-02-17 10:20:54 作者：iii
来源：亿速云阅读：182

# CentOS8怎么安装Gogs托管服务

## 前言

Gogs（Go Git Service）是一个用Go语言编写的轻量级自托管Git服务，类似于GitHub和GitLab，但更加轻量、简单易用。对于个人开发者或小团队来说，Gogs是一个非常好的代码托管选择。本文将详细介绍如何在CentOS8系统上安装和配置Gogs服务。

## 准备工作

在开始安装之前，请确保您已经具备以下条件：

1. 一台运行CentOS8的服务器（物理机或虚拟机均可）
2. 拥有root权限或sudo权限的账户
3. 服务器已连接互联网
4. 基本熟悉Linux命令行操作

## 第一步：系统更新

在安装任何软件之前，建议先更新系统软件包：

```bash
sudo dnf update -y
sudo dnf upgrade -y

第二步：安装必要依赖

Gogs需要一些基础软件包才能正常运行：

sudo dnf install -y wget git tar unzip

第三步：安装和配置MySQL数据库

虽然Gogs支持SQLite、MySQL和PostgreSQL，但对于生产环境建议使用MySQL：

1. 安装MySQL服务器

sudo dnf install -y @mysql

2. 启动并启用MySQL服务

sudo systemctl enable --now mysqld

3. 运行安全安装脚本

sudo mysql_secure_installation

按照提示设置root密码并完成安全配置。

4. 创建Gogs数据库

登录MySQL：

mysql -u root -p

执行以下SQL命令创建数据库和用户：

CREATE DATABASE gogs CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'gogs'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON gogs.* TO 'gogs'@'localhost';
FLUSH PRIVILEGES;
EXIT;

第四步：安装和配置Git

Gogs依赖于Git，确保已安装最新版本：

sudo dnf install -y git

配置Git全局设置：

git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"

第五步：创建Gogs运行用户

为安全起见，建议创建一个专用用户来运行Gogs：

sudo adduser --system --shell /bin/bash --comment 'Gogs Service' --home /home/git git
sudo passwd git

第六步：下载并安装Gogs

1. 下载Gogs二进制包

cd /tmp
wget https://dl.gogs.io/0.12.3/gogs_0.12.3_linux_amd64.tar.gz

2. 解压并安装

sudo tar -zxvf gogs_0.12.3_linux_amd64.tar.gz -C /opt
sudo ln -s /opt/gogs /home/git/gogs
sudo chown -R git:git /opt/gogs /home/git/gogs

第七步：配置Gogs

1. 创建配置文件

sudo -u git cp /opt/gogs/custom/conf/app.ini.sample /opt/gogs/custom/conf/app.ini

2. 编辑配置文件

sudo -u git nano /opt/gogs/custom/conf/app.ini

主要修改以下部分：

[server]
DOMN           = your-domain.com
HTTP_PORT        = 3000
ROOT_URL        = http://your-domain.com:3000/
DISABLE_SSH      = false
SSH_PORT         = 22
START_SSH_SERVER = false
OFFLINE_MODE     = false

[database]
DB_TYPE  = mysql
HOST     = 127.0.0.1:3306
NAME     = gogs
USER     = gogs
PASSWD   = your_strong_password
SSL_MODE = disable

第八步：配置Gogs为系统服务

1. 创建systemd服务文件

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

添加以下内容：

[Unit]
Description=Gogs (Go Git Service)
After=syslog.target
After=network.target
After=mysqld.service

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

[Install]
WantedBy=multi-user.target

2. 启动并启用Gogs服务

sudo systemctl daemon-reload
sudo systemctl enable --now gogs

第九步：防火墙配置

如果启用了防火墙，需要开放相关端口：

sudo firewall-cmd --permanent --add-port=3000/tcp
sudo firewall-cmd --permanent --add-port=22/tcp
sudo firewall-cmd --reload

第十步：通过Web界面完成安装

现在可以通过浏览器访问Gogs的Web界面完成最后的配置：

打开浏览器，访问 http://your-server-ip:3000
首次访问会跳转到安装页面
填写数据库配置（与app.ini中一致）
设置管理员账户信息
点击”立即安装”按钮完成安装

第十一步：高级配置（可选）

1. 配置HTTPS访问

可以使用Let’s Encrypt免费证书：

sudo dnf install -y certbot python3-certbot-nginx
sudo certbot certonly --standalone -d your-domain.com

然后修改app.ini中的相关配置：

[server]
PROTOCOL         = https
ROOT_URL         = https://your-domain.com:3000/
CERT_FILE        = /etc/letsencrypt/live/your-domain.com/fullchain.pem
KEY_FILE         = /etc/letsencrypt/live/your-domain.com/privkey.pem

2. 配置反向代理（Nginx）

安装Nginx：

sudo dnf install -y nginx

创建Nginx配置文件：

sudo nano /etc/nginx/conf.d/gogs.conf

添加以下内容：

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

重启Nginx：

sudo systemctl enable --now nginx
sudo systemctl restart nginx

3. 配置邮件服务

修改app.ini中的邮件部分：

[mailer]
ENABLED = true
HOST    = smtp.your-email-provider.com:587
FROM    = gogs@your-domain.com
USER    = your-email@your-domain.com
PASSWD  = your-email-password

第十二步：备份与恢复

1. 备份Gogs数据

sudo -u git /opt/gogs/gogs backup --target /backup/gogs --database-only

2. 恢复Gogs数据

sudo -u git /opt/gogs/gogs restore --from /backup/gogs/backup-xxx.zip

常见问题解决

1. 无法访问3000端口

检查防火墙设置和SELinux状态：

sudo systemctl status firewalld
sudo getenforce

2. 数据库连接失败

检查MySQL服务状态和用户权限：

sudo systemctl status mysqld
mysql -u gogs -p

3. Gogs服务无法启动

查看服务日志：

journalctl -u gogs -f

性能优化建议

对于大型仓库，可以启用Git大文件存储(LFS)
定期清理不必要的仓库和分支
配置适当的缓存设置
考虑使用SSD存储提高IO性能

总结

通过以上步骤，您已经在CentOS8系统上成功安装并配置了Gogs自托管Git服务。Gogs以其轻量级和易用性著称，非常适合个人开发者和小型团队使用。您可以根据实际需求进一步定制和优化Gogs的配置。

附录

1. 相关资源链接

Gogs官方网站：https://gogs.io/
Gogs文档：https://gogs.io/docs
Gogs GitHub仓库：https://github.com/gogs/gogs

2. 推荐阅读

《Git权威指南》
《Pro Git》中文版
《Git团队协作》

3. 版本说明

本文基于以下软件版本编写： - CentOS 8.4 - Gogs 0.12.3 - MySQL 8.0 - Git 2.27.0

”`

这篇文章详细介绍了在CentOS8上安装Gogs的完整过程，包括系统准备、依赖安装、数据库配置、Gogs安装与配置、服务管理、防火墙设置以及高级配置选项等。按照这个指南，您应该能够成功搭建自己的Git托管服务。