Scoop: scoop国内镜像优化库，能够加速scoop安装及bucket源文件，无需用户设置代理。内置加速站有调用次数限制，请勿提取滥用。镜像频率：12小时。

0. 项目实现功能

国内github访问不通畅，且多数开源软件托管在github，导致scoop体验极差。为改善使用体验，将scoop主程序库托管在gitee，增加分流逻辑处理安装与更新所涉及的资源，提示见附图所示。

无任何其他代理

无任何代理时

存在其他代理

存在其他代理

注意事项：

请勿提取并滥用加速链接，如有发现滥用则取消公开；
退出360后再使用（如有解决办法可提issue）；
源代码镜像纯属用爱发电，有用请点star；

1. 安装scoop主程序

1.1 初次安装

（第一次在电脑安装时，执行完本节内容，可跳过1.2节内容。）

打开Windows Powershell界面（开始菜单右键）

# 脚本执行策略更改
Set-ExecutionPolicy RemoteSigned -scope CurrentUser
# 输入Y或A，同意
Y
# 执行安装命令（默认安装在用户目录下，如需更改请执行“自定义安装目录”命令）
iwr -useb scoop.201704.xyz | iex


## 自定义安装目录（注意将目录修改为合适位置)
irm scoop.201704.xyz -outfile 'install.ps1'
.\install.ps1 -ScoopDir 'D:\Scoop' -ScoopGlobalDir 'D:\GlobalScoopApps'

1.2 已安装scoop,更换镜像

（适用于已安装官方源或其他镜像地址的人使用)

# 更换scoop的repo地址
scoop config SCOOP_REPO "https://gitee.com/scoop-installer/scoop"
# 拉取新库地址
scoop update

1.3 切换scoop分支

本库包含如下分支。

分支	含义	基于原版分支
master	代理分流,根据电脑网络环境自动判断	master
develop	代理分流，同上	develop
archieve	原版，无任何修改	master

安装默认选择master分支，想要切换到其他分支，可执行如下命令

# 切换分支到develop
scoop config scoop_branch develop
# 重新拉取git
scoop update

2. 添加bucket

2.1 安装git程序

#必装git，scoop及bucket更新均依赖此软件
scoop install git

2.2 添加已知bucket

#查询已知bucket
scoop bucket known
#添加bucket
scoop bucket add extras

目前已知bucket已镜像至gitee，可访问https://gitee.com/organizations/scoop-installer/projects获取对应bucket库连接，然后按照下节内容添加即可，

2.3 添加第三方bucket

# 基本语法
scoop bucket add <别名> <git地址>

# 举例添加scoopcn（[Mostly Chinese applications / 大多是国内应用程序](https://github.com/scoopcn/scoopcn)）
scoop bucket add scoopcn https://gitee.com/scoop-installer/scoopcn

其他较为优秀的bucket，可点击scoop-installer，有选择性地添加

删除bucket

scoop bucket rm <别名>

3. 安装软件

3.1 代理(可选)

# 添加代理 根据实际需要，填写http代理信息
scoop config proxy 127.0.0.1:4412

# 删除代理
scoop config rm proxy

3.2 软件安装

# 基本语法
scoop install <库名/软件名>

# 例如安装 qq 微信(wechat) 
scoop install qq
# 指定bucket库的软件（如需要）
scoop install scoopcn/wechat

# 一条命令安装多个软件
scoop install qq wechat aria2

3.3 软件卸载

scoop uninstall qq wechat

3.4 软件更新

scoop update *

3.5 其他命令

# 软件暂停更新
scoop hold <软件名>
# 切换到指定版本
scoop reset <软件名@版本号>
# 重置所有软件链接及图标
scoop reset *

# 删除缓存软件包
scoop cache rm *

# 删除软件老版本
scoop cleanup rm *

4. 常见问题

问题1：Scoop is running the installer as administrator is disabled.

原因：scoop禁止在管理员权限下安装

解决办法：开始菜单右键，选择Windows PowerShell，然后重新执行安装命令

问题2：无法正确下载软件资源，导致软件安装失败

原因：存在多重套娃代理，例如（https://<代理A>/https://<代理B>/<资源链接>），尤其是国内镜像bucket或者针对中国优化的bucket库，其中json资源多数已硬编码了代理链接。以scoop-proxy-cn为例，git资源的下载链接为：https://mirror.ghproxy.com/https://github.com/git-for-windows/git/releases/download/v2.45.0.windows.1/PortableGit-2.45.0-64-bit.7z.exe#/dl.7z，其已经存在了代理B，由于此类链接的IP多为外网IP，默认走程序代理，也即出现上面的代理套娃，跨域失败，资源拉取失败，软件安装失败。

