第02章安装与环境配置

第02章：安装与环境配置

2.1 系统要求

在安装 .NET Reactor 之前，需要确保系统满足以下要求。

2.1.1 硬件要求

最低配置：

CPU：1 GHz 或更快的处理器
RAM：512 MB
硬盘空间：100 MB 可用空间

推荐配置：

CPU：双核 2 GHz 或更快的处理器
RAM：2 GB 或更多
硬盘空间：500 MB 可用空间（包含临时文件）
SSD 硬盘（提高处理速度）

2.1.2 操作系统要求

Windows 系统：

Windows 7 SP1 或更高版本
Windows 8/8.1
Windows 10（推荐）
Windows 11
Windows Server 2008 R2 SP1 或更高版本
Windows Server 2012/2016/2019/2022

支持 32 位和 64 位系统，但推荐使用 64 位系统以获得更好的性能。

Linux 系统：

Ubuntu 18.04 LTS 或更高版本
Debian 9 或更高版本
CentOS 7 或更高版本
Fedora 30 或更高版本
其他主流 Linux 发行版

macOS 系统：

macOS 10.12 (Sierra) 或更高版本
macOS 10.13 (High Sierra)
macOS 10.14 (Mojave)
macOS 10.15 (Catalina)
macOS 11 (Big Sur)
macOS 12 (Monterey)
macOS 13 (Ventura)

2.1.3 软件依赖

.NET Framework 依赖：

.NET Framework 4.6.2 或更高版本（用于运行 .NET Reactor 本身）
根据要保护的目标程序，需要安装对应的 .NET 版本

.NET Core / .NET 5+ 依赖：

.NET Core Runtime 3.1 或更高版本
.NET 5.0/6.0/7.0/8.0 Runtime（根据需要）

其他依赖：

Visual C++ Redistributable（Windows 系统）
Mono Runtime（Linux/macOS 系统，用于某些功能）

2.2 下载 .NET Reactor

2.2.1 官方下载途径

官方网站下载
- 访问：https://www.eziriz.com/
- 点击 "Download" 或 "Downloads" 链接
- 选择适合的版本下载
版本选择
- 标准版（Standard Edition）：包含基本的代码保护功能
- 企业版（Enterprise Edition）：包含完整功能和许可证系统
- 试用版（Trial Version）：功能完整，有时间或功能限制

下载文件

dotNET_Reactor_Setup_x.x.x.x.exe    # Windows 安装程序
dotNET_Reactor_x.x.x.x.zip          # Windows 便携版
dotNET_Reactor_x.x.x.x.tar.gz       # Linux/macOS 版本

2.2.2 版本说明

.NET Reactor 版本号说明：

6.9.0.0
│ │ │ └─ 修订版本号（Bug 修复）
│ │ └─── 小版本号（小功能更新）
│ └───── 大版本号（重要功能更新）
└─────── 主版本号（重大架构变化）

版本选择建议：

稳定版本：用于生产环境
最新版本：获得最新功能和安全更新
LTS 版本：长期支持版本，推荐企业使用

2.3 安装 .NET Reactor

2.3.1 Windows 系统安装

使用安装程序：

运行安装程序

双击 dotNET_Reactor_Setup_x.x.x.x.exe

安装向导步骤

步骤 1：欢迎界面
- 点击 "Next" 继续
步骤 2：许可协议
- 阅读并接受许可协议
- 选择 "I accept the agreement"
- 点击 "Next"
步骤 3：选择安装位置
```
默认安装路径：
C:\Program Files (x86)\Eziriz\.NET Reactor\

或自定义路径，例如：
D:\Development\Tools\.NET Reactor\
```
步骤 4：选择组件
- .NET Reactor GUI（图形界面）
- Command Line Interface（命令行工具）
- Visual Studio Integration（VS 集成，可选）
- Documentation（帮助文档）
- Example Projects（示例项目）
步骤 5：开始菜单快捷方式
- 选择开始菜单文件夹名称
- 默认：Eziriz.NET Reactor
步骤 6：创建桌面快捷方式
- Create a desktop icon
步骤 7：确认安装
- 检查安装设置
- 点击 "Install" 开始安装
步骤 8：完成安装
- 安装完成后点击 "Finish"
- 可选：[x] Launch .NET Reactor（启动程序）

