SFTP経由での接続: FileZilla、Cyberduck、およびコマンドライン

SFTP (Secure File Transfer Protocol) を使用すると、サーバー上のサイトのファイルに直接アクセスできます。このガイドでは、認証情報の確認からエラーのトラブルシューティングまで、正常に接続するために必要なすべてのことについて説明します。

SFTP とその使用時期について

KPanel に組み込まれているファイルマネージャーは、クイック編集に便利です。ファイルの名前変更、設定の表示、単一のアセットのアップロードなどです。SFTP は、以下の場合に最適なツールです:

• 大量のファイルを一度にアップロードまたはダウンロードする (サイトの移行、画像の一括アップロード)。
• ブラウザベースのアップロードでタイムアウトする大きなファイルを転送する。
• ローカルでファイルを編集し、変更をプッシュする開発ワークフローの一部として作業する。
• ローカルフォルダとリモートフォルダの同期を保つ GUI クライアントを使用する。
• KPanel のファイルマネージャーで公開されていないログまたは設定ファイルにアクセスする。

SFTP は転送中のすべてのデータを暗号化するため、通常の FTP よりも安全です。KapsuleHost は暗号化されていない FTP 接続を提供していません。

前提条件

接続する前に、2 つのことが必要です。

1. KPanel のサイトに追加された SSH キー。

KapsuleHost の SFTP は SSH キー認証を使用します。パスワード認証はセキュリティ上の理由から無効です。SSH 公開キーをまだ追加していない場合は、最初に サイトへの SSH キーの追加 ガイドに従い、その後ここに戻ってください。

2. サイトのユーザー名。

KapsuleHost 上の各サイトには、専用のシステムユーザーがあります。これは KPanel のメールアドレスではなく、そのサイトに特に結びついた短いユーザー名です。

確認するには:

1. kpanel.kapsulehost.com で KPanel にログインします。
2. 左側のサイドバーで Websites をクリックします。
3. 接続するサイトをクリックします。
4. SSH / SFTP ページに移動します。
5. サイトのユーザー名はこのタブの上部に表示されます。通常は mysite_com または myexamplesite_net のような形式です。

接続詳細の概要:

---

FileZilla での接続

FileZilla は Windows、macOS、Linux で利用可能な無料のクロスプラットフォーム SFTP クライアントです。filezilla-project.org からダウンロードしてください (まだない場合)。

ステップバイステップセットアップ

1. FileZilla を開きます。

2. File > Site Manager に移動します (Windows で Ctrl+S を、Mac で Cmd+S を押すか)。

3. Add Website をクリックし、名前を付けます (例: 「My Kapsule Site」)。

4. General タブで、次のフィールドを構成します:

   フィールド	値
   Protocol	SFTP - SSH File Transfer Protocol
   Host	cp1-kapsule.kapsulehost.com
   Port	22
   Logon Type	Key file
   User	サイトのユーザー名 (例: mysite_com)
   Key file	Browse をクリックしてプライベートキーファイルに移動します

5. キーファイルについては、KPanel で追加した公開キーに対応するプライベートキーを選択します。macOS と Linux では、プライベートキーは通常 ~/.ssh/ に保存されます (例: ~/.ssh/id_ed25519 または ~/.ssh/id_rsa)。Windows では、C:\Users\YourName\.ssh\ に保存されることが多いです。

1. Connect をクリックして接続をテストするか、OK をクリックして後で接続するために保存します。

保存と再接続

Site Manager に保存された後、いつでも File > Site Manager に移動して Connect をクリックすることで再接続できます。FileZilla はツールバーのドロップダウンに保存されたサイトも表示し、クイックアクセスが可能です。

---

Cyberduck での接続

Cyberduck は macOS と Windows 向けの無料の SFTP クライアントです。cyberduck.io からダウンロードします。

ステップバイステップセットアップ

1. Cyberduck を開きます。

2. Open Connection をクリックします (ツールバーの地球アイコン)。

3. ダイアログの上部のプロトコルドロップダウンから、SFTP (SSH File Transfer Protocol) を選択します。

4. 接続フィールドに入力します:

   フィールド	値
   Server	cp1-kapsule.kapsulehost.com
   Port	22
   Username	サイトのユーザー名 (例: mysite_com)
   Password	空白のままにします
   SSH Private Key	Choose をクリックしてプライベートキーファイルを選択します

5. Connect をクリックします。

初回接続時、Cyberduck はサーバーのホストキーフィンガープリントの確認を求めます。Allow をクリックして続行します。後続の接続で異なるフィンガープリントでこのプロンプトが表示される場合は、それを受け入れず、サポートに問い合わせてください。設定の変更を示す可能性があります。

ブックマークとして保存

接続を将来使用するために保存するには:

