【bat】バッチファイルでFTP送受信を自動化する方法完全ガイド｜スクリプトファイル・アップロード・ダウンロード・エラー処理・実践例まで徹底解説

毎日決まった時刻にサーバーへファイルをアップロードしたい、または定期的にリモートサーバーからファイルを取得したい。そういった要件はバッチファイルとWindowsに標準搭載されているftp コマンドで自動化できます。この記事では、バッチファイルからFTP送受信を自動化する方法を体系的に解説します。FTPスクリプトファイルを使ったヘッドレス実行の仕組みから、アップロード・ダウンロード・複数ファイル一括転送・エラー処理・パスワード管理のセキュリティ注意点まで、実践例3本とともにわかりやすく説明します。

1. Windows の ftp コマンドとヘッドレス実行の仕組み

Windowsには ftp.exe（C:\Windows\System32\ftp.exe）が標準搭載されています。通常は対話形式で使いますが、-s:スクリプトファイル オプションを使うと、あらかじめ用意したコマンドファイルを読み込んで非対話（ヘッドレス）で実行できます。これがバッチから FTP を自動化する基本的な仕組みです。

:: 基本的な実行形式
ftp -n -s:ftpscript.txt

:: オプションの意味
::   -n   自動ログインを抑制（スクリプト内で user コマンドでログインする）
::   -s:  読み込むFTPスクリプトファイルのパスを指定
::   -i   複数ファイル転送中の確認プロンプトを抑制（mput/mget に必須）
::   -v   応答メッセージの表示を抑制（ログが増えるのを防ぐ）

2. バッチからFTPスクリプトファイルを動的に生成する方法

FTPスクリプトファイルを静的に用意しておく方法もありますが、バッチ実行時に動的に生成する方法が実務では一般的です。日付付きファイル名を転送対象にしたり、環境変数から接続先を切り替えたりできます。

@echo off

:: ─── FTP接続情報（本来は環境変数や設定ファイルから読み込む） ─
set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
set "FTP_PASS=mypassword"
set "REMOTE_DIR=/upload/data"
set "LOCAL_FILE=C:\work\data.csv"
set "REMOTE_FILE=data.csv"

:: ─── FTPスクリプトファイルを動的生成 ─────────────────────────
set "FTP_SCRIPT=%TEMP%\ftpcmd_%RANDOM%.txt"

echo open %FTP_HOST%                     > "%FTP_SCRIPT%"
echo user %FTP_USER% %FTP_PASS%          >> "%FTP_SCRIPT%"
echo binary                              >> "%FTP_SCRIPT%"
echo cd %REMOTE_DIR%                     >> "%FTP_SCRIPT%"
echo put "%LOCAL_FILE%" %REMOTE_FILE%    >> "%FTP_SCRIPT%"
echo bye                                 >> "%FTP_SCRIPT%"

:: ─── FTP実行 ───────────────────────────────────────────────────
ftp -n -i -v -s:"%FTP_SCRIPT%"
set "FTP_RC=%ERRORLEVEL%"

:: ─── スクリプトファイルを削除（パスワードが残らないように） ──
del "%FTP_SCRIPT%" >nul 2>&1

if "%FTP_RC%"=="0" (
    echo [OK] FTP送信完了: %REMOTE_FILE%
) else (
    echo [ERROR] FTP送信失敗 ERRORLEVEL=%FTP_RC%
    exit /b 1
)
pause

3. ファイルをアップロードする（put）

3-1. 1ファイルをアップロードする基本パターン

@echo off

set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
set "FTP_PASS=mypassword"

:: ─── 日付付きレポートをアップロードする例 ──────────────────
set "YMD=%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%"
set "LOCAL_FILE=C:\work\report_%YMD%.csv"
set "REMOTE_FILE=report_%YMD%.csv"

:: ─── ファイルの存在確認 ────────────────────────────────────
if not exist "%LOCAL_FILE%" (
    echo [ERROR] アップロード対象ファイルが見つかりません: %LOCAL_FILE%
    exit /b 1
)