解决办法（3种方法可选）：

执行scoop update将程序更新至最新版本，然后再执行下载（推荐）；
放弃优化软件库，使用本页面推荐的几个bucket；
切换至archieve分支，放弃本镜像的代理优化。

问题3：远程主机强迫关闭了一个现有的连接

原因：重复多次请求同一个资源，后端关闭了此链接。

解决办法：关闭aria2

问题4：fatal: protocol ''https' is not supported

原因：软件未正确识别内容，详细内容见官方问答区。

解决办法: 将命令中的链接使用双引号包裹起来（命令中存在链接，都可以解决），重新执行一遍命令。

C:\Users\用户名>scoop config SCOOP_REPO 'https://gitee.com/glsnames/scoop-installer'
'SCOOP_REPO' has been set to ''https://gitee.com/glsnames/scoop-installer''

C:\Users\用户名>scoop update *
Updating Scoop...
fatal: protocol ''https' is not supported
Update failed.

C:\Users\用户名>scoop config SCOOP_REPO "https://gitee.com/glsnames/scoop-installer"
'SCOOP_REPO' has been set to 'https://gitee.com/glsnames/scoop-installer'

C:\Users\用户名>scoop update *
Latest versions for all apps are installed! For more information try 'scoop status'

若依旧不能更新，请用记事本打开config文件(scoop安装目录\apps\scoop\current\.git\config)，手动去掉其中url行中的引号，修改保存后再重新执行更新命令。显示为如下内容为正常。

***省略
[remote "origin"]
	url = https://gitee.com/glsnames/scoop-installer
	fetch = +refs/heads/*:refs/remotes/origin/*
***省略

5. 常用命令

Usage: scoop <command> [<args>]  
  
Some useful commands are:  
  
alias       Manage scoop aliases # 管理指令的替身  
bucket      Manage Scoop buckets # 管理软件仓库  
cache       Show or clear the download cache # 查看与管理缓存  
checkup     Check for potential problems # 做个体检  
cleanup     Cleanup apps by removing old versions # 清理缓存与旧版本软件包  
config      Get or set configuration values # 配置Scoop  
create      Create a custom app manifest # 创建自定义软件包  
depends     List dependencies for an app # 查看依赖  
export      Exports (an importable) list of installed apps # 导出软件包列表  
help        Show help for a command # 显示帮助指令  
hold        Hold an app to disable updates # 禁止软件包更新  
home        Opens the app homepage # 打开软件包主页  
info        Display information about an app # 显示软件包信息  
install     Install apps # 安装软件包的指令  
list        List installed apps # 列出所有已安装软件包  
prefix      Returns the path to the specified app # 查看软件包路径  
reset       Reset an app to resolve conflicts # 恢复软件包版本  
search      Search available apps # 搜索软件包  
status      Show status and check for new app versions # 查看软件包更新状态  
unhold      Unhold an app to enable updates # 启动软件包更新  
uninstall   Uninstall an app # 卸载软件包的指令  
update      Update apps, or Scoop itself # 更新软件包  
virustotal  Look for app hash on virustotal.com # 查看哈希值  
which       Locate a shim/executable (similar to 'which' on Linux) # 查看可执行程序路径

scoop-installer / Scoop

0. 项目实现功能

1. 安装scoop主程序

1.1 初次安装

1.2 已安装scoop,更换镜像

1.3 切换scoop分支

2. 添加bucket

3. 安装软件

3.1 代理(可选)

3.2 软件安装

3.3 软件卸载

3.4 软件更新

3.5 其他命令

4. 常见问题

问题1：Scoop is running the installer as administrator is disabled.

问题2：无法正确下载软件资源，导致软件安装失败

问题3：远程主机强迫关闭了一个现有的连接

问题4：fatal: protocol ''https' is not supported

5. 常用命令

简介

发行版 (4)

贡献者

近期动态

scoop-installer / Scoop .gitee-modal { width: 500px !important; }

0. 项目实现功能

1. 安装scoop主程序

1.1 初次安装

1.2 已安装scoop,更换镜像

1.3 切换scoop分支

2. 添加bucket

3. 安装软件

3.1 代理(可选)

3.2 软件安装

3.3 软件卸载

3.4 软件更新

3.5 其他命令

4. 常见问题

问题1：Scoop is running the installer as administrator is disabled.

问题2：无法正确下载软件资源，导致软件安装失败

问题3：远程主机强迫关闭了一个现有的连接

问题4：fatal: protocol ''https' is not supported

5. 常用命令

简介

发行版 (4)

贡献者

近期动态

搜索帮助

scoop-installer / Scoop