1. 正常に接続した後、Bookmark > New Bookmark に移動します (Mac で Cmd+Shift+B を押すか)。
2. ブックマークに名前を付けてダイアログを閉じます。ブックマークは Cyberduck ブックマークリストに表示されます。

---

ターミナルから接続する (Mac、Linux、WSL)

コマンドラインを使用する場合は、sftp コマンドが macOS、Linux、Windows Subsystem for Linux (WSL) で利用可能です。

基本接続

sftp mysite_com@cp1-kapsule.kapsulehost.com

mysite_com を実際のサイトのユーザー名に置き換えます。プライベートキーがデフォルトの場所 (~/.ssh/id_rsa または ~/.ssh/id_ed25519) にない場合は、-i フラグで指定します:

sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com

初回接続時に、サーバーのホストフィンガープリントを確認するよう求められます。yes と入力して Enter を押します。これはデバイスごとにキーごとに 1 回だけ発生します。

便利な SFTP コマンド

接続すると、sftp> プロンプトが表示されます。これらのコマンドを使用してファイルをナビゲートおよび転送します:

例: ファイルをダウンロードする

sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip

例: ファイルをアップロードする

sftp> lcd ~/Desktop
sftp> cd htdocs/wp-content/uploads
sftp> put my-image.jpg

---

ファイルの場所

接続すると、サイトユーザーのホームディレクトリにランドします: /home/[siteuser]/。

ディレクトリ構造は以下のようになります:

/home/mysite_com/
├── htdocs/              ← Your web root (main location for site files)
│   ├── index.php
│   ├── wp-config.php
│   ├── wp-content/
│   │   ├── themes/
│   │   ├── plugins/
│   │   └── uploads/
│   └── ...
├── logs/                ← PHP and access logs
└── tmp/                 ← Temporary files

WordPress (またはその他のアプリケーション) が存在する Web ルートは htdocs/ です。これはほとんどの時間を過ごすディレクトリです。一部のサイト設定では、代わりに public_html/ という名前の場合があります。接続して public_html/ の代わりに htdocs/ が表示される場合は、それを使用します。

---

接続の問題のトラブルシューティング

接続が拒否されました

接続が確立される前にアクティブに拒否されました。

確認: ホスト cp1-kapsule.kapsulehost.com とポート 22 を使用していることを確認してください。一般的な間違いは、ポート 21 (これは SFTP ではなく FTP) または ホスト名のタイプミスを入力することです。

パーミッションが拒否されました (publickey)

サーバーは接続試行を受け入れましたが、認証を拒否しました。

以下の各項目を確認してください:

• SSH 公開キーが KPanel > Websites > [site] > SSH / SFTP に追加されています。ここにリストされていない場合、サーバーはそのレコードがありません。
• FileZilla/Cyberduck で正しいプライベートキーを選択しています。具体的には、KPanel に追加した公開キーとペアになるプライベートキーです。
• キーがパスフレーズを持っている場合は、正しく入力していることを確認してください。
• 複数のキーがある場合は、誤って間違ったキーを選択していないことを確認してください。

ホストキーの確認に失敗しました

SFTP クライアントがこのホスト名に対して以前に異なるホストキーを見て、不一致を警告しています。

初回接続時: フィンガープリントを受け入れるよう求められます。これは正常です。Accept をクリックするか、yes と入力してください。

新しいフィンガープリントでの後続接続: これはサーバーの設定変更を示すことができます。受け入れる前にサポートに support@kapsulehost.com で問い合わせ、何が表示されたかについて説明してください。

ターミナルで古いホストキーをクリアするには、~/.ssh/known_hosts を編集して cp1-kapsule.kapsulehost.com の行を削除します。

リモートリポジトリから読み取れませんでした、または間違ったディレクトリ

ユーザー名として KPanel メールアドレスの代わりにサイトのユーザー名を使用した可能性があります。

確認: ユーザー名は、メールアドレスではなく、サイトのユーザー名 (例: mysite_com) である必要があります。正しいユーザー名は KPanel > Websites > [site] > SSH / SFTP で確認してください。

接続がタイムアウトしました

接続試行がハングし、エラーなしでタイムアウトします。

考えられる原因:

• IP アドレスが、ログイン試行の失敗が繰り返されたために Kapsule のファイアウォールで一時的にブロックされている可能性があります。support@kapsulehost.com でサポートに問い合わせて、ファイアウォールログを確認するよう求めてください。
• ローカルファイアウォールまたはネットワークの VPN がポート 22 上のアウトバウンド接続をブロックしている可能性があります。別のネットワーク (モバイルホットスポットなど) から試してみて、これを除外してください。

---

関連記事

• サイトへの SSH キーの追加
• KPanel のファイルマネージャーの使用
• SSH トンネル経由でデータベースに接続する