# ファイルアップロード設定

# 概要

GROWI ページへのファイルアップロードに関する設定について紹介します。

GROWI ページの添付ファイルの保存先は以下を利用できます。詳細はこちらを参照してください。

WARNING

ファイル保存先を途中で変更すると、これまでにアップロードしたファイル等へのアクセスができなくなりますのでご注意ください。

添付ファイルの保存先を環境変数によって固定したい場合は、環境変数 FILE_UPLOAD_USES_ONLY_ENV_VAR_FOR_FILE_UPLOAD_TYPE を true にし、以下の表を参考に環境変数 FILE_UPLOAD の値を設定してください。

環境変数 FILE_UPLOAD_USES_ONLY_ENV_VAR_FOR_FILE_UPLOAD_TYPE によって保存先が固定されている場合、管理画面で設定した保存先は無効となります。

ファイルアップロード設定内の GCS 設定のフォームで値を指定していない場合は、以下のデフォルト値を利用します。

GCS 設定を環境変数によって固定したい場合は、環境変数 GCS_USES_ONLY_ENV_VARS_FOR_SOME_OPTIONS を true にし、上記の環境変数に値を入れてください。未設定の場合は、null が入ります。

環境変数 GCS_USES_ONLY_ENV_VARS_FOR_SOME_OPTIONS による GCS 設定の固定が有効な場合、ファイルアップロード設定での GCS 設定のフォームの値は無効となり、変更もできなくなります。

ファイルアップロード設定内の Azure(Blob) 設定のフォームで値を指定していない場合は、以下のデフォルト値を利用します。

Azure(Blob) 設定を環境変数によって固定したい場合は、環境変数 AZURE_USES_ONLY_ENV_VARS_FOR_SOME_OPTIONS を true にし、上記の環境変数に値を入れてください。未設定の場合は、null が入ります。

環境変数 AZURE_USES_ONLY_ENV_VARS_FOR_SOME_OPTIONS による Azure(Blob) 設定の固定が有効な場合、ファイルアップロード設定での Azure(Blob) 設定のフォームの値は無効となり、変更もできなくなります。

以下の環境変数により、一度にアップロードできるファイルのサイズ上限と全ページに添付されているファイルの累計サイズの上限を設定できます。いずれも単位は bytes です。デフォルトではいずれの値も Infinity となっており、ファイルサイズは制限されません。

v4.2.3 より添付ファイル参照方法に変更が加わりました。

Amazon S3, Google Cloud Storage を利用する場合、下記の2種類の方法から選択できます。
なお、v4.2.3 以降はデフォルトが Redirect Mode になります。

完全なセキュリティーが必要な場合のみ、
管理画面のアプリ設定から Relay Mode に変更してください。

Relay Mode では GROWI サーバーが Cloud Service との通信を中継し、クライアントにデータをリレー配信します。

クライアントは GROWI サーバーとの通信しか行わないため、
ファイル参照に関してはセキュリティー的には最も安全な手段となります。

ただしリレーの特性上、画像の数や容量、リクエスト数に応じて GROWI サーバーと Cloud Service との間のトラフィックが増大するというデメリットがあります。

Redirect Mode では Cloud Service にファイル参照用の署名付きURLの発行を依頼し、
それをクライアントに知らせ、リダイレクトを促します。

クライアントは受け取った署名付きURLにアクセスし、Cloud Service から画像を直接取得します。

GROWI サーバーはトラフィックを中継せず、各クライアントが直接 Cloud Service から画像を受け取ります。そのため、画像の数や容量、リクエスト数によって GROWI サーバーに負荷がかからず、全体的に優れたパフォーマンスを発揮できます。

また署名付きURLの発行時は十分に短い失効期間が設定されるため、セキュリティ上もバランスの取れた仕様となっています。

GROWI サーバーは失効期間と同じ長さだけ署名付きURLをキャッシュします(デフォルトでは120秒)。
キャッシュを保持する秒数は環境変数で設定できます。