怎么用Gogs搭建属于自己的Git服务器

发布时间：2021-12-13 09:50:46 作者：柒染
来源：亿速云阅读：247

# 怎么用Gogs搭建属于自己的Git服务器

在当今的软件开发中，Git已经成为版本控制的事实标准。虽然GitHub、GitLab等平台提供了强大的托管服务，但出于隐私、安全或定制化需求，许多团队和个人选择搭建自己的Git服务器。Gogs（Go Git Service）是一个用Go语言编写的轻量级自托管Git服务，具有安装简单、资源占用低等特点。本文将详细介绍如何从零开始搭建Gogs服务器。

## 一、准备工作

### 1. 硬件要求
- 最低配置：1核CPU / 512MB内存（适合小型团队或个人项目）
- 推荐配置：2核CPU / 2GB内存（支持20人左右团队协作）
- 存储空间根据项目大小决定，建议预留10GB以上

### 2. 软件环境
- **操作系统**：Linux（推荐Ubuntu 20.04+或CentOS 7+）
- **数据库**：MySQL 5.7+/PostgreSQL/SQLite3（本文以MySQL为例）
- **Git**：1.8.3或更高版本
- Web服务器（可选）：Nginx/Apache（用于HTTPS和域名绑定）

## 二、安装步骤

### 1. 安装基础依赖
```bash
# Ubuntu/Debian
sudo apt update
sudo apt install -y git mysql-server

# CentOS/RHEL
sudo yum install -y git mysql-server

2. 配置MySQL数据库

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

3. 下载并安装Gogs

# 创建专用用户
sudo useradd -m git
sudo su - git

# 下载二进制包（请替换为最新版本）
wget https://dl.gogs.io/0.12.3/gogs_0.12.3_linux_amd64.tar.gz
tar -xzvf gogs_*.tar.gz
cd gogs

4. 初始配置

编辑 custom/conf/app.ini 文件：

[server]
DOMN           = git.yourdomain.com
HTTP_PORT        = 3000
ROOT_URL         = http://git.yourdomain.com:3000/

[database]
DB_TYPE  = mysql
HOST     = 127.0.0.1:3306
NAME     = gogs
USER     = gogs
PASSWD   = your_password

5. 启动服务

./gogs web

首次访问 http://服务器IP:3000 会进入安装向导，完成管理员账号设置。

三、高级配置

1. 配置为系统服务

创建systemd服务文件 /etc/systemd/system/gogs.service：

[Unit]
Description=Gogs
After=syslog.target
After=network.target

[Service]
User=git
Group=git
WorkingDirectory=/home/git/gogs
ExecStart=/home/git/gogs/gogs web
Restart=always

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl enable gogs
sudo systemctl start gogs

2. 配置HTTPS和域名

Nginx配置示例：

server {
    listen 80;
    server_name git.yourdomain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name git.yourdomain.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
    }
}

3. 邮件通知配置

在app.ini中添加：

[mailer]
ENABLED = true
HOST = smtp.your-email.com:587
FROM = no-reply@yourdomain.com
USER = your-email@yourdomain.com
PASSWD = your-email-password

四、日常维护

1. 数据备份

# 备份数据库
mysqldump -u gogs -p gogs > gogs.sql

# 备份仓库数据
tar -czvf gogs-repositories.tar.gz /home/git/gogs-repositories

2. 版本升级

停止服务：systemctl stop gogs
备份当前安装目录
下载新版解压覆盖（注意保留custom/conf和data目录）
重启服务

五、常见问题解决

无法推送大文件：修改app.ini中的[repository.upload]部分：
```
FILE_MAX_SIZE = 100
MAX_FILES = 50
```
性能优化：
- 启用缓存：配置[cache]和[session]使用Redis
- 对于大型仓库，启用git gc定期清理：
```
sudo -u git crontab -e
# 添加：0 3 * * * cd /home/git/gogs && ./gogs admin repo-gc
```
LDAP/AD集成：在app.ini中配置[auth]部分支持企业账号系统

结语

通过以上步骤，你已经成功搭建了一个功能完整的Git服务器。Gogs的轻量级特性使其特别适合中小团队或个人开发者，同时它提供的Issues、Pull Request等协作功能也能满足基本开发需求。随着使用深入，你还可以探索Web钩子、CI集成等高级功能，构建更完善的开发工作流。 “`

这篇文章包含了： 1. 详细的安装步骤 2. 配置说明（基础+高级） 3. 维护指南 4. 常见问题解决方案 5. 实际可执行的命令示例 6. 结构化排版（Markdown标题层级）

可根据实际环境调整数据库类型、域名等参数。建议在正式部署前先在测试环境验证。