如何快速搭建本地Git服务器？

Git本地服务器搭建指南

在团队协作或独立开发中，搭建本地Git服务器能实现代码的集中管理和高效同步，本文将详细介绍如何通过简单的步骤,在局域网或物理机环境中快速部署一个安全的Git本地服务器。

前置条件

1. 硬件需求
   • 一台作为服务器的计算机（Linux/Windows/macOS均可，推荐Linux）。
   • 确保服务器与客户端处于同一网络环境（如局域网）。
2. 软件需求
   • 安装Git：所有设备需安装Git（官网下载链接）。
   • SSH服务（Linux/macOS默认支持；Windows需启用OpenSSH）。

搭建步骤

在服务器上创建Git仓库

• 初始化裸仓库
  裸仓库（bare repository）不包含工作目录，适合作为中央仓库，执行以下命令：

  mkdir -p /opt/git/project.git
  cd /opt/git/project.git
  git init --bare

• 权限配置
  确保仓库目录权限允许团队成员访问（以Linux为例）：

  

  chown -R gituser:gitgroup /opt/git/project.git  # 替换为实际用户/组
  chmod -R 775 /opt/git/project.git

配置SSH访问

• 生成SSH密钥（客户端操作）
  在客户端生成密钥对：

  ssh-keygen -t ed25519  # 推荐使用ed25519算法

  将公钥（~/.ssh/id_ed25519.pub复制到服务器的~/.ssh/authorized_keys文件中。

• 测试SSH连接
  客户端执行：

  ssh gituser@server_ip  # 替换为服务器用户名和IP

克隆与推送代码

• 客户端克隆仓库

  

  git clone gituser@server_ip:/opt/git/project.git

• 日常使用流程

  git add .
  git commit -m "提交说明"
  git push origin main

高级配置（可选）

通过HTTP协议访问

安装Git的Web服务组件（如gitweb或cgit），或使用轻量级工具如：

# 使用Python临时启用HTTP服务（仅测试环境）
cd /opt/git/project.git
python3 -m http.server 8000

权限精细化管理

• 使用Gitosis/Gitolite
  适用于团队权限控制，支持按分支、目录设置读写权限（Gitolite文档）。

• 配置钩子脚本（Hooks）
  在/opt/git/project.git/hooks/目录下添加脚本，

  # post-receive示例：推送后自动部署
  #!/bin/sh
  git --work-tree=/var/www/html checkout -f

注意事项

1. 安全性建议
   • 禁用服务器的Shell登录权限（通过编辑/etc/passwd将Git用户Shell改为git-shell）。
   • 定期备份仓库目录（/opt/git）。
2. 常见问题排查
   • 权限错误：检查目录所有权和authorized_keys文件权限（应为600）。
   • 连接超时：确认防火墙是否放行SSH端口（默认22）。

引用说明
本文参考了Git官方文档、SSH协议规范及开源社区最佳实践，技术细节可通过Git官网或Gitolite文档进一步查阅。