# ファイル転送設定

<figure><img src="/files/3ovlrGX9qE3g6g4kMPxn" alt=""><figcaption></figcaption></figure>

Keeper Connection Managerは、双方向のファイル転送をサポートしており、さまざまな接続タイプで独自の機能を使用できます。

### [RDP](#rdp-windows)

ローカルシステムとリモート接続の間で、簡単な[ドラッグアンドドロップ](#transfer-files)でファイルを転送できます。

### [SSH](#ssh-linux)

ファイルはドラッグアンドドロップで[リモートシステムに転送](#transfer-to-linux)できます。`guacctl`ツールを使用して、[リモートシステムからローカルブラウザへのファイル転送](#transfer-from-linux)を実行します。

### [VNC](#vnc)

ファイルはドラッグアンドドロップでリモートシステムにsftpで転送できます。sftpエンドポイントは、「Connection Edit」 (接続の編集) 画面で設定します。

### [MySQL](#mysql)

新しいMySQL接続タイプは、ブラウザインターフェースを介したリモートデータベースとのCSVデータの送受信をサポートしており、MySQL構文の拡張機能として開発された特別な「select」および「load」コマンドを使用します。

## RDP / Windows

Windows接続のファイル転送で使用する接続パラメータを以下に示します。RDP接続タイプは、2種類のファイル転送メソッドをサポートします。「Enable Drive」 (ドライブを有効化) メソッドはRDPプロトコルを使用し、ファイル転送をリモートシステムに対応づけられたドライブにマッピングします。

インストールメソッドに応じて、「Drive Path」 (ドライブパス) をいくつかの異なる方法で設定できます。

Dockerのインストールメソッドでは、`/var/lib/guacamole/`へのデフォルトのボリュームマウントがあります。

ドライブパスにはファイルの書き込みに必要な権限を持つベースパスである`/var/lib/guacamole/drives`を含める必要があります。

複数の接続で同じドライブパスを指定した場合、それらの接続間でファイルが共有されます。 /drives/に続いて`${GUAC_USERNAME}`などのトークンがドライブパスに含まれている場合、ユーザーごとに自分の共有ドライブが表示されます。

<figure><img src="/files/Sx9HDliiMr2yavA5VqJM" alt=""><figcaption><p>ファイル転送用のRDP接続設定</p></figcaption></figure>

{% code title="ドライブのパス" %}

```
/var/lib/guacamole/drives/${GUAC_USERNAME}
```

{% endcode %}

この例では、以下のパラメータが設定されています。

* **Enable Drive (ドライブを有効化) :** チェックするとファイル転送機能が有効になります。
* **Drive Path (ドライブパス)** : 環境に合わせてパスを設定します。このフォルダは、guacdユーザーから書き込み可能である必要があります。
* **Automatically Create Drive (ドライブの自動作成)** : 権限が付与されている場合、サブフォルダは必要に応じて作成されます。

マッピングされたドライブは、以下のようにリモートシステムに表示されます。

<figure><img src="/files/miq1r8U0s4pPR22v6KZy" alt=""><figcaption><p>ドライブの削除</p></figcaption></figure>

Windows接続では、オプションでファイル転送にSFTPを使用できます。使用するには、接続のSFTPセクションで有効にします。また、SFTPクライアント/サーバーがWindows上で実行されている必要があります。

#### ファイルの転送 <a href="#transfer-files" id="transfer-files"></a>

ローカルシステムからリモート接続にファイルを転送するには、ファイルをウィンドウにドラッグアンドドロップするだけです。 右下に進行状況のインジケータが表示されます。

<figure><img src="/files/7zzrTCxPt8MDK6esQ5e1" alt=""><figcaption><p>Windowsでのファイル転送</p></figcaption></figure>

ファイルの転送が完了すると、ドライブのフォルダにファイルが表示されます。

<figure><img src="/files/iug8OBhBGNgglm3zCmDh" alt=""><figcaption><p>ファイル転送完了</p></figcaption></figure>

<figure><img src="/files/xmB4QCPziVGJBZeAOWzk" alt=""><figcaption><p>ドライブフォルダ</p></figcaption></figure>

リモートシステムからローカルコンピュータにファイルを転送するには、リモートシステム上のファイルをマッピングされたドライブへとドラッグアンドドロップしてから、マッピングされたドライブの「ダウンロード」フォルダにドラッグするだけです。ファイルは直ちにローカルシステムにダウンロードされます。

<figure><img src="/files/vgo2EhjozgAuspjGumh1" alt=""><figcaption><p>マッピングされたドライブにファイルをコピー</p></figcaption></figure>

<figure><img src="/files/UyF0NW7pTpIuIcjgjTZQ" alt=""><figcaption><p>ダウンロードフォルダにファイルをコピー</p></figcaption></figure>

<figure><img src="/files/DVenS7cRtochPivHLPee" alt=""><figcaption><p>ローカル保存ファイル</p></figcaption></figure>

## SSH / Linux <a href="#ssh-linux" id="ssh-linux"></a>

SSH接続タイプでは、SFTPファイル転送が利用でき、ファイルをSSH接続画面に簡単にドラッグアンドドロップできます。SSH接続設定で指定した所定のフォルダにファイルが転送されます。

<figure><img src="/files/qHHDqfCpw5moyV6sCoQl" alt=""><figcaption><p>SFTP接続設定</p></figcaption></figure>

#### Linuxへの転送 <a href="#transfer-to-linux" id="transfer-to-linux"></a>

ファイルをSSH 接続にドラッグアンドドロップしてファイルをリモートシステムに転送できます。 デフォルトでは、別のルートディレクトリパスが指定されない限り、ファイルはホームフォルダに転送されます。

<figure><img src="/files/DMHObjbA8aI19ciMltj5" alt=""><figcaption><p>SSHファイル転送</p></figcaption></figure>

<figure><img src="/files/b4TXyt6tw5OfwIADRmd2" alt=""><figcaption><p>ホームフォルダに転送されたファイル</p></figcaption></figure>

#### Linuxからの転送 <a href="#transfer-from-linux" id="transfer-from-linux"></a>

SSHリモート接続からローカルファイルシステムにファイルを転送するには、リモートシステムに`guacctl`というツールを使用してアウトバウンド転送を実行します。

`guacctl`をダウンロードし、実行可能に設定します。

```bash
sudo wget https://raw.githubusercontent.com/apache/guacamole-server/master/bin/guacctl
sudo chmod +x guacctl
```

ファイルのダウンロードを開始します。

```sh
sudo ./guacctl -d <filename>s
```

<figure><img src="/files/WV6beAfLiZUxp8HEJiz8" alt=""><figcaption><p>guacctlを使用したファイル転送</p></figcaption></figure>

## MySQL

### インポート

データのインポートは、標準の「LOAD DATA LOCAL INFILE」SQLコマンドを使用して、ウェブブラウザインターフェースを介して実行されます。Keeper Connection Managerは応答データを傍受し、ウェブブラウザの標準ファイルダウンロード機能を使用して、そのデータをリダイレクトします。

以下に例を示します。

```
LOAD DATA LOCAL INFILE "input.csv" 
INTO TABLE products
FIELDS TERMINATED BY ','
ENCLOSED BY '"'
IGNORE 1 LINES
```

このSQLクエリは、ブラウザのファイルアップロードを実行し、提供されたデータをインポートします。

<figure><img src="/files/yivasQwB8XNV0LFlfjIY" alt=""><figcaption></figcaption></figure>

構文の詳細は、[MySQLのウェブサイト](https://dev.mysql.com/doc/refman/8.0/en/load-data.html)をご参照ください。

### エクスポート

新しい`SELECT...INTO LOCAL OUTFILE`コマンドを使用してSQLクエリからCSVデータをエクスポートします。

以下に例を示します。

```
 SELECT * FROM products INTO LOCAL OUTFILE "products.csv";
```

<figure><img src="/files/F2R1OCnXqSKEkJCsgVf6" alt=""><figcaption><p>MySQLからKeeper Connection Managerにデータをエクスポート</p></figcaption></figure>

## **ファイル転送のアップロード制限**

ファイルのアップロード制限は、NGINXの設定ファイルの`client_max_body_size`設定によって管理します。

Keeper Connection ManagerのDockerインストールでは、この設定のデフォルト値は「0」であり、アップロードできるファイルのサイズは無制限です。

Linux高度インストールメソッドでは、デフォルトのファイル転送制限が1MBに設定されている場合があり、ほとんどの場合、この制限を引き上げる必要があります。NGINXの一般的なインストール手順に従った場合は、設定ファイル (`/etc/nginx/conf.d/guacamole.conf`など) を変更する必要があります

以下のパラメータ (client\_max\_body\_size) が推奨される最大ファイルサイズ制限に設定されていることを確認します。例えば、以下は200MBのサイズ制限に設定されています。

`client_max_body_size 200m;`

この値を更新した後は、必ずNGINXを再起動してください。

`systemctl restart nginx`

## カスタムネットワークドライブ

ファイルの場所のパスを既存のネットワークドライブに関連付けたい場合は、以下の手順に従います。

* ネットワークドライブをKeeper Connection Managerホストファイルシステムにマウントします
* Docker Composeでネットワークドライブのパスをguacdコンテナにボリュームマウントします
* guacdユーザーが、dockerコンテナのファイルに書き込み可能であることを確認します

これを行うときに留意すべき最も重要なことは、ドライブパスのファイルへの書き込み許可を必要とするのが「guacd」サービスであるという点です。guacdサービスは、「guacd」コンテナ内で権限の制限された「guacd」ユーザーとして動作するため、ファイルの権限を適宜設定する必要があります。これを行うには、コンテナが使用する数字のUID/GIDを使用して、ファイルシステム上のファイルの所有権を適切な設定に変更するか、またはGUACD\_UIDおよびGUACD\_GID環境変数を使用して、guacdコンテナのファイルシステム上のファイルがすでに使用しているUID/GIDを使用するようにコンテナを設定します。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keeper.io/keeper-connection-manager/jp/using-keeper-connection-manager/file-transfer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
