ドキュメント · ガイド

中国のミラー：magpie のプラグイン・Bun・アップデートを速くダウンロード

中国からプラグインを入れるとき、npm や GitHub はよく遅く、つながらないこともあります。magpie はそのダウンロードを中国のミラーに先に聞けます。ミラーのファイルは公式と同じもので、同じように確かめます。

プラグインページの中国のミラー

1. プラグイン ページを開く。
2. 中国のミラー をオンにする。そのページのダウンロードは中国のミラーに先に聞き、だめなら公式のアドレスを使います。

• npm（プラグインのパッケージ・バージョン・検索）：registry.npmmirror.com。
• Bun：npmmirror のバイナリミラー。
• プラグイン一覧：jsDelivr（cdn.jsdelivr.net/gh/magpie-community/plugins）。

ミラーにまだないものは公式のアドレスから取ります。npm の週間ダウンロード数は npmjs のものです。bun add も npmmirror に向けます。ただし BUN_CONFIG_REGISTRY か NPM_CONFIG_REGISTRY がすでにレジストリを指定していればそのままです。このスイッチは gh-proxy のようなプロキシには何も送りません。

インストールとアップデートをミラーやプロキシ経由で

インストーラーと magpie update はどちらも --proxy（http・https・socks5・socks5h。MAGPIE_PROXY・HTTPS_PROXY・ALL_PROXY でも可）と、リリースの github.com URL の前に付ける GitHub ダウンロードミラー --mirror（MAGPIE_MIRROR でも可）を受け付けます。

curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --proxy http://127.0.0.1:7890
magpie update --mirror https://mirror.example/
magpie update mirror https://mirror.example/   # every update, the app's too
magpie update mirror off

アプリでは、設定の ダウンロード元 の行で ミラーを使う… から ミラーのアドレス を入れ、ミラーをやめる で戻します。指定しなければミラーは使いません。GitHub には届き usemagpie.ai には届かないネットワークでは設定は不要で、アップデートは GitHub から取り、署名を確かめます。

MAGPIE_MIRRORS：失敗したらミラー

もう 1 つの方法は既定でオフです。MAGPIE_MIRRORS=on にすると、まず公式のソースを試し、ネットワークエラー・HTTP 429・HTTP 5xx・GitHub のレート制限の 403 のときだけミラーを使います。既定のミラーは npm が registry.npmmirror.com、GitHub が gh-proxy.com で、MAGPIE_NPM_REGISTRY と MAGPIE_GITHUB_MIRROR で置き換えられます。

MAGPIE_MIRRORS=on \
MAGPIE_NPM_REGISTRY=https://registry.example.com \
MAGPIE_GITHUB_MIRROR=https://gh.example magpie serve

公式のソースとミラーは 1 つのリクエスト時間を分け合うので、公式が止まっても待ち時間は倍になりません。

ミラーは安全か

• magpie 自身のアップデートは、ミラーではなく usemagpie.ai の SHA-256 で確かめます。合わないファイルはインストールしません。
• Bun の zip は Bun の SHA-256 で、プラグインのパッケージは npm が示した integrity で確かめます。
• 認証情報を含むリクエスト（Authorization・Cookie・API キー・URL 内のトークン）はミラーを使わず、公式のソースにだけ送ります。
• スキルの tarball は常に公式のソースから取ります。
• npm のメタデータ、プラグインの README と検索結果、バージョン確認にはチェックサムがなく、ミラーが違うバージョンを返すことがあります。

よくある質問

magpie でプラグインのインストールが遅いときは？

プラグインページで中国のミラーをオンにします。プラグイン一覧は jsDelivr、npm パッケージと Bun は npmmirror から取り、だめなら公式のアドレスを使います。

magpie のアップデートがダウンロードできないときは？

magpie update --mirror <プレフィックス> を実行するか、magpie update mirror <プレフィックス> で以後のアップデートすべてに使います。--proxy でプロキシ経由にもできます。チェックサムは常に usemagpie.ai のものです。

ミラーに API キーが見えますか？

見えません。Authorization・Cookie・API キー・URL のトークンを含むリクエストはミラーを使わず、公式のソースにだけ送ります。

MAGPIE_MIRRORS と中国のミラーのスイッチの違いは？

スイッチはプラグインページのダウンロードを中国のミラーに先に聞きます。MAGPIE_MIRRORS=on は公式を先に試し、ネットワークエラー・429・5xx・GitHub のレート制限のときだけミラーを使います。

関連ページ：はじめに、よくあるエラーの直し方：401・429・502・504 など。質問は Discord へどうぞ。