winrar-keygen/README.zh-CN.md

WinRAR Keygen

Principle of WinRAR key generation

English | 简体中文

1. WinRAR是什么？

WinRAR 是一款用于管理压缩包文件的共享软件。其算法由作者尤金·罗谢尔研发，享有原创专利。

它可以用来创建或浏览 RAR、ZIP 等众多格式的压缩包。

WinRAR 不是免费软件。如果你想使用它，你应当向 RARLAB 付费，然后获得一个授权文件 rarreg.key。

这份 repo 将会告诉你 "rarreg.key" 是如何生成的。

2. "rarreg.key"是如何生成的？

见 这里。

3. 使用方法

有多种方法可供选择：

• 使用 Github Actions
• 使用 Github Actions with secrets
• 通过 Visual Studio 编译使用
• 通过 Github Action 编译使用
• 通过 Cmake 编译使用
• 使用 Windows GUI

3.1 编码说明

WinRAR Keygen 支持 ASCII、ANSI 和 UTF8NoBOM 三种编码类型，对应支持的字符如下表：

Note

默认使用 utf8，但是你也可以指定编码为 ascii 或 ansi。

编码	支持的字符	字符示例
ascii	仅支持 ASCII 编码字符
ansi	没有一种固定的 ANSI 编码，通常是 Windows-1252，但也可以是其他本地
utf8	支持无 BOM 的 UTF-8	ASCII characters, English, 简体中文, 繁體中文, Deutsch, Français, Русский, Italiano, 日本語, 한국어, Lengua española, Ελληνική γλώσσα 等。

3.2 License 类型

WinRAR license 有 rarreg.key 和 rarkey.rar 两种类型，它们仅在导入上有区别：

rarreg.key	rarkey.rar
拖动导入或放于指定位置	双击运行自动导入

你可以把 rarreg.key 放置于以下目录中：

%APPDATA%\WinRAR\rarreg.key

你也可以将 rarreg.key 压缩成 rarkey.rar 然后双击运行，授权导入将会自动进行。

4. 使用 Github Actions

点击展开

新的 workflow 能很方便的帮助你生成 license，你只需跟随以下步骤即可：

你的 <Username> 和 <License Name> 会出现在 Actions 的日志中，如果你不想泄露这些信息，请参考 5. 使用 Github Actions with secrets。

4.1 Fork

点击该项目右上角的 Fork 按钮，fork 一份代码到你的 Github：

4.2 允许 fork 仓库运行 workflows

返回到你刚刚 fork 完成的 repo，然后点击 Actions 去允许 workflows 在你的 fork repo 中运行：

4.3 运行 workflow

允许 workflow 后，选择 WinRAR Keygen > Run workflow 并填入信息就可以开始生成了：

License 编码的区别请参考 3.1 编码说明。

运行成功之后，打开对应的任务，选择 rarreg_file 下载：

文件保留 90 天，超出时间后会自动销毁。

将 rarreg_file.zip 解压缩后会得到 rarreg.key，然后拖动导入 WinRAR 即可。你也可以将 rarreg.key 压缩成 rarkey.rar，然后双击运行，授权导入将会自动进行。

5. 使用 Github Actions with secrets

点击展开

使用 secrets 可以帮助你隐藏 license 信息。

5.1 Fork

点击该项目右上角的 Fork 按钮，fork 一份代码到你的 Github：

5.2 允许 fork 仓库运行 workflows

返回到你刚刚 fork 完成的 repo，然后点击 Actions 去允许 workflows 在你的 fork repo 中运行：

5.3 创建 secrets

允许 workflows 后，进入 Settings > Secrets and variables > Actions > New repository secret 创建 secrets：

创建三个 secrets，名称为 TEXT1 、 TEXT2 和 PWD，并填入相关值：

填入的值应与你选择的编码类型保持一致。

Secrets Name	Explanation
TEXT1	用户名
TEXT2	许可名
PWD	压缩包密码

创建完成后，你将会看到：

5.4 运行 workflow

进入 Actions 选择 WinRAR Keygen with secrets > Run workflow 并填入信息：

License 编码的区别请参考 3.1 编码说明。

运行成功之后，打开对应的任务，选择 rarreg_file 下载：

文件仅保留 1 天，请及时下载。

