如何通过Capistrano实现Rails应用服务器与Nginx服务器间的文件传输？

我来分享几个在Capistrano部署流程里直接把应用服务器上的构建文件传到Nginx服务器的实用方案，都是我实际部署中验证过的，比先下载到部署服务器再转传要简洁得多：

方案1：用Capistrano多角色配合rsync直接同步 #

这是我最常用的方案，完全集成在Capistrano的部署流程里，不需要额外的中间步骤。

首先在你的deploy.rb里定义Nginx服务器的角色：

role :nginx, %w{your-nginx-user@nginx-server-ip}

然后添加一个自定义的Capistrano任务，在部署完成（比如assets预编译之后）执行同步：

namespace :deploy do
  desc 'Sync compiled assets to Nginx server'
  task :sync_assets_to_nginx do
    on roles(:app) do |app|
      # 应用服务器上的构建文件目录，比如Rails的public/assets或者前端构建的dist
      local_assets_dir = "#{release_path}/public/assets"
      # Nginx服务器上的静态文件目录，根据你的配置调整
      remote_nginx_dir = "/var/www/your-app/static/assets"

      # 用rsync通过SSH直接同步，-avz是归档、 verbose、压缩，--delete可以删除Nginx上已不存在的文件
      execute "rsync -avz --delete #{local_assets_dir}/ #{fetch(:nginx_user)}@#{fetch(:nginx_host)}:#{remote_nginx_dir}/"
    end
  end
end

# 把这个任务挂载到Capistrano的部署流程里，比如在assets:precompile之后
after 'deploy:assets:precompile', 'deploy:sync_assets_to_nginx'

优点：

• 完全嵌入Capistrano流程，部署时自动执行，不用手动操作
• 直接点对点传输，没有中间服务器的冗余步骤
• rsync增量同步，只传变化的文件，效率高

注意事项：

• 要确保应用服务器能通过SSH免密登录到Nginx服务器（可以在应用服务器上生成SSH密钥，把公钥加到Nginx服务器的~/.ssh/authorized_keys里）
• 调整目录路径和rsync参数以匹配你的实际环境

方案2：利用Capistrano的SSH代理转发直接传输 #

如果你的部署服务器（运行Capistrano的机器）已经能同时访问应用服务器和Nginx服务器，还可以用SSH代理转发，让应用服务器通过部署服务器的SSH连接访问Nginx服务器，这样不用单独配置应用服务器和Nginx之间的信任关系。

修改上面的任务，添加代理转发：

namespace :deploy do
  desc 'Sync assets to Nginx via SSH proxy'
  task :sync_assets_to_nginx do
    on roles(:app) do |app|
      # 启用SSH代理转发
      ssh_options[:forward_agent] = true

      local_assets_dir = "#{release_path}/public/assets"
      remote_nginx_dir = "/var/www/your-app/static/assets"

      execute "rsync -avz --delete -e 'ssh -A' #{local_assets_dir}/ #{fetch(:nginx_user)}@#{fetch(:nginx_host)}:#{remote_nginx_dir}/"
    end
  end
end

优点：

• 不用单独配置应用服务器和Nginx之间的SSH信任，依赖部署服务器的现有连接
• 同样是直接同步，流程简洁

注意事项：

• 部署服务器的SSH代理要开启，并且已经添加了能访问Nginx服务器的密钥
• 确保应用服务器上的rsync支持-e 'ssh -A'参数

方案3：用共享存储避免传输（适合规模化部署） #

如果你的应用服务器和Nginx服务器数量较多，或者静态文件更新频繁，用共享存储是更优的选择，根本不需要传输文件。

比如：

• NFS共享：在Nginx服务器（或者专门的存储服务器）搭建NFS共享目录，设置应用服务器的IP为允许访问的客户端；应用服务器挂载这个NFS目录到构建输出路径，Rails预编译assets时直接写到共享目录，Nginx直接从本地挂载的目录读取静态文件。
• 对象存储（如S3）：Rails预编译assets时直接上传到对象存储，Nginx配置反向代理到存储服务，或者搭配CDN加速访问。

优点：

• 完全消除文件传输的开销，效率最高
• 适合多服务器集群场景，所有服务器共享同一套静态文件

注意事项：

• 需要配置NFS或者对象存储的权限和访问控制
• 要考虑共享存储的可用性和备份策略

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