必须启用系统SSH服务并创建git用户,再用--bare初始化裸仓库、配置denyCurrentBranch=ignore及权限,最后通过ssh git@hostname.local验证连接并克隆推送。

要在Mac上搭建本地私有Git服务器环境,必须利用系统自带的SSH服务和Git裸仓库机制,无需安装额外Web界面服务,仅通过终端命令即可完成全部配置,整个过程不依赖网络、不暴露公网、不启动HTTP服务。
确认并启用系统SSH服务
macOS已预装OpenSSH服务,但默认关闭。打开“系统设置”→“通用”→“共享”,勾选“远程登录”。【必须确保当前账户或指定用户出现在下方列表中,否则客户端无法认证】
终端执行 sudo systemsetup -getremotelogin,若返回 Remote Login: On 表示已启用。
这一步不能跳过——没有SSH,git over ssh协议就完全不可用,所有后续操作都会失败。
创建专用git用户(推荐)
方法一:图形界面创建
“系统设置”→“用户与群组”→左下角锁图标解锁→点击“+”→设置账户名为 git,账户类型选“标准”,密码设为强密码(如 g1tS3rv3r2026)。
方法二:命令行创建(需管理员权限)sudo sysadminctl -addUser git -fullName "Git Server" -password "g1tS3rv3r2026"
【新建用户后必须再次进入“共享”→“远程登录”,将该git用户加入允许列表,否则SSH拒绝连接】
初始化裸仓库并设置权限
第一步:在git用户主目录下创建仓库存放路径sudo -u git mkdir -p /Users/git/repositories
第二步:创建一个裸仓库(以 myproject.git 为例)sudo -u git git --bare init /Users/git/repositories/myproject.git
第三步:修正权限,避免客户端push时提示“Permission denied (publickey)”sudo chown -R git:staff /Users/git/repositoriessudo chmod -R g+sw /Users/git/repositories
在提交旁边记录AI编码会话,以便代理程序可以恢复代码更改的原因、从检查点恢复以及干净地交接工作。
裸仓库不能有工作区,--bare 是硬性要求;漏掉会导致客户端克隆后无法接收push,且报错信息极不直观。
配置接收推送行为
编辑裸仓库的配置文件:sudo -u git nano /Users/git/repositories/myproject.git/config
在文件末尾添加以下三行:
[receive] denyCurrentBranch = ignore advertiseRefTips = false
保存退出。这一步决定服务器是否接受远程push——不加 denyCurrentBranch = ignore,所有push操作都会被拒绝并返回 fatal: refusing to update checked out branch。
客户端验证连接与克隆
在另一台Mac或同一台机器的普通用户终端中执行:ssh git@$(hostname).local
输入密码后能成功登录,说明SSH通路正常。
接着执行克隆命令:git clone git@$(hostname).local:/Users/git/repositories/myproject.git
如果提示 fatal: '/Users/git/repositories/myproject.git' does not appear to be a git repository,请检查路径拼写、用户权限及是否漏掉 .git 后缀。
克隆成功后,进入本地目录,添加文件、提交、推送:echo "# test" > README.md && git add . && git commit -m "init" && git push origin master

















