在团队协作或个人项目开发中,使用公共代码托管平台虽然方便,但受限于网络速度和隐私考量,很多开发者和小型团队更倾向于将代码库部署在内网环境中。搭建局域网Git服务器不仅能实现极速的读写体验,还能完全掌控数据主权。本教程将带你从零开始,在本地网络中快速配置一套稳定可靠的Git服务。
环境准备与基础检查
搭建局域网Git服务器对硬件要求极低,一台运行Linux、macOS或Windows的普通电脑即可胜任。首先确保所有参与设备的操作系统已安装Git命令行工具。Linux用户可通过终端执行sudo apt install git命令完成安装,Windows和macOS用户建议从官网下载标准安装包。其次,确认服务器端与客户端处于同一子网内,能够互相ping通。若使用Linux作为服务端,需提前安装openssh-server并启动SSH服务,这是Git远程传输的核心依赖。防火墙方面,请放行22端口及Git daemon所需的9418端口,避免连接被拦截。
服务端仓库初始化配置
登录到计划作为代码服务器的机器,创建专门用于存放Git仓库的目录。建议使用mkdir命令新建一个名为projects的文件夹,并在其中创建一个子目录代表你的项目。进入该目录后,执行git init --bare命令。这里必须强调--bare参数的重要性,它会生成一个不包含工作区的裸仓库,专为远程共享设计,能有效防止误操作覆盖文件。接着,给仓库添加描述信息,打开config文件或在同级目录新建description文件,填入项目名称和用途说明,方便其他协作者识别。
客户端克隆与权限设置
回到需要拉取代码的工作机,打开终端输入git clone加服务器IP地址和刚才创建的仓库路径。例如git clone user@server_ip:/home/projects/myproject.git。首次连接时会提示信任主机密钥,输入yes确认即可。克隆完成后,你会得到一个完整的项目副本。如果需要限制访问权限,可以在服务端修改仓库目录的属主和读写权限。Linux系统推荐使用chown和chmod命令控制,或者利用Git自带的访问控制功能。对于多人协作场景,建议统一使用同一个只读账号进行拉取,指定少数管理员账号负责推送,以此降低代码冲突风险。
日常开发与分支管理流程
局域网Git的使用逻辑与云端平台一致。开发者在本地修改代码后,依次执行git add标记变更文件,git commit提交到本地版本库。确认无误后,运行git push origin main将更新推送到内网服务器。遇到合并冲突时,先执行git pull拉取最新代码,手动解决diff后再重新提交。分支管理是高效协作的关键,养成feature开头命名功能分支的习惯,开发完毕后通过git merge命令合并回主分支。定期清理已合并的本地分支,保持仓库整洁。由于没有公网延迟,大型二进制文件或媒体素材的推送速度会显著提升,适合频繁迭代的原型开发。
安全加固与备份策略
内网环境并非绝对安全,务必为Git账户设置强密码,并关闭SSH的密码登录模式,改用公钥认证。在客户端生成ssh-keygen后,将公钥追加到服务端的authorized_keys文件中,实现免密安全连接。定期备份是保障资产不丢失的最后防线。可以使用rsync或tar命令将裸仓库打包存储到其他磁盘或移动硬盘中。若条件允许,可搭配定时任务脚本每天凌晨执行自动同步。掌握这套局域网Git方案后,你将拥有完全自主可控的代码管理中心,大幅提升开发效率与数据安全等级。



