Marinaraのバックアップと復元

Marinara Engineのデータのコピーを保存し、後から戻す方法を説明します。アップデートの前、新しいデバイスへの移行前、データを消去する前に行ってください。

使う方法の選び方

方法	作られるもの	用途
Download Backup	すべてのデータとファイルを収めた`.zip`。	すべてをまるごと1つにしたコピー。
Export Profile	アカウントのデータ(キャラクター、チャット、ロアブックなど)だけを収めた小さめのファイル。	秘密の値を含まないコピーや、他のツール向けのファイル。

.zipは、たくさんのファイルを1つにまとめたファイルです。どちらの方法もSettings → Advanced → Backup & Export(設定 → 詳細設定 → バックアップとエクスポート)にあります。復元はSettings → Imports → Profile & Marinara(設定 → インポート → プロファイルとMarinara)で行います。

始める前に: Marinaraを動かしているコンピューターでは、これらの機能はそのまま使えます。スマートフォン、タブレットなどの別のデバイスから使う場合は、サーバーに管理者用のシークレットを設定し、同じ値をSettings → Advanced → Admin Accessに入力してください。管理者用のシークレットは、サーバーの.envファイルにADMIN_SECRETという設定で書くパスワードです。サーバー設定リファレンスの「Privileged APIs (ADMIN_SECRET)」のセクションとリモートアクセスを参照してください。

Download Backup

Settings → Advancedを開きます。
Backup & ExportでDownload Backupをクリックします。ボタンの表示はCreating backup…になります。
ブラウザーが確認したらファイルを保存します。または、ダウンロードフォルダーで見つけます。

.zipには次のものが入っています。

保存済みのテキストデータ(キャラクター、チャット、ロアブック、プリセット、接続、設定)
アップロードしたファイルと生成したファイル(アバター、スプライト、背景、ギャラリーの画像、フォント、カスタム絵文字とスタンプ、自分で設定した通知音など)
.encryption-keyファイル(存在する場合)
手作業での復元方法を書いたRESTORE.txtのメモ(手作業での復元を参照)

フォルダー名については、Marinaraがデータを保存する場所を参照してください。

Warning: バックアップには、保存済みのAPIキーと、それを復号する.encryption-keyファイルが入っています。絶対に共有しないでください。他人に見られない場所に保管してください。

Androidではアプリのデータフォルダーに手が届きません。そのため、デバイスの外にコピーを取り出すにはDownload Backupを使います。

うまくいかなかった場合: 「Backup preparation timed out after one hour.」と表示されたら、もう一度試してください。別のデバイスからダウンロードできない場合は、Admin Accessを確認してください(上記を参照)。

自動バックアップ

Marinaraは、動かしているコンピューター上で、スケジュールに沿って完全バックアップを作れます。

Settings → Advanced → Backup & Exportを開きます。
Automatic backupsをオンにします。
Daily、Weekly、Monthlyのいずれかを選びます。
Automatic backups keptを1から9999までの範囲で設定します。

Marinaraは、オンにしてまもなく最初のバックアップを作ります。実行のたびに、新しいバックアップを設定した数まで残し、古い自動バックアップを削除します。Download Backupで作ったバックアップは削除しません。

自動バックアップは、データフォルダー内のbackups/フォルダーにあります。最新のものはmarinara-automatic-backup.zipです。古いものは、名前に日付と時刻が付きます。形式はDownload Backupと同じです。

新しいアーカイブが完成するまで古いものが残るため、実行のたびに完全なアーカイブ1つ分の空き容量が必要です。空き容量が足りないと、Marinaraはその回をスキップし、設定の横に理由を表示します。空き容量ができたら、再試行します。

Tip: データフォルダーの外にも、コピーをもう1つ置いてください。ディスクの故障やアプリの消去では、自動バックアップも一緒に消えます。

プロファイルのエクスポート

Settings → Advanced → Backup & Exportを開きます。
Export Profileをクリックします。同じタイトルのウィンドウが開きます。
形式を選びます。
ブラウザーがファイルをダウンロードします。

