For the complete documentation index, see llms.txt. This page is also available as Markdown.

ファイル転送設定

ローカル接続とリモート接続間でのファイル転送

Keeperコネクションマネージャーは、双方向のファイル転送に対応しており、さまざまな接続タイプで独自の機能を使用できます。

RDP

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

SSH

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

VNC

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

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} などのトークンがドライブパスに含まれている場合、ユーザーごとに自分の共有ドライブが表示されます。

ファイル転送用のRDP接続設定

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

  • [Enable Drive] (ドライブを有効化): チェックするとファイル転送機能が有効になります。

  • [Drive Path] (ドライブパス): 環境に合わせてパスを設定します。このフォルダは、guacd ユーザーから書き込み可能である必要があります。

  • [Automatically Create Drive] (ドライブの自動作成): 権限が付与されている場合、サブフォルダは必要に応じて作成されます。

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

ドライブの削除

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

ファイルの転送

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

Windowsでのファイル転送

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

ファイル転送完了
ドライブフォルダ

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

マッピングされたドライブにファイルをコピー
ダウンロードフォルダにファイルをコピー
ローカル保存ファイル

SSH / Linux

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

SFTP接続設定

Linuxへの転送

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

SSHファイル転送
ホームフォルダに転送されたファイル

Linuxからの転送

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

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

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

guacctlを使用したファイル転送

MySQL

インポート

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

以下に例を示します。

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

構文について詳しくは、MySQLのウェブサイト をご参照ください。

エクスポート

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

以下に例を示します。

MySQLからKeeperコネクションマネージャーにデータをエクスポート

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

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

KeeperコネクションマネージャーのDockerインストールでは、この設定のデフォルト値は 0 であり、アップロードできるファイルのサイズは無制限です。

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

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

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

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

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

  • ネットワークドライブをKeeperコネクションマネージャーホストファイルシステムにマウントします

  • Docker Composeでネットワークドライブのパスを guacd コンテナにボリュームマウントします

  • guacd ユーザーが、dockerコンテナのファイルに書き込み可能であることを確認します

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

最終更新