ユーザー検索意図へ先に応える結論観察
「Clash 設定ファイル バックアップ」と検索するときには、たいてい単なるファイル複製だけではなく、編集ログと突き合わせて問題点を説明できる材料がほしいときです。また「YAML 構成のロールバック」について調べている読者は、一度のマージミスやルールの順序変更でサイト全体が読めなくなったときに、タイムスタンプだけが変わって内容が読めなくなる恐怖を体感しています。この不安を鎮めるために、構成をテキスト資産として扱い、その履歴を Git に載せやすくするだけで体感の安心感は桁違いになります。Mihomo や広く呼ばれる Clash Meta でも、ユーザーが細かく追いかけるレイヤーの多くが結局 YAML と外部ルールセットに集約されますから、運用側の共通言語になります。分流ルール入門記事で並べ順の考え方を押さえたあと、この稿では「構成を変更してもひとつのコマンドから元に帰れる」状態をゴールとしておきます。
検索クエリにある「換機復元」「端末ごとの環境統一」を言い換えると、クライアントがどれであっても、自分が信頼するルール骨格/policy-group/DNS 側のひな形をポート番号だけ合わせ直せば機能する状態を目指しているはずです。GUI の保存先はアプリにより変わっても、この稿のワークフローは OS のパスの差異を吸収できるよう抽象化できます。
何を資産としてリポジトリに載せるか切り分ける
リポジトリに丸ごと放り込むと逆に復元できなくなる代表的なものは、オンライン上に晒したくない 購読トークン と、構成が多少狂っても再生成できる巨大なキャッシュ類です。Mihomo 系において、`rule-providers` によるリモート取得は便利ですが、アウトボックスの状態がどこまでローカルの `.yaml` と同期しているか読めないときもあります。そこで方針を二段にすると整理しやすいです:A クライアントが直接読む「メイン YAML」およびそこへ include させる細分化ファイル群、B ルールをローカルに固定したい場合のテキストセット。
- 載せやすい:`rules`、`proxy-groups`、`dns` 関連のカスタム部、独自のヒントとなるコメントだけを残した整理済み構成、自分で curl しないと再現できないローカルの追記セット。
- 慎重に載せたいもの:`subscription-userinfo` がURLに載るような購読行、開発者環境のみのポート番号、アプリ側で自動調整されるキーだけが並んだ巨大ファイルなど。
- 載せなくてよいもの:`cache.db` に相当するワークスペース状態、自動生成されるアーティファクト、TLS 証明書ストア(アプリ側の運用規約にも依存)。
Rule Providers の詳細稿で触れたとおり、`behavior` と更新間隔の設計によってはオンライン障害の影響を受ける領域と、自分でロックしたい領域を分離できます。その判断をコードレビューのようにログへ残せることが Git の強みになります。
base.yaml.example のような公開しても問題ない名前で骨格だけを載せ、環境側の別ファイルには購読行と追加シークレットだけを載せ、その本体をinclude で取り込むのが読みやすいです。mixin や自動マージに寄せる構成も増えましたが、この稿ではまず単純な include に寄せれば十分です。ディレクトリ設計から .gitignore と初回コミットまで
ワークスペースの実体より「どこをソースとして見るか」の境界線を明示してください。ユーザーが自分で選べる自由度が高まった GUI 環境でも、構成タブへ貼っているテキストの原本はどこかに残しています。その原本をクローン側がいつでもフェッチできる位置にそろえると、復元チェックリストが単純化します。YAML 構成のバックアップとは、複数レイヤがある場合は複数レイヤすべてを視野にいれることになります。
-
ルート構成をフラットより意味単位へ:`rules/` と `profiles/` と `providers-local/` を分けるなど、自分が grep するときにも探しやすい粒度にしましょう。将来の自動生成スクリプトを挟むときもここでの整理が効きます。
-
.gitignoreにキャッシュ類を並べる:アプリ側で生成される/cacheやワークスペース固有のロックファイル、アーカイバが混ぜるだけのバックアップを明示的に外します。この段階で「リポジトリに入れたくない名前」をコメント込みで列挙しておけば後任の自分にも優しいです。 -
秘匿ヘッダ付きファイルを環境側へ:`subscriptions.local.yml` に購読列だけを載せ、アプリ側の参照パスだけを環境ごとに合わせる。複数PCで共通にしたい本体は単一リポジトリを pull していつでも揃えます。
-
初回
git commit:「GUIからコピペした状態と一致する」だけでなく、アプリ側の構文チェックで警告されない状態をログに書き記します。この時点でのスクリーンショットやバージョン番号までメッセージに残す癖を付けると、あとからの自分が助かります。
開発者向けワークフロー:ブランチ、コメント、タグ付けロールバック
ルール並べ替えや policy をいじったあとだけを即座に検証するときには、短命ブランチに逃がすだけで体感が楽です。機能追加とバグフィックスではない変更でも、自分の頭のメモリーと Git のログを二分しておけるため、復元単位として意味があるからです。また git tag milestone-YYYYMMDD のようにイベント駆動のタグへ残す癖を付けると、「リリース前の安定構成」と「検証中」を切り分けやすいです。
- 粒度の細かさ:一行ずつ細かく切るより、policy とルールセットという意味単位でまとめると diff が読めるままになります。YAML 構成のバージョン管理は diff が読めるかどうかが復元可否に直結します。
- 自動整形:フォーマッタを通すときは、その導入を別コミットに分離します。機能変更コミットに混ぜると巻き戻し粒度が細かくなりすぎて逆に復元できません。
- チェックリスト付き MR:チーム運用でも個人運用でも、Pull Request 相当の自分宛メモだけでも「ポート番号をいじったか」「証明書を差し込んだか」を書くと復元ログとして効きます。
ローカル環境のみで問題ないならreset --hard が速く、複数ホストへ push 済みならgit revert のほうが他者にも追跡できます。共通リポジトリで「履歴書き換え」を避けるのは協業だけでなく、将来の自分に対しても親切になります。構成ロールバックの意思決定をコミットメッセージへ残してください。
git-secrets や pre-commit でURLっぽい文字列を弾く、あるいは `git submodule` と秘密用の別リポジトリを分離する運用まで踏み込めば事故率が下がります。復元パターンのマトリックス(チェックアウト/revert/cherry-pick)
症状別に復元経路が変わります。ルール並べ順だけ間違ったなら単一ファイルの差し替えで足りますが、DNS と TUN と routing の三者が連関している変更ならセットで戻す必要があります。その判断を頭のなかだけに置かず、この表へ落としておくと落ち着いて操作できます。
- `git checkout HEAD~1 -- path/to/file.yml`:特定ファイルのみ過去状態へ寄せられるので、広い構成に波及しないミスへの対応として速いです。
git revert(対象ハッシュ):過去へ巻き戻すというより「逆向きの変更」をスタックすることで履歴線形を維持します。Mihomo 設定を何人かで分担しているときに向きます。- `git stash` と GUI 自動保存ログの両立:GUI が暗黙に残すバックアップと Git が追う状態は別レイヤになるので、アプリ側の「直前状態」復元機能と競合しないかだけは一度頭のチェックリストに入れてください。
- タグを指してのワークツリー復元:タグ済み構成へ一時チェックアウトし、問題が再現しないかだけ見てから現在ブランチへ戻ります。並行構成を並べられるマシンなら、この操作が心理的負担が最も軽くなりがちです。
復元だけで済まず、復元後のリロード手順までひとつのシナリオにまとめると運用フェーズでの再現テストになります。mihomo -t のようなチェックコマンドを使える環境なら自動化にも繋げられます。コア側のアップグレード稿とセットで読むと、機能フラグだけが変わったときの差異もログとして追えるようになります。
換機復元および複数ホストでの骨格複製ワークフロー
新しいノートへ移すとき問題になるのは、ネットワークドライバの差や管理者権限制約、ポートの取り合いだけではありません。Git で揃えた構成YAMLは文字どおり複製されますが、アプリ側のインストーラが初期化するときに作るパスだけは手で合わせ直すケースがあります。手順としては単純で、クローン済み構成をフェッチできる場所を用意し、アプリ側の「外部ファイルを読む」設定へ差し込みます。そのうえで起動ログを読み込み、アプリ側のエラーだけを潰していく順番が復元チェックリストです。
-
秘密ファイルだけ抜けるとフェッチだけ失敗しやすい:
subscriptions.local.ymlなど環境側の鍵を置く前にアプリ側が購読を取りに行くと、ログには「無効な URL」の類だけが出ることがあります。復元順序としてはまず環境側に鍵ファイルを復元し、その後にオンラインへフェッチすれば確認しやすいです。 -
TUN と Win/macOS/Linux の許可モデルだけ差し替え:TUN が使えなくても構成が読めるならポートモードだけで済ませ、ローカルの権限昇格済み状態になってからまた TUN に戻す二段構成にすると復元ログが単純化します。
-
複数ホスト共通リポジトリ:`git pull --rebase` を習慣化し、競合するときだけマージログを自分宛に書く。競合しないようルールセットを機能単位ファイルへ分割していたほうが結果的に速いことが多く、Git のメリットと相性が良いです。
この段階で「端末ごとに異なる出口ノード」を使いたければ環境側のグループだけ切り替え、それ以外は同一構成を読み込む二層モデルになります。多端末での同期に Git を使ってよいものかという問いに対しては、秘密を分離しさえすればソースの整合性だけを共有することに向いています。対してストリーミング用の状態やセッションはアプリ側のキャッシュであり、強制的に複製しない方がむしろ安全なケースがあります。
オンライン同期・ストレージ併走と情報へのアクセス統制
Git のみでの同期が難しく、クラウド同期や社内 NFS を併せるときはロックファイル競合だけ注意してください。またリポジトリをプライベートにしておかないと、ルールセットに含まれうる会社内部ドメイン名まで外部へ漏れるリスクがあります。公開 OSS 設定を自分用に複製するときにも、環境情報を削除してから公開するワークフローが必要です。この稿で触れた 構成バックアップの範疇には、インフォメーション開示まで含まれます。mihomo-compatible なコマンド群を自動化するときにも、チェックリストの観点は同じです。
よくある質問と安全側の選び取り
購読URL をリポジトリから完全に離したまま復元できますか。
はい。mixin.user.yaml のような名前をアプリ側に読み込ませれば、共通リポジトリからは離れた場所にある購読行だけ別管理できます。自動生成スクリプトで KMS などから貼り付ける方法も増えましたが、この稿の前提は単純に「環境側ファイルで吸収できる」状態を保つだけで足ります。もし複数環境があるなら、ひとつのテンプレに対応する環境ファイルを増やすだけに留めれば、復元順序ミスにも強くなります。
git revert とブランチ巻き戻しではどちらが安全ですか。
共有リモート運用があるなら revert を選びやすく、自分専用の実験ブランチだけなら reset も現実的です。履歴線形への固執より「他人が追えるか」を優先しましょう。GUI 自動生成と手書きとの混線が起きやすい Clash YAML 運用でも、Revert は diff が読めるという利点があります。
オンラインの Rule Providers が落ちた場合 Git は役に立ちますか。
リモート障害それ自体とは別次元ですが、ローカルの追記構成が問題なら単純に過去ファイルへ退避できます。またリポジトリにローカルコピーを直書きし同期するモデルまで伸ばせば、CDN 側の問題を迂回する設計にもつなげられます。詳しくは前述の Providers 記事での offline モデルとも接続されます。
オンラインストレージのみで済ませたいときの壁はどこですか。
最新ファイルは常に複製されていても、「なぜ昨日は動いたのか」を説明する材料になりにくく、並行チェックにも向きません。Git は履歴ログとセットで評価するのが本質であり、オンライン同期は結果バックアップとして併せ持つと安心です。この二種類が噛み合うと復元チェックリストの半分くらいは自動になります。
まとめ:監査可能な構成管理が強いとき
従来型の一体型プロキシクライアントでは、レイテンシや特定サイトのタイムアウトにつながった変更要素が画面上から追いにくく、アプリ側の自動修復に頼ると原因説明まで行きつかず固まってしまうこともあります。対して Mihomo と呼ばれる体験を含む Clash 系は、構成がテキスト化されログと突き合わせやすいため、そのテキストを Git でバージョン管理するだけでも切り分けと構成ロールバックが現実味を帯びます。GUI が残す自動バックアップだけでは変更理由が本文に載らず、自分宛の開発フローのようにコミットで痕跡を残せないときもありますが、レイヤ単位のアウトバウンド制御があるほどここでの透明性が利きます。この稿で述べた Clash 設定ファイル バックアップの視点——履歴ログとセットで評価する作法——は、その強みに素直に乗れるものになります。
まずはビルドの入手元だけ当サイト側でひとつに寄せ、`git clone` とこの記事の手順だけで自分用のワークスペースへ落としてから微調整するのが運用開始として素直です。入手後にも履歴ログを残す運用があると復元チェックリストの負荷がぐっと下がります。
プラットフォームと用途に応じて最新クライアントを確認したい場合は、このクライアント一覧へ移動して入手できます。