Marinara Nativeは、キャラクター、ペルソナ、チャット、ロアブック、プリセット、エージェント、テーマ、Personal Extensionのコード、メディアを保持します。APIキー、Webhookのリンク、一部のチャット設定は復元されません(キーの再入力を参照)。Marinaraで復元できます。
Compatible JSONは、他のツール向けに、素のキャラクター、ペルソナ、ロアブックのファイルを集めた.zipを作ります。Marinaraでは復元できません。

ネイティブ形式のプロファイルは、marinara-profile.jsonとしてダウンロードされます。大きすぎる場合、MarinaraはZIPファイルを代わりに提案します。Export ZIPをクリックすると、marinara-profile.zipがダウンロードされます。

ネイティブ形式のプロファイルにはPersonal Extensionのコードも残りますが、有効かどうかの状態と承認は残りません。復元された拡張機能はすべて無効の状態で入ります。Settings → Addonsで、もう一度確認してください。

Import Profileでの復元

Import Profileは、プロファイルのファイルまたはDownload Backupの.zipを読み込みます。

Settings → Importsを開きます。
Profile & MarinaraでImport Profile (JSON/ZIP)をクリックします。
marinara-profile.json、marinara-profile.zip、またはバックアップの.zipを選びます。ボタンの表示はScanning Profile...になります。
Import Profileウィンドウを読みます。Marinaraが見つけた内容が一覧表示され、インポートは取り消せないという警告が出ます。
続けるならImportを、やめるならCancelをクリックします。ボタンの表示はImporting Profile...になり、進捗バーが続きます。完了すると、プロファイルをインポートしたというメッセージが表示されます。

うまくいかなかった場合:

localhost、127.0.0.1、[::1]以外でMarinaraを開いている場合、プロファイルのインポートにはHTTPSが必要です。エラーは「Profile import requires HTTPS outside local development.」です。HTTPSのアドレスでMarinaraを開いてください。
.zipの中にメディアのファイルが一部欠けていても、インポートは最後まで進みます。欠けているものを列挙した警告が表示され、Marinaraは残りをインポートします。

同じプロファイルを2回インポートすると、Marinaraは項目をコピーせずに更新します。かなり古いバージョンのプロファイルでは、重複が作られることがあります。

キーの再入力

Import Profileは、Download Backupの.zipからでも、APIキーとWebhookのリンクを復元しません。APIキーとは、サービスが発行する秘密のコードです。プロファイルのファイルと、バックアップの中のプロファイルでは、これらの値が空になっています。そのため、新しいコンピューターにインポートした後は、次の手順で入力し直します。

上部バーからConnectionsを開きます。
使っているアカウントを1つずつ開き、APIキーを入力して保存します。AIプロバイダーへの接続を参照してください。
Webhookのリンクを使うカスタムツールごとに、リンクを入力し直します。

アドレスやキーを含む一部のチャット設定(Discord、DeepL、Intiface)も、空の状態で戻ります。各チャットのChat Settingsで入力し直してください。

インポートで、同じインストールにすでに設定したキーが空になることはありません。

新しいコンピューターへの移行

新しいコンピューターにMarinaraをインストールして起動します。インストールを参照してください。
Settings → Imports → Profile & Marinaraを開き、Import Profile (JSON/ZIP)をクリックします。
Download Backupの.zipまたはプロファイルのファイルを選び、Importをクリックします。
上で説明したとおり、APIキーを入力し直します。

バックアップに入っているキーのファイルが役に立つのは、次のようにデータフォルダー全体を手作業でコピーする場合だけです。

手作業での復元

Import Profileが使えない場合にだけ使ってください。.zipの中には、たとえばmarinara-backup-...のようなフォルダーが1つあり、RESTORE.txtのメモが入っています。

Marinaraを停止します。
バックアップを展開します。
展開したフォルダーから、各フォルダーと.encryption-keyファイルを、データフォルダーへコピーします。Marinaraがデータを保存する場所を参照してください。
Marinaraを起動します。

.encryption-keyファイルはstorageフォルダーと一緒に置いてください。そうしないと、保存済みのAPIキーを読み取れません。

Backup & ExportのExisting backups一覧は、通常は空です。この一覧は使う必要がありません。