Установка

Cyberstrike можно установить через несколько менеджеров пакетов. Выберите метод, наиболее подходящий для вашей среды разработки.

npm (Рекомендуется)

Рекомендуемый метод установки для большинства пользователей.

npm install -g @cyberstrike-io/cyberstrike@latest

Проверьте установку:

cyberstrike --version

Bun Скоро

Поддержка Bun пока недоступна.

Homebrew (macOS) Скоро

Поддержка Homebrew пока недоступна.

curl (Linux/macOS)

Прямая установка через shell-скрипт:

curl -fsSL https://cyberstrike.io/install | bash

iwr (Windows/Powershell)

Выполните скрипт установки:

iwr -useb https://cyberstrike.io/install.ps1 | iex

Docker

Проверка установки

После установки убедитесь, что Cyberstrike работает:

# Проверить версию
cyberstrike --version

# Список доступных команд
cyberstrike --help

Вы должны увидеть баннер Cyberstrike и номер версии, а затем список доступных команд.

Обновление Cyberstrike

Обновление до последней версии:

# npm
npm update -g @cyberstrike-io/cyberstrike@latest

# Самообновление (рекомендуется)
cyberstrike upgrade

Удаление

Удаление Cyberstrike из системы:

# npm
npm uninstall -g @cyberstrike-io/cyberstrike@latest

Конфигурация хранится в ~/.config/cyberstrike/ (учётные данные в ~/.local/share/cyberstrike/) и может быть удалена вручную при необходимости.

Устранение неполадок

Команда не найдена

Если cyberstrike не найден после установки:

1. Проверьте, что PATH включает глобальный каталог bin npm
2. Перезапустите терминал
3. Выполните npm bin -g для поиска глобального пути bin

Ошибки прав доступа

На Linux/macOS при возникновении ошибок прав доступа:

# Исправление прав npm
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Конфликты версий

Если у вас несколько версий Node:

# Используйте nvm для управления версиями
nvm use 20
npm install -g @cyberstrike-io/cyberstrike@latest

Корпоративные сети (SSL-инспекция / Zscaler)

В корпоративной сети с SSL-инспекцией (Zscaler, Netskope и подобные) исходящий HTTPS перехватывается и переподписывается корневым сертификатом компании. Если Cyberstrike не доверяет этому сертификату, проверка TLS завершается ошибкой, и вы увидите сообщения вроде:

error: unable_to_get_issuer_cert_locally  downloading package manifest @cyberstrike-io/plugin
hackbrowser:navigator  TypeError: unable to get local issuer certificate — planPage failed, retrying once

Сканер HackBrowser особенно подвержен этой проблеме: его вызовы планировщика завершаются ошибкой, поэтому сканирование обрабатывает лишь несколько страниц и останавливается рано.

Решение — добавьте доверие к корпоративному корневому CA через NODE_EXTRA_CA_CERTS. Корпоративный корневой сертификат уже находится в хранилище доверия вашей ОС (поэтому ваш браузер работает), поэтому экспортируйте хранилище в PEM-пакет и укажите Cyberstrike на него. Это автоматически распространяется на рабочий процесс HackBrowser.

Windows (PowerShell) — экспорт всех корневых CA компьютера (корпоративный включён, определять его не нужно):

$out = "$env:USERPROFILE\corp-ca.pem"
Get-ChildItem Cert:\LocalMachine\Root | ForEach-Object {
  "-----BEGIN CERTIFICATE-----"
  [Convert]::ToBase64String($_.RawData, 'InsertLineBreaks')
  "-----END CERTIFICATE-----"
} | Set-Content -Encoding ascii $out

$env:NODE_EXTRA_CA_CERTS = $out       # текущая сессия
setx NODE_EXTRA_CA_CERTS "$out"       # сохранить для новых сессий

macOS:

security find-certificate -a -p /Library/Keychains/System.keychain > ~/corp-ca.pem
security find-certificate -a -p /System/Library/Keychains/SystemRootCertificates.keychain >> ~/corp-ca.pem
export NODE_EXTRA_CA_CERTS=~/corp-ca.pem

Затем запустите Cyberstrike в том же терминале. Ошибки unable to get local issuer certificate должны исчезнуть, а сканирование должно завершаться полностью.