



# 一、Gogs介绍




## 1.1 Gogs 简介
>`Gogs` 是一款使用 Go 语言开发的轻量级、易于部署的自助式 Git 服务，旨在为个人和团队提供简单高效的代码托管解决方案。

## 1.2 Gogs主要特点

*   **用户仪表板与个人资料：** 提供直观的用户仪表板和可自定义的个人资料页面，方便用户管理自身信息。
*   **活动时间线：** 记录并展示用户的操作历史，清晰呈现项目动态。
*   **多协议仓库访问：** 支持通过 SSH、HTTP 和 HTTPS 三种协议进行代码仓库的克隆与推送。
*   **用户组织仓库管理：** 提供完善的用户、组织及代码仓库的创建、配置和权限管理功能。
*   **支持多种 Webhooks：** 支持仓库和组织级别的 Webhooks，可与 Slack、Discord、钉钉等第三方工具集成。
*   **Git 高级功能支持：** 支持 Git 钩子、部署密钥以及 Git LFS（Large File Storage），满足复杂开发需求。
*   **代码协作功能：** 提供问题跟踪（Issues）、拉取请求（Pull Requests）、Wiki 文档和受保护分支等协作开发功能。
*   **仓库迁移与镜像：** 支持从其他代码平台（如 GitHub、GitLab）迁移或镜像仓库到 Gogs。
*   **在线文件编辑：** 内置 Web 文件编辑器，可直接在浏览器中快速修改代码或 Wiki 内容。
*   **文档渲染支持：** 可直接在浏览器中渲染并查看 Jupyter Notebook (.ipynb) 和 PDF 文件。
*   **多种认证方式：** 支持 SMTP 邮件、LDAP、反向代理、GitHub 及 GitHub Enterprise（含 2FA）等多种登录认证方式。
*   **界面与内容自定义：** 允许自定义 HTML 模板、静态资源文件等，便于个性化部署。
*   **多数据库支持：** 兼容 PostgreSQL、MySQL、SQLite3 和 TiDB 等多种数据库后端。
*   **多语言本地化：** 提供超过 31 种语言的界面翻译，支持国际化使用。













# 二、本次实践规划
## 2.1 本地环境规划
>本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。


|hostname| IP地址  | 操作系统版本   |Docker版本   |部署项目
|--|--| --|  --|--|
|jeven01 |192.168.3.88  | Ubuntu 24.04.2 LTS| 28.3.3    | Gogs


## 2.2 本次实践介绍
>1.本次实践部署环境为个人测试环境，生产环境请谨慎；
>2.在Docker环境下部署Gogs服务器。





# 三、本地环境检查

## 3.1 检查Docker服务状态
>检查Docker服务是否正常运行，确保Docker正常运行。



```bash
root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Mon 2025-08-04 10:10:52 UTC; 30min ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 860 (dockerd)
      Tasks: 10
     Memory: 97.2M (peak: 98.4M)
        CPU: 606ms
     CGroup: /system.slice/docker.service
```



## 3.2  检查Docker版本
>检查Docker版本

```bash
root@jeven:~# docker -v
Docker version 28.3.3, build 980b856
```


## 3.3 检查docker compose 版本
>检查Docker compose版本，确保2.0以上版本。


```bash
docker compose version
```


# 四、拉取Gogs镜像
>下载Gogs容器镜像，如下所示

```bash
docker pull gogs/gogs:latest
```




![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/5539b1a1a4d0971aae64b60afe045ccd.png)




























# 五、部署Gogs服务


## 5.1 创建部署目录
- 创建部署目录

```bash
mkdir -p /data/gogs/data   &&  cd /data/gogs/
```
- 目录授权

```bash
chmod -R 777 /data/gogs/
```

## 5.2 编辑部署文件

>使用docker-cli方式部署，可参考以下命令：

```bash
docker run -d \
   --restart unless-stopped \
   --name gogs \
   -p 3200:3000 \
   -p 4200:22 \
   -v /data/gogs/data:/data \
   gogs/gogs:latest

```


>在部署目录下，创建docker-compose.yaml文件，内容如下所示：


```bash
vim docker-compose.yaml
```

```yaml
version: '3.9'
services:
    gogs:
        image: 'gogs/gogs:latest'
        volumes:
            - '/data/gogs/data:/data'
        ports:
            - '4200:22'
            - '3200:3000'
        container_name: gogs
        restart: always

```



- 端口介绍：