验证安装

# 打开命令提示符
cd "C:\Program Files (x86)\Eziriz\.NET Reactor"

# 检查版本
dotNET_Reactor.Console.exe -version

# 输出示例：
# .NET Reactor 6.9.0.0
# Copyright © 2004-2024 Eziriz

使用便携版：

解压文件

解压 dotNET_Reactor_x.x.x.x.zip 到任意目录
例如：D:\Tools\.NET Reactor\

配置环境变量（可选）

将 .NET Reactor 目录添加到 PATH 环境变量：

系统属性 → 高级 → 环境变量
在 "Path" 变量中添加：
D:\Tools\.NET Reactor\

创建快捷方式
- 右键点击 dotNET_Reactor.exe
- 选择 "发送到" → "桌面快捷方式"

2.3.2 Linux 系统安装

使用 Mono 运行：

安装 Mono

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install mono-complete

# CentOS/RHEL
sudo yum install mono-complete

# Fedora
sudo dnf install mono-complete

解压 .NET Reactor

# 解压文件
tar -xzf dotNET_Reactor_x.x.x.x.tar.gz

# 移动到安装目录
sudo mkdir -p /opt/dotnet-reactor
sudo mv dotNET_Reactor/* /opt/dotnet-reactor/

# 设置权限
sudo chmod +x /opt/dotnet-reactor/dotNET_Reactor.Console.exe

创建启动脚本

# 创建脚本文件
sudo nano /usr/local/bin/dotnet-reactor

# 添加内容：
#!/bin/bash
mono /opt/dotnet-reactor/dotNET_Reactor.Console.exe "$@"

# 设置可执行权限
sudo chmod +x /usr/local/bin/dotnet-reactor

验证安装
```
dotnet-reactor -version
```

使用 .NET Core 运行（如果支持）：

安装 .NET SDK

# 下载并安装 .NET SDK
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh --channel 8.0

运行 .NET Reactor

dotnet /opt/dotnet-reactor/dotNET_Reactor.dll

2.3.3 macOS 系统安装

使用 Mono 运行：

安装 Mono

# 使用 Homebrew
brew install mono

# 或下载 Mono 安装包
# 访问：https://www.mono-project.com/download/stable/

解压和安装

# 解压文件
tar -xzf dotNET_Reactor_x.x.x.x.tar.gz

# 移动到应用程序目录
sudo mkdir -p /Applications/dotNET_Reactor
sudo mv dotNET_Reactor/* /Applications/dotNET_Reactor/

# 设置权限
sudo chmod +x /Applications/dotNET_Reactor/dotNET_Reactor.Console.exe

创建启动脚本

# 创建脚本
sudo nano /usr/local/bin/dotnet-reactor

# 添加内容：
#!/bin/bash
mono /Applications/dotNET_Reactor/dotNET_Reactor.Console.exe "$@"

# 设置权限
sudo chmod +x /usr/local/bin/dotnet-reactor

创建应用程序别名（可选）

# 创建 .app 包
# 使用 Automator 或直接使用命令行启动

2.4 许可证激活

2.4.1 许可证类型

试用许可证（Trial License）
- 免费使用
- 功能完整或部分限制
- 时间限制（通常 30 天）
- 可能有输出限制
标准许可证（Standard License）
- 永久使用
- 基本保护功能
- 单用户授权
企业许可证（Enterprise License）
- 永久使用
- 完整功能
- 多用户授权
- 优先技术支持
订阅许可证（Subscription License）
- 按年订阅
- 包含更新和支持
- 到期需续订

2.4.2 在线激活

启动 .NET Reactor
- 首次运行会提示激活

选择激活方式

┌─────────────────────────────────┐
│  .NET Reactor License Manager   │
├─────────────────────────────────┤
│  ○ Trial Version (30 days)     │
│  ● Enter License Key            │
│  ○ Offline Activation           │
└─────────────────────────────────┘

输入许可证密钥

Name:    Your Name or Company
Email:   your-email@example.com
License: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

在线验证
- 点击 "Activate Online"
- 系统连接到激活服务器
- 验证许可证有效性
- 完成激活

激活成功

✓ License activated successfully

Licensed to: Your Name / Company
License Type: Enterprise License
Valid Until: Perpetual / 2025-12-31

2.4.3 离线激活

对于无法连接互联网的计算机：

生成激活请求

在 .NET Reactor 中：
License → Activate → Offline Activation
→ Generate Request File

保存文件：activation_request.dat

在线提交请求
- 在有网络的计算机上访问激活网站
- 上传 activation_request.dat
- 输入许可证密钥
- 下载激活响应文件：activation_response.dat

导入激活响应

在离线计算机上：
License → Activate → Offline Activation
→ Import Response File

选择文件：activation_response.dat

完成激活
- 系统验证响应文件
- 激活成功

2.4.4 许可证管理

查看许可证信息：

Help → About → License Information

显示内容：
- License Type
- Licensed To
- License Key
- Activation Date
- Expiration Date (if applicable)
- Allowed Machines

许可证转移：

如需在新机器上使用：
1. 在旧机器上停用（Deactivate）
2. 在新机器上激活
3. 或联系技术支持

企业许可证可能支持多机器激活

许可证更新：

License → Check for Updates

订阅用户可自动获取更新
永久许可证用户可能需要购买升级

2.5 开发环境集成

2.5.1 Visual Studio 集成

安装 Visual Studio 扩展：

从 Visual Studio Marketplace 安装

方法一：在线安装
1. 打开 Visual Studio
2. 扩展 → 管理扩展
3. 搜索 ".NET Reactor"
4. 点击 "Download"
5. 重启 Visual Studio 完成安装

方法二：手动安装
1. 下载 VSIX 文件
2. 双击安装
3. 重启 Visual Studio

验证安装

工具 → .NET Reactor

应该看到：
- Protect Assembly...
- Settings...
- About...

配置项目保护：

项目属性配置

右键项目 → 属性 → Build Events

Post-build event command line:
"C:\Program Files (x86)\Eziriz\.NET Reactor\dotNET_Reactor.Console.exe" 
-file "$(TargetPath)" 
-targetfile "$(TargetDir)Protected\$(TargetFileName)"
-project "$(ProjectDir).nrproj"

使用构建后事件

<Target Name="ProtectAssembly" AfterTargets="Build">
  <Exec Command="&quot;C:\Program Files (x86)\Eziriz\.NET Reactor\dotNET_Reactor.Console.exe&quot; -file &quot;$(TargetPath)&quot; -targetfile &quot;$(TargetDir)Protected\$(TargetFileName)&quot;" />
</Target>

创建保护配置文件

<!-- MyProject.nrproj -->
<?xml version="1.0" encoding="utf-8"?>
<dotNET_Reactor>
  <Settings>
    <Obfuscation enabled="true" />
    <NecroBit enabled="true" />
    <AntiTampering enabled="true" />
    <Licensing enabled="true" />
  </Settings>
</dotNET_Reactor>

2.5.2 JetBrains Rider 集成

安装插件：

从插件市场安装

File → Settings → Plugins
→ Marketplace
→ 搜索 ".NET Reactor"
→ Install
→ Restart Rider

配置构建后处理

Run → Edit Configurations
→ 选择项目配置
→ Before Launch: 添加 "Run External Tool"

Program: C:\Program Files (x86)\Eziriz\.NET Reactor\dotNET_Reactor.Console.exe
Arguments: -file "$OutputPath$" -project "$ProjectDir$/.nrproj"
Working Directory: $ProjectDir$

2.5.3 命令行工具配置

基本用法：

# Windows
dotNET_Reactor.Console.exe [options]

# Linux/macOS
mono dotNET_Reactor.Console.exe [options]
# 或
dotnet-reactor [options]

常用参数：

# 保护单个文件
dotNET_Reactor.Console.exe -file MyApp.exe

# 使用项目文件
dotNET_Reactor.Console.exe -project MyProject.nrproj

# 指定输出文件
dotNET_Reactor.Console.exe -file MyApp.exe -targetfile MyApp.Protected.exe

# 启用特定功能
dotNET_Reactor.Console.exe -file MyApp.exe -necrobit -antitampering

# 静默模式（无 GUI）
dotNET_Reactor.Console.exe -file MyApp.exe -quiet

# 显示帮助
dotNET_Reactor.Console.exe -help

创建批处理脚本：

@echo off
REM protect.bat - 保护程序集的批处理脚本

set REACTOR="C:\Program Files (x86)\Eziriz\.NET Reactor\dotNET_Reactor.Console.exe"
set SOURCE=bin\Release\MyApp.exe
set TARGET=bin\Release\Protected\MyApp.exe
set PROJECT=MyProject.nrproj

echo Protecting assembly...
%REACTOR% -file %SOURCE% -targetfile %TARGET% -project %PROJECT% -quiet

if %ERRORLEVEL% EQU 0 (
    echo Protection completed successfully!
) else (
    echo Protection failed with error code %ERRORLEVEL%
    exit /b %ERRORLEVEL%
)

PowerShell 脚本：

# Protect-Assembly.ps1

param(
    [Parameter(Mandatory=$true)]
    [string]$SourceFile,
    
    [Parameter(Mandatory=$false)]
    [string]$TargetFile = "",
    
    [Parameter(Mandatory=$false)]
    [string]$ProjectFile = ""
)

$reactorPath = "C:\Program Files (x86)\Eziriz\.NET Reactor\dotNET_Reactor.Console.exe"

if (!(Test-Path $SourceFile)) {
    Write-Error "Source file not found: $SourceFile"
    exit 1
}

$args = @("-file", $SourceFile)

if ($TargetFile) {
    $args += @("-targetfile", $TargetFile)
}

if ($ProjectFile) {
    $args += @("-project", $ProjectFile)
}

$args += "-quiet"

Write-Host "Protecting $SourceFile..."
& $reactorPath $args

if ($LASTEXITCODE -eq 0) {
    Write-Host "Protection completed successfully!" -ForegroundColor Green
} else {
    Write-Error "Protection failed with error code $LASTEXITCODE"
    exit $LASTEXITCODE
}

2.5.4 CI/CD 集成

Azure DevOps Pipeline：

# azure-pipelines.yml

trigger:
  - main

pool:
  vmImage: 'windows-latest'

variables:
  buildConfiguration: 'Release'
  reactorPath: 'C:\Program Files (x86)\Eziriz\.NET Reactor\dotNET_Reactor.Console.exe'

steps:
- task: DotNetCoreCLI@2
  displayName: 'Build Project'
  inputs:
    command: 'build'
    projects: '**/*.csproj'
    arguments: '--configuration $(buildConfiguration)'

