为什么团队需要局域网Git服务
把Git放在公司内网里，最直接的收益就是速度快、数据不外流。外网托管虽然方便，但大文件传输受带宽限制，敏感代码也有泄露风险。局域网部署后，团队成员在同一交换机下推送代码，延迟通常控制在毫秒级，几十兆的分支合并也能秒完成。同时，网络隔离让外部攻击者无法直接触碰核心资产，适合对安全性要求较高的开发团队。搭建过程不需要复杂架构，一台普通Linux主机配合基础软件就能跑起来。
服务器端环境准备与核心安装
选一台性能稳定的机器作为Git服务器，系统推荐Ubuntu或CentOS。先更新系统包，然后执行安装命令获取Git本身和依赖工具。接着创建专用系统账户用于管理仓库，这个账户不登录桌面环境，只保留SSH访问权限。在用户目录下新建一个名为git-repos的文件夹，并赋予正确权限。这一步是地基，权限设错会导致后续推送频繁报拒绝访问。最后开启SSH服务，确保端口放行，防火墙规则只允许内网IP段连接。
创建仓库与添加团队成员
Git仓库分两种，裸仓库和普通仓库。团队协作一律用裸仓库初始化。进入目标目录，输入git init bare命令即可生成不带工作区的纯净库。生成后，将项目结构拷入或者让成员首次克隆该地址。接下来处理账号认证，建议统一使用公钥验证。收集所有开发者的.pub文件，粘贴到服务器的authorized_keys清单中。按角色分配读写权限，核心骨干给完整权限，实习生或外包人员仅开放指定子模块。定期清理离职人员的密钥，避免权限残留。
客户端配置与日常代码流转
开发者拿到服务器内网IP后，在本地终端配置用户名和邮箱，这步决定了提交记录的归属标识。随后使用ssh协议拉取仓库，地址格式为ssh加管理员账号加内网IP加冒号加仓库路径。日常开发遵循分支隔离原则，主分支保持随时可发布状态，新功能走独立特性分支。完成编码后执行本地提交，核对改动无误再推送到远端。遇到冲突时不要强行覆盖，先用pull命令拉取最新差异，手动合并后再推送。定期执行fetch查看他人进度，保持信息同步能大幅减少后期整合成本。
权限管理与安全备份策略
单纯靠SSH密钥不够精细，可以引入Git自带的hooks机制实现自动化管控。在仓库的hooks目录下编写pre-receive脚本，拦截不符合规范的推送请求。比如限制非授权账号修改配置文件，或者强制要求提交信息包含任务编号。日志记录要全量开启，每次操作都会留痕，方便事后追溯。备份方面采用定时任务结合rsync方案，每天凌晨将仓库目录打包压缩并同步到另一台冷备机。重要版本节点打上标签，标签一旦创建就不删除，形成清晰的历史锚点。磁盘空间低于百分之七十时自动触发清理旧归档，防止存储爆满导致服务中断。
常见问题快速排障
推送失败最先检查网络连接，ping测试确认互通性，再查iptables规则是否误拦截了22端口。如果提示权限被拒，核对authorized_keys文件格式，每行末尾不能有多余空格或换行符。内存占用过高通常是缓存堆积，执行git gc命令释放空间。客户端证书过期会阻断连接，重新生成密钥对并上传即可恢复。遇到数据库类钩子报错，检查脚本执行权限是否为可运行状态。平时养成写操作手册的习惯，把高频问题归类存档，新成员入职半天就能上手独立提交。
