Skip to content

Latest commit

 

History

History
103 lines (74 loc) · 8.05 KB

readme.zh-Hant.md

File metadata and controls

103 lines (74 loc) · 8.05 KB

如何安裝:

安裝前請檢查要求。​如果這些不符合,SigTool將無法正常運行。

要求:

  • 是給 SigTool <=1.0.2: PHP >=7.0.3 用phar支持(PHP >=7.2.0 建議)。
  • 是給 SigTool 1.0.3: PHP >=7.0.3 (PHP >=7.2.0 建議)。
  • 是給 SigTool v2: PHP >=7.2.0.
  • 所有版本: 至少 >=681 MB 的可用RAM(但是,強烈建議至少 >=1 GB)。
  • 所有版本: 大約 300 MB 的可用磁盤空間(此數字可能因簽名數據庫的迭代而異)。
  • 所有版本: 能夠在 CLI 模式下操作 PHP (例如,命令提示符、終端、shell、bash、等等)。

安裝SigTool的推薦方法是通過Composer。

composer require phpmussel/sigtool

或者,您可以直接從GitHub克隆存儲庫或下載ZIP。


如何使用:

請注意,SigTool不是基於PHP的網絡應用程序(或『web-app』)!​SigTool是基於PHP的CLI應用程序(或『CLI-app』)旨在與終端,shell,等等一起使用。​可以通過使用SigTool.php文件作為第一個參數調用PHP二進制來調用它:

$ php SigTool.php

當調用SigTool時,將顯示幫助信息,列出了在運行SigTool時可以使用的參數。

可以使用的參數:

  • 沒有參數:顯示此幫助信息。
  • x:從daily.cvdmain.cvd中提取簽名文件。
  • p:處理用於phpMussel的簽名文件。

產生的產出是各種phpMussel簽名文件直接從ClamAV簽名數據庫生成,有兩種形式:

  • 可以直接插入在/vault/signatures/目錄的簽名文件。
  • GZ壓縮的簽名文件副本,可用於更新phpMussel/Signatures存儲庫。

輸出直接生成到與SigTool.php相同的目錄中。​源文件和所有臨時工作文件將在操作過程中被刪除(所以,如果您想保留『daily.cvd』和『main.cvd』的副本,您應該在處理簽名文件之前進行複制)。

當使用SigTool生成新簽名文件時,您的電腦的防病毒掃描程序可能會嘗試刪除或隔離新生成的簽名文件。​這有時會發生因為,當您的防病毒執行掃描時,簽名文件可能包含看起來很惡毒的數據。​但是,SigTool生成的簽名文件不包含任何可執行代碼,並且完全是良性的。​如果遇到此問題,可以嘗試暫時禁用防病毒掃描程序,或配置您的防病毒掃描程序將在白名單中包括您的生成新簽名文件的目錄。

如果signatures.dat YAML文件在處理時包含在同一目錄中,版本信息和校驗和將相應更新(所以,當使用SigTool於更新phpMussel/Signatures存儲庫,這應該包括在內)。

注意:如果您是phpMussel用戶,請記住,簽名文件必須是『活性』以便正常工作!​如果您使用SigTool於生成新的簽名文件,您可以通過在phpMussel配置『Active』指令中列出它們來『啟用』它們。​如果您正在使用前端更新頁面來安裝和更新簽名文件,您可以從前端更新頁面直接『啟用』他們。​但是,使用這兩種方法是不必要的。​此外,為了最佳的phpMussel性能,建議您僅使用安裝所需的簽名文件(例如,如果某些特定類型的文件被列入黑名單,您可能不需要與該類型的文件相對應的簽名文件;​分析將被阻止的文件是多餘的工作,可以顯著減慢掃描過程)。

使用SigTool的視頻演示在YouTube上可用: youtu.be/f2LfjY1HzRI


由SigTool生成的簽名文件列表:

簽名文件 說明
clamav.hdb 用於所有文件類型;它使用文件哈希。
clamav.htdb 用於HTML文件;它使用HTML規範化數據。
clamav_regex.htdb 用於HTML文件;它使用HTML規範化數據;簽名可以包含正則表達式。
clamav.mdb 用於PE文件;它使用PE部分元數據。
clamav.ndb 用於所有文件類型;它使用ANSI規範化數據。
clamav_regex.ndb 用於所有文件類型;它使用ANSI規範化數據;簽名可以包含正則表達式。
clamav.db 用於所有文件類型;它使用原始數據。
clamav_regex.db 用於所有文件類型;它使用原始數據;簽名可以包含正則表達式。
clamav_elf.db 用於ELF文件;它使用原始數據。
clamav_elf_regex.db 用於ELF文件;它使用原始數據;簽名可以包含正則表達式。
clamav_email.db 用於EML文件;它使用原始數據。
clamav_email_regex.db 用於EML文件;它使用原始數據;簽名可以包含正則表達式。
clamav_exe.db 用於PE文件;它使用原始數據。
clamav_exe_regex.db 用於PE文件;它使用原始數據;簽名可以包含正則表達式。
clamav_graphics.db 用於圖像文件;它使用原始數據。
clamav_graphics_regex.db 用於圖像文件;它使用原始數據;簽名可以包含正則表達式。
clamav_java.db 用於Java文件;它使用原始數據。
clamav_java_regex.db 用於Java文件;它使用原始數據;簽名可以包含正則表達式。
clamav_macho.db 用於Mach-O文件;它使用原始數據。
clamav_macho_regex.db 用於Mach-O文件;它使用原始數據;簽名可以包含正則表達式。
clamav_ole.db 用於OLE對象;它使用原始數據。
clamav_ole_regex.db 用於OLE對象;它使用原始數據;簽名可以包含正則表達式。
clamav_pdf.db 用於PDF文件;它使用原始數據。
clamav_pdf_regex.db 用於PDF文件;它使用原始數據;簽名可以包含正則表達式。
clamav_swf.db 用於SWF文件;它使用原始數據。
clamav_swf_regex.db 用於SWF文件;它使用原始數據;簽名可以包含正則表達式。

關於簽名文件擴展名:

這些信息將在未來擴大。

  • cedb: 複雜擴展簽名文件(這是為phpMussel創建的格式,並且與ClamAV簽名數據庫無關;​SigTool不使用此擴展名生成任何簽名文件;​這些是為phpMussel/Signatures存儲庫手動編寫的;​clamav.cedb包含了以前版本的ClamAV签名数据库中某些已弃用/过时修改的签名,​被认为对phpMussel具有持续的用处)。​基于由phpMussel生成的扩展元数据的各种规则的签名文件使用此扩展。
  • db: 標準簽名文件(這些是從daily.cvdmain.cvd包含的.ndb簽名文件中提取的)。​這些簽名文件直接與文件內容一起工作。
  • fdb: 文件名簽名文件(ClamAV签名数据库以前支持的文件名签名,但不再是;​SigTool不會使用此擴展名生成任何簽名文件;​因為它被認為對phpMussel是有用)。​這些簽名文件使用文件名。
  • hdb: 哈希簽名文件(這些是從daily.cvdmain.cvd包含的.hdb簽名文件中提取的)。​這些簽名文件使用哈希。
  • htdb: HTML簽名文件(這些是從daily.cvdmain.cvd包含的.ndb簽名文件中提取的)。​這些簽名文件使用HTML標準化內容。
  • mdb: PE部分簽名文件(這些是從daily.cvdmain.cvd包含的.mdb簽名文件中提取的)。​這些簽名文件使用PE部分元數據。
  • medb: PE擴展簽名文件(這是為phpMussel創建的格式,並且與ClamAV簽名數據庫無關;​SigTool不會使用此擴展名生成任何簽名文件;​這些是為phpMussel/Signatures存儲庫手動編寫的)。​這些簽名文件使用PE元數據(除了PE部分元數據)。
  • ndb: 標準化簽名文件(這些是從daily.cvdmain.cvd包含的.ndb簽名文件中提取的)。​這些簽名文件使用ANSI標準化內容。
  • udb: URL簽名文件(這是為phpMussel創建的格式,並且與ClamAV簽名數據庫無關;​SigTool目前不使用此擴展名生成任何簽名文件,但這可能會在將來發生變化;目前,這些是為phpMussel/Signatures存儲庫手動編寫的)。​這些簽名文件使用URL。
  • ldb: 邏輯簽名文件(最終,為未來的SigTool版本,這些將從.ldb簽名文件中提取的,但SigTool或phpMussel尚不支持)。​這些簽名文件使用各種邏輯規則。

最後更新:2021年7月22日。