- task: PowerShell@2
  displayName: 'Protect Assemblies'
  inputs:
    targetType: 'inline'
    script: |
      $files = Get-ChildItem -Path "$(Build.SourcesDirectory)" -Filter "*.exe" -Recurse
      foreach ($file in $files) {
        Write-Host "Protecting $($file.FullName)"
        & "$(reactorPath)" -file $file.FullName -quiet
      }

- task: PublishBuildArtifacts@1
  displayName: 'Publish Artifacts'
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)'
    ArtifactName: 'protected-app'

GitHub Actions：

# .github/workflows/build-and-protect.yml

name: Build and Protect

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build-and-protect:
    runs-on: windows-latest
    
    steps:
    - uses: actions/checkout@v3
    
    - name: Setup .NET
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: '8.0.x'
    
    - name: Restore dependencies
      run: dotnet restore
    
    - name: Build
      run: dotnet build --configuration Release --no-restore
    
    - name: Install .NET Reactor
      run: |
        # 下载并安装 .NET Reactor
        # 或使用预安装的版本
        
    - name: Protect Assemblies
      run: |
        $reactorPath = "C:\Program Files (x86)\Eziriz\.NET Reactor\dotNET_Reactor.Console.exe"
        Get-ChildItem -Path "bin\Release" -Filter "*.exe" -Recurse | ForEach-Object {
          & $reactorPath -file $_.FullName -quiet
        }
      shell: powershell
    
    - name: Upload Artifacts
      uses: actions/upload-artifact@v3
      with:
        name: protected-application
        path: bin/Release/net8.0/*.exe

Jenkins Pipeline：

// Jenkinsfile

pipeline {
    agent {
        label 'windows'
    }
    
    environment {
        REACTOR_PATH = 'C:\\Program Files (x86)\\Eziriz\\.NET Reactor\\dotNET_Reactor.Console.exe'
        BUILD_CONFIG = 'Release'
    }
    
    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }
        
        stage('Build') {
            steps {
                bat 'dotnet restore'
                bat "dotnet build --configuration ${BUILD_CONFIG}"
            }
        }
        
        stage('Protect') {
            steps {
                script {
                    def files = findFiles(glob: "bin/${BUILD_CONFIG}/**/*.exe")
                    files.each { file ->
                        bat "\"${REACTOR_PATH}\" -file \"${file.path}\" -quiet"
                    }
                }
            }
        }
        
        stage('Archive') {
            steps {
                archiveArtifacts artifacts: "bin/${BUILD_CONFIG}/**/*.exe", fingerprint: true
            }
        }
    }
    
    post {
        success {
            echo 'Build and protection completed successfully!'
        }
        failure {
            echo 'Build or protection failed!'
        }
    }
}