set "FTP_SCRIPT=%TEMP%\ftpcmd_%RANDOM%.txt"
(
    echo open %FTP_HOST%
    echo user %FTP_USER% %FTP_PASS%
    echo binary
    echo cd /upload/reports
    echo put "%LOCAL_FILE%" %REMOTE_FILE%
    echo bye
) > "%FTP_SCRIPT%"

ftp -n -i -v -s:"%FTP_SCRIPT%" >> "%~dp0logs\ftp_%YMD%.log" 2>&1
del "%FTP_SCRIPT%" >nul 2>&1

echo [%DATE% %TIME%] アップロード完了: %REMOTE_FILE%
pause

put の引数は put ローカルファイル リモートファイル名 の順です。リモートファイル名を省略すると、ローカルのファイル名と同名でアップロードされます。FTPログは >> ログファイル 2>&1 でファイルに記録することを推奨します。ログ出力の詳しい方法も参照してください。

3-2. サブフォルダへアップロードする（cd でサーバー側ディレクトリ移動）

:: ─── FTPスクリプト内で cd を使ってサーバー側のフォルダを移動 ─
echo open %FTP_HOST%       > "%FTP_SCRIPT%"
echo user %FTP_USER% %FTP_PASS% >> "%FTP_SCRIPT%"
echo binary               >> "%FTP_SCRIPT%"
echo cd /upload           >> "%FTP_SCRIPT%"
echo mkdir %YMD%          >> "%FTP_SCRIPT%"
echo cd %YMD%             >> "%FTP_SCRIPT%"
echo put "C:\work\data.csv" data.csv >> "%FTP_SCRIPT%"
echo bye                  >> "%FTP_SCRIPT%"

4. ファイルをダウンロードする（get）

4-1. 1ファイルをダウンロードする基本パターン

@echo off

set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
set "FTP_PASS=mypassword"
set "REMOTE_FILE=latest_data.csv"
set "LOCAL_DIR=C:\work\download"

:: ─── ダウンロード先フォルダを作成 ──────────────────────────
if not exist "%LOCAL_DIR%\" mkdir "%LOCAL_DIR%"

set "FTP_SCRIPT=%TEMP%\ftpcmd_%RANDOM%.txt"
(
    echo open %FTP_HOST%
    echo user %FTP_USER% %FTP_PASS%
    echo binary
    echo lcd %LOCAL_DIR%
    echo cd /download
    echo get %REMOTE_FILE%
    echo bye
) > "%FTP_SCRIPT%"

ftp -n -i -v -s:"%FTP_SCRIPT%"
set "RC=%ERRORLEVEL%"
del "%FTP_SCRIPT%" >nul 2>&1

if "%RC%"=="0" (
    echo [OK] ダウンロード完了: %LOCAL_DIR%\%REMOTE_FILE%
) else (
    echo [ERROR] ダウンロード失敗 ERRORLEVEL=%RC%
    exit /b 1
)
pause

get の引数は get リモートファイル [ローカルファイル名] です。ローカルファイル名を省略するとリモートと同名でダウンロードされます。lcd（local change directory）でローカルの保存先フォルダを移動してから get を実行すると、任意のフォルダに保存できます。

5. 複数ファイルを一括転送する（mput / mget）

ワイルドカードで複数ファイルを一括転送するには mput（アップロード）または mget（ダウンロード）を使います。-i オプション（確認プロンプトの抑制）が必須です。忘れると各ファイルごとに「y/n?」と聞かれてバッチが止まります。

@echo off

set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
set "FTP_PASS=mypassword"

set "FTP_SCRIPT=%TEMP%\ftpcmd_%RANDOM%.txt"

:: ─── 複数CSVファイルをアップロード（mput） ────────────────
(
    echo open %FTP_HOST%
    echo user %FTP_USER% %FTP_PASS%
    echo binary
    echo lcd C:\work\data
    echo cd /upload
    echo mput *.csv
    echo bye
) > "%FTP_SCRIPT%"

:: -i オプションで確認プロンプトを抑制することが必須
ftp -n -i -v -s:"%FTP_SCRIPT%"
del "%FTP_SCRIPT%" >nul 2>&1

