通过Git将代码提交到Linux服务器，最稳健的方式是配置SSH密钥免密登录，并在服务器端设置Git Hook自动部署，从而实现本地提交后代码自动同步至生产环境。
很多开发者习惯在本地写完代码，再手动FTP上传或复制粘贴到服务器，这种方式不仅效率低下，还容易因为文件遗漏导致线上故障，现代DevOps流程中，自动化部署是标配，我们将通过构建一个安全、高效的Git推送通道,解决这一痛点。
服务器端Git仓库初始化与环境准备
在动手操作之前，我们需要在Linux服务器上搭建一个“裸仓库”，裸仓库不包含工作目录，专门用于接收推送,避免直接修改远程文件导致的冲突。
安装Git与创建专用用户
出于安全考虑，不建议使用root用户直接操作Git仓库，业内专家指出,最小权限原则是服务器安全的基石。
登录你的Linux服务器,执行以下命令安装Git：
sudo apt-get install git # Debian/Ubuntu # 或 sudo yum install git # CentOS/RHEL
创建一个专门用于代码部署的用户，例如名为gituser：
sudo adduser gituser sudo passwd gituser
切换到该用户并初始化裸仓库：
sudo su - gituser mkdir ~/myproject.git cd ~/myproject.git git init --bare
这里的--bare参数至关重要，它告诉Git这是一个远程仓库，只存储版本历史,不存储实际的工作文件。
配置自动部署钩子（Hook）
裸仓库本身不会更新工作目录，我们需要一个“触发器”来告诉服务器：有新代码来了，请更新到指定目录，这就是Git Hook的作用。
在myproject.git目录下，找到hooks文件夹，复制post-receive.sample并重命名为post-receive：
cd hooks cp post-receive.sample post-receive chmod +x post-receive
编辑post-receive文件,填入以下内容：
#!/bin/bash GIT_WORK_TREE=/var/www/myproject git checkout -f
这段脚本的含义是：当收到推送时，强制将代码检出到/var/www/myproject目录，请确保该目录存在，且gituser用户拥有写入权限。
本地Git仓库配置与SSH密钥管理
服务器端就绪后，我们需要在本地机器上配置推送路径，这一步的核心是解决“如何安全且便捷地登录服务器”的问题。
生成并配置SSH密钥
密码登录既不安全又繁琐，SSH密钥对是行业标准解决方案,在本地终端执行：
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
一路回车即可，默认保存在~/.ssh/id_rsa,将公钥上传到服务器：
ssh-copy-id gituser@your_server_ip
如果ssh-copy-id不可用，可以手动将~/.ssh/id_rsa.pub追加到服务器的~gituser/.ssh/authorized_keys文件中,测试连接：
ssh gituser@your_server_ip
若能直接登录且无需输入密码,说明配置成功。
添加远程仓库地址
回到本地项目目录，添加远程仓库地址，这里的地址格式为user@host:path/to/repo：
git remote add production gituser@your_server_ip:/home/gituser/myproject.git
你可以验证一下：
git remote -v
确保输出中包含production及其对应的SSH地址。
自动化部署流程与常见问题排查
配置完成后，整个流程变得极其简单：本地提交，推送至生产环境,服务器自动更新。
标准操作流程
- 在本地修改代码。
- 提交更改：
git commit -m "update feature" - 推送至服务器：
git push production master
当推送成功后，服务器端的post-receive钩子会自动触发，将最新代码检出到Web根目录，对于Web项目，你可能还需要在钩子中重启Nginx或PHP-FPM服务，
sudo systemctl restart nginx
权限与路径问题
在实际操作中，最常见的问题是权限拒绝，如果推送失败，提示Permission denied,请检查：
- 服务器上的
/var/www/myproject目录是否对gituser用户可写？ - 本地SSH密钥是否正确配置？
- 服务器防火墙是否放行了22端口？
若项目依赖Node.js或Python包，建议在post-receive脚本中加入依赖安装步骤,确保运行环境一致。
进阶优化：分支管理与安全加固
对于小型项目，上述方案已足够，但对于团队协作或大型项目,需要更精细的控制。
多分支支持
默认情况下，post-receive会检出master分支，若需支持多分支，需修改脚本逻辑，根据推送的分支动态检出，仅当推送master分支时更新生产环境，推送develop分支时更新测试环境。
安全加固建议
- 限制Shell访问：在服务器端，将
gituser用户的Shell设置为git-shell，防止其通过SSH执行系统命令，修改/etc/passwd文件，将gituser:x:1001:1001::/home/gituser:/bin/bash改为/usr/bin/git-shell。 - 使用Webhook：对于更复杂的CI/CD流程，可结合Jenkins或GitHub Actions，通过Webhook触发构建,而非直接推送代码到服务器。
Git提交到linux服务器 与 传统FTP上传 对比
| 特性 | Git推送部署 | FTP上传 |
|---|---|---|
| 版本控制 | 完整历史，可随时回滚 | 无版本，覆盖即丢失 |
| 传输效率 | 增量传输，速度快 | 全量传输，速度慢 |
| 安全性 | SSH加密，密钥认证 | 明文或弱加密，易被截获 |
| 自动化 | 支持Hook自动部署 | 需手动或复杂脚本 |
| 协作性 | 支持多人并行开发 | 易产生文件冲突 |
业内共识认为，随着DevOps理念的普及，Git推送部署已成为绝大多数中小型项目的首选方案，它不仅提升了效率,更降低了人为错误风险。
Git提交到linux服务器 常见问题解答
Git提交到linux服务器 时提示权限被拒绝怎么办？
首先检查本地SSH密钥是否已添加到服务器的authorized_keys文件，确认服务器上的Git仓库目录及工作目录权限是否正确，若使用git-shell,确保用户仅能通过Git协议访问。
如何实现Git提交到linux服务器 后自动重启服务？
在服务器端的hooks/post-receive脚本末尾添加服务重启命令，对于Nginx，添加sudo systemctl restart nginx，注意，需确保gituser用户有执行该命令的sudo权限,且无需密码。
Git提交到linux服务器 支持大文件传输吗？
Git本身不适合存储大文件，若项目包含大量二进制文件或媒体资源，建议使用Git LFS（Large File Storage），配置LFS后，大文件将通过专用URL下载，而Git仅存储指针,从而避免仓库体积膨胀和推送超时问题。
首发原创文章，作者：世雄 - 原生数据库架构专家，如若转载，请注明出处：https://idctop.com/article/416375.html