2.6 环境变量配置

2.6.1 Windows 环境变量

系统级配置：

# 添加 .NET Reactor 到 PATH
setx PATH "%PATH%;C:\Program Files (x86)\Eziriz\.NET Reactor" /M

# 设置 .NET Reactor 主目录
setx REACTOR_HOME "C:\Program Files (x86)\Eziriz\.NET Reactor" /M

# 设置许可证文件路径
setx REACTOR_LICENSE "C:\ProgramData\Eziriz\license.dat" /M

用户级配置：

# 添加到用户 PATH
setx PATH "%PATH%;C:\Program Files (x86)\Eziriz\.NET Reactor"

# 设置用户特定配置
setx REACTOR_CONFIG "%USERPROFILE%\.reactor\config.xml"

2.6.2 Linux/macOS 环境变量

Bash 配置：

# 编辑 .bashrc 或 .bash_profile
nano ~/.bashrc

# 添加以下内容：
export REACTOR_HOME="/opt/dotnet-reactor"
export PATH="$PATH:$REACTOR_HOME"
export REACTOR_LICENSE="/etc/dotnet-reactor/license.dat"

# 应用更改
source ~/.bashrc

Zsh 配置：

# 编辑 .zshrc
nano ~/.zshrc

# 添加内容同上
export REACTOR_HOME="/opt/dotnet-reactor"
export PATH="$PATH:$REACTOR_HOME"