将 rarreg_file.zip 解压缩后会得到 rarreg.7z，使用你设置的密码进行解压缩获得 rarreg.key，然后拖动导入 WinRAR 即可。你也可以将 rarreg.key 压缩成 rarkey.rar，然后双击运行，授权导入将会自动进行。

6. 通过 Visual Studio 编译使用

点击展开

如果你不想自行编译，可以到在 Actions 中编译，也可以到 Release 页面获取对应版本的构建程序。

6.1 前提条件

1. 请确保你有 Visual Studio 2022，因为这是一个 VS2022 项目。如果你仍在使用 Visual Studio 2019，可以在 vs2019 分支中找到适合 VS2019 的项目，但是此分支将不再维护。

2. 请确保你安装了 vcpkg 以及下面几个库：

   • mpir:x86-windows-static
   • mpir:x64-windows-static
   • mpir:gmp:x64-windows
   • gmp:arm64-windows-static

   你可以通过下的命令来安装：

   $ vcpkg install mpir:x86-windows-static
   $ vcpkg install mpir:x64-windows-static
   $ vcpkg install gmp:x64-windows
   $ vcpkg install gmp:arm64-windows-static
   

3. 你的 vcpkg 与 Visual Studio 整合了，即你曾成功运行了下面这条命令：

   $ vcpkg integrate install
   

6.2 编译

1. 在 Visual Studio 中打开这个项目；
2. 选择 Release 配置；
3. 选择 生成 > 生成解决方案。

你将在 bin/ 目录下看到生成的文件。

6.3 如何使用？

直接在终端执行以下代码，配置两个参数即可生成 rarreg.key。

Usage:
  winrar-keygen.exe <Username> <LicenseName> [options]
  winrar-keygen.exe -v | --version
  winrar-keygen.exe -h | --help

Options:
  -e, --encoding <enc>   utf8 (default), ascii, ansi
  -o, --output <file>    Output file (default: rarreg.key)
  -a, --activate         Write to %APPDATA%\WinRAR\rarreg.key
  -t, --text             Print to console only, don't write file
  -u, --update           Check for updates on GitHub
  -v, --version          Show version
  -h, --help             Show this help

参数选项

参数	描述
-e, --encoding <enc>	utf8 (默认), ascii, ansi
-o, --output <file>	Output file path (默认: rarreg.key)
-a, --activate	Write to %APPDATA%\WinRAR\rarreg.key
-t, --text	Print to console only, don't write file
-u, --update	Check for updates on GitHub
-v, --version	Show version
-h, --help	Show help

这里以 Github 和 Single PC usage license 参数和 ASCII 编码为例：

./winrar-keygen.exe "Github" "Single PC usage license" -t -e ascii

现在你可以看到新生成的文件：

RAR registration data
Github
Single PC usage license
UID=3a3d02329a32b63da7d8
6412212250a7d8753c5e7037d83011171578c57042fa30c506caae
9954e4853d415ec594e46017cb3db740bc4b32e47aea25db62f350
9f22065a27da4f8216d2938e1050b6e3347501a3767d1fdd7ee130
dd4ab952600ba16a99236d910bfa995d5f60651ec451f462511507
95b3722d059f2d5303a231e396cf21f17098edeec0b6e3347501a3
767d1fdd7ee45388769767642338ee8a63178f3458b71de5609b18
5eede7ed46566b10bf033daa6384062b259194b1acbd0378116064

6.4 更多示例

生成 UTF-8 编码的 license 并直接激活 WinRAR：

UTF-8 编码的 license 将会根据字符自动决定是否添加 utf8: 前缀

./winrar-keygen.exe "Github" "Single PC usage license" -a

生成 ANSI 编码的 license 并生成 license 文件：

ANSI 编码与 Windows 的地区有关，一般当前地区的字符能够正常展示，也会遇到字符乱码问题

./winrar-keygen.exe "Github" "Single PC usage license" -e ansi

生成 ASCII 编码的 license 并只在控制台输出：

./winrar-keygen.exe "Github" "Single PC usage license" -t -e asci

7. 通过 Github Actions 编译使用

点击展开

你可以在 Actions 中构建 Linux x64、Linux ARM64、macOS ARM64、Windows x64、Windows Win32 和 Windows ARM64 六种架构的应用程序。

