シェルスクリプトでSFTPファイル転送を自動化する設計｜バッチモードとSSH鍵認証で安全な自動転送を実装する方法

この記事のポイント

・SSH鍵認証でパスワード不要のSFTP自動接続を確立できる
・sftp -b でバッチファイルを渡せばput/getを無人実行できる
・sftpはファイル未存在でもexit 0を返すので戻り値だけに頼らない設計が必要
・ログとcronを組み合わせれば深夜の定期転送が実現できる

# 転送元サーバーで実行
$ ssh-keygen -t ed25519 -f ~/.ssh/sftp_key -N ""

Generating public/private ed25519 key pair.
Your identification has been saved in /home/operator/.ssh/sftp_key
Your public key has been saved in /home/operator/.ssh/sftp_key.pub
The key fingerprint is:
SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx operator@transfer01

# 転送先SFTPサーバーのユーザーホームに公開鍵をコピー
$ ssh-copy-id -i ~/.ssh/sftp_key.pub -p 22 sftp-user@192.168.1.50

# または手動でauthorized_keysに追記（ssh-copy-idが使えない環境）
$ cat ~/.ssh/sftp_key.pub | ssh sftp-user@192.168.1.50   "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"

# 鍵を指定してSFTP接続テスト（パスワードなしで繋がるか確認）
$ sftp -i ~/.ssh/sftp_key sftp-user@192.168.1.50

Connected to 192.168.1.50.
sftp> pwd
Remote working directory: /home/sftp-user
sftp> exit

# バッチファイルの例（/tmp/sftp_batch.txt）
cd /remote/upload
put /local/data/report_20260829.csv
bye

# バッチファイルを指定してsftp実行
$ sftp -i ~/.ssh/sftp_key -b /tmp/sftp_batch.txt sftp-user@192.168.1.50
Uploading /local/data/report_20260829.csv to /remote/upload/report_20260829.csv
/local/data/report_20260829.csv           100%   48KB   1.2MB/s   00:00

#!/bin/bash
set -euo pipefail

SFTP_HOST="192.168.1.50"
SFTP_USER="sftp-user"
SFTP_KEY="/home/operator/.ssh/sftp_key"
REMOTE_DIR="/remote/upload"
LOCAL_DIR="/var/transfer/outbox"
LOG_FILE="/var/log/sftp_upload.log"

log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" | tee -a "${LOG_FILE}"
}

# 転送対象ファイルを確認
FILES=("${LOCAL_DIR}"/*.csv)
if [[ ! -e "${FILES[0]}" ]]; then
    log "転送対象ファイルなし。終了します"
    exit 0
fi

# バッチファイルを一時生成
BATCH_FILE=$(mktemp /tmp/sftp_batch.XXXXXX)
trap 'rm -f "${BATCH_FILE}"' EXIT

{
    echo "cd ${REMOTE_DIR}"
    for f in "${FILES[@]}"; do
        echo "put ${f}"
    done
    echo "bye"
} > "${BATCH_FILE}"

# SFTP実行
log "アップロード開始: ${#FILES[@]}件"
if sftp -i "${SFTP_KEY}" -b "${BATCH_FILE}"        "${SFTP_USER}@${SFTP_HOST}" >> "${LOG_FILE}" 2>&1; then
    log "アップロード完了: ${#FILES[@]}件"
else
    log "ERROR: sftpコマンドがエラーを返しました"
    exit 1
fi

#!/bin/bash
set -euo pipefail

SFTP_HOST="192.168.1.50"
SFTP_USER="sftp-user"
SFTP_KEY="/home/operator/.ssh/sftp_key"
REMOTE_DIR="/remote/download"
LOCAL_DIR="/var/transfer/inbox"
LOG_FILE="/var/log/sftp_download.log"

log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" | tee -a "${LOG_FILE}"
}

BATCH_FILE=$(mktemp /tmp/sftp_batch.XXXXXX)
trap 'rm -f "${BATCH_FILE}"' EXIT

{
    echo "cd ${REMOTE_DIR}"
    echo "lcd ${LOCAL_DIR}"
    echo "mget *.csv"
    echo "bye"
} > "${BATCH_FILE}"

log "ダウンロード開始"
if sftp -i "${SFTP_KEY}" -b "${BATCH_FILE}"        "${SFTP_USER}@${SFTP_HOST}" >> "${LOG_FILE}" 2>&1; then
    log "ダウンロード完了"
else
    log "ERROR: sftpコマンドがエラーを返しました"
    exit 1
fi

# 転送後にリモートのファイル存在を確認する例
VERIFY_BATCH=$(mktemp /tmp/sftp_verify.XXXXXX)
trap 'rm -f "${VERIFY_BATCH}"' EXIT

TARGET_FILE="report_$(date '+%Y%m%d').csv"

{
    echo "cd ${REMOTE_DIR}"
    echo "ls ${TARGET_FILE}"
    echo "bye"
} > "${VERIFY_BATCH}"

if sftp -i "${SFTP_KEY}" -b "${VERIFY_BATCH}"        "${SFTP_USER}@${SFTP_HOST}" 2>&1 | grep -q "${TARGET_FILE}"; then
    log "検証OK: ${TARGET_FILE} をリモートで確認"
else
    log "ERROR: リモートにファイルが存在しない"
    exit 1
fi

# ログ関数（タイムスタンプ付きでファイルと標準出力に二重出力）
LOG_FILE="/var/log/sftp_transfer.log"

log() {
    local level="$1"
    shift
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [${level}] $*" | tee -a "${LOG_FILE}"
}

# 使用例
log "INFO"  "転送開始: ${COUNT}件"
log "ERROR" "接続失敗: ${SFTP_HOST}"
log "INFO"  "転送完了: 所要時間 ${ELAPSED}秒"

# crontab -e で編集（operator ユーザー）
# PATH と HOME を明示しないとスクリプト内のコマンドが見つからないことがある
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOME=/home/operator

# 毎日 02:30 にアップロードを実行
30 2 * * * /home/operator/scripts/sftp_upload.sh

# 毎時5分にダウンロードを確認
5 * * * * /home/operator/scripts/sftp_download.sh

$ chmod 700 /home/operator/scripts/sftp_upload.sh
$ chmod 700 /home/operator/scripts/sftp_download.sh

# 詳細ログ出力で認証フローを確認する
$ sftp -vvv -i ~/.ssh/sftp_key sftp-user@192.168.1.50

# バッチファイルの先頭でディレクトリを作成しておく
-mkdir /remote/upload
cd /remote/upload
put /local/data/file.csv
bye