scpコマンドの使い方:SSH経由でファイルを1回のコマンドでコピーする

scpは、SSHの仕組みを使って、サーバーとの間でファイルをコピーするコマンドです。通信は暗号化されるため、インターネット越しでも安全にファイルを転送できます。

scpの仕組みと基本の考え方

scpは「secure copy」の略で、SSHの接続を利用してファイルを転送します。認証の方法も、通信の暗号化も、sshと共通です。そのため、sshで接続できるサーバーであれば、追加の設定なしでscpも使えます。

コピー元とコピー先のうち、ホスト:パスの形で書かれた側がサーバー、それ以外が手元のパスとして解釈されます。サーバー側のパスを相対パスで書いた場合は、ログインするユーザーのホームディレクトリが基準になります。user@host:とコロンだけを書くと、ホームディレクトリの直下を指します。

新しいバージョンのOpenSSHでは、scpコマンドの内部で使われる転送の仕組みが、SFTPに切り替わっています。使い方は変わりませんが、今後のファイル転送の手段としては、sftpやrsyncの利用も推奨されています。

scpのよく使う形

実務や学習で登場しやすい使い方を、そのまま入力できる形でまとめました。

コマンド例内容
scp file.txt user@192.0.2.10:/tmp/手元のファイルを、サーバーへ送る
scp user@192.0.2.10:/var/log/app.log .サーバーのファイルを、手元へ取得する
scp -r dir user@192.0.2.10:/tmp/ディレクトリごとコピーする
scp -P 2222 file.txt user@192.0.2.10:/tmp/ポート番号を指定する
scp -i ~/.ssh/key.pem file.txt ec2-user@192.0.2.10:~秘密鍵を指定する
scp -p file.txt user@192.0.2.10:/tmp/更新日時と権限を保ったままコピーする

scpの主なオプション

オプション意味
-rディレクトリごとコピー
-Pポート番号を指定

scpの実行例と結果の読み方

scp report.txt user@192.168.1.20:/tmp/ を実行した結果です。表示の意味は、画面の下の「出力の読み方」で項目ごとに説明しています。

$ scp report.txt user@192.168.1.20:/tmp/
report.txt                                    100%    6     3.2KB/s   00:00

※ 練習用ターミナルからは外部のサーバーに接続できないため、表示は実機での出力例です。

出力の読み方

表示・項目意味
report.txt送ったファイル名
100%転送の進み具合
6ファイルのサイズ(バイト)
3.2KB/s転送の速さ
00:00転送にかかった時間(転送中は残り時間)

練習用ターミナルでは、scpをブラウザ上で安全に試せます。

scpの実務での使いどころ

サーバーのログを、手元に持ってきて調べる

scp user@192.0.2.10:/var/log/nginx/error.log ./error_$(date +%Y%m%d).log

調査用に、ログを手元へコピーします。保存する名前に日付を入れておくと、いつ取得したものかが分かります。

設定ファイルを、サーバーへ配置する

scp -p nginx.conf user@192.0.2.10:/tmp/
ssh user@192.0.2.10 'sudo cp -p /tmp/nginx.conf /etc/nginx/nginx.conf && sudo nginx -t'

一般ユーザーでは/etcに直接書き込めないため、いったん/tmpに送り、サーバー上でsudoを使って配置します。

scpを組み合わせて使う実践例

複数のファイルをまとめてから転送する

tar -czf logs.tar.gz /var/log/app/
scp logs.tar.gz user@192.0.2.10:/backup/

ファイルの数が多い場合は、1つにまとめて圧縮してから送ると、転送が速く、権限などの情報も保たれます。

転送後に、内容が一致しているかを確かめる

sha256sum backup.tar.gz
scp backup.tar.gz user@192.0.2.10:/backup/
ssh user@192.0.2.10 'sha256sum /backup/backup.tar.gz'

転送の前後でハッシュ値を比べると、ファイルが壊れずに届いたかを確認できます。重要なデータの受け渡しで使われる方法です。

似たコマンドとの違い・使い分け

rsyncは、変更された部分だけを転送でき、途中で切れても再開できます。scpは、常に全体をコピーする単純な仕組みです。1つのファイルを手早く送るならscp、大量のファイルや、定期的な同期にはrsyncが向いています。対話的にファイルを選んで転送したいときは、sftpも使えます。

