

在软件开发的世界里，Git 已经成为版本控制的事实标准。GitHub、GitLab 等平台提供了强大的托管服务，但有时候，我们需要一个完全属于自己的私有 Git 仓库——可能是为了代码安全，可能是为了定制化需求，可能是为了集成到现有服务中，也可能只是想在自己的服务器上搭建一个个人代码库。开源gitlab有点重，最近我在GitHub上发现了一个轻量级项目`Gogs`。

![](https://developer.qcloudimg.com/http-save/yehe-9735680/cb620d0084aa003e6a0c9143f44583db.png)


## 什么是 Gogs？

Gogs 是一个用 Go 语言编写的自助 Git 托管服务。它的目标是以最简单、最轻松的方式搭建一个简单、稳定且可扩展的 Git 服务。得益于 Go 语言的跨平台特性，Gogs 可以在 Linux、macOS、Windows 以及基于 ARM 的系统上以独立的二进制文件运行。

该项目在github上已有`47.5k` star

![](https://developer.qcloudimg.com/http-save/yehe-9735680/bd18fff54b8abe8e870da958f9a909e3.png)


github地址：[https://github.com/gogs/gogs](https://github.com/gogs/gogs)

文档地址: [https://gogs.io/](https://gogs.io/)



## 为什么选择 Gogs？

### 轻量级，低资源占用

Gogs 最吸引人的特点就是轻量。有人在仅有 64MB 内存的 Docker 容器中运行 Gogs！对于团队协作，2 个 CPU 核心和 512MB 内存就足够起步了。

### 功能丰富，不输大厂

别看 Gogs 轻量，该有的功能一个都不少：

- **用户面板**：用户仪表板、个人资料和活动时间线
- **多协议访问**：支持 SSH、HTTP 和 HTTPS 协议访问仓库
- **完整的管理功能**：用户、组织和仓库管理
- **Webhook**：支持 Slack、Discord、钉钉等
- **Git 钩子**：Git hooks、部署密钥和 Git LFS
- **协作功能**：工单（Issues）、合并请求（Pull Requests）、Wiki、受保护分支
- **仓库迁移**：从其他代码托管平台迁移和镜像仓库
- **Web 编辑器**：在线编辑仓库文件和 Wiki
- **多格式渲染**：支持 Jupyter Notebook 和 PDF 渲染
- **多认证方式**：SMTP、LDAP、反向代理、GitHub.com、GitHub Enterprise，支持两步验证
- **多语言支持**：超过 31 种语言的本地化

### 数据库支持丰富

Gogs 支持多种数据库后端：PostgreSQL、MySQL、SQLite3，以及任何支持这些协议的数据库。

## Docker 部署：5 分钟快速上手

以下是Docker具体的部署步骤：

### 第一步：拉取镜像

```bash
docker pull gogs/gogs
```

### 第二步：创建docker-compose.yml文件

创建一个部署目录`gogs`,在该目录下创建docker-compose.yml文件，内容如下：

```yaml
services:
  gogs:
    image: gogs/gogs
    container_name: gogs
    ports:
      - "10022:22"
      - "10880:3000"
    volumes:
      - ./data:/data
    restart: unless-stopped

```

这里解释一下各个参数的含义：
- `- "10022:22"`：将宿主机的 10022 端口映射到容器的 22 端口（SSH 服务）
- `- "10880:3000"`：将宿主机的 10880 端口映射到容器的 3000 端口（Web 服务）
- `- ./data:/data`：将宿主机的 `./data` 目录挂载到容器的 `/data` 目录


### 第三步：运行容器

```bash
docker-compose up -d 
```

出现如下内容则说明启动成功

![](https://developer.qcloudimg.com/http-save/yehe-9735680/01a59ad0a4e8ba025c93b0108274d195.png)




### 第四步：初始配置

启动容器后，通过浏览器访问 `http://你的服务器IP:10880` 进入安装页面。

我们需要先创建好所需要的数据库，我使用的是mysql


![](https://developer.qcloudimg.com/http-save/yehe-9735680/23e95e69659b88c7eec8fa2b3c71288c.png)



![](https://developer.qcloudimg.com/http-save/yehe-9735680/22c9917dd2a9cabb94a96fd3fe4ae455.png)



![](https://developer.qcloudimg.com/http-save/yehe-9735680/8b00b999d042aa924eb9d24e688c5940.png)




![](https://developer.qcloudimg.com/http-save/yehe-9735680/bd18fff54b8abe8e870da958f9a909e3.png)



### 第五步：使用

使用相对来说比较简单，此处不多做讲解

![](https://developer.qcloudimg.com/http-save/yehe-9735680/6e8f1af3e5da182a56d423f4fa3f269d.png)




## 常见问题与解决方案

### 1. 内置 SSH 服务器不推荐

在 Docker 容器内使用内置 SSH 服务器不被推荐。建议使用映射到宿主机的 SSH 端口（如示例中的 10022）。

## 其他方式部署

还有其他二进制包部署等方式，家人们可参考一下文章

使用 Gogs 搭建自己的 Git 服务器：[https://blog.mynook.info/post/host-your-own-git-server-using-gogs/](https://blog.mynook.info/post/host-your-own-git-server-using-gogs/)

![](https://developer.qcloudimg.com/http-save/yehe-9735680/88484cc3a34a43b5ce206dde8b8e2976.png)


## 结语

Gogs 是一个小而美的 Git 服务解决方案。无论你是想在个人服务器上搭建私有的代码仓库，还是为小团队提供一个轻量级的代码协作平台，Gogs 都是一个值得考虑的选择。

它的简洁并不意味着功能的缺失，相反，Gogs 在保持轻量的同时，提供了 Git 托管服务所需的核心功能。加上 Docker 的一键部署，你可以在几分钟内拥有一个属于自己的 Git 服务。


在软件开发的世界里，Git 已经成为版本控制的事实标准。GitHub、GitLab 等平台提供了强大的托管服务，但有时候，我们需要一个完全属于自己的私有 Git 仓库——可能是为了代码安全，可能是为了定制化需求，可能是为了集成到现有服务中，也可能只是想在自己的服务器上搭建一个个人代码库。开源gitlab有点重，最近我在GitHub上发现了一个轻量级项目Gogs。

Gogs: 打造属于你自己的轻量级 Git 服务

Gogs 是一个小而美的 Git 服务解决方案。无论你是想在个人服务器上搭建私有的代码仓库，还是为小团队提供一个轻量级的代码协作平台，Gogs 都是一个值得考虑的选择。

后端

编程语言

开发工具

Gogs是一个轻量级自托管Git服务，用Go语言编写，支持多平台部署。仅需64MB内存即可运行，功能齐全：多协议访问、仓库管理、Webhook、工单系统等。支持多种数据库和Docker快速部署，5分钟即可搭建私有Git仓库。适合个人开发者和小团队使用，47.5k星GitHub热门项目。

2026采购季 | AI焕新·智启新局

4核4G3M云服务器 新用户低至38元/年！

tencentdb-catalog

腾讯云数据库特惠，新用户首单0.5折起


postgres

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Gogs: 打造属于你自己的轻量级 Git 服务-腾讯云开发者社区-腾讯云

Gogs: 打造属于你自己的轻量级 Git 服务

Gogs: 打造属于你自己的轻量级 Git 服务

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