在团队协作开发中，使用公网平台托管代码虽然方便，但受网络波动和隐私安全限制。搭建本地局域网Git服务器能实现高速内网传输、完全掌控数据权限，且无需担心外网延迟。本文将用大白话带你从零搭建局域网Git环境，涵盖仓库初始化、SSH免密配置、日常分支协作及常见坑位排查，适合中小团队快速上手。
准备工作与环境配置
首先确保所有参与电脑的操作系统已安装Git。Windows用户可在官网下载并勾选命令行工具集成选项，Mac和Linux通常自带或通过包管理器一键安装。接着选定一台性能稳定、常开机的电脑作为Git服务端，建议固定内网IP地址。在终端输入ipconfig或ifconfig查看当前IP，记下类似192.168.1.100的字符串。服务端只需普通系统账户即可，不需要额外安装Web服务或数据库，纯靠Git自带的协议就能跑通。
创建远程仓库
在服务器上打开终端，进入你想存放项目的目录，执行git init --bare命令。带bare参数的初始化会创建一个裸仓库，里面只有版本控制文件而不包含实际工作区代码，这是Git官方推荐的做法。创建完成后，你会看到一堆HEAD、objects、refs等隐藏文件夹。此时仓库已经就绪，其他同事可以通过内网路径或SSH地址进行连接。为了便于管理，建议按项目命名目录，比如srv/git/project-alpha。
配置SSH免密登录
每次推送代码都输密码效率太低，配置SSH密钥是局域网协作的标准动作。在服务端生成密钥对后，将公钥分发给所有客户端。具体操作是在每台电脑上运行ssh-keygen -t ed25519，一路回车生成默认文件。拿到生成的id_ed25519.pub内容后，将其追加到服务器的.ssh/authorized_keys文件中。如果没有这个文件就新建一个，记得设置权限为600。配置完毕后，终端输入ssh username@server_ip测试连通性，首次连接需确认指纹，后续即可秒级免密交互。
克隆、推送与日常协作
环境打通后，开发者只需一条命令即可拉取代码。git clone ssh://username@server_ip/path/to/repo.git会把完整历史下载到本地。新增文件或修改完代码后，先用git add .暂存更改，再通过git commit -m 提交描述打上新标签。推送阶段执行git push origin master即可同步到服务端。多人并行开发时，务必养成先pull再push的习惯，避免覆盖冲突。遇到分支需求可以git branch feature-login创建新线，切换用checkout，合并回主分支用merge指令。配合git status随时查看当前状态，能让协作流程清爽不少。
常见问题排查与维护建议
局域网环境下最常见的问题是权限拒绝或连接超时。如果提示fatal unable to access，检查防火墙是否放行SSH端口，常规做法是关闭系统防火墙或开放22端口。若推送时报错permission denied，核对authorized_keys文件归属是否为服务器当前用户，且权限不能过于宽松。定期备份裸仓库非常关键，直接拷贝整个仓库目录或使用git bundle打包导出即可。此外，建议制定简单的分支命名规范，重要节点打tag标记版本号，防止误删主分支导致数据丢失。
掌握这套基础流程后，团队内部就能建立起稳定高效的代码管理机制。局域网Git不仅速度快，还能灵活对接自动化部署工具，逐步替代臃肿的第三方托管方案。保持习惯规范、定期清理无用分支，你的内网开发环境会越用越顺手。
