2026-07-21 Watt Toolkit 安装与配置指南

环境: Deepin 25.2.0 (crimson) / 内核 6.18.36-amd64-desktop-rolling / x86_64
版本: Watt Toolkit v3.1.0（Steam++）
说明: 个人经验分享，仅基于本机安装与排错过程整理，不保证适用于其他环境

---

一、下载安装

前置准备：Watt Toolkit 需要向系统写入 hosts 和证书，请先关闭 Deepin 的磐石只读保护：控制中心 → 系统 → 开发者选项 → 磐石只读保护 → 关闭。

本文以 ~/WattToolkit 为安装目录。如需换到其他位置（如 ~/myapps/WattToolkit），将下面所有 ~/WattToolkit 替换过去即可。

官方提供一键脚本 curl -sSL https://steampp.net/Install/Linux.sh | bash，但该脚本在 Linux 下存在已知问题（Issue #4110、#4111），故改用从 Gitee 镜像手动下载。

# 创建安装目录
mkdir -p ~/WattToolkit
# 下载安装包（Gitee 国内镜像，约 82MB）
wget -O ~/WattToolkit/WattToolkit.tgz \
  "https://gitee.com/rmbgame/SteamTools/releases/download/3.1.0/Steam%20%20_v3.1.0_linux_x64.tgz"
# 解压
tar -xzf ~/WattToolkit/WattToolkit.tgz -C ~/WattToolkit
# 设置权限并创建符号链接
chmod +x ~/WattToolkit/dotnet/dotnet ~/WattToolkit/Steam++.sh
ln -sf ~/WattToolkit/dotnet/dotnet ~/WattToolkit/Steam++
# 验证 .NET 运行时（应输出 10.0.4）
~/WattToolkit/dotnet/dotnet --info

二、添加到启动器

Watt Toolkit 不会自动注册启动器快捷方式，需要手动创建：

# 创建启动器快捷方式
cat > ~/.local/share/applications/Watt\ Toolkit.desktop << 'EOF'
[Desktop Entry]
Name=Watt Toolkit
Exec=/home/Light/WattToolkit/Steam++.sh
Icon=/home/Light/WattToolkit/Icons/Watt-Toolkit.png
Terminal=false
Type=Application
StartupNotify=false
EOF
# 添加可执行权限
chmod +x ~/.local/share/applications/Watt\ Toolkit.desktop

然后将该文件复制到桌面：cp ~/.local/share/applications/Watt\ Toolkit.desktop ~/Desktop/。

如自定义了安装目录，将 Exec= 和 Icon= 两行中的路径替换为实际路径（注意：.desktop 文件不支持 ~，必须写绝对路径）。

三、证书配置（必做，否则加速报错）

Watt Toolkit 的加速功能使用自签名证书进行 HTTPS 解密，需要将该证书安装到两处信任链。

3.1 安装到系统 CA 目录（解决 Git/curl 证书错误）

# 创建系统 CA 目录（如不存在）
sudo mkdir -p /usr/local/share/ca-certificates
# 安装证书到系统 CA
sudo install -m 0644 \
  ~/.local/share/Steam++/Plugins/Accelerator/SteamTools.Certificate.cer \
  /usr/local/share/ca-certificates/steamtools.crt
# 更新系统证书缓存
sudo update-ca-certificates --fresh

3.2 安装到 Chrome NSS 数据库（解决浏览器 ERR_CERT_AUTHORITY_INVALID）

# 删除可能存在的旧证书（Watt Toolkit 重启后可能重新生成证书）
certutil -d sql:$HOME/.pki/nssdb -D -n "SteamTools" 2>/dev/null
# 添加新证书，信任属性设为 CT,（CA + SSL 对等端）
certutil -d sql:$HOME/.pki/nssdb -A -t "TC,," -n "SteamTools" \
  -i ~/.local/share/Steam++/Plugins/Accelerator/SteamTools.Certificate.cer
