概要
Reverse SSHでは、お客様のNASがPaperOfficeへの発信暗号化接続(トンネル)を自ら確立します。ルーターでのポート開放は不要です。PaperOffice AIはWorkspacesの暗号化された文書をお客様のNASに保存します。
Workspaceを作成する前にストレージを作成してください。Workspacesのストレージモードは作成後に変更できません。
ステップ1:NASの準備(QNAPの例)
QTSのメニューはQTSのバージョンによって若干異なる場合があります。
- 専用の共有フォルダーを作成します。例:
paperoffice。PaperOffice ClassicやMariaDBのフォルダーは使用しないでください。 - コントロールパネル › ネットワーク&ファイルサービス › Telnet / SSHで、SSHとSFTPを有効にします。
- そこで「アクセス権限の編集」に、ログインに使用するNASユーザーを追加します。このリストにユーザーがいない場合、NASはSSHログインを拒否します。
- Container Station(Docker)をインストールします。提案されたコンテナ用共有フォルダーはそのまま使用できます。
Synology:Container Manager、ユーザーホームサービスを有効にし、ユーザーをadministratorsグループに追加します。ASUSTOR:Docker Engine。UGREEN:Docker。
ステップ2:PaperOffice AIでストレージを作成する
- Document AI › Storage Mountsを開き、Storage Mount を追加をクリックします。
- 赤いアスタリスク(*)の付いた項目は必須項目です。
- この Storage Mount の名前:自由に選択できます。
- 振込名義:BYOS-Storageとして使用。
- 接続タイプ:リバースSSHでローカルフォルダに接続。
- お客様のNAS:QNAPを選択します。アプリが
/share/paperofficeを提案します(Synology、ASUSTOR、UGREEN:/volume1/paperoffice)。 - ローカルSSHユーザー:NASでのユーザー名です。管理者グループのメンバーである必要があります。
- ローカルフォルダ:フォルダーへのフルパス。QNAPでは
/share/<Name des Freigabeordners>です。引用符、バックスラッシュ、* ? [ ]は使用しないでください。フォルダーとユーザーは後から変更できません。 - 暗号化パスワードとパスワードの確認:16文字以上、または安全なパスワードを生成(鍵アイコン)。
- .txtとしてダウンロードをクリックします。その後でないとストレージを作成できません。ファイルは安全な場所に保管してください。パスワードがないと復元できません。
- 確認のチェックボックスをオンにして保存します。
ステップ3:適切なセットアップブロックを選択する
保存後、リバースSSHセットアップウィンドウがトンネルエイリアスとともに開きます。上部でバリエーションを選択してください:
- Docker対応NAS: 小さなトンネルコンテナを起動するブロック。Container Station搭載のQNAPにとって適切な選択です。
- Dockerを使用しないNAS: ブロック1をSSH経由で、ブロック2を自動起動に設定します。
- Linux / macOSおよびWindows: パソコン向けです。
セットアップをコピーを使用してブロックをコピーしてください。Dockerを使用しないNASの場合、各ブロックに専用のボタンが用意されています。
ステップ4: NASでログインし、ブロックを貼り付ける
Windowsの場合は、PuTTYなどを使用します(バージョンにより表記が若干異なる場合があります):
- 「Host」欄に、ローカルネットワーク内のNASのIPアドレスを入力し、ポート
22で接続を開きます。 - ステップ2で設定したNASユーザーでログインしてください。パスワード入力時は文字が表示されませんが、これは正常な動作です。
- QNAPがログイン後にコンソールメニュー(例:「Console Management」)を表示する場合があります。通常のコマンドラインに戻るため、QTSのバージョンに応じて
Qおよびその後Yを押してください。 - ウィンドウ内で右クリックするとブロックが貼り付けられます。その後、Enterキーを押してください。
Macの場合:ターミナルアプリを開き、次にssh <Benutzer>@<IP-Adresse des NAS>を実行してください。
ブロックはNASにあるこのウィンドウにのみ配置してください。NASにはインターネット接続が必要です。トンネルはお客様のNASから外部に向けて構築され、コンテナ起動時に小さなLinuxパッケージが読み込まれます。
ステップ5:接続テスト
- Storage Mountsのストレージを編集で開きます。
- 接続テストをクリックします(保存後に有効になります)。
- 成功のメッセージ:「トンネル有効:NASに到達可能、フォルダは書き込み可。」その後、独自のストレージ(BYOS)を使用してWorkspaceを作成してください。
テストでログインが拒否された場合は、ステップ1で確認したNASユーザーとアクセスリストを確認してください。その後、登録されているNASユーザーとして再度エントリを追加し、テストを再実行してください。
トレースが示す内容
一覧で 接続テスト を起動すると、PaperOffice のトレースが地図付きで開始されます。Reverse SSH では、ターゲットは PaperOffice のトンネルサーバーであり、お客様の NAS ではありません。場所の表示は、この経路上のネットワークノードを示しており、お客様のファイルの保存場所ではありません。
リブート後
トンネルコンテナは、Docker が稼働している状態になると、リブート後に自動的に起動します。接続が切断された場合は、10秒後に再接続を試みます。Docker がない場合、自動起動のブロック 2 が対応します。
セキュリティ:セットアップブロックには秘密鍵が含まれています
このブロックには秘密鍵が含まれており、お客様の NAS ユーザーのログインキーとして登録されます。このブロックを所持している者は、お客様のトンネルになりすまし、SSH サービスが利用可能な場所からお客様の NAS ユーザーとしてログインできます。暗号化パスワードはブロック内には含まれていません。
- チャンネル、AI アシスタント、メール、サポートチケットにこのブロックを絶対に貼り付けないでください。
- サポートはこのブロックを必要としません。代わりにテストのエラーメッセージをお知らせください。
Wenn es doch passiert ist:
- 可能な限りメッセージを削除してください。
- 「キーの再生成」ボタンは存在しません。編集してもキーは変更されません。
- Workspace がストレージを使用していない場合:Storage Mount を削除してください。これにより、PaperOffice はトンネルサーバーからキーが解除されますが、NAS 上のファイルは保持されます。同じ暗号化パスワードまたは空のフォルダを使用して、ストレージを再作成してください(新しいキー、新しいトンネルエイリアス)。
- NAS から古いキーを削除してください:お客様の NAS ユーザーのフォルダ
.ssh内にある、authorized_keysの行で「PaperOffice」と古いトンネルエイリアスで終わるものを削除し、ファイルpaperoffice_<alter Tunnel-Alias>を削除してください。Docker を使用している場合:お客様の Docker インターフェース(QNAP: Container Station)から、名前にpaperoffice-tunnel-が付く古いコンテナを削除してください。Docker を使用していない場合:同じフォルダ.ssh内のスクリプトpaperoffice_tunnel_<alter Tunnel-Alias>.shを削除し、自動起動から古いエントリを削除してください。 - Workspace がすでにストレージを使用している場合、そのストレージは削除できません。その場合は、アプリ内の サポート でチケットを作成し、キーが外部に漏れたことを記載してください。この際、ブロックを貼り付けないでください。