palamccc/gogs Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Gogs - Go Git Service

!Gogs Logo

镜像概述和主要用途

Gogs的目标是提供最简单、快速且无痛苦的自托管Git服务搭建方式。通过Go语言开发，可作为独立二进制分发到Go支持的所有平台，包括Linux、Mac OS X、Windows及ARM架构设备，适用于个人、小型团队或企业搭建私有Git服务器。

核心功能和特性

• 活动时间线：追踪仓库和用户活动记录
• 多协议支持：SSH和HTTP/HTTPS协议
• 认证方式：支持SMTP、LDAP及反向代理认证
• 反向代理支持：支持带子路径的反向代理配置
• 完整的管理功能：账户、组织及仓库管理
• Webhooks与Git钩子：支持仓库/组织Webhooks（含Slack集成）及Git钩子/部署密钥
• 协作功能：仓库Issue跟踪、拉取请求和Wiki
• 权限管理：添加/移除仓库协作者
• 头像支持：Gravatar及自定义头像源
• 邮件服务：集成邮件通知功能
• 管理面板：完整的系统管理功能
• 多数据库支持：MySQL、PostgreSQL、SQLite3及TiDB（实验性）
• 多语言支持：支持18种语言

系统要求

• 基础功能：树莓派级别的设备即可满足
• 团队协作：建议至少2个CPU核心和1GB内存

浏览器支持

• 基于Semantic UI框架，支持主流浏览器（具体版本参考Semantic UI浏览器支持）
• 官方支持最小分辨率为1024*768，更小分辨率可能存在显示问题

使用方法和配置说明

Docker部署

基本运行命令

bash
docker run -d --name=gogs -p 3000:3000 -p 2222:22 -v /var/gogs:/data gogs/gogs

参数说明

• -p 3000:3000：映射Web界面端口
• -p 2222:22：映射SSH端口（避免与主机SSH冲突）
• -v /var/gogs:/data：持久化存储Gogs数据（包括仓库、配置等）

Docker Compose配置示例

yaml
version: '3'
services:
  gogs:
    image: gogs/gogs
    container_name: gogs
    ports:
      - "3000:3000"
      - "2222:22"
    volumes:
      - /var/gogs:/data
    restart: always
    environment:
      - TZ=Asia/Shanghai

初始化配置

1. 启动容器后，访问http://localhost:3000进入安装界面
2. 配置数据库（支持MySQL、PostgreSQL、SQLite3等）
3. 设置应用基本信息（站点名称、域名、SSH端口等）
4. 创建管理员账户
5. 完成配置后即可开始使用

数据持久化

所有数据（仓库、用户信息、配置文件等）均存储在/data目录，通过卷挂载确保数据持久化，避免容器重启后数据丢失。

适用场景

• 个人私有Git服务器
• 小型开发团队代码托管
• 企业内部代码管理系统
• 教育机构教学用Git平台
• 资源受限环境（如ARM设备）的Git服务部署

注意事项

• 生产环境建议使用外部数据库（如MySQL）而非SQLite3，提升性能和可靠性
• SSH端口映射时需避免与主机SSH服务（默认22端口）冲突
• 定期备份/data目录以防止数据丢失
• 安全漏洞报告请发送至***
• API功能处于实验阶段，文档参考go-gogs-client

许可证

本项目采用MIT许可证，详见LICENSE文件。