実際の出力を並べると、違いがつかみやすくなります。

・rsync

差分だけを効率的に同期する。

$ rsync -av --dry-run notes/ notes-copy/
sending incremental file list
created directory notes-copy/

sent 120 bytes  received 54 bytes  480.00 bytes/sec
total size is 0  speedup is 0.00 (DRY RUN)

scpを使うときの注意点

書式はscp コピー元 コピー先で、サーバー側はユーザー@ホスト:パスの形で書きます。コロン(:)を付け忘れると、手元でのコピーとして扱われ、その名前のファイルが作られてしまいます。

ポート番号の指定は、大文字の-Pです。sshでは小文字の-pを使うため、取り違えやすいポイントです。

scpでよくある失敗と対処

コロンを付け忘れて、手元にファイルができた

scp file user@hostは、user@hostという名前のファイルを手元に作ります。サーバー側の指定には、必ず:とパスを付けます。

同名のファイルを、確認なしで上書きした

scpは、コピー先に同じ名前のファイルがあっても、確認せずに上書きします。重要なファイルは、事前にコピー先のバックアップを取っておきましょう。

scpで困ったときの症状別チェック

実際の現場で出会いやすい症状を、原因の見当と確認方法とあわせて、逆引きできる形にまとめました。

症状考えられる原因確認・対処
Permission denied (publickey)と出る鍵の指定、または公開鍵の登録に問題があるsshで接続できるかを先に確認し、-iで正しい秘密鍵を指定します。
No such file or directoryと出るコピー元、またはコピー先のパスが存在しないsshでログインして、パスを確認します。
コピー先でPermission deniedになるコピー先のディレクトリに、書き込み権限がない/tmpなど書き込める場所へ送り、サーバー上でsudoを使って移動します。
not a regular fileと出るディレクトリを、-rなしでコピーしようとした-rを付けて実行します。

scpを手を動かして試す

手元からサーバーへ送る、サーバーから手元へ取得する、ディレクトリごと送る、ポートを指定する、という基本の形を順に試します。接続先のアドレスとユーザー名は、ご自身の環境のものに置き換えてください。

echo test > up.txt
scp up.txt user@192.0.2.10:/tmp/
scp user@192.0.2.10:/tmp/up.txt ./down.txt
scp -r mydir user@192.0.2.10:/tmp/
scp -P 2222 -p up.txt user@192.0.2.10:/tmp/

安全に練習したいときは、練習用ターミナルでも同じ操作を試せます。

scpに関するよくある質問

ディレクトリごとコピーするには?

-rを付けます。scp -r dir user@host:/tmp/で、ディレクトリの中身も含めてコピーされます。

ポート番号を指定するには?

大文字の-Pを使います。小文字の-pは、日時や権限を保持するオプションです。

サーバーからサーバーへ、直接コピーできますか?

scp user1@host1:/path user2@host2:/pathの形で実行できます。ただし、認証の設定によっては失敗するため、いったん手元を経由するか、-3を付ける方法もあります。

大きなファイルの転送が途中で切れた場合、再開できますか?

scpには、再開の機能がありません。大きなファイルや、多数のファイルの転送には、途中から再開できるrsyncが向いています。

パスワードを毎回入力せずに済ませるには?

公開鍵認証を設定します。秘密鍵を-iで指定するか、~/.ssh/configに接続先の情報を書いておくと、入力の手間を省けます。

scpのまとめ

書式は「コピー元、コピー先」で、サーバー側には:とパスを付けます。ポートの指定は、大文字の-Pです。

トラブルシューティングやエラーの対処、現場の作業手順の中で、scpを使っている記事です。実際の場面での使い方の参考にしてください。

関連ページ

あわせて覚えたいコマンド:ssh・rsync・cp・tar

「ネットワーク」のコマンド解説:curl・ping・ip・ss・wget・dig・traceroute・nslookup

scpが登場する章:中級 第22章

GitHubなどのリモートリポジトリへSSHで接続する方法は、Git入門で扱っています。

コマンドをまとめて自動化したいときは、Linuxシェルスクリプト入門も参考にしてください。

← Linuxコマンド一覧へ戻る