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

# 一、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 ```  # 五、部署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 ```  ## 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 ```  # 六、访问Gogs服务 ## 6.1 访问Gogs初始页 >浏览器地址： `http://<个人的服务器IP>:4200`，访问Gogs的初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。  ## 6.2 初始化配置 - 数据库配置：可以选择用 MySQL、PostgreSQL、SQLite3 等数据库，这里为了快速部署，直接使用SQLite3数据库。  - 应用基本配置，可参考如下： >- 域名： 填写宿主机的主机名或 IP地址，将默认的 localhost 改为 192.168.3.88 >- 应用 URL：填写公开的访问地址，将默认的 http:// localhost:3000/ 改为 http:// 192.168.3.88:3200 >- SSH端口号：如果要启用SSH功能，则可以修改宿主机映射的4200端口 >- 其余默认不变。  - 管理员设置： 自定义设置管理员账号信息，点击“立即安装”。   ## 6.3 创建Git仓库 >点击Gogs首页的【我的仓库】旁边“+”选项，立即创建仓库。  >填写仓库名称后，确认创建即可。   ## 6.4 管理面板 >点击“管理面板”选项，进入到该页面进行相关操作。  # 七、总结 >通过本次实践，我们成功使用Docker快速部署了轻量级Git服务器Gogs，整个过程简洁高效。Gogs凭借其易于安装、界面友好和功能齐全的特点，非常适合个人开发者或小型团队搭建私有代码仓库。Docker的容器化方式进一步简化了环境依赖和部署流程，提升了服务的可移植性与维护性。未来可根据实际需求进一步配置备份、HTTPS加密或集成CI/CD流程，提升代码管理的安全性与自动化水平。