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.

PowerShell244351528

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

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 games https://gitee.com/scoop-installer/scoop-games
scoop bucket add nirsoft https://mirror.nju.edu.cn/git/scoop-nirsoft.git/
scoop bucket add sysinternals https://gitee.com/scoop-installer/scoop-sysinternals

Add Chinese software buckets

Dorado (recommended, clean):

chawyehsu/dorado

🐟 Yet Another bucket for lovely Scoop

PowerShell1220109

powershell

scoop bucket add dorado https://gitee.com/scoop-bucket/dorado.git

ScoopCN (alternative):

powershell

scoop bucket add scoopcn https://gitee.com/scoop-installer/scoopcn.git

Refresh and verify

powershell

scoop update
scoop bucket list

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

Dynamic URL replacement

Use tools for URL replacement during install/update:

powershell

scoop bucket add abyss https://gitee.com/abgox/abyss
scoop install abyss/abgox.scoop-install
scoop install abyss/abgox.scoop-update

Configure replacement rules (using a GitHub mirror proxy):

powershell

scoop config abgox-scoop-install-url-replace-from "^https://github.com|^https://raw.githubusercontent.com"
scoop config abgox-scoop-install-url-replace-to "https://gh-proxy.com/github.com|https://gh-proxy.com/raw.githubusercontent.com"

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 *`