jenserat/gogs

Gogs Docker镜像文档

Gogs是一个用Go语言编写的自托管Git服务，本Docker镜像提供了Gogs的便捷部署方案，支持私有代码仓库管理、用户权限控制等核心功能，适合个人或团队搭建私有Git服务。

镜像概述

该镜像封装了Gogs服务，包含所有运行所需依赖，支持数据持久化存储、多种数据库配置及灵活的端口映射，便于快速部署和维护自托管Git服务。

核心功能与特性

• 自托管Git服务：完整支持Git功能，包括代码仓库管理、分支控制、提交历史等
• 数据持久化：关键数据通过卷(vol)挂载，确保数据不丢失
• 多数据库支持：兼容PostgreSQL、MySQL/MariaDB和SQLite，镜像内置所有必要驱动
• 自动数据库维护：Gogs可自动处理数据库升级，无需手动干预
• 灵活端口配置：暴露SSH(22)和HTTP(3000)端口，支持端口重定向

数据存储与端口

数据卷挂载点

以下路径已定义为卷，建议通过外部挂载实现数据持久化：

• /opt/gogs/data：存储上传文件（头像、附件等）
• /opt/gogs/custom：自定义配置文件目录
• /srv：git用户主目录，包含代码仓库和授权密钥
• /etc/ssh：sshd配置文件和主机密钥

暴露端口

• 22：SSH服务端口
• 3000：HTTP服务端口

提示：端口可通过Docker端口映射功能重定向，需同步修改Gogs配置文件中的URI设置

配置说明

首次启动配置

首次启动Gogs时，安装向导会预填关键配置项并自动生成数据库。完成初始配置后，可通过以下方式进行进一步配置：

1. 编辑配置文件：/opt/gogs/custom/config.ini
2. 配置参数参考Gogs官方配置文档

数据库配置

支持以下数据库系统，无需额外安装驱动：

• PostgreSQL
• MySQL/MariaDB
• SQLite

Gogs会自动处理数据库架构更新，升级时无需手动执行数据库维护操作。

使用方法

基本部署命令

bash
docker run -d \
    --name gogs \
    --restart always \
    --publish 22:22 \
    --publish 3000:3000 \
    --link gogs-postgresql:db \  # 如使用外部数据库，需链接数据库容器
    --volume /srv/gogs/data:/opt/gogs/data \
    --volume /srv/gogs/ssh:/etc/ssh \
    --volume /srv/gogs/custom:/opt/gogs/custom \
    --volume /srv/gogs/home:/srv \
    jenserat/gogs

自定义端口配置

实际部署中通常需要修改端口（如主机22端口已被占用），示例：

bash
docker run -d \
    --name gogs \
    --restart always \
    --publish 10022:22 \  # 映射SSH到主机10022端口
    --publish 10080:3000 \  # 映射HTTP到主机10080端口
    --volume /srv/gogs/data:/opt/gogs/data \
    --volume /srv/gogs/ssh:/etc/ssh \
    --volume /srv/gogs/custom:/opt/gogs/custom \
    --volume /srv/gogs/home:/srv \
    jenserat/gogs

升级与维护

自动数据库升级

Gogs会在启动时自动检测并升级数据库架构，无需手动干预。

容器维护

如需进入容器执行维护操作（假设容器名为gogs）：

bash
docker exec -ti gogs /bin/bash

更多维护信息

其他升级维护细节请参考Gogs官方文档。