docs(cache): cargo 客户端配方改成「源替换」

`[registries.crates-io] index = …` 会被 cargo **静默忽略**(继续用真正的
crates.io ⇒ 看着「装成功了」,其实没过网关)⇒ 必须用源替换
([source.crates-io] replace-with + 同名的 [registries.ipass])。

另需 `[registry] global-credential-providers = ["cargo:token"]`,
否则 cargo 对需要鉴权的 registry 直接报
「authenticated registries require a credential-provider to be configured」。

Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
adminandClaude Code committed 2026-10-31 12:13:03 +08:00
1 parent fefd57ac7f
commit 417c8c9be2
1 file changed
+7 -2
+7 -2
View File
@@ -188,8 +188,13 @@ pub const CLIENT_HINTS: &[(&str, &str, &str)] = &[
("go", "Go module proxy", "export GOPROXY={base}/go"),
(
"cargo",
"crates.io 稀疏索引(包本体需另配 /cargo-dl/,见文档)",
"mkdir -p ~/.cargo && printf '[registries.crates-io]\\nindex = \"sparse+{base}/cargo/\"\\n' >> ~/.cargo/config.toml",
"crates.io 稀疏索引(config.json 的 dl 已改写回本网关 ⇒ 包体也走网关)",
// ⚠️ 必须是**源替换**:`[registries.crates-io] index = …` 会被 cargo
// **静默忽略**(继续用真正的 crates.io ⇒ 看着成功,其实没过网关)。
// 另需 `[registry] global-credential-providers`(否则 cargo 报
// "authenticated registries require a credential-provider"),
// token 放 credentials.toml。
"mkdir -p ~/.cargo && printf '[source.crates-io]\\nreplace-with = \"ipass\"\\n[source.ipass]\\nregistry = \"sparse+{base}/cargo/\"\\n[registries.ipass]\\nindex = \"sparse+{base}/cargo/\"\\n[registry]\\nglobal-credential-providers = [\"cargo:token\"]\\n' >> ~/.cargo/config.toml && printf '[registries.ipass]\\ntoken = \"sk_…\"\\n' >> ~/.cargo/credentials.toml",
),
(
"pypi",