点击该项目右上角的 Fork 按钮，fork 一份代码到你的 Github。然后找到你 fork 的仓库，进入 Actions 页面并手动执行 Build All Platforms (build.yml)。

Windows 的构建耗时在 20 分钟左右，建议本地构建速度更快。

运行成功之后，可在 Artifacts 下载。

8. 通过 Cmake 编译使用

Click to expand

对于 Linux 或 macOS 用户，你可以通过 Github Actions 编译使用，但也可以自行编译。

8.1 Linux (Ubuntu/Debian)

# 安装依赖
sudo apt-get update
sudo apt-get install -y build-essential cmake libgmp-dev

# 编译
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release

# 产物
./winrar-keygen --help

8.2 macOS (Homebrew)

# 安装依赖
brew install cmake gmp

# 编译
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release

# 产物
./winrar-keygen --help

文件生成在 build/winrar-keygen，版本号由 CMakeLists.txt 中的 APP_VERSION 控制。

9. 使用 Windows GUI

Click to expand

如果你正在使用 Windows 10 / 11，你可以使用 GUI 程序，它基于 .NET 8 WPF 和 Fluent Design (WPF UI) 构建，提供 x64 和 ARM 64 两种架构支持。

你可以在 gui 分支中获取项目，并自行构建 GUI 程序，也可以到 Release 页面获取对应版本的构建程序。

更详细的信息请查看分支 README。

10. 常见错误

10.1 Keygen 错误

从 ver4 版本开始，Keygen 增加了一些常见的 Error 提示信息，请根据输出信息来进行修正。

使用 -h 或 --help 来查看帮助信息：

./winrar-keygen.exe -h

10.2 Github Actions 错误

如果你使用 ascii 编码时发生了错误，原因是你使用了非 ASCII 字符。

如果你 ansi 编码时发生了错误，原因是因为字符编码不受当前 Windows 系统支持。GitHub Actions 的系统平台是 windows-2022-english （ANSI code page 1252），包含非 ASCII 字符都会失败。

10.3 关于简体中文版

在 RARLAB 下载的简体中文版 WinRAR 将会自带广告组件，即使使用了 rarreg.key 授权，广告组件依旧会出现。这是由于简体中文代理商的一些意见，RARLAB 已将简体中文安装包的公开链接更换成了带有广告的简体中文安装包。

感谢 @hoochanlon 提供的一些方法。可以使用 win-rar-extractor 获取简体中文商业版的下载连接；也可以根据商业版的地址规律，获取相应版本的简体中文安装包：

简体中文 「商业版」 下载地址：

# 7.13
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20250804/rrlb/winrar-x64-713sc.exe
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20250804/wrr/winrar-x64-713sc.exe

# 7.12
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20250627/rrlb/winrar-x64-712sc.exe
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20250627/wrr/winrar-x64-712sc.exe

# 7.11 （注意该版本的日期格式变更为了 YYYYDDMM）
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20253103/rrlb/winrar-x64-711sc.exe
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20253103/wrr/winrar-x64-711sc.exe

# 7.10 （注意该版本的日期格式变更为了 YYYYDDMM）
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20251003/rrlb/winrar-x64-710sc.exe
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20251003/wrr/winrar-x64-710sc.exe

# 6.24
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20231013/wrr/winrar-x32-624sc.exe
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20231013/wrr/winrar-x64-624sc.exe

简体中文 「广告版」 （以 6.24 版本为例），不要下载此类版本：

# 其链接特点是「不包含」日期信息

win-rar 渠道：
https://www.win-rar.com/fileadmin/winrar-versions/winrar/winrar-x32-624sc.exe
https://www.win-rar.com/fileadmin/winrar-versions/winrar/winrar-x64-624sc.exe

rarlab 渠道：
https://www.rarlab.com/rar/winrar-x32-624sc.exe
https://www.rarlab.com/rar/winrar-x64-624sc.exe

请注意区分上述连接地址，更多方法可以查看 Issues #14 和 Issues #19。

11. 贡献

11.1 反馈和建议

如果您在使用过程中遇到问题或有任何建议，欢迎在 Issues 页面反馈，或提交 Pull Request。我们以及社区中的开发者将乐于为您提供帮助。

11.2 感谢

感谢所有为本项目做出贡献的开发者，以及在 Issues 中热心解答问题的社区成员。

12. 许可

使用 MIT License