# 验证（应显示 SteamTools  CT,,）
certutil -d sql:$HOME/.pki/nssdb -L

关键：证书文件在 ~/.local/share/Steam++/Plugins/Accelerator/SteamTools.Certificate.cer，NSS 数据库在 ~/.pki/nssdb/。两处证书必须一致，否则 Chrome 报 ERR_CERT_AUTHORITY_INVALID。

3.3 Firefox 独立证书导入

Firefox 不使用系统 NSS 数据库，需手动操作：

1. 打开 Firefox → 设置 → 隐私与安全 → 查看证书 → 证书机构 → 导入
2. 选择 ~/.local/share/Steam++/Plugins/Accelerator/SteamTools.Certificate.cer
3. 勾选「信任此 CA 以标识网站」→ 确定

四、使用加速

1. 重启 Chrome（让 NSS 证书变更生效）
2. 双击桌面图标启动 Watt Toolkit
3. 切换到 网络加速 标签页 → 勾选 GitHub → 点击 一键加速
4. 访问 https://github.com → 正常打开即成功

五、常见问题

Q1: Chrome 报 ERR_CERT_AUTHORITY_INVALID

原因：NSS 数据库中的证书版本与代理正在使用的证书版本不一致（Watt Toolkit 重启后可能重新生成证书）。

解决：重复 3.2 节 操作（先删旧证书再加新证书），然后完全重启 Chrome。

Q2: Git 报 server certificate verification failed

原因：系统 CA 目录未安装证书。

解决：重复 3.1 节 操作。

---

附：文件结构

~/WattToolkit/                          # 安装目录
├── Steam++.sh                          # 启动脚本
├── Steam++ → dotnet/dotnet             # 符号链接
├── dotnet/                             # 自带 .NET 10.0.4 运行时
├── assemblies/                         # 程序集
├── Icons/                              # 图标
├── modules/                            # 功能模块
│   ├── Accelerator/                    #   加速器
│   ├── Authenticator/                  #   令牌验证器
│   ├── GameAccount/                    #   游戏账号切换
│   ├── GameList/                       #   游戏库管理
│   └── SteamIdleCard/                  #   挂卡
├── native/linux-x64/                   # 原生库 (SkiaSharp, SQLite 等)
└── script/                             # 辅助脚本

~/.local/share/Steam++/
├── Plugins/
│   ├── Accelerator/                    # 加速器配置与证书
│   │   ├── SteamTools.Certificate.cer  #   证书（公钥）
│   │   ├── SteamTools.Certificate.pfx  #   证书（含私钥）
│   │   ├── LOCAL_ACCELERATE.json       #   加速规则
│   │   ├── Scripts/                    #   加速脚本
│   │   ├── Settings/                   #   加速器设置
│   │   │   ├── ProxySettings.json      #     代理配置
│   │   │   └── GameAcceleratorSettings.json
│   │   └── Yarp/                       #   反向代理缓存
│   ├── Authenticator/                  # 令牌数据
│   ├── GameAccount/                    # 账号登录数据
│   ├── GameList/                       # 游戏库设置
│   └── SteamIdleCard/                  # 挂卡设置
└── Settings/                           # 全局设置
    ├── GeneralSettings.json
    ├── SteamSettings.json
    └── UISettings.json

附：卸载

如自定义了安装目录，将下方 ~/WattToolkit 替换为实际路径。

# 删除安装目录、应用数据和缓存
rm -rf ~/WattToolkit ~/.local/share/Steam++ ~/.cache/Steam++
# 删除快捷方式
rm -f ~/.local/share/applications/Watt\ Toolkit.desktop
rm -f ~/Desktop/Watt\ Toolkit.desktop
# 删除系统 CA 证书并更新缓存
sudo rm -f /usr/local/share/ca-certificates/steamtools.crt
sudo update-ca-certificates --fresh
# 删除 NSS 数据库中的证书
certutil -d sql:$HOME/.pki/nssdb -D -n "SteamTools" 2>/dev/null