# 应用更改
source ~/.zshrc

2.7 验证安装

2.7.1 GUI 验证

启动图形界面

Windows: 开始菜单 → Eziriz → .NET Reactor
Linux: dotnet-reactor (如果配置了启动脚本)
macOS: 双击应用程序或使用终端

检查界面元素
- 菜单栏完整显示
- 工具栏图标正常
- 主界面布局正确

检查许可证状态

Help → About
查看许可证信息和激活状态

2.7.2 命令行验证

# 检查版本
dotNET_Reactor.Console.exe -version

# 显示帮助
dotNET_Reactor.Console.exe -help

# 测试保护（使用示例程序）
dotNET_Reactor.Console.exe -file TestApp.exe -targetfile TestApp.Protected.exe

2.7.3 功能测试

创建测试项目：

// TestApp.cs
using System;

namespace TestApp
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello, .NET Reactor!");
            Console.WriteLine("This is a test application.");
            Console.ReadKey();
        }
    }
}

编译并保护：

# 编译
csc TestApp.cs

# 保护
dotNET_Reactor.Console.exe -file TestApp.exe

# 运行保护后的程序
TestApp.exe

验证保护效果：

# 使用反编译工具（如 ILSpy）打开保护前后的程序
# 对比查看保护效果

2.8 常见安装问题

