GitHub Actions同步Docker镜像至Lightsail VPS遇Broken pipe错误求助

针对你遇到的client_loop: send disconnect: Broken pipe超时错误，以下是具体的排查和解决方法：

1. 调整SSH连接心跳参数 #

SSH连接长时间无数据交互时，会被服务器或中间网络判定为空闲断开。在rsync命令中添加SSH心跳选项，维持连接：

修改部署步骤的rsync命令：

rsync -av --partial -e "ssh -o ServerAliveInterval=30 -o ServerAliveCountMax=10" ./images ${{ secrets.VPS_USER }}@${{ secrets.VPS_HOST }}:/home/ec2-user/

• ServerAliveInterval=30：每30秒向服务器发送一次心跳包，防止被判定为空闲
• ServerAliveCountMax=10：连续10次心跳无响应才断开连接，容错网络波动
• --partial：保留未传输完成的文件，断连后可续传，无需重新开始
• 去掉-z：Docker镜像tar包本身已压缩，再压缩会浪费CPU和时间，反而拖慢传输

2. 检查Lightsail安全组与防火墙配置 #

• 确认Lightsail实例的安全组规则允许**22端口（SSH）**的入站流量，若需限制来源，可添加GitHub Actions官方IP段
• 登录VPS，检查本地防火墙（如ufw、iptables）是否有SSH连接超时或带宽限制规则，必要时调整

3. 替代方案：使用镜像仓库替代tar包传输 #

大文件tar包传输容易受网络波动影响，更稳定的方式是直接推送镜像到容器仓库，再在VPS拉取：

修改GitHub Actions工作流示例： #

name: build-and-deploy-image

on:
  push:
    branches: ["master", "ci/cd-implementation"]

jobs:
  build-and-deploy-image:
    runs-on: ubuntu-latest
    
    steps:
      - name: checkout
        uses: actions/checkout@v4

      - name: setup docker buildx
        uses: docker/setup-buildx-action@v3

      - name: login to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: build and push images
        run: |
          docker-compose -f building.yml build
          docker-compose -f building.yml push

      # 在VPS上拉取镜像并启动
      - name: Install SSH Key
        uses: shimataro/ssh-key-action@v2
        with:
          key: ${{ secrets.VPS_SSH_KEY }}
      
      - name: Adding Known Hosts
        run: ssh-keyscan -H ${{ secrets.VPS_HOST }} >> ~/.ssh/known_hosts

      - name: Pull and restart containers on VPS
        run: |
          ssh ${{ secrets.VPS_USER }}@${{ secrets.VPS_HOST }} "
            docker login -u ${{ secrets.DOCKERHUB_USERNAME }} -p ${{ secrets.DOCKERHUB_TOKEN }}
            docker-compose -f /home/ec2-user/building.yml pull
            docker-compose -f /home/ec2-user/building.yml up -d
          "

这种方式利用容器仓库的增量同步特性，避免了大文件传输的不稳定问题，更高效可靠。

内容的提问来源于stack exchange，提问作者ElMagoPerodelDQ