Vagrantの仮想マシンからローカルにファイルをコピーする4つの方法

2025年7月18日2025年7月20日

Vagrant環境で作成したファイルを、ローカル（ホスト側）にコピーする方法をいくつか紹介します。目的や状況に応じて最適な方法を選びましょう。

Contents

方法①: 共有フォルダ（`/vagrant`）を利用

Vagrantでは、ゲストOS内の/vagrantディレクトリがホスト側と同期されています。Vagrantfileと同じディレクトリとリンクしているため、ここを経由すればファイルを簡単にやり取りできます。

cp /home/vagrant/sample.txt /vagrant/

1	cp /home/vagrant/sample.txt /vagrant/

ls ./sample.txt

1	ls ./sample.txt

補足: /vagrantは双方向で同期されているため、逆にローカルから仮想マシンへファイルを渡すこともできます。

一時的にファイルをコピーしたい場合は、このプラグインが便利です。

vagrant plugin install vagrant-scp

1	vagrant plugin install vagrant-scp

vagrant scp default:/home/vagrant/sample.txt ./sample.txt

1	vagrant scp default:/home/vagrant/sample.txt ./sample.txt

仮想マシン名がdefaultでない場合は適宜置き換えてください。

SSHの詳細情報をもとに、scpで安全にファイルをコピーする方法です。

vagrant ssh-config

1	vagrant ssh-config

scp -P 2222 -i /path/to/private_key vagrant@127.0.0.1:/home/vagrant/sample.txt ./sample.txt

1	scp -P 2222 -i /path/to/private_key vagrant@127.0.0.1:/home/vagrant/sample.txt ./sample.txt

出力結果のPortやIdentityFileは各環境で異なりますので、出力に合わせてコマンドを調整してください。

多くのファイルをコピーしたいときはrsyncが便利です。

rsync -e "ssh -i /path/to/private_key -p 2222" vagrant@127.0.0.1:/home/vagrant/data/ ./local_data/

1	rsync -e "ssh -i /path/to/private_key -p 2222" vagrant@127.0.0.1:/home/vagrant/data/ ./local_data/

差分コピーにも対応しており、再実行も高速です。