Installing a package
You can install a package from GitHub Packages and use the package as a dependency in your own project.
You can install any package that you have permission to view.
GitHub Packages is available with GitHub Free, GitHub Pro, GitHub Free for organizations, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server 3.0 or higher, and GitHub AE.
GitHub Packages is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access registries that support granular permissions, because these accounts are billed by repository. For the list of registries that support granular permissions, see «About permissions for GitHub Packages.» For more information, see «GitHub’s products.»
About package installation
You can search on GitHub.com to find packages in GitHub Packages that you can install in your own project. For more information, see «Searching for packages.»
After you find a package, you can read the package’s description and installation and usage instructions on the package page.
Installing a package
You can install a package from GitHub Packages using any supported package client by following the same general guidelines.
- Authenticate to GitHub Packages using the instructions for your package client. For more information, see «Introduction to GitHub Packages.»
- Install the package using the instructions for your package client.
For instructions specific to your package client, see «Working with a GitHub Packages registry.»
Help us make these docs great!
All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.
Скачивание и использование инструментов с GitHub для начинающих
Наверное, каждый пробовал скачивать утилиты с GitHub по видео-гайдам из ютуба «Как хакнуть пентагон за секунду« или »бесплатный телеграм скрапер участников». Эти громкие названия действительно работают и ничего не понимающие люди идут скачивать утилиту с GitHub, потому что с её помощью можно взломать подругу и разведать её интимки.
Но нас это не интересует. В гите находится огромное количество инструментов для OSINT, аналогов которым не найти. Сегодня мы глубоко в GitHub лезть не будем, а лишь узнаем, как же использовать этот неиссякаемый инструментарий.
*Внимание, переконцентрация слова GitHub
GitHub — крупнейший веб-сервис для размещения IT-проектов и их совместной разработки. На нем хостятся ваши проекты, утилиты, фотки и что угодно.
На GitHub свыше 100000+ утилит(небольших программ) и каждая по-своему уникальна, отличаются они способом установки и языком программирования, на котором написана сама утилита и, если в зависимости от языка, эта установка меняется кардинально и поэтому приходится разбираться с документацией по установке скрипта(набор строк кода), смотреть гайды по установке или в последнюю очередь — обращаться к людям, знающим язык программирования, на котором написан код.
Так как Python — самый популярный язык и на нем написано много утилит, то сегодня мы рассмотрим установку утилиты на python — https://github. com/Red-company/RDDoS_Tool
На страничке мы видим: разбор и объяснение про репозиторий(любой проект, размещенный на GitHub); это мы пропускаем и идем к пункту Installing — здесь рассказано, на каких ОС утилита работает (Windows/Linux/MacOs/Termux) .
Первое поле — это обновление пакетов(комплектующих системы) с помощью конкретного пакетного менеджера в ОС линукс
Второе поле — установка GIT
Третье поле — установка утилиты с помощью GIT, также можно и с помощью веб-интерфейса GitHub скачать
Четвертое поле — это переход в директорию(папка в файловой системе)
Пятое поле — это запуск .sh скрипта с помощью Bash
Шестое поле — это запуск основного скрипта с помощью python(язык на котором и написана сама утилита)
Некоторые пункты будут пропущены, потому что не соответствуют структуре ОС
Установка с помощью Windows
Второе, установка GIT, читаем мануал
Третье, скачивание утилиты с GitHub, нажимаем комбинацию клавиш > Win+R пишем > powershell делаем > запустить; переходим на рабочий стол cd «c:\\Users\ваш юзернейм\Desktop\» пишем заветную команду:
Также это можно сделать с помощью веб-интерфейса, на скрине сверху нажимаем Download ZIP и перемещаем из папки Загрузок на рабочий стол
Четвертое, переходим в директорию именно с помощью терминала, но сначала убедитесь, в какой директории вы находитесь и не находитесь ли вы в корневой директории. Для этого используем команду :
Пятое, запускаем установочный скрипт bash setup. sh, но на виндовс он работать не будет, на странице написано, что нужно сделать так, значит делаем вручную как сказано
А также устанавливаем python, потому что это будет нужно для исполнения основного файла ТЫК
Шестое, запускаем сам python скрипт
Установка с помощью Linux
Если у вас пакетный менеджер apt(проверьте методом тыка), то смело делаем все как в установке показано:
Если у вас другой пакетный менеджер, то следуем инструкции дальше!
- 1. Это обновление пакетов, вам нужно посмотреть как обновлять пакеты на вашем линукс-дистрибутиве(разновидность ОС Linux) и обновить
- 2. Установка GIT и опять же посмотрите, как установить GIT на вашем дистрибутиве линукс
- 3.Установка утилиты, тут по аналогии с виндовс действуем:
Переходим в директорию рабочего стола cd $HOME/Desktop/ и устанавливаем:
4. Переход в директорию
5. Исполнение Bash-скрипта, если у вас не пакетный менеджер APT, то устанавливаем пакеты вручную. А знаю я это, потому что нужно посмотреть в код setup. sh и посмотреть, как исполняется этот скрипт и что делает, примерно можно понять, что он делает и для какого ПМ(наиболее популярная утилита управления пакетами для Linux систем) он работает
С помощью вашего ПМ установите python:
6. Запуск скрипта
Как узнать, какой у меня дистрибутив линукс? ТЫК
Установка с помощью Android
Чтобы исполнять код, нам нужно скачать Termux и прочитать, что это такое на вики
Делаем все по аналогии с оригинальной установкой, а также с линуксом, попутно устанавливая git, python, pip, пакеты pip
Установка с помощью MacOS
MacOS в первую очередь основан на Unix, а это значит, что почти все команды у него совпадают с Linux-установкой и поэтому делаем все также, только вместо apt-get используем пакетный менеджер MacOS > brew
Не забываем про установку git, python, pip, пакеты pip, которые по умолчанию должны быть на MacOS, но лучше обезопаситься:
Потренируйтесь
В довесок оставлю здесь небольшую подборку инструментов с GitHub, в установке которых вы можете опробовать свои силы:
Больше можно найти на нашем канале :
Сегодня мы разобрали основные способы установки утилит из GitHub, теперь вы можете смело использовать репозитории, безостановочно публикующиеся в OSINT-каналах.
Как установить программное обеспечение с помощью Git в Linux
Вам сказали «клонировать репо и построить его», и вы не знаете, что делать дальше? Мы покажем вам, как запустить эту программу на GitHub в Linux, даже если вы новичок.
Инструкции, составляющие компьютерную программу, пишутся, редактируются и сохраняются в текстовых файлах. Затем эти файлы обрабатывает программа, называемая компилятором. Этот создает исполняемую версию программы. Текстовые файлы инструкций называются исходным кодом. Версия программы, которая действительно может работать на компьютере, называется двоичной или исполняемой.
Это упрощенная версия событий, но она рисует правильную — если обобщить — картину. На практике вы найдете множество вариантов этой модели. Иногда другие программы создают текстовые файлы. В других случаях исходный код запускается внутри переводчика и не требует компиляции, и так далее.
Однако одна универсальная истина для всех программных проектов заключается в следующем: файлы исходного кода драгоценности короны, и за ними нужно так же тщательно ухаживать.
Программы контроля версий
Все файлы исходного кода в проекте называются базой кода. В крупных проектах над кодовой базой часто работает много разработчиков. Каждое изменение кода необходимо отслеживать и идентифицировать. При необходимости изменения должны быть обратимыми. Если разные разработчики вносят изменения в один и тот же файл исходного кода, их правки необходимо объединить.
Поэтому неудивительно, что существуют программы, называемые системами контроля версий, чтобы упростить управление изменениями в кодовой базе. Системы контроля версий содержат все предыдущие версии каждого файла в базе кода, и каждое изменение записывается, комментируется и отслеживается.
Маленькая штука под названием Git
Линус Торвальдс, создатель ядра Linux, разработал программу контроля версий под названием Git для администрирования кодовой базы ядра Linux. В настоящее время это наиболее широко используемое программное обеспечение для контроля версий. Миллионы людей используют его буквально.
В Git кодовая база проекта хранится в репозиториях. В дополнение к локальным репозиториям, которые находятся на компьютерах разработчика и, возможно, на центральном сервере в сети, рекомендуется иметь внешний или удаленный репозиторий.
И здесь на помощь приходит GitHub.
GitHub
GitHub был создан в результате успеха git. Основатели увидели растущую потребность в безопасных удаленных репозиториях git. Они начали бизнес предоставление облачной платформы чтобы группы разработчиков могли размещать удаленные репозитории. По состоянию на апрель 2019 года на GitHub размещено более 100 миллионов репозиториев.
Если приложение является проектом с открытым исходным кодом, очень высоки шансы, что оно будет размещено на GitHub. Доступны и другие платформы репозиториев, такие как BitBucket и GitLab, но на GitHub приходится львиная доля репозиториев с открытым исходным кодом.
Анатомия репозитория
Репозиторий GitHub состоит из папок, содержащих файлы, такие как важнейшие файлы исходного кода. Обычно в репозитории есть много других типов файлов. Это могут быть файлы документации, страницы руководства, файлы лицензий на программное обеспечение, инструкции по сборке и файлы сценариев оболочки. Нет никаких правил относительно того, что репозиторий должен или должен содержать, но есть соглашения.
Если вы разбираетесь в одной кухне, вы можете ориентироваться на любой кухне. То же самое и с репозиториями. Как только вы поймете условные обозначения, вы поймете, где найти то, что вам нужно.
Итак, как получить копию репозитория на свой компьютер и как встроить программу в двоичный исполняемый файл?
Файл readme
Традиционно включать файл readme в репозиторий. Его можно назвать readme, Readme или README. Он может иметь расширение «.md» или вообще не иметь расширения.
Посмотрим на GitHub репозиторий для редактора Atom. Вы видите длинный список папок и файлов. Прокрутите вниз, и вы увидите содержимое файла README.md.
GitHub автоматически помещает содержимое файла readme на главную страницу репозитория. Если файл readme имеет расширение «.md», он будет содержать Разметка Markdown язык. Это позволяет разработчикам использовать элементы стиля, такие как шрифты, маркеры и изображения.
Как правило, в файле readme есть разделы, в которых рассказывается, о чем идет речь, о типе лицензии, о том, кто поддерживает проект, как принять участие и как создать и запустить приложение.
Если в нем нет фактических инструкций по сборке, он сообщит вам, где найти эту информацию. Другая информация, полезная для создания приложения, такая как необходимые инструменты сборки и другие зависимости, может быть указана здесь, или ссылка может привести вас к этой информации.
Репозиторий коробок
Наша миссия — клонировать репозиторий ящиков, а затем создайте приложение ящиков.
Репозиторий имеет ту же структуру, что и Atom. Там список папок и файлов, а ниже — содержимое файла readme. Он следует стандартной схеме репозитория, но это меньший по размеру проект, поэтому в нем меньше папок и файлов.
Файл readme тоже короче. В нем есть раздел под названием «Разработка». В этом разделе есть ссылка под названием «Построение из исходного кода». Если мы перейдем по этой ссылке, мы должны найти информацию нам нужно.
Обычно для навигации по репозиторию и поиска нужной информации требуется легкое отслеживание, но это не сложно. Внимательно прочтите все на странице репозитория. Иногда информация присутствует, но может не отображаться на видном месте.
Зависимости
На странице «Сборка из исходного кода» есть раздел «Сборка в Linux», и это как раз то, что нам нужно. Он говорит, что мы должны иметь Компилятор C, Бизон, и Flex установлены.
В инструкциях по сборке сказано, что нужно выполнить команду make, поэтому нам также понадобится make.
Инструменты, необходимые для создания этого приложения, — это компилятор C, Bison, Flex, make и Git (для клонирования репозитория на ваш компьютер).
Эта статья была исследована на компьютерах, работающих под управлением дистрибутивов Ubuntu, Fedora и Manjaro Linux. Ни в одном из дистрибутивов не были установлены все эти инструменты — на каждый из них нужно было что-то установить.
Установка набора инструментов
В Ubuntu должны были быть установлены Git, Flex, Bison и make. Вот команды:
В Fedora должны были быть установлены Flex, Bison и make. Вот команды:
На Manjaro должны были быть установлены компилятор GCC, Flex и Bison. Вот команды:
Клонирование репозитория
Каждый репозиторий GitHub имеет определенный веб-адрес, используемый Git для клонирования репозитория на ваш компьютер. На главной странице репозитория ящиков есть зеленая кнопка с надписью «Клонировать или скачать».
Нажмите кнопку, чтобы увидеть веб-адрес. Это адрес, который мы должны передать команде git при клонировании репозитория.
Перейдите в каталог, в который мы хотим клонировать репозиторий, и затем используйте эту команду. Если ваше окно терминала поддерживает это, вы можете скопировать и вставить веб-адрес в команду. Нажмите Ctrl + Shift + V, чтобы вставить в окно терминала GNOME.
Git клонирует удаленный репозиторий и создает на вашем компьютере локальный. Он сообщает нам, что клонируется в каталог под названием «ящики».
Каталог боксов создается в каталоге, из которого вы запустили команду git. Если мы переключимся в каталог box и посмотрим на его содержимое, мы увидим тот же список файлов и папок, который мы видели на странице GitHub.
Большой! Мы успешно клонировали исходный код и другие файлы на наш компьютер. Теперь нам нужно создать приложение.
Сборка приложения
Чтобы собрать приложение, мы должны следовать инструкциям в репозитории GitHub. Иногда мы запускаем определенный файл оболочки, а другие — make. Инструкции по сборке, которым мы следуем, говорят нам запустить make.
Утилита make читает и выполняет набор инструкций из make-файла. Эти инструкции говорят make, как скомпилировать программу и связать ее вместе. make передает инструкции компилятору и другим инструментам сборки.
Команда, которую нам предлагают использовать, вызовет make дважды. Первый вызов make создает приложение, а второй запускает набор тестов.
Команда, которую нам сказали использовать инструкции по сборке:
Многие строки вывода быстро прокручиваются в окне терминала. Примерно через минуту вы вернетесь в командную строку.
Развертывание приложения боксов
Приложение создано, и у нас есть исполняемый двоичный файл. Теперь мы должны скопировать двоичный файл в каталог / usr / bin /. Это позволяет оболочке находить его, когда мы пытаемся его использовать.
Для некоторых приложений это может быть все, что вам нужно сделать. В других случаях вам может потребоваться скопировать дополнительные файлы, такие как страницы руководства и файлы конфигурации, в места в файловой системе. Последнее — то, что мы должны сделать с нашим новым приложением, потому что это было в инструкциях по сборке.
Используйте sudo для запуска этих команд. Первая команда копирует справочную страницу в каталог man1:
Затем скопируйте глобальный файл конфигурации в каталог в / usr / share /:
Наконец, скопируйте двоичный файл в / usr / bin:
Тестирование приложений коробок
Посмотрим, все ли работает! Попытайтесь открыть страницу руководства для команды боксов.
Это воодушевляет! Вы видите страницу руководства, в которой рассказывается, как использовать команду боксов.
Нажмите «Q», чтобы выйти из системы man, и попробуйте использовать команду box.
И получаем ответ:
Это может показаться немного разочаровывающим, учитывая все усилия, которые вы приложили, но суть этого упражнения заключалась в том, чтобы помочь вам вытащить репозиторий из GitHub и построить приложение.
Команда боксов позволяет вам заключать текст, который передается в него, в самые разные фреймы. Некоторые из них можно использовать в качестве комментариев в файлах исходного кода. Приведенный выше формат будет работать, например, как комментарий в файле исходного кода C. Остальные чисто декоративные. Параметр -d (дизайн) позволяет выбрать стиль рамки.
Есть длинный список дизайнов, из которых вы можете выбирать. Чтобы увидеть их все, используйте эту команду:
Сборка завершена
Шаги по сборке из исходного кода обычно просты:
Ознакомьтесь с инструкциями по сборке в репозитории.
Убедитесь, что у вас установлены необходимые инструменты, и установите все, что отсутствует.
Клонируйте репозиторий на свой компьютер.
Следуйте инструкциям по сборке, которые зачастую так же просты, как ввод make.
Скопируйте файл (ы) в нужные места.
Если в инструкциях по сборке есть непонятные шаги, посмотрите, есть ли у проекта форум или сообщество, в которое вы можете отправить вопрос. Если у приложения есть веб-сайт, у них может быть страница «Свяжитесь с нами». Электронная почта разработчика, поддерживающего проект боксов, находится на странице «О программе» сайт коробки. Это щедрый жест с его стороны, типичный для более широкого сообщества разработчиков ПО.
How to install an npm package from GitHub directly
Trying to install modules from GitHub results in this error:
Easily reproduced using express:
npm install https://github.com/visionmedia/express throws error.
npm install express works.
Why can’t I install from GitHub?
Here is the console output:
22 Answers 22
Because https://github.com/visionmedia/express is the URL of a web page and not an npm module. Use this flavor: git+
or this flavor if you need SSH:
or if you need to install a GitHub Enterprise repository:
To install from GitHub, you can also do
There is also support for installing directly from a Gist, Bitbucket, GitLab, and a number of other specialized formats. Look at the npm install documentation for them all.
If Git is not installed, we can try:
As of September 2016, installing from vanilla HTTPS GitHub URLs now works:
You can’t do this for all modules because you are reading from a source control system, which may well contain invalid/uncompiled/buggy code. So to be clear (although it should go without saying): given that the code in the repository is in an npm-usable state, you can now quite happily install directly from GitHub.
In October 2019, we are now living through "peak TypeScript/React/Babel", and therefore JavaScript compilation has become quite common. If you need to take compilation into account, look into prepare . That said, NPM modules do not need to be compiled, and it is wise to assume that compilation is not the default, especially for older node modules (and possibly also for very new, bleeding-edge "ESNext"-y ones).