Scoop Installation and Configuration Guide

Scoop is my personal favorite Windows package manager. However, its default configuration depends on GitHub, which leads to slow downloads and errors in China. This guide covers installation, mirror switching, and acceleration.

ScoopInstaller/Scoop

A command-line installer for Windows.

PowerShell245301532

Prerequisites

PowerShell blocks local scripts by default. You need to unlock it:

powershell

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

For PowerShell installation and beautification, see Beautifying Windows Terminal. It is recommended to install via Scoop:

powershell

scoop install powershell

Install Scoop

Use NJU mirror for a fast installation:

powershell

irm https://mirror.ghproxy.com/https://raw.githubusercontent.com/duzyn/scoop-cn/master/install.ps1 | iex

If SSL errors occur, bypass certificate validation:

powershell

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
add-type -TypeDefinition @"
using System.Net;
using System.Security.Cryptography.X509Certificates;
public class TrustAllCertsPolicy : ICertificatePolicy {
public bool CheckValidationResult(
ServicePoint srvPoint, X509Certificate certificate,
WebRequest request, int certificateProblem) {
return true;
}
}
"@
System.Net.ServicePointManager::CertificatePolicy = New-Object TrustAllCertsPolicy
irm https://ghproxy.cc/https://raw.githubusercontent.com/duzyn/scoop-cn/master/install.ps1 | iex

Verify:

powershell

scoop --version

Switch Mirrors: Chinese Mirrors + Practical Buckets

Remove default buckets

powershell

scoop bucket rm main
scoop bucket rm extras
scoop bucket rm versions

Add NJU mirrors

main / extras / versions / nirsoft use the NJU mirror, which is stable and fast for git pulls:

powershell

scoop bucket add main https://mirror.nju.edu.cn/git/scoop-main.git
scoop bucket add extras https://mirror.nju.edu.cn/git/scoop-extras.git
scoop bucket add versions https://mirror.nju.edu.cn/git/scoop-versions.git
scoop bucket add nirsoft https://mirror.nju.edu.cn/git/scoop-nirsoft.git/

Add official GitHub buckets (proxied)

Use official GitHub repos with a proxy prefix for games / sysinternals:

powershell

scoop bucket add games https://gh-proxy.com/https://github.com/Calinou/scoop-games
scoop bucket add sysinternals https://gh-proxy.com/https://github.com/niheaven/scoop-sysinternals

Add Chinese software buckets

Dorado (recommended, clean):

chawyehsu/dorado

🐟 Yet Another bucket for lovely Scoop

PowerShell1223111

powershell

scoop bucket add dorado https://gh-proxy.com/https://github.com/chawyehsu/dorado.git

ScoopCN (alternative):

powershell

scoop bucket add scoopcn https://gh-proxy.com/https://github.com/scoopcn/scoopcn.git

For existing GitHub buckets, switch the git remote instead of re-cloning (the script menu below can also batch-process them):

powershell

git -C "$env:SCOOP\buckets\games" remote set-url origin "https://gh-proxy.com/https://github.com/Calinou/scoop-games"

Speed Optimization

Enable Aria2

powershell

scoop uninstall aria2 --purge
scoop cache rm aria2
scoop install https://mir.nju.edu.cn/git/scoop-extras/raw/master/bucket/aria2.json
scoop config aria2-enabled true
scoop config aria2-retry-wait 2
scoop config aria2-split 5
scoop config aria2-max-connection-per-server 5
scoop config aria2-min-split-size 4M

Proxy GitHub downloads

Run directly in PowerShell and follow the menu:

powershell

irm https://raw.githubusercontent.com/Dr1mH4X/Scripts/refs/heads/main/pwsh/scoop-proxy.ps1 | iex

Since scoop update overwrites download.ps1 and breaks the patch, save the script locally and run one command to update Scoop and re-enable acceleration (it auto-reads your configured GITHUB_PROXY):

powershell

.\scoop-proxy.ps1 -Update

To switch to a different acceleration link, add the -Proxy parameter:

powershell

.\scoop-proxy.ps1 -Update -Proxy ghfast.top

In interactive mode, running the script and picking option 6 does the same thing.

Refresh and verify

powershell

scoop update
scoop bucket list

Restore SSL validation

powershell

System.Net.ServicePointManager::CertificatePolicy = $null

Install scoop-search (Faster Search)

scoop search queries the GitHub API and typically takes 20+ seconds. scoop-search is a local drop-in replacement that indexes manifests for near-instant results — roughly 350x faster.

powershell

scoop install scoop-search

Install UniGetUI (GUI)

UniGetUI is a graphical frontend for CLI package managers including Scoop, Winget, and Chocolatey. Browse, install, update, and uninstall software in one window — no commands needed.

powershell

scoop install unigetui

Launch UniGetUI from the Start Menu. It auto-detects your configured Scoop buckets and displays all Scoop-installed software in its interface.

Daily Commands

Action	Command
Search	`scoop-search <name>`
Install	`scoop install <name>`
Uninstall	`scoop uninstall <name>`
Update single app	`scoop update <name>`
Update all	`scoop update *`
List installed	`scoop list`
Cleanup old versions	`scoop cleanup *`
Clear cache	`scoop cache rm *`