GitLab-CI中SCP文件传输超时失效问题求助

排查Runner运行账户的密钥环境 #

GitLab Runner默认以Local System账户运行，和你手动操作的登录用户不是同一个，密钥存储路径完全不同：

• 打开服务列表，找到gitlab-runner服务，查看它的登录身份。
• 如果是Local System，用psexec -i -s powershell.exe打开系统账户的PowerShell窗口（需提前下载PsTools）。
• 在这个窗口里，把你的SSH私钥复制到C:\Windows\System32\config\systemprofile\.ssh目录，确保权限正确，再把公钥同步到开发服务器admin用户的.ssh/authorized_keys文件中。
• 在系统账户的PowerShell里测试SCP命令，确认能正常传输后再回到流水线。

修正SCP命令的参数和路径格式 #

Windows路径在SCP里容易出现转义问题，调整成以下写法：

• 复制文件夹必须加-r参数，路径用正斜杠替代反斜杠：

scp -r C:/folder-to-copy/* admin@ipv4-of-dev-server:C:/destination

• 避免直接复制根目录，用通配符指定文件，减少路径解析问题。

换用PowerShell原生的WinRM传输方案 #

如果SCP始终有问题，试试PowerShell自带的PSRemoting（需提前在开发服务器开启WinRM）：

# 建立免密会话（需提前配置Runner账户的WinRM信任）
$session = New-PSSession -ComputerName "ipv4-of-dev-server" -Authentication Negotiate
# 递归复制文件夹
Copy-Item -Path "C:\folder-to-copy\" -Destination "C:\destination\" -Recurse -ToSession $session
# 清理会话
Remove-PSSession $session

配置WinRM免密的话，把Runner账户的公钥添加到开发服务器的TrustedHosts，或者用组策略配置PSRemoting的免密认证。

临时调整流水线超时时间 #

如果是传输大文件导致超时，在.gitlab-ci.yml里给任务单独设置更长的超时：

transfer_job:
    stage: transfer
    script:
        - scp -r C:/folder-to-copy/* admin@ipv4-of-dev-server:C:/destination
    timeout: 3h  # 根据实际文件大小调整

手动启动SSH Agent加载密钥 #

在流水线脚本里显式启动ssh-agent并加载私钥，避免Runner环境找不到密钥：

transfer_job:
    stage: transfer
    script:
        - Start-Service ssh-agent
        - ssh-add "C:\Windows\System32\config\systemprofile\.ssh\id_rsa"
        - scp -r C:/folder-to-copy/* admin@ipv4-of-dev-server:C:/destination

内容的提问来源于stack exchange，提问作者devops-q