ESET 联机帮助

搜索 简体字
选择类别
选择主题

镜像工具 - Windows

您是 Linux 用户吗?

您可以在独立工具更改日志中找到 Mirror Tool 更改日志。

镜像工具对脱机检测引擎更新而言不可或缺。如果您的客户端计算机不具有 Internet 连接而需要进行检测引擎更新,您可以使用镜像工具从 ESET 更新服务器下载更新文件,然后将其存储在本地。


note

镜像工具具有以下功能:

模块更新 - 它会下载检测引擎更新和其他程序模块,但不会下载自动更新 (uPCU)。

存储库创建 - 它可以创建完整的脱机存储库,包括自动更新 (uPCU)。

镜像工具不会下载 ESET LiveGrid® 数据。

先决条件


important

镜像工具不支持 Windows XP 和 Windows Server 2003。

目标文件夹必须可供共享(Samba/Windows 或 HTTP/FTP 服务),具体取决于您希望如何访问更新。

o适用于 Windows 的 ESET 安全产品 - 可以使用 HTTP 或共享文件夹远程更新它们。

o适用于 Linux/macOS 的 ESET 安全产品 - 只可以使用 HTTP 远程更新它们。如果使用共享文件夹,该文件夹必须和 ESET 安全产品位于同一计算机上。

需要一个脱机许可证文件来激活 Mirror Tool 以及生成更新镜像。您可以在 ESET Business Account 或 ESET PROTECT Hub 中生成脱机许可证文件:

oESET Business Account 中,选中包括用户名和密码复选框。

oESET PROTECT Hub 中,选中允许联机激活复选框。

create_offline_lic_file create_offline_license_file_hub

 

在运行 Mirror Tool 之前,需要安装以下程序包:Microsoft Visual C++ 2022 Redistributable x64

如何使用镜像工具

1.ESET 下载页独立安装程序部分)下载镜像工具。

2.解压缩下载的压缩文件。

3.打开命令提示,然后导航到内含 MirrorTool.exe 文件的文件夹。

4.运行以下命令,以查看镜像工具及其版本的所有可用参数:

MirrorTool.exe --help

 

mirror_tool_help

 


note

Mirror Tool 1.0.x - 所有参数均区分大小写。

Mirror Tool 1.2.x 及更高版本 - 所有参数均不区分大小写。

可以使用参数来创建存储库镜像或模块镜像:

arrow_down_business 存储库和模块镜像的参数

arrow_down_business 存储库特定参数

arrow_down_business 模块特定参数

 

参数

说明

--updateServer

Mirror Tool 创建的文件夹结构不同于 Endpoint 镜像创建的文件夹结构。每个文件夹都包含一组产品的更新文件。


warning

必须在使用镜像的产品的更新设置中,指定更新服务器完整链接(即正确文件夹的完整路径)。

--offlineLicenseFilename

您必须指定指向您的脱机许可证文件的路径(如上所述)。

--mirrorOnlyLevelUpdates

不需要参数。如果已设置,则仅下载级别更新(不会下载微量更新)。在我们的知识库文章中阅读有关更新类型的详细信息。

--mirrorFileFormat


warning

在使用 --mirrorFileFormat 参数前,确保您的环境不包含更低(6.5 及更低版本)和更高(6.6. 及更高版本)ESET 安全产品版本。此参数的错误使用可能导致 ESET 安全产品的错误更新。

可以指定下载哪种类型的更新文件。可能的值(区分大小写):

dat - 如果您的环境仅有 ESET 安全产品版本 6.5 及更低版本,则使用此值。

dll - 如果您的环境仅有 ESET 安全产品版本 6.6 及更高版本,则使用此值。

dylib - 如果你的环境仅使用 ESET 安全产品 macOS 版本 8 及更高版本,则使用此值。

--compatibilityVersion

此可选参数适用于随 ESET PROTECT On-Prem 8.1 及更高版本一起分发的镜像工具。

镜像工具将下载与您在参数自变量中以格式 x.xx.x.x.x 指定的 ESET PROTECT On-Prem 存储库版本兼容的更新文件,例如:--compatibilityVersion 11.1--compatibilityVersion 8.1.13.0

--compatibilityVersion 参数将从镜像中排除自动更新 (uPCU)。如果您需要环境中存在自动更新 (uPCU) 并希望减小镜像大小,请使用 --filterFilePath 参数。


note

要减少从 ESET 存储库下载的数据量,建议您在随 ESET PROTECT On-Prem 9 一起分发的镜像工具中使用新参数:--filterFilePath--dryRun

1.采用 JSON 格式创建过滤器(参见下面的 --filterFilePath)。

2.执行使用 --dryRun 参数运行镜像工具的测试(参见下文),并根据需要调整过滤器。

3.使用 --filterFilePath 参数和定义的下载过滤器,以及 --intermediateRepositoryDirectory--outputRepositoryDirectory 参数运行镜像工具。

4.定期运行镜像工具,以始终使用最新的安装程序。

参数

说明

--filterFilePath

使用此可选参数以根据与镜像工具位于同一文件夹中的 JSON 格式文本文件过滤 ESET 安全产品,例如:--filterFilePath filter.txt

arrow_down_business 过滤器配置说明:

--dryRun

当使用此可选参数时,镜像工具不会下载任何文件,但它会生成一个 .csv 文件(其中列出将要下载的所有程序包)。

 