:: ─── 複数ファイルをダウンロード（mget） ───────────────────
set "FTP_SCRIPT2=%TEMP%\ftpcmd_%RANDOM%.txt"
(
    echo open %FTP_HOST%
    echo user %FTP_USER% %FTP_PASS%
    echo binary
    echo lcd C:\work\download
    echo cd /download
    echo mget *.csv
    echo bye
) > "%FTP_SCRIPT2%"

ftp -n -i -v -s:"%FTP_SCRIPT2%"
del "%FTP_SCRIPT2%" >nul 2>&1
pause

6. for ループで複数ファイルを確実に1件ずつ転送する

mput が不安定な場合や、転送ごとに結果を記録したい場合は、バッチの for ループで対象ファイルを1件ずつ転送する方法が堅牢です。

@echo off
setlocal enabledelayedexpansion

set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
set "FTP_PASS=mypassword"
set "LOCAL_DIR=C:\work\data"
set "REMOTE_DIR=/upload/data"
set "LOG_FILE=%~dp0logs\ftp_%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%.log"

if not exist "%~dp0logs\" mkdir "%~dp0logs"

set /a "OK=0"
set /a "NG=0"

:: ─── 対象フォルダの全CSVを1件ずつアップロード ──────────
for %%F in ("%LOCAL_DIR%\*.csv") do (
    set "FTP_SCRIPT=%TEMP%\ftpcmd_!RANDOM!.txt"
    (
        echo open %FTP_HOST%
        echo user %FTP_USER% %FTP_PASS%
        echo binary
        echo cd %REMOTE_DIR%
        echo put "%%F" %%~nxF
        echo bye
    ) > "!FTP_SCRIPT!"

    ftp -n -i -v -s:"!FTP_SCRIPT!" >> "%LOG_FILE%" 2>&1
    set "RC=!ERRORLEVEL!"
    del "!FTP_SCRIPT!" >nul 2>&1

    if "!RC!"=="0" (
        echo [%DATE% %TIME%] [OK] %%~nxF >> "%LOG_FILE%"
        set /a "OK+=1"
    ) else (
        echo [%DATE% %TIME%] [NG] %%~nxF ERRORLEVEL=!RC! >> "%LOG_FILE%"
        set /a "NG+=1"
    )
)

echo [%DATE% %TIME%] 完了 OK=!OK! NG=!NG! >> "%LOG_FILE%"
echo 完了: OK=!OK! NG=!NG!  ログ: %LOG_FILE%
pause

7. バイナリ / ASCII モードの切り替えと注意点

FTPには バイナリモードと ASCIIモードの2種類の転送モードがあります。モードを間違えるとファイルが壊れる原因になります。

8. FTP のエラー処理とログ記録の注意点

8-1. ERRORLEVEL の落とし穴

Windows の ftp.exe はエラーが発生しても ERRORLEVEL が 0 を返すことがあります。たとえば接続先ファイルが存在しなくて get が失敗した場合でも、ftp コマンド自体の終了コードは 0 になることが多いです。このため、FTP の成否を確認するには FTPログを解析する方法が最も確実です。

@echo off
setlocal enabledelayedexpansion

set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
set "FTP_PASS=mypassword"
set "FTP_LOG=%TEMP%\ftp_result_%RANDOM%.log"
set "FTP_SCRIPT=%TEMP%\ftpcmd_%RANDOM%.txt"

(
    echo open %FTP_HOST%
    echo user %FTP_USER% %FTP_PASS%
    echo binary
    echo put "C:\work\data.csv" data.csv
    echo bye
) > "%FTP_SCRIPT%"

:: ─── FTP実行ログをファイルに保存 ───────────────────────────
ftp -n -i -v -s:"%FTP_SCRIPT%" > "%FTP_LOG%" 2>&1
del "%FTP_SCRIPT%" >nul 2>&1

:: ─── ログ内に成功メッセージがあるか確認 ─────────────────
findstr /i "226 Transfer complete" "%FTP_LOG%" >nul 2>&1
if %ERRORLEVEL%==0 (
    echo [OK] FTP送信成功
) else (
    echo [ERROR] FTP送信失敗。ログを確認してください: %FTP_LOG%
    type "%FTP_LOG%"
    exit /b 1
)
del "%FTP_LOG%" >nul 2>&1
pause

