mirror of
https://github.com/bitcookies/winrar-keygen.git
synced 2026-03-11 17:45:31 +00:00
381 lines
16 KiB
Markdown
381 lines
16 KiB
Markdown
<p align="center">
|
||
<img width="100px" src="icon.png" align="center" alt="WinRAR Keygen" />
|
||
<h2 align="center">WinRAR Keygen</h2>
|
||
<p align="center">Principle of WinRAR key generation</p>
|
||
</p>
|
||
<p align="center">
|
||
<a href="https://github.com/bitcookies/winrar-keygen/releases"><img src="https://img.shields.io/github/v/release/bitcookies/winrar-keygen?label=version" /></a>
|
||
<a href="https://github.com/bitcookies/winrar-keygen/issues"><img alt="Issues" src="https://img.shields.io/github/issues/bitcookies/winrar-keygen?color=F48D73" /></a>
|
||
<img src="https://img.shields.io/badge/Visual%20Studio-2022-5D4298?logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBzdGFuZGFsb25lPSJubyI/PjwhRE9DVFlQRSBzdmcgUFVCTElDICItLy9XM0MvL0RURCBTVkcgMS4xLy9FTiIgImh0dHA6Ly93d3cudzMub3JnL0dyYXBoaWNzL1NWRy8xLjEvRFREL3N2ZzExLmR0ZCI+PHN2ZyB0PSIxNzI4MTA5NjA3MzUyIiBjbGFzcz0iaWNvbiIgdmlld0JveD0iMCAwIDEwMjQgMTAyNCIgdmVyc2lvbj0iMS4xIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHAtaWQ9IjYxMjAiIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB3aWR0aD0iMjQiIGhlaWdodD0iMjQiPjxwYXRoIGQ9Ik03MTguOTMzMzMzIDg1LjMzMzMzM0wzODcuODQgNDE2Ljg1MzMzM2wtMjA5LjA2NjY2Ny0xNjQuNjkzMzMzTDg3LjQ2NjY2NyAyOTguNjY2NjY3djQyNi42NjY2NjZsOTEuNzMzMzMzIDQ2LjUwNjY2NyAyMTAuMzQ2NjY3LTE2NC4yNjY2NjdMNzE5Ljc4NjY2NyA5MzguNjY2NjY3IDkzOC42NjY2NjcgODUwLjM0NjY2N1YxNzAuNjY2NjY3ek0xODYuNDUzMzMzIDYxMC4xMzMzMzNWNDExLjczMzMzM2wxMDQuMTA2NjY3IDEwMy42OHogbTUyNi4wOCA1NS4wNEw1MTQuMTMzMzMzIDUxMmwxOTguNC0xNTMuMTczMzMzeiIgcC1pZD0iNjEyMSIgZmlsbD0iIzk1OWRhNSI+PC9wYXRoPjwvc3ZnPg==" />
|
||
<a href="https://github.com/bitcookies/winrar-keygen/actions"><img src="https://github.com/bitcookies/winrar-keygen/actions/workflows/keygen.yml/badge.svg" /></a>
|
||
<a href="https://github.com/bitcookies/winrar-keygen/blob/master/LICENSE"><img alt="License" src="https://img.shields.io/github/license/bitcookies/winrar-keygen.svg" /></a>
|
||
</p>
|
||
<p align="center">
|
||
<a href="README.zh-CN.md">简体中文</a> | <a href="README.md">English</a>
|
||
</p>
|
||
|
||
|
||
## 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-编译使用)
|
||
|
||
### 3.1 编码说明
|
||
|
||
WinRAR Keygen 支持 `ASCII`、`ANSI` 和 `UTF8NoBOM` 三种编码类型，对应支持的字符如下表：
|
||
|
||
> [!NOTE]
|
||
> 默认使用 `utf8`，但是你也可以指定编码为 `ascii` 或 `ansi`。
|
||
|
||
| 编码 | 支持的字符 | 字符示例 |
|
||
| -------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
|
||
| [ascii](https://en.wikipedia.org/wiki/ASCII) | 仅支持 ASCII 编码字符 | <img width="300px" src="assets/ascii-characters-light.svg#gh-light-mode-only"><img width="300px" src="assets/ascii-characters-dark.svg#gh-dark-mode-only"> |
|
||
| ansi | 没有一种固定的 ANSI 编码，通常是 [Windows-1252](http://en.wikipedia.org/wiki/Windows-1252)，但也可以是其他本地 | <img width="300px" src="assets/windows-1252-characters-light.svg#gh-light-mode-only"><img width="300px" src="assets/windows-1252-characters-dark.svg#gh-dark-mode-only"> |
|
||
| [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` 两种类型，它们仅在导入上有区别：
|
||
|
||
| <img width="60px">rarreg.key<img width="60px"> | <img width="60px">rarkey.rar<img width="60px"> |
|
||
| :--------------------------------------------: | :----------------------------------------------: |
|
||
| <img width="100px" src="assets/file-icon.svg"> | <img width="100px" src="assets/winrar-icon.svg"> |
|
||
| 拖动导入或放于指定位置 | 双击运行自动导入 |
|
||
|
||
如果你无法执行拖动操作，你可以尝试把 `rarreg.key` 放置于以下目录中：
|
||
|
||
```shell
|
||
C:\Users\yourname\AppData\Roaming\WinRAR\rarreg.key
|
||
```
|
||
|
||
你也可以将 `rarreg.key` 压缩成 `rarkey.rar` 然后双击运行，授权导入将会自动进行。
|
||
|
||
## 4. 使用 Github Actions
|
||
|
||
<details>
|
||
<summary>点击展开</summary>
|
||
|
||
新的 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`，然后双击运行，授权导入将会自动进行。
|
||
|
||
如果你得到的是 key 是无效的，请查看[解决方法](#7-无效的-Key)。
|
||
|
||
</details>
|
||
|
||
## 5. 使用 Github Actions with secrets
|
||
|
||
<details>
|
||
<summary>点击展开</summary>
|
||
|
||
使用 [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<img width="120px"> | Explanation<img width="120px"> |
|
||
| ------------------------------- | ------------------------------ |
|
||
| 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`，然后双击运行，授权导入将会自动进行。
|
||
|
||
如果你得到的是 key 是无效的，请查看[解决方法](#7-无效的-Key)。
|
||
|
||
</details>
|
||
|
||
## 6. 通过 Visual Studio 编译使用
|
||
|
||
<details>
|
||
<summary>点击展开</summary>
|
||
|
||
我建议通过 Github Actions 的方法来使用，但是你仍然可以选择自行编译。
|
||
|
||
如果你不想自行编译，也可以到 [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`
|
||
|
||
你可以通过下的命令来安装：
|
||
|
||
```shell
|
||
$ vcpkg install mpir:x86-windows-static
|
||
$ vcpkg install mpir:x64-windows-static
|
||
$ vcpkg install gmp:x64-windows
|
||
```
|
||
|
||
3. 你的 `vcpkg` 与 __Visual Studio__ 整合了，即你曾成功运行了下面这条命令：
|
||
|
||
```shell
|
||
$ vcpkg integrate install
|
||
```
|
||
|
||
### 6.2 编译
|
||
|
||
1. 在 __Visual Studio__ 中打开这个项目；
|
||
2. 选择 `Release` 配置；
|
||
3. 选择 __生成 > 生成解决方案__。
|
||
|
||
你将在 `bin/` 目录下看到生成的文件。
|
||
|
||
### 6.3 如何使用？
|
||
|
||
直接在终端执行以下代码，配置两个参数即可生成 `rarreg.key`。
|
||
|
||
这里以 `Github` 和 `Single PC usage license` 参数和 ASCII 编码为例：
|
||
|
||
```shell
|
||
Usage:
|
||
winrar-keygen.exe <Username> <License Name>
|
||
|
||
Example:
|
||
|
||
winrar-keygen.exe "Github" "Single PC usage license"
|
||
```
|
||
|
||
|
||
|
||
现在你可以看到新生成的文件：
|
||
|
||
```console
|
||
RAR registration data
|
||
Github
|
||
Single PC usage license
|
||
UID=3a3d02329a32b63da7d8
|
||
6412212250a7d8753c5e7037d83011171578c57042fa30c506caae
|
||
9954e4853d415ec594e46017cb3db740bc4b32e47aea25db62f350
|
||
9f22065a27da4f8216d2938e1050b6e3347501a3767d1fdd7ee130
|
||
dd4ab952600ba16a99236d910bfa995d5f60651ec451f462511507
|
||
95b3722d059f2d5303a231e396cf21f17098edeec0b6e3347501a3
|
||
767d1fdd7ee45388769767642338ee8a63178f3458b71de5609b18
|
||
5eede7ed46566b10bf033daa6384062b259194b1acbd0378116064
|
||
```
|
||
|
||
将生成的信息以 **ASCII 编码** 的文本格式保存为 `rarreg.key`。
|
||
|
||
### 6.4 支持更多字符
|
||
|
||
除了使用 ASCII 编码，你还可以使用 ANSI 和 UTF8NoBOM 以支持更多字符，但你需要[安装 PowerShell 7.4 及其后续版本](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.4)。
|
||
|
||
例如，用 UTF8NoBOM 编码生成 license：
|
||
|
||
> `utf8:` 是为了保证在不同语言的 WinRAR 中做到不变的字符表示。
|
||
|
||
```shell
|
||
winrar-keygen.exe "utf8:简体中文" "license" | Out-File -Encoding UTF8NoBOM rarreg.key
|
||
|
||
winrar-keygen.exe "utf8:Français" "license" | Out-File -Encoding UTF8NoBOM rarreg.key
|
||
|
||
winrar-keygen.exe "utf8:日本語" "license" | Out-File -Encoding UTF8NoBOM rarreg.key
|
||
|
||
winrar-keygen.exe "utf8:한국어" "license" | Out-File -Encoding UTF8NoBOM rarreg.key
|
||
```
|
||
|
||
</details>
|
||
|
||
## 7. 无效的 Key
|
||
|
||
为什么我生成的 `rarreg.key` 是无效的？
|
||
|
||
### 7.1 字符编码不正确
|
||
|
||
参数 `TEXT1` 和 `TEXT2` 需要满足[对应的编码要求](#31-编码说明)：
|
||
|
||
```console
|
||
winrar-keygen.exe <TEXT1> <TEXT2>
|
||
```
|
||
|
||
具体可参考原理文档：[授权文件"rarreg.key"的生成](https://github.com/bitcookies/winrar-keygen/blob/master/README.HOW_DOES_IT_WORK.zh-CN.md#7-%E6%8E%88%E6%9D%83%E6%96%87%E4%BB%B6rarregkey%E7%9A%84%E7%94%9F%E6%88%90)
|
||
|
||
### 7.2 文本储存编码不正确
|
||
|
||
如果你使用了如下命令：
|
||
|
||
```shell
|
||
winrar-keygen.exe "Github" "Single PC usage license" > rarreg.key
|
||
```
|
||
|
||
在较新的 Windows 10 / 11 系统中，PowerShell 将默认以 **UTF16-LE** 格式导出，这将会导致错误。
|
||
|
||
请指定输出编码格式，例如：
|
||
|
||
```shell
|
||
winrar-keygen.exe "Github" "license" | Out-File -Encoding ascii rarreg.key
|
||
|
||
winrar-keygen.exe "Github" "license" | Out-File -Encoding ansi rarreg.key
|
||
|
||
winrar-keygen.exe "utf8:Github" "license" | Out-File -Encoding UTF8NoBOM rarreg.key
|
||
```
|
||
|
||
### 7.3 关于简体中文版
|
||
|
||
在 [__RARLAB__](https://www.rarlab.com/) 下载的简体中文版 WinRAR 将会自带广告组件，即使使用了 `rarreg.key` 授权，广告组件依旧会出现。这是由于简体中文代理商的一些意见，RARLAB 已将简体中文安装包的公开链接更换成了带有广告的简体中文安装包。
|
||
|
||
感谢 [@hoochanlon](https://github.com/hoochanlon) 提供的一些方法。可以使用 [win-rar-extractor](https://github.com/lvtx/WinRAR-Extractor) 获取简体中文商业版的下载连接；也可以根据商业版的地址规律，获取相应版本的简体中文安装包：
|
||
|
||
简体中文**商业版**（以 `6.24` 和`7.01` 以及 `7.10` 和 `7.11` 版本为例）：
|
||
|
||
```
|
||
# 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
|
||
|
||
# 7.01
|
||
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20240528/wrr/winrar-x32-701sc.exe
|
||
https://www.win-rar.com/fileadmin/winrar-versions/sc/sc20240528/wrr/winrar-x64-701sc.exe
|
||
|
||
# 注意：自 7.10 版之后，日期格式调整为 YYYYDDMM
|
||
# 7.10
|
||
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
|
||
|
||
# 7.11
|
||
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
|
||
```
|
||
|
||
简体中文**广告版**（以 `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)。
|
||
|
||
## 8. 贡献
|
||
|
||
### 8.1 反馈和建议
|
||
|
||
如果您遇到了一些问题，可在 [Issues](https://github.com/bitcookies/winrar-keygen/issues) 页面反馈，会有很多热心的开发者及 Github 用户帮助你。
|
||
|
||
该项目欢迎贡献和建议，您可以在 [Issues](https://github.com/bitcookies/winrar-keygen/issues) 提出建议，或者进行提交拉取请求 😄
|
||
|
||
### 8.2 感谢
|
||
|
||
非常感谢一些热心的开发者，在 [Issues](https://github.com/bitcookies/winrar-keygen/issues) 帮助解答一些问题。
|
||
|
||
🏆 特别感谢 [@Sonic-The-Hedgehog-LNK1123](https://github.com/Sonic-The-Hedgehog-LNK1123)
|
||
|
||
## 9. 许可
|
||
|
||
使用 [MIT License](https://github.com/bitcookies/winrar-keygen/blob/master/LICENSE)
|