| 本地端口 | 容器端口 | 说明 |
| :--- | :--- | :--- |
| 3200 | 3000 | Gogs 主服务端口，用于通过浏览器访问 Web 管理界面 |
| 4200 | 22 | SSH 服务端口，用于通过 Git 的 SSH 协议进行代码克隆、推送和拉取操作 |








## 5.3 创建Gogs容器
>执行以下命令，创建Gogs容器。


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






![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/a0190181b9b9974b94286c387a96d5b3.png)

















## 5.4 查看Gogs容器状态
>检查Gogs容器运行状态，确保Gogs容器正常启动。

```bash
root@jeven:/data/gogs#  docker compose ps
WARN[0000] /data/gogs/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME      IMAGE              COMMAND                   SERVICE   CREATED         STATUS                   PORTS
gogs      gogs/gogs:latest   "/app/gogs/docker/st…"   gogs      2 minutes ago   Up 2 minutes (healthy)   0.0.0.0:4200->22/tcp, [::]:4200->22/tcp, 0.0.0.0:3200->3000/tcp, [::]:3200->3000/tcp
```





## 5.5 检查容器运行日志

>检查Gogs容器运行日志，确保Gogs服务正常运行。

```bash
docker compose logs
```


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/7145c2a91f838f280a3f5aab6f7a5d00.png)






























# 六、访问Gogs服务

## 6.1 访问Gogs初始页




>浏览器地址： `http://<个人的服务器IP>:4200`，访问Gogs的初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。





![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/f7a7389972f9c572b997c44c44002916.png)




## 6.2 初始化配置


- 数据库配置：可以选择用 MySQL、PostgreSQL、SQLite3 等数据库，这里为了快速部署，直接使用SQLite3数据库。


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/2a1d72d97e894301d35385f65aafe6b8.png)




- 应用基本配置，可参考如下：


>- 域名： 填写宿主机的主机名或 IP地址，将默认的 localhost 改为 192.168.3.88
>- 应用 URL：填写公开的访问地址，将默认的 http:// localhost:3000/ 改为 http:// 192.168.3.88:3200
>- SSH端口号：如果要启用SSH功能，则可以修改宿主机映射的4200端口
>- 其余默认不变。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/69d259d94054fb705e2efc31e6c30afb.png)


- 管理员设置： 自定义设置管理员账号信息，点击“立即安装”。




![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/afdc1c1b747db869407a0dc4729df730.png)



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/0ecf92f1f486de5a50fdec29b6bb942b.png)











## 6.3 创建Git仓库

>点击Gogs首页的【我的仓库】旁边“+”选项，立即创建仓库。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/5c4e69eb976d0579e5b8c0d1e16c8cc7.png)


>填写仓库名称后，确认创建即可。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/51650bf81e2006bc1ea3d4b8069f68e4.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/af281af19799b25d999de24f5d109108.png)
## 6.4 管理面板


>点击“管理面板”选项，进入到该页面进行相关操作。


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/23de22181d08729fb591927b2ba5c551.png)


# 七、总结



>通过本次实践，我们成功使用Docker快速部署了轻量级Git服务器Gogs，整个过程简洁高效。Gogs凭借其易于安装、界面友好和功能齐全的特点，非常适合个人开发者或小型团队搭建私有代码仓库。Docker的容器化方式进一步简化了环境依赖和部署流程，提升了服务的可移植性与维护性。未来可根据实际需求进一步配置备份、HTTPS加密或集成CI/CD流程，提升代码管理的安全性与自动化水平。


Gogs 是一款使用 Go 语言开发的轻量级、易于部署的自助式 Git 服务，旨在为个人和团队提供简单高效的代码托管解决方案。

轻量高效！用Docker运行Gogs，搭建属于你的私有GitHub

开发工具

后端

云计算

Gogs是一款基于Go语言开发的轻量级Git服务，支持多协议仓库访问、Webhooks集成、Git高级功能及代码协作工具。本文详细介绍在Ubuntu24.04系统下使用Docker部署Gogs的完整流程，包括环境检查、镜像拉取、容器创建及初始化配置步骤，帮助开发者快速搭建私有代码托管平台。

云服务器

PostgreSQL

服务器

数据库

防火墙

容器

Docker

GitHub

MySQL

2026新春采购季

tencentdb-catalog

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

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


postgres

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

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

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

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

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

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

社区新版编辑器体验调研

轻量高效！用Docker运行Gogs，搭建属于你的私有GitHub-腾讯云开发者社区-腾讯云

轻量高效！用Docker运行Gogs，搭建属于你的私有GitHub

轻量高效！用Docker运行Gogs，搭建属于你的私有GitHub

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