8-2. ネットワーク接続を事前確認してからFTPを実行する

ネットワークが不安定な環境では、FTP実行前に接続確認を行うことを推奨します。ネットワーク接続の有無を判定して処理を分岐する方法も参照してください。

@echo off

set "FTP_HOST=ftp.example.com"

:: ─── ping で接続確認（1回・タイムアウト3秒） ──────────────
ping -n 1 -w 3000 %FTP_HOST% >nul 2>&1
if %ERRORLEVEL% neq 0 (
    echo [ERROR] %FTP_HOST% に到達できません。FTP処理を中止します
    exit /b 1
)
echo [OK] ネットワーク接続確認済み

:: ─── FTP処理へ続く ─────────────────────────────────────────

9. パスワード管理のセキュリティ注意点

9-1. 環境変数でパスワードを外部から注入する

パスワードをバッチファイルに直書きせず、実行前に環境変数としてセットする方法が比較的安全です。タスクスケジューラやCI環境ではシークレット変数から渡せます。

:: 別のスクリプトや環境からパスワードを渡す場合
:: set FTP_PASS=実際のパスワード  ← 実行環境でセット
@echo off

if "%FTP_PASS%"=="" (
    echo [ERROR] 環境変数 FTP_PASS が設定されていません
    exit /b 1
)

set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
:: FTP_PASS は環境変数から取得（バッチ内に直書きしない）

set "FTP_SCRIPT=%TEMP%\ftpcmd_%RANDOM%.txt"
(
    echo open %FTP_HOST%
    echo user %FTP_USER% %FTP_PASS%
    echo binary
    echo put "C:\work\data.csv" data.csv
    echo bye
) > "%FTP_SCRIPT%"

ftp -n -i -v -s:"%FTP_SCRIPT%"
del "%FTP_SCRIPT%" >nul 2>&1

9-2. SFTPへの移行を検討する

FTPは通信が暗号化されていません。ユーザー名・パスワード・ファイルの中身がすべて平文でネットワークを流れます。社内ネットワークであっても、セキュリティ要件が厳しい環境では SFTP（SSH File Transfer Protocol）への移行を検討してください。WinSCPをバッチから使う方法は WinSCPを使ったSFTP接続とファイル送受信の方法で詳しく解説しています。

10. 実践例3本

実践例1：毎日の売上CSVを日付付きでFTPアップロードする

タスクスケジューラと組み合わせて毎朝9時に実行する想定の、日次バッチファイルの定番パターンです。日付をファイル名に使う方法と組み合わせています。

@echo off
setlocal enabledelayedexpansion

:: ─── 設定 ──────────────────────────────────────────────────
set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
set "FTP_PASS=mypassword"
set "YMD=%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%"
set "LOCAL_FILE=C:\work\sales\sales_%YMD%.csv"
set "REMOTE_FILE=sales_%YMD%.csv"
set "LOG_DIR=%~dp0logs"
set "LOG_FILE=%LOG_DIR%\ftp_upload_%YMD%.log"

if not exist "%LOG_DIR%\" mkdir "%LOG_DIR%"

:: ─── ファイル存在確認 ───────────────────────────────────────
if not exist "%LOCAL_FILE%" (
    echo [%DATE% %TIME%] [ERROR] 対象ファイルなし: %LOCAL_FILE% >> "%LOG_FILE%"
    exit /b 1
)

:: ─── ネットワーク確認 ───────────────────────────────────────
ping -n 1 -w 3000 %FTP_HOST% >nul 2>&1
if %ERRORLEVEL% neq 0 (
    echo [%DATE% %TIME%] [ERROR] FTPサーバーに到達不可 >> "%LOG_FILE%"
    exit /b 1
)

:: ─── FTP実行 ────────────────────────────────────────────────
set "FTP_SCRIPT=%TEMP%\ftpcmd_!RANDOM!.txt"
set "FTP_RESULT=%TEMP%\ftpresult_!RANDOM!.txt"
(
    echo open %FTP_HOST%
    echo user %FTP_USER% %FTP_PASS%
    echo binary
    echo cd /upload/sales
    echo put "%LOCAL_FILE%" %REMOTE_FILE%
    echo bye
) > "!FTP_SCRIPT!"

