WinRAR Keygen
Principle of WinRAR key generation
English | 简体中文
## 1. WinRAR是什么？
WinRAR 是一款用于管理压缩包文件的共享软件。其算法由作者尤金·罗谢尔研发，享有原创专利。
它可以用来创建或浏览 RAR、ZIP 等众多格式的压缩包。
WinRAR 不是免费软件。如果你想使用它，你应当向 [**RARLAB**](https://www.rarlab.com/) 付费，然后获得一个授权文件 `rarreg.key`。
这份 repo 将会告诉你 `"rarreg.key"` 是如何生成的。
## 2. "rarreg.key"是如何生成的？
见 [这里](README.HOW_DOES_IT_WORK.zh-CN.md)。
## 3. 使用方法
有多种方法可供选择：
+ [使用 Github Actions](#4-使用-Github-Actions)
+ [使用 Github Actions with secrets](#5-使用-Github-Actions-with-secrets)
+ [通过 Visual Studio 编译使用](#6-通过-Visual-Studio-编译使用)
+ [使用 GUI](#7-使用 GUI)
+ [通过 Cmake 编译使用](#8-通过-Cmake-编译使用)
### 3.1 编码说明
WinRAR Keygen 支持 `ASCII`、`ANSI` 和 `UTF8NoBOM` 三种编码类型，对应支持的字符如下表：
> [!NOTE]
> 默认使用 `utf8`，但是你也可以指定编码为 `ascii` 或 `ansi`。
| 编码 | 支持的字符 | 字符示例 |
| -------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| [ascii](https://en.wikipedia.org/wiki/ASCII) | 仅支持 ASCII 编码字符 | 
|
| ansi | 没有一种固定的 ANSI 编码，通常是 [Windows-1252](http://en.wikipedia.org/wiki/Windows-1252)，但也可以是其他本地 | 
|
| [utf8](https://en.wikipedia.org/wiki/UTF-8) | 支持无 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` 放置于以下目录中：
```shell
%APPDATA%\WinRAR\rarreg.key
```
你也可以将 `rarreg.key` 压缩成 `rarkey.rar` 然后双击运行，授权导入将会自动进行。
## 4. 使用 Github Actions
点击展开
新的 workflow 能很方便的帮助你生成 license，你只需跟随以下步骤即可：
> 你的 `Username` 和 `License Name` 会出现在 actions 的日志中，如果你不想泄露这些信息，请参考 [5. 使用 Github Actions with secrets](#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 编码说明](#31-编码说明)。
运行成功之后，打开对应的任务，选择 **rarreg_file** 下载：
> 文件保留 90 天，超出时间后会自动销毁。
将 `rarreg_file.zip` 解压缩后会得到 `rarreg.key`，然后拖动导入 WinRAR 即可。你也可以将 `rarreg.key` 压缩成 `rarkey.rar`，然后双击运行，授权导入将会自动进行。
## 5. 使用 Github Actions with secrets
点击展开
使用 [secrets](https://docs.github.com/en/actions/security-guides/encrypted-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 编码说明](#31-编码说明)。
运行成功之后，打开对应的任务，选择 **rarreg_file** 下载：
> 文件仅保留 **1 天**，请及时下载。
将 `rarreg_file.zip` 解压缩后会得到 `rarreg.7z`，使用你设置的密码进行解压缩获得 `rarreg.key`，然后拖动导入 WinRAR 即可。你也可以将 `rarreg.key` 压缩成 `rarkey.rar`，然后双击运行，授权导入将会自动进行。
## 6. 通过 Visual Studio 编译使用
点击展开
如果你不想自行编译，也可以到 [Release](https://github.com/bitcookies/winrar-keygen/releases/) 页面获取对应版本的 `winrar-keygen.exe`。
### 6.1 前提条件
1. 请确保你有 **Visual Studio 2022**，因为这是一个 VS2022 项目。如果你仍在使用 Visual Studio 2019，可以在 [vs2019](https://github.com/bitcookies/winrar-keygen/tree/vs2019) 分支中找到适合 VS2019 的项目，但是此分支将不再维护。
2. 请确保你安装了 `vcpkg` 以及下面几个库：
+ `mpir:x86-windows-static`
+ `mpir:x64-windows-static`
+ `mpir:gmp:x64-windows`
+ `gmp:arm64-windows-static`
你可以通过下的命令来安装：
```shell
$ 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** 整合了，即你曾成功运行了下面这条命令：
```shell
$ vcpkg integrate install
```
### 6.2 编译
1. 在 **Visual Studio** 中打开这个项目；
2. 选择 **Release** 配置；
3. 选择 **生成 > 生成解决方案**。
你将在 `bin/` 目录下看到生成的文件。
### 6.3 如何使用？
直接在终端执行以下代码，配置两个参数即可生成 `rarreg.key`。
```shell
Usage:
winrar-keygen.exe [options]
winrar-keygen.exe -v | --version
winrar-keygen.exe -h | --help
Options:
-e, --encoding utf8 (default), ascii, ansi
-o, --output 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 ` | `utf8` (默认), `ascii`, `ansi` |
| `-o, --output ` | 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 编码为例：
```shell
./winrar-keygen.exe "Github" "Single PC usage license" -t -e ascii
```
现在你可以看到新生成的文件：
```console
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:` 前缀
```shell
./winrar-keygen.exe "Github" "Single PC usage license" -a
```
生成 ANSI 编码的 license 并生成 license 文件：
> ANSI 编码与 Windows 的地区有关，一般当前地区的字符能够正常展示，也会遇到字符乱码问题
```shell
./winrar-keygen.exe "Github" "Single PC usage license" -e ansi
```
生成 ASCII 编码的 license 并只在控制台输出：
```shell
./winrar-keygen.exe "Github" "Single PC usage license" -t -e asci
```
## 7. 使用 GUI
Click to expand
如果你正在使用 Windows 10 / 11，你可以使用 GUI 程序，它基于 .NET 8 WPF 和 Fluent Design (WPF UI) 构建，提供 `x64` 和 `ARM 64` 两种架构支持。
你可以在 [gui](https://github.com/bitcookies/winrar-keygen/tree/gui) 分支中获取项目，并自行构建 GUI 程序。更详细的信息请查看分支 [README](https://github.com/bitcookies/winrar-keygen/blob/gui/README.zh-CN.md)。
## 8. 通过 Cmake 编译使用
Click to expand
对于 Linux 或 macOS 用户，你可以在 Actions 页面用 `build.yml` 自动构建，也可以自行编译。
### 8.1 Linux (Ubuntu/Debian)
```shell
# 安装依赖
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)
```shell
# 安装依赖
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. 常见错误
### 9.1 Keygen 错误
从 `ver4` 版本开始，Keygen 增加了一些常见的 Error 提示信息，请根据输出信息来进行修正。
使用 `-h` 或 `--help` 来查看帮助信息：
```shell
./winrar-keygen.exe -h
```
### 9.2 Github Actions 错误
如果你使用 `ascii` 编码时发生了错误，原因是你使用了非 ASCII 字符。
如果你 `ansi` 编码时发生了错误，原因是因为字符编码不受当前 Windows 系统支持。GitHub Actions 的系统平台是 `windows-2022-english` （ANSI code page 1252），包含非 ASCII 字符都会失败。
### 9.3 关于简体中文版
在 [**RARLAB**](https://www.rarlab.com/) 下载的简体中文版 WinRAR 将会自带广告组件，即使使用了 `rarreg.key` 授权，广告组件依旧会出现。这是由于简体中文代理商的一些意见，RARLAB 已将简体中文安装包的公开链接更换成了带有广告的简体中文安装包。
感谢 [@hoochanlon](https://github.com/hoochanlon) 提供的一些方法。可以使用 [win-rar-extractor](https://github.com/lvtx/WinRAR-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](https://github.com/bitcookies/winrar-keygen/issues/14) 和 [Issues #19](https://github.com/bitcookies/winrar-keygen/issues/19)。
## 10. 贡献
### 10.1 反馈和建议
如果您在使用过程中遇到问题或有任何建议，欢迎在 [Issues](https://github.com/bitcookies/winrar-keygen/issues) 页面反馈，或提交 Pull Request。我们以及社区中的开发者将乐于为您提供帮助。
### 10.2 感谢
感谢所有为本项目做出贡献的开发者，以及在 [Issues](https://github.com/bitcookies/winrar-keygen/issues) 中热心解答问题的社区成员。
## 11. 许可
使用 [MIT License](https://github.com/bitcookies/winrar-keygen/blob/master/LICENSE)