2026-08-31 · 学习笔记 01

Scoop 安装与代理配置

1. Scoop 是什么

Windows 命令行包管理器，一条命令安装/更新/卸载软件，装到用户目录，不需要管理员权限。

特点：

• 软件装在自己的目录 scoop\apps\<软件>\，清理时整个目录删掉，没有注册表残留
• 每个软件配一个 shim（快捷命令），自动加入 PATH
• 更新软件 = 装新版 + 切链接，旧版本目录保留可以回退

2. 安装

先决条件：Windows 10/11，PowerShell 5.1+。打开 PowerShell（非管理员即可）：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

安装脚本要访问 GitHub，如果系统代理还没开，给安装脚本显式指定代理（-Proxy 参数写法见第 4 节）。

装完自动装好 git（scoop 的仓库更新依赖它）。

3. 验证

新开一个终端：

scoop --version
# 输出类似：Current Scoop version: ... 0.5.3

4. 大陆用户：代理

scoop 的源和下载都在 GitHub，需要代理。分两层：

日常够用：系统代理零配置。 代理客户端（Clash Verge）把首页的「系统代理」开关打开，scoop 的 .NET 下载器和 git 拉 bucket 会自动走它；国内站点由客户端分流规则（geosite:cn）直连。验证：scoop status 输出 Everything is ok!。

大包和全量升级：要显式配代理 + 多连接。 节点对单条连接限速（实测同一个 285 MB 文件：单流 67–262 KB/s，16 流合计 6 MB/s，1 分半下完），只靠系统代理会慢十几倍。

分片只对「支持 Range 且不限并发」的宿主有效：Google 存储（claude-code 那个 285 MB 的 exe）能吃满 16 连接；GitHub release 资产（release-assets.githubusercontent.com）实测仍退化成单流 ~100–150 KB/s，配置了也快不了。

scoop config proxy 127.0.0.1:7897      # Clash Verge 的混合端口，改过就换成你自己的
scoop config aria2-enabled true
scoop config aria2-split 16
scoop config aria2-max-connection-per-server 16
scoop config aria2-min-split-size 1M

代价是端口写死，换客户端或换端口要改；撤掉用：

scoop config rm proxy
scoop config aria2-enabled false

bucket 拉取（git 层）偶尔报 schannel: failed to receive handshake，是节点对同域并发握手掐连接，与 scoop 无关：git config --global http.proxy ""（必须空字符串，--unset 压不住环境变量）改成直连重跑，装完再设回。

唯一必须显式指定代理的另一场景是装 scoop 本体时系统代理还没开（安装脚本要下载 GitHub 上的文件），用官方脚本自带的 -Proxy 参数（前一个管下载安装脚本，后一个管脚本内部下载，端口用 Clash 的混合端口 7897）：

irm get.scoop.sh -Proxy 'http://127.0.0.1:7897' | iex -Proxy 'http://127.0.0.1:7897'

5. 代理假死：一类连带故障的根源

代理"假死"（进程和端口还在，但节点不通或转发挂死）时，所有经它转发的操作会一起卡住超时，表现为一连串莫名其妙的报错：scoop status 拉取失败、git 克隆/推送 timeout、schannel: failed to receive handshake。排查时先确认代理真的活着，再看软件本身：

curl -o /dev/null -w "%{http_code} %{time_total}s\n" https://github.com

几秒内返回 200/304 说明代理链路正常；卡住不返回就是代理问题，重启代理客户端或换节点即可，不用折腾 scoop/git。

6. 目录结构

装完在用户目录下生成 scoop\：

目录	作用
apps\<软件>\	软件本体，每个版本一个目录，current 是指向当前版本的链接
persist\<软件>\	持久化数据（配置、数据库等）。更新/重装不丢，删软件也保留，确定不要再手动删
buckets\	软件仓库（manifest 源），每个 bucket 一个 git 仓库
shims\	全局命令入口，已自动加入 PATH
cache\	下载缓存

7. 配置速记

项目	值
主仓库	ScoopInstaller/Scoop 官方源
默认 bucket	main（基础软件）
代理	日常系统代理零配置；大包提速用 scoop config proxy + aria2 16 连接（见第 4 节）
卸载检查	scoop uninstall <软件>

scoop 本体更新用 scoop update。