すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:OSS FTP のインストール

最終更新日:Mar 20, 2026

ossftp は、標準の FTP クライアントを用いて OSS バケットにアクセスできるようにするツールです。本ページでは、Windows、Linux、macOS 各環境における ossftp のダウンロード、インストール、および構成方法について説明します。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

  • OSS バケットを 1 つ以上保有する Alibaba Cloud アカウント

  • 形式が BucketName.Endpoint のバケットエンドポイント(例: examplebucket.oss-cn-hangzhou.aliyuncs.com

  • ローカルコンピューターで TCP ポート 2048 および 8192 が利用可能であること

  • ネットワーク経由で他のユーザーにサービスを提供する場合:TCP ポート 2048 および 8192 へのインバウンドトラフィックを許可するファイアウォールルール

クイックスタート

  1. ご利用のオペレーティングシステムに対応したインストールパッケージをダウンロードします(「インストールパッケージのダウンロード」をご参照ください)。

  2. ダウンロードしたパッケージを、パス名に漢字を含まないディレクトリに展開します。

  3. ご利用のオペレーティングシステム向けに ossftp を起動します(「ossftp の実行」をご参照ください)。

  4. ブラウザで http://127.0.0.1:8192 を開き、バケットエンドポイントを入力して、[Save Config] をクリックし、次に [Restart] をクリックします。

インストールパッケージのダウンロード

ossftp 1.2.0 は Windows、Linux、macOS 各環境に対応しています。

Windows

ossftp-1.2.0-win.zip をダウンロードします。

Windows 用パッケージには Python 2.7 がバンドル済みです。別途 Python をインストールする必要はありません。

Linux

ossftp-1.2.0-linux-mac.zip をダウンロードします。

Linux にはデフォルトで Python 2.7 または Python 3.x が含まれています。このパッケージには必要な依存ライブラリのみが含まれます。

macOS

ossftp-1.2.0-linux-mac.zip をダウンロードします。

macOS にはデフォルトで Python 2.7 または Python 3.x が含まれています。このパッケージには必要な依存ライブラリのみが含まれます。

パッケージの展開

ダウンロードした .zip ファイルをローカルディレクトリに展開します。

重要

展開先のパスには漢字を含めないでください。パスに漢字が含まれていると、ossftp の起動に失敗します。

ossftp の実行

ご利用のオペレーティングシステム向けに ossftp を起動します。

オペレーティングシステム操作
Windowsstart.vbs をダブルクリックします。
Linuxbash start.sh を実行します。
macOSstart.command をダブルクリックします。
Windows 環境で ossftp が起動しない場合は、Internet Explorer を最新バージョンにアップグレードするか、別のブラウザを既定のブラウザに設定してください。

ossftp が起動すると、ローカルコンピューター上で以下の 2 つの TCP ポートが開きます。

ポート用途
2048FTP サーバー — FTP リクエストを受信
8192Web サーバー — グラフィカル管理インターフェイスをホスト
ネットワーク上の他のユーザーにもサービスを提供する場合は、ファイアウォール設定で両方のポートを開いてください。

ossftp の構成

  1. ブラウザでグラフィカル管理インターフェイスを開きます。

    デバイスURL
    ローカルコンピューターhttp://127.0.0.1:8192
    リモートデバイスhttp://<Linux サーバーの IP アドレス>:8192
  2. 構成パラメーターを設定します。

    パラメーター説明
    ossftp address127.0.0.1FTP サービスを利用するクライアントの IP アドレス。クライアントがローカルコンピューター上で動作する場合は、デフォルト値のままにしてください。
    ossftp port2048ossftp がリクエストを受信するポート。他のポートと競合しない限り、デフォルト値のままにしてください。
    ossftp passive ports start51000パッシブポート範囲の開始ポート番号。他のポートと競合しない限り、デフォルト値のままにしてください。
    ossftp passive ports end53000パッシブポート範囲の終了ポート番号。他のポートと競合しない限り、デフォルト値のままにしてください。
    ossftp log levelINFOログ出力レベル。有効な値: DEBUG | INFO | WARNING | ERROR | CRITICAL。詳細については、「ログレベル」をご参照ください。
    Bucket endpointsexamplebucket.oss-cn-hangzhou.aliyuncs.comバケットにアクセスするためのエンドポイント(形式:BucketName.Endpoint)。複数のエンドポイントを指定する場合は、カンマ(,)で区切ります。
    Languagecnossftp の表示言語。

    OSS FTP configuration interface

  3. [設定の保存] をクリックし、次に [再起動] をクリックして設定を有効にします。

    重要

    終了」をクリックしないでください。「終了」をクリックすると、ossftp が停止します。

ログレベル

レベル説明
DEBUG詳細な情報イベントを記録します。デバッグ時に使用します。
INFO通常の操作中に発生するイベントを記録します。
WARNINGシステムの動作に影響を与えない異常イベントを記録します。
ERRORシステムに影響を与える異常イベントを記録しますが、信頼性には影響しません。
CRITICALossftp の動作停止を引き起こすイベントを記録します。