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が登場する記事
トラブルシューティングやエラーの対処、現場の作業手順の中で、scpを使っている記事です。実際の場面での使い方の参考にしてください。
- パッチ適用の手順(現場ガイド)
関連ページ
「ネットワーク」のコマンド解説:curl・ping・ip・ss・wget・dig・traceroute・nslookup
scpが登場する章:中級 第22章
GitHubなどのリモートリポジトリへSSHで接続する方法は、Git入門で扱っています。
コマンドをまとめて自動化したいときは、Linuxシェルスクリプト入門も参考にしてください。