在飞牛私有云上搭建个人开发环境或管理项目代码时，Git作为最流行的版本控制工具是必不可少的。很多用户在初次接触飞牛系统时，不太清楚如何手动部署Git服务。本文将分步骤讲解如何通过命令行和Docker两种方式完成Git的安装与配置，全程无需复杂操作，适合家庭实验室和小型团队使用。
准备工作与权限确认
在安装Git之前，需要确保飞牛系统的SSH功能已经开启。进入飞牛控制面板，找到终端与SNMP选项，勾选允许SSH登录并设置好端口。推荐使用WinSCP或FinalShell等客户端，通过管理员账号和密码连接NAS设备。获取root权限后执行sudo su命令切换到超级用户模式，后续所有安装命令都将在该环境下运行。同时建议提前规划好数据盘挂载路径，将代码仓库存放在性能稳定的硬盘分区中，避免频繁读写影响系统响应速度。
方法一：命令行直接安装
飞牛底层基于Debian架构，可以直接使用包管理器进行安装。连接SSH后，依次输入apt update更新软件源列表，等待进度条完成后执行apt install git -y命令。系统会自动下载依赖包并完成编译安装，整个过程通常在一两分钟内结束。安装完毕后输入git version查看版本号，若显示两点零以上的信息，说明基础组件已就绪。
接下来需要创建专用的Git运行账户以保障安全。使用useradd命令新建专用的系统用户，并通过passwd设置独立密码。随后在指定目录下建立.git目录，初始化bare仓库用于存放远程推送的代码。将工作目录权限授予该账户，避免普通文件读写冲突。此时可以通过ssh协议测试本地电脑向NAS推送空仓库，验证连通性。如果发现连接超时，请检查路由器端口映射及飞牛内置防火墙规则是否放行相关端口。
方法二：Docker容器化部署
如果希望隔离运行环境或使用更稳定的长期维护版本，Docker方案更为推荐。打开飞牛应用商店的容器模块，搜索gitea或gitlab-ce镜像。Gitea占用资源极小，适合个人开发者快速上手；GitLab功能全面但需要较大内存支持。选择对应镜像后填写映射端口，将主机的八百零八端口指向容器内部，数据卷路径务必绑定到固定硬盘位置以防丢失。
启动容器后访问网页界面完成初始化管理向导。设置管理员邮箱与密码，启用邮件通知功能方便接收提交记录。在常规设置中关闭注册限制，仅允许受邀用户加入。此时即可通过网页端创建项目，或者继续使用命令行进行克隆与拉取操作。Docker方式的优点在于随时可以备份整个数据文件夹，更换服务器也能无缝迁移。建议为容器分配静态IP地址，便于后续编写自动化脚本调用接口。
基础配置与日常使用技巧
首次使用前建议配置全局用户名和邮箱，执行git config命令填入个人信息。生成SSH密钥对并添加到飞牛系统的authorized_keys文件中，可实现免密传输大幅提升效率。对于大文件存储需求，可额外安装扩展插件，避免传统Git处理多媒体素材时的卡顿现象。定期执行git fsck检查仓库完整性，利用gc命令清理冗余对象释放存储空间。配合定时任务脚本自动打包备份重要分支，能有效防止误删导致的数据灾难。
常见问题排查指南
若遇到权限拒绝报错，请检查系统日志记录，多数情况是防火墙策略拦截了连接。尝试开放对应端口并在路由器做好端口转发规则。网络延迟较高时可调整TCP窗口缩放参数，启用压缩传输缓解带宽压力。当仓库体积超过五十GB时，建议切换至高级文件系统并开启子卷快照功能，提升恢复速度。部分老旧客户端可能不支持新版哈希算法，需在配置文件里显式声明兼容模式。遇到合并冲突时不要强行覆盖，先用差异工具对比内容再手动修正。掌握这些核心要点后，飞牛私有云即可稳定承载中小型项目的代码托管任务。
