scp コマンドの使い方 (SSH 経由のファイルコピー)

▶

編集

この記事の要点

scp は SSH で暗号化してファイルをコピーするコマンド。SSH でログインできる相手なら追加設定なしで使える
ローカル → リモート: scp ローカルファイルホスト:リモートパス
リモート → ローカル: scp ホスト:リモートファイルローカルパス
よく使うオプション: -r ディレクトリごと / -p 日時と権限を保持 / -P ポート指定（大文字）/ -i 秘密鍵指定
~/.ssh/config に Host を登録しておくと scp file myserver:/tmp/ のように短く書ける
大量・大容量の同期や再開が必要なら rsync の方が向いている

scp とは

scp（secure copy）は、SSH の接続を使ってホスト間でファイルをコピーするコマンドです。通信はすべて暗号化され、認証も SSH と同じ（パスワード認証または公開鍵認証）なので、SSH でログインできるサーバーであれば、そのまま scp も使えるのが利点です。Linux・Mac には標準で入っており、Windows 10 以降も OpenSSH クライアントとして標準搭載されています。

SSH の接続設定や鍵認証の準備は SSH とは？暗号化リモート接続・鍵認証・実装一覧を参照してください。

基本の書式

scp [オプション] コピー元 コピー先

リモート側のパスは ユーザー名@ホスト:パス の形で書きます。: の有無でローカルかリモートかを区別している点がポイントです。

ローカルからリモートへコピー（アップロード）

# 書式
scp [コピー元のローカルのファイルパス] [ユーザー名@ホスト:リモートのコピー先のフォルダパス]

# 例: report.csv をサーバーの /home/taro/data/ にコピー
scp ./report.csv taro@192.168.1.10:/home/taro/data/

リモートからローカルへコピー（ダウンロード）

# 書式
scp [ユーザー名@ホスト:リモートのコピー元のファイルパス] [コピー先のローカルのフォルダパス]

# 例: サーバーのログをカレントディレクトリにコピー
scp taro@192.168.1.10:/var/log/app/error.log .

ssh config の識別子を使う

~/.ssh/config に接続先を登録しておくと、ユーザー名・ホスト・ポート・鍵ファイルを毎回書かずに済みます。

Host myserver
    HostName 192.168.1.10
    User taro
    Port 2222
    IdentityFile ~/.ssh/id_ed25519

# config に設定した識別子（myserver）で指定できる
scp ./report.csv myserver:/home/taro/data/
scp myserver:/var/log/app/error.log .

主なオプション

オプション	意味
`-r`	ディレクトリごと再帰的にコピーする
`-p`	コピー元の更新日時・アクセス日時・パーミッションを保持する。どの日時に変更されたファイルをコピーしたか正確に把握できる
`-P ポート`	SSH のポート番号を指定する（大文字。ssh コマンドの `-p` とは違うので注意）
`-i 鍵ファイル`	認証に使う秘密鍵を指定する
`-F 設定ファイル`	ssh の config ファイルを指定する（既定は `~/.ssh/config`）
`-C`	転送データを圧縮する。テキストなど圧縮が効くファイルを低速回線で送るときに有効
`-l 帯域`	転送速度の上限を Kbit/s で指定する（本番回線を占有しないため）
`-q`	進捗表示を出さない（スクリプト向け）
`-v`	詳細なデバッグ出力。接続できない原因の調査に使う
`-3`	リモート間のコピーを、手元のマシン経由で中継する

よく使う組み合わせ

# ディレクトリをまるごと、日時と権限を保ったままアップロード
scp -rp ./public_html myserver:/var/www/

# ポート 2222・鍵指定でダウンロード
scp -P 2222 -i ~/.ssh/id_ed25519 taro@example.com:/backup/db.sql.gz .

# 複数ファイルをまとめて送る（コピー先はディレクトリ）
scp a.txt b.txt c.txt myserver:/tmp/

落とし穴と注意点

ポート指定は大文字の -P: 小文字の -p は「日時の保持」なので、ポートを指定したつもりで接続先が 22 番のままになることがあります
上書き確認がない: コピー先に同名ファイルがあると、確認なしで上書きされます。重要なファイルを送る前にコピー先を確認しましょう
リモート側のワイルドカードはクォート: scp 'myserver:/var/log/*.log' . のようにクォートしないと、手元のシェルが先に展開しようとしてエラーになることがあります
空白を含むパス: リモート側のパスに空白がある場合はクォートします。古い OpenSSH ではさらにエスケープが必要でした
途中で切れると最初からやり直し: scp には再開機能がありません。数 GB 以上のファイルや、差分だけ送りたい場合は rsync を使います
プロトコルの変化: OpenSSH 9.0（2022 年）以降、scp コマンドは内部で SFTP プロトコルを使うのが既定になりました。古いサーバーで動かない場合は -O オプションで従来の方式に戻せます

scp・rsync・sftp の使い分け

コマンド	向いている用途
scp	数ファイルを 1 回だけさっと送る・取ってくる
rsync	ディレクトリの同期、差分転送、中断からの再開、除外指定
sftp	対話的にリモートのディレクトリを見ながら操作する

うまくいかないときの確認方法

まず ssh myserver でログインできるか確認する（ssh で入れなければ scp も使えません）
scp -v で実行し、どの段階（名前解決・接続・認証）で止まっているかを見る
「Permission denied」が転送先で出る場合は、リモート側のディレクトリの書き込み権限を確認する
コピー後は ls -l でサイズと日時を確認し、重要なファイルは sha256sum で両側のハッシュ値を比較する

ページ一覧

その他