rockstorm/git-server

Git Server Docker镜像文档

概述

Git Server Docker是一个轻量级Docker镜像，包含可通过SSH协议访问的Git服务器。该镜像旨在简化Git服务器的部署流程，适用于需要在本地或内部网络中快速搭建私有Git仓库的场景。

镜像源代码地址：https://github.com/rockstorm101/git-server-docker

核心功能与特性

• 提供基础Git服务器功能，支持标准Git操作（克隆、推送、拉取等）
• 通过SSH协议进行仓库访问和身份验证
• 支持多种自定义配置选项，包括：
  • 设置自定义密码
  • 使用SSH公钥认证
  • 配置自定义主机SSH密钥
  • 启用无绝对路径的Git URL访问
  • 禁用git用户交互式登录
  • 自定义git用户的UID和GID

使用场景

适用于个人开发、小型团队协作或内部网络环境，需要快速部署私有Git仓库且对资源占用有一定要求的场景。不建议直接暴露在公共互联网环境中（详见安全注意事项）。

部署与使用方法

基本部署命令

使用以下命令启动Git服务器容器：

bash
docker run -v git-repositories:/srv/git -p 2222:22 rockstorm/git-server

参数说明：

• -v git-repositories:/srv/git：将容器内的/srv/git目录（Git仓库存储路径）挂载到命名卷git-repositories，实现仓库数据持久化
• -p 2222:22：将主机的2222端口映射到容器的22端口（SSH服务默认端口）

访问仓库示例

服务器启动后，可通过以下命令克隆仓库（需先在服务器端创建对应仓库）：

bash
git clone ssh://git@localhost:2222/srv/git/your-repo.git

默认访问凭据：

• 默认用户名：git
• 默认密码：12345（建议首次使用后立即修改）

安全注意事项

重要提示：将此服务器直接暴露到公共互联网存在安全风险。该镜像的默认配置并非为生产环境优化的安全配置。使用前请务必阅读https://github.com/rockstorm101/git-server-docker%E4%B8%AD%E7%9A%84%E5%AE%89%E5%85%A8%E5%BB%BA%E8%AE%AE%EF%BC%8C%E9%87%87%E5%8F%96%E5%BF%85%E8%A6%81%E7%9A%84%E5%AE%89%E5%85%A8%E5%8A%A0%E5%9B%BA%E6%8E%AA%E6%96%BD%E3%80%82

高级配置选项

该镜像支持丰富的自定义配置，详细说明请参考https://github.com/rockstorm101/git-server-docker%EF%BC%8C%E4%B8%BB%E8%A6%81%E5%8C%85%E6%8B%AC%EF%BC%9A

• 配置自定义密码替代默认密码
• 配置SSH公钥认证以提高安全性
• 生成和使用自定义主机SSH密钥
• 配置简化的Git URL（无需指定绝对路径）
• 禁用git用户的交互式shell登录
• 调整git用户的UID和GID以匹配主机用户权限

支持的标签与变体

有关该镜像的可用标签和变体信息，请参见源代码仓库的https://github.com/rockstorm101/git-server-docker#variants%E5%92%8Chttps://github.com/rockstorm101/git-server-docker#tagging-scheme%E9%83%A8%E5%88%86%E3%80%82

许可证信息

镜像中包含的软件许可证信息请查看https://github.com/rockstorm101/git-server-docker/blob/master/LICENSE%E3%80%82

与所有Docker镜像一样，本镜像可能包含基础发行版提供的其他软件（如Bash等），这些软件可能具有独立的许可证。使用本镜像时，用户应确保对其中所有软件的使用符合相关许可证要求。