ftp -n -i -v -s:"!FTP_SCRIPT!" > "!FTP_RESULT!" 2>&1
type "!FTP_RESULT!" >> "%LOG_FILE%"
del "!FTP_SCRIPT!" >nul 2>&1

:: ─── 成否をログ解析で確認 ──────────────────────────────────
findstr /i "226 Transfer complete" "!FTP_RESULT!" >nul 2>&1
if !ERRORLEVEL!==0 (
    echo [%DATE% %TIME%] [OK] アップロード成功: %REMOTE_FILE% >> "%LOG_FILE%"
    echo [OK] アップロード完了
) else (
    echo [%DATE% %TIME%] [ERROR] アップロード失敗 >> "%LOG_FILE%"
    echo [ERROR] アップロード失敗。ログ: %LOG_FILE%
)
del "!FTP_RESULT!" >nul 2>&1
pause

実践例2：リモートサーバーからデータファイルを定期ダウンロードする

リモートサーバーの特定フォルダから複数のCSVをダウンロードして日付付きフォルダに保存する定期実行バッチの例です。

@echo off
setlocal enabledelayedexpansion

set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
set "FTP_PASS=mypassword"
set "YMD=%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%"
set "DOWNLOAD_DIR=C:\work\download\%YMD%"
set "LOG_FILE=%~dp0logs\ftp_download_%YMD%.log"

if not exist "%DOWNLOAD_DIR%\" mkdir "%DOWNLOAD_DIR%"
if not exist "%~dp0logs\" mkdir "%~dp0logs"

echo [%DATE% %TIME%] ダウンロード開始 >> "%LOG_FILE%"

set "FTP_SCRIPT=%TEMP%\ftpcmd_!RANDOM!.txt"
(
    echo open %FTP_HOST%
    echo user %FTP_USER% %FTP_PASS%
    echo binary
    echo lcd %DOWNLOAD_DIR%
    echo cd /data/export
    echo mget *.csv
    echo bye
) > "!FTP_SCRIPT!"

ftp -n -i -v -s:"!FTP_SCRIPT!" >> "%LOG_FILE%" 2>&1
del "!FTP_SCRIPT!" >nul 2>&1

echo [%DATE% %TIME%] ダウンロード完了 保存先: %DOWNLOAD_DIR% >> "%LOG_FILE%"
echo 完了。保存先: %DOWNLOAD_DIR%
pause

実践例3：アップロード後にリモートの古いファイルを削除する

新しいファイルをアップロードした後、サーバー側の古いファイルを FTPスクリプト内の delete で削除するパターンです。サーバー側のディスクが逼迫しないよう定期的に行う運用に使えます。

@echo off
setlocal enabledelayedexpansion

set "FTP_HOST=ftp.example.com"
set "FTP_USER=ftpuser"
set "FTP_PASS=mypassword"
set "YMD=%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%"

:: ─── 昨日の日付を計算（PowerShellで取得） ─────────────────
for /f %%d in ('powershell -NoProfile -Command "Get-Date (Get-Date).AddDays(-1) -Format yyyyMMdd"') do set "YESTERDAY=%%d"

set "FTP_SCRIPT=%TEMP%\ftpcmd_!RANDOM!.txt"
(
    echo open %FTP_HOST%
    echo user %FTP_USER% %FTP_PASS%
    echo binary
    echo cd /upload/daily
    echo put "C:\work\daily_%YMD%.csv" daily_%YMD%.csv
    echo delete daily_%YESTERDAY%.csv
    echo bye
) > "!FTP_SCRIPT!"

ftp -n -i -v -s:"!FTP_SCRIPT!" >> "%~dp0logs\ftp_%YMD%.log" 2>&1
del "!FTP_SCRIPT!" >nul 2>&1

echo [OK] %YMD% アップロード + %YESTERDAY% 削除完了
pause

11. まとめ：FTP バッチ チートシート

FAQ