可以在不带强制参数 --intermediateRepositoryDirectory--outputRepositoryDirectory 的情况下使用此参数,例如:

Windows:MirrorTool.exe --repositoryServer AUTOSELECT --dryRun test.csv

Linux:sudo ./MirrorTool --repositoryServer AUTOSELECT --dryRun test.csv


note

某些 ESET 安装程序是通用于语言的(语言代码为 multilang),即使在 --filterFilePath 中指定了语言,镜像工具也会将它们列在 .csv 文件中。

 

如果使用 --dryRun 参数以及 --intermediateRepositoryDirectory--outputRepositoryDirectory 参数,镜像工具不会清除 outputRepositoryDirectory

--listUpdatableProducts

列出 Mirror Tool 可以为其下载模块更新的所有 ESET 产品(除非使用了 --excludedProducts)。

从版本 Mirror Tool 开始提供该参数:1.0.1294.0 (Windows),1.0.2226.0 (Linux)。

--networkDriveUsername

用于通过 SMB 访问输出目录的用户名(例如 \\hostname)。该参数仅对适用于 Windows 的 Mirror Tool 适用。

--networkDrivePassword

用于通过 SMB 访问输出目录的密码。该参数仅对适用于 Windows 的 Mirror Tool 适用。

Mirror Tool 文件夹结构

默认情况下,如果不指定 --updateServer 参数,则 Mirror Tool 会在 HTTP 服务器上创建此文件夹结构:


important

请勿使用仅采用 HTTP 的镜像服务器

确保本地镜像服务器使用 HTTP 和 HTTPS 协议,或仅使用 HTTPS。如果镜像服务器仅使用 HTTP,则无法使用“软件安装”客户端任务,因为无法从 HTTP 服务器检索 ESET 安全产品的最终用户许可协议。

Mirror Tool 默认文件夹

ESET 安全产品

更新服务器(根据 HTTP 服务器根位置)

mirror/eset_upd/era6

ESET PROTECT On-Prem(所有版本)

要从镜像更新 ESET PROTECT On-Prem 11.1,请将更新服务器设置为 http://your_server_address/mirror/eset_upd/era6

mirror/eset_upd/ep[版本]

适用于 Windows 的 ESET Endpoint Antivirus/Security 版本 6.x(及更高版本)。每个主版本都有其文件夹,例如 ep10 对应于版本 10.x

http://your_server_address/mirror/eset_upd/ep10(对应于版本 10.x 的示例)

mirror/eset_upd/v5

适用于 Windows 的 ESET Endpoint Antivirus/Security 版本 5.x

http://your_server_address/mirror/eset_upd/v5


important

ESET 安全产品策略 Linux/macOS

必须指定 --updateServer 参数并创建其他文件夹,才能从 HTTP 镜像更新适用于 Linux/macOS 的 ESET 安全产品(见下文)。

--updateServer

其他 Mirror Tool 文件夹

ESET 安全产品

更新服务器(根据 HTTP 服务器根位置)

http://update.eset.com/eset_upd/businesslinux

mirror/eset_upd/BusinessLinux

ESET Endpoint Antivirus 对于 Linux

http://your_server_address/mirror/eset_upd/BusinessLinux

http://update.eset.com/eset_upd/serverlinux

mirror/eset_upd/LinuxServer

ESET Server Security 对于 Linux

http://your_server_address/mirror/eset_upd/LinuxServer

http://update.eset.com/eset_upd/businessmac

mirror/eset_upd/BusinessMac

适用于 macOSESET Endpoint Security 版本 7.x+

http://your_server_address/mirror/eset_upd/BusinessMac

http://update.eset.com/eset_mobile/eesa

mirror/eset_upd/EndpointAndroid

ESET Endpoint Security 对于 Android

http://your_server_address/mirror/eset_upd/EndpointAndroid

 

arrow_down_business 语言代码表

要创建镜像,请至少使用最少必需的参数运行镜像工具。以下是一个示例:

MirrorTool.exe --mirrorType regular ^

--intermediateUpdateDirectory c:\temp\mirrorTemp ^

--offlineLicenseFilename c:\temp\offline.lf ^

--outputDirectory c:\temp\mirror

以下是内含所选产品、语言和已启用旧文件下载功能(在 filter.txt 文件中定义)的脱机存储库的更高级配置示例(请参阅上述 --filterFilePath 详细信息中的文件内容示例):

MirrorTool.exe --repositoryServer AUTOSELECT ^

--intermediateRepositoryDirectory c:\temp\repoTemp ^

--outputRepositoryDirectory c:\temp\repository ^

--filterFilePath filter.txt

镜像工具和更新设置

若要自动下载模块更新,可以创建一个运行镜像工具的计划。若要执行此操作,请打开 Web 控制台并导航至客户端任务 > 操作系统 > 运行命令。选择要运行的命令行(包括指向 MirrorTool.exe 的路径)和合理的触发器(如每小时都执行 CRON 0 0 * * * ?*)。您也可以使用 Windows 任务计划程序或 Linux 中的 Cron

若要在客户端计算机上配置更新,请创建新策略并将更新服务器配置为指向您的镜像地址或共享文件夹。


important

如果您使用 HTTPS 镜像服务器,则需要将其证书导入到客户端计算机上受信任的根存储中。请参见 Windows 上的安装受信任的根证书


note

请参阅本知识库文章以设置镜像工具链(配置镜像工具为从其他镜像工具下载更新)。