2.8.1 许可证问题

问题：无法激活许可证

解决方案：

1. 检查网络连接
2. 确认许可证密钥正确
3. 检查防火墙设置
4. 尝试离线激活
5. 联系技术支持

问题：许可证已在其他机器上激活

解决方案：

1. 在原机器上停用许可证
2. 或等待自动释放（通常 24-48 小时）
3. 或联系技术支持手动释放

2.8.2 依赖项问题

问题：缺少 .NET Framework

错误信息：
"This application requires .NET Framework 4.6.2 or higher"

解决方案：
1. 下载并安装 .NET Framework
2. 访问：https://dotnet.microsoft.com/download/dotnet-framework

问题：Visual C++ Redistributable 缺失

错误信息：
"VCRUNTIME140.dll was not found"

解决方案：
1. 下载并安装 Visual C++ Redistributable
2. 访问：https://support.microsoft.com/help/2977003

2.8.3 权限问题

Windows UAC 权限：

问题：安装或运行时提示权限不足

解决方案：
1. 右键点击程序
2. 选择 "以管理员身份运行"
3. 或修改安装目录权限

Linux/macOS 权限：

# 问题：Permission denied

# 解决方案：
sudo chmod +x /opt/dotnet-reactor/dotNET_Reactor.Console.exe
sudo chown -R $USER:$USER /opt/dotnet-reactor

2.8.4 兼容性问题

Windows 兼容性模式：

如果在旧版 Windows 上运行有问题：
1. 右键点击程序
2. 属性 → 兼容性
3. 选择兼容模式
4. 勾选 "以管理员身份运行此程序"

2.9 卸载 .NET Reactor

2.9.1 Windows 卸载

使用卸载程序：

方法一：从控制面板卸载
控制面板 → 程序和功能 → .NET Reactor → 卸载

方法二：从开始菜单卸载
开始菜单 → Eziriz → .NET Reactor → Uninstall

方法三：运行卸载程序
<安装目录>\unins000.exe

手动清理：

# 删除程序文件
rmdir /s "C:\Program Files (x86)\Eziriz\.NET Reactor"

# 删除用户数据
rmdir /s "%APPDATA%\Eziriz\.NET Reactor"
rmdir /s "%LOCALAPPDATA%\Eziriz\.NET Reactor"

# 删除注册表项（可选）
reg delete "HKEY_CURRENT_USER\Software\Eziriz\.NET Reactor" /f
reg delete "HKEY_LOCAL_MACHINE\SOFTWARE\Eziriz\.NET Reactor" /f

2.9.2 Linux/macOS 卸载

# 删除程序文件
sudo rm -rf /opt/dotnet-reactor

# 删除启动脚本
sudo rm /usr/local/bin/dotnet-reactor

# 删除用户配置
rm -rf ~/.config/dotnet-reactor
rm -rf ~/.local/share/dotnet-reactor

# 删除许可证文件
sudo rm /etc/dotnet-reactor/license.dat

2.10 本章小结

本章详细介绍了 .NET Reactor 的安装和环境配置：

系统要求
- 硬件和软件要求
- 操作系统兼容性
- 必要的依赖组件
安装过程
- Windows、Linux、macOS 各平台的安装方法
- 图形界面和命令行工具的安装
- 便携版的使用
许可证激活
- 在线和离线激活方式
- 许可证类型和管理
- 常见激活问题处理
开发环境集成
- Visual Studio 集成
- JetBrains Rider 集成
- 命令行工具配置
- CI/CD 流程集成
环境配置
- 环境变量设置
- PATH 配置
- 验证安装成功

通过本章的学习，你应该已经成功安装并配置好了 .NET Reactor，可以开始学习具体的使用方法了。

下一章预告：在第三章中，我们将详细介绍 .NET Reactor 的用户界面，包括主界面布局、菜单功能、工具栏使用等，帮助你快速熟悉操作环境。

posted @ 2025-12-20 13:37 我才是银古阅读(4) 评论(0) 收藏举报

刷新页面返回顶部

梦开始的地方

慢慢来会比较快！

第02章 安装与环境配置