別のマシンとスマートフォン
同期
Hyla の設定——テーマ、フォント、キー、エージェント、Feishu、Tailcat——はひとつのファイルです。同期 はそれを、どのマシンからも届くサーバー経由で同じに保ちます: WebDAV フォルダ、S3 互換のバケット、または GitHub のリポジトリです。
スナップショットは書き込んだマシンで暗号化されます。サーバーにあるのは暗号文だけです: 設定は読めませんし、パスフレーズなしにファイルを手に入れても読めません。
同期するもの
設定ファイルそのものだけです。hyla config path が示すファイルで、既定値と違うところだけを持ちます。同期したマシンは、他のマシンの設定をそのまま使います。
同期しない のは、そのマシン自身のものです: セッションとそのターミナル、プロジェクト、サイドバーの SSH と K8s のホスト、ウィンドウの大きさ、最後に選んでいたセッション。
置き場所
| サーバー | 入力するもの |
|---|---|
| WebDAV — 堅果雲、Nextcloud、ownCloud | アドレス(https://dav.jianguoyun.com/dav/ など)、ユーザー名、アプリパスワード |
| S3 互換 — MinIO、R2、B2、OSS、COS | エンドポイント、バケット、プレフィックス、リージョン、アクセスキー、シークレットキー |
| GitHub | owner/name、パス(hyla/config.enc など)、ブランチ、トークン——リポジトリは 非公開 に。スナップショットには鍵が入りますが、暗号文としてだけです |
WebDAV のアドレスの下に hyla/ フォルダを作ります。バケットとリポジトリでは hyla/config.enc を使うので、同じサーバーに他のものも置けます。
パスフレーズ
どのマシンでも同じパスフレーズを入力し、それがスナップショットを封じ、開きます。Argon2id で鍵を導き、AES-256-GCM で暗号化します: パスフレーズが違う、あるいはサーバー上でファイルが変わっていれば、何も開けません。
忘れないでください。 取り戻す方法はありません: パスフレーズなしでは、どのマシンでも、Hyla でも、誰も開けません。
パスフレーズとサーバーの資格情報は各マシンに留まります。設定の隣の sync.json(自分だけが読める)に置かれ、同期される内容には入りません。スナップショットが自分自身の鍵を運ぶことはありません。
いつ同期するか
- 起動時: 取得します。しばらく開いていなかったマシンも、他のマシンの設定で始まります。
- 変更後: 設定を変えると 30 秒後に送ります。続けて変えた分は一度にまとまります。自動で同期 を切れば、指示したときだけ同期します。
- 指示したとき: 設定 › 同期 › 今すぐ同期、または
hyla sync。
設定ファイルのないマシンは、空のものを送らずサーバーのものを取ります。
両側が変わったとき
同じ設定を同時に変えることはよくありませんが、起こります。そのとき このマシンの設定が残ります: サーバーのものは config.remote-<マシン名>-<時刻> として隣に保存され、送信がサーバー側を置き換えます。書いたものが写しなしに消えることはなく、Hyla はもう一方をどこに置いたか告げます。
コマンドライン
hyla sync # 今すぐ同期(起動時と同じ)
hyla sync status # どこへ、どこまで進んだか
hyla sync push # サーバーの中身に関わらずこのマシンのを送る
hyla sync pull # このマシンの中身に関わらずサーバーのを取る
hyla sync set backend webdav # webdav.url、webdav.user、webdav.password も
hyla sync set passphrase "…" # どのマシンでも同じもの
hyla sync set auto on
hyla sync set が取るのは backend(webdav、s3、github、off)、passphrase、auto、webdav.url|user|password、s3.endpoint|bucket|prefix|region|accessKey|secretKey、github.repo|path|branch|token です。