February 26

Ультимативный гайд по работе с софтами

Приветствую всех читателей данной статьи, сразу хочется начать вести свой канал с чего-то сверх полезного и я представляю вам данную статью!

Подписка на мой канал "Бульдозер у клавиатуры" - лучшая мотивация

Здесь вы найдете самую простую, понятную инструкцию, которая поможет вам запускать любые крипто/обычных софтов. Постараюсь максимально простым языком объяснить как все работает и зачем. После прочтения вы получите 100% понимание как с этим работать. P.S статья написана для новичков, поэтому сложными и непонятными терминами грузить тут не собираюсь, если вы разработчик, то некоторые аналогии у вас могут вызвать раздражение, сразу предупредил!

ВАЖНО! Если вы используете Linux/MacOS то спокойно вводите все команды в терминале. Если вы используете Windows то откройте и используйте PowerShell
ВНИМАТЕЛЬНО смотрите на команды которые вводите, множество команд просят указать ваши данные(никнейм, ссылку и т.п)

План:

1. Настройка Github и SSH

1.1 Регистрация

1.2 Генерация SSH и добавление на Github

2. Установка Python

2.1 Python на Windows

2.2 Python на MacOS

2.3 Python на Linux

3. Запуск Python скриптов

3.1 Клонирование репозитория

3.2 Краткая инструкция по работе с терминалом

3.3 Работа с Python скриптами

4. Установка JS/TS скриптов

4.1 Установка на Windows

4.2 Установка на MacOS

4.3 Установка на Linux

5. Запуск и работа с JS/TS скриптами

5.1 Клонирование репозитория

5.2 Краткая инструкция по работе с терминалом

5.3 Работа с JS/TS скриптами

6. Работа софта на сервере

6.1 Покупка сервера

6.2 Подключение к серверу

6.3 Установка SSH, Python/Node, Screen

6.4 Полезные команды для Screen

6.5 Клонирование репозитория и запуск скрипта

6.6 Установка рабочего стола(Опционально)

6.7 Подключение к удаленному рабочему столу

7. Итог

7.1 Donate Support

7.2 My links

Github и SSH ключ

99% софтов находятся на гите(github). Вкратце: Супер удобный и полезный инструмент, с помощью него вы сможете легко устанавливать и обновлять код в софтах

1) Первое что надо сделать это зарегаться на гите

Надеюсь здесь вам не нужна инструкция

Тут уже появляются разные варианты развития событий по установке. Я использую исключительно установку через SSH ключи и в этом гайде будет именно так. Да, вы можете качать zip архивы или через http. Но архивы не обновите, а через http не скачаете закрытые репозитории. Крч SSH идеальное решение

2) Генерация и добавление SSH-ключей на GitHub

Шаг 1: Проверка наличия существующих SSH-ключей

Перед созданием нового SSH-ключа проверь, есть ли у тебя уже сгенерированные ключи:

ls -al ~/.ssh

Если в списке есть файлы id_rsa.pub, id_ecdsa.pub, id_ed25519.pub или аналогичные, значит, SSH-ключ уже есть. Ты можешь использовать его или создать новый.


Шаг 2: Генерация нового SSH-ключа

Если ключей нет или ты хочешь создать новый, используй команду:

ssh-keygen -t ed25519 -C "your_email@example.com"

После запуска появятся такие вопросы:

  • "Enter file in which to save the key" — Нажми Enter, чтобы сохранить ключ в ~/.ssh/id_ed25519.
  • "Enter passphrase" — Введи свой пароль, после повтори его. P.S ввод пароля не отображается * и т.п символами, просто печатай и жми Enter

Ключи будут сохранены в ~/.ssh/id_ed25519 (приватный) и ~/.ssh/id_ed25519.pub (публичный).

Для Windows C:\Users\your_user\.ssh\id_ed25519


Шаг 3: Добавление SSH-ключа в агент SSH

Теперь нужно добавить ключ в ssh-agent, который управляет ключами для подключения

Linux/Mac:

  1. Запусти eval "$(ssh-agent -s)"
  2. Добавь ssh-add ~/.ssh/id_ed25519

Windows:

Чтобы автоматически загружать ключ, запусти SSH-агент:

Start-Service ssh-agent

Добавь ключ в агент:

ssh-add $env:USERPROFILE\.ssh\id_ed25519

Чтобы агент запускался автоматически, введи:

Set-Service ssh-agent -StartupType Automatic


Шаг 4: Копирование SSH-ключа

Скопируй содержимое публичного ключа:

Linux/Mac:

Выведет ключ, полностью копируй его

cat ~/.ssh/id_ed25519.pub

Windows:

Сразу скопирует весь ключ

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard


Шаг 5: Добавление SSH-ключа на GitHub

  1. Перейди в настройки SSH-ключей GitHub.
  2. Нажми "New SSH Key".
  3. В поле "Title" укажи имя компьютера (например, "MacBook Pro" или "Work PC").
  4. Вставь скопированный ключ в поле "Key".
  5. Нажми "Add SSH key".

Шаг 6: Проверка подключения

Чтобы убедиться, что SSH-ключ работает, выполни:

ssh -T git@github.com

Если всё настроено верно, ты увидишь сообщение:

Hi your_github_username! You've successfully authenticated, but GitHub does not provide shell access.

Отлично! Мы настроили SSH ключ. В будущем при смене устройства или если будешь ставить софт на сервер, то проделывай все пункты по новой.

Установка Python

Внимательно прочтите README софта, который хотите ставить. Скорее всего там будет указано какая версия Python вам нужна. Если вы не знаете какую поставить, то ставьте 3.10 или 3.11. Я сам использую 3.10.11 или 3.11.7

Python на Windows

Шаг 1: Скачивание установщика

  1. Перейди на официальный сайт Python:
    🔗 https://www.python.org/downloads/
  2. Нажми "Download Python 3.11.x" (установщик .exe для Windows).
  3. Дождись завершения загрузки.

Шаг 2: Установка Python

  1. Запусти скачанный .exe файл.
  2. Обязательно отметь галочку"Add Python to PATH" внизу окна.
  3. Нажми "Install Now" для стандартной установки (рекомендуется).
  4. Дождись окончания установки и закрой установщик.

Шаг 3: Проверка установки

Открой PowerShell или Командную строку (cmd) и введи:

python --version

ИЛИ

python3 --version

Если всё установлено правильно, ты увидишь что-то вроде:

Python 3.11.x


Дополнительно: Обновление PATH (если Python не найден)

Если Python не найден (command not found), добавь его вручную в PATH:

  1. Открой Параметры WindowsСистемаО системеДополнительные параметры системы.
  2. Вкладка Дополнительно → Нажми Переменные среды.
  3. В разделе Системные переменные найди Path → нажми Изменить.
  4. Нажми Новый и добавь путь к Python (обычно это):C:\Users\ТвойПользователь\AppData\Local\Programs\Python\Python311\
  5. Нажми OK и перезапусти терминал.


Python на MacOS

Шаг 1: Скачать установщик Python

  1. Открой официальный сайт Python.
  2. Найди версию Python 3.11.x и нажми "Download macOS 64-bit universal2 installer" (файл .pkg).
  3. Дождись завершения загрузки.

Шаг 2: Установка Python

  1. Открой скачанный .pkg файл.
  2. Нажми "Continue" → "Agree" → "Install".
  3. Введи пароль администратора (если потребуется).
  4. Дождись окончания установки и нажми "Close".

Шаг 3: Проверка установки

Открой Терминал (⌘ + Пробел, введи Terminal, нажми Enter) и введи:

python3 --version

ИЛИ

python3.11 --version

Если установка прошла успешно, ты увидишь:

Python 3.11.x


Шаг 4: Настроить Python как основную версию (если нужно)

По умолчанию в macOS может быть установлен Python 2.x, и команда python может вызывать старую версию.

Чтобы python запускал Python 3.11, выполни в терминале:

echo 'alias python=python3.11' >> ~/.zshrc source ~/.zshrc

Теперь можно проверить:

python --version

Python на Linux

Шаг 1: Обновление системы

Перед установкой лучше обновить пакеты:

В зависимости от вашего дистрибутива вам нужно будет ввести разные команды. 99%, что у вас стоит Ubuntu, а если нет, то скорее всего вы знаете какой пакетный менеджер использовать

Ubuntu:

sudo apt update && sudo apt upgrade -y

Fedora:

sudo dnf update -y

Arch:

sudo pacman -Syu


Шаг 2: Установка Python 3.11 (через пакетный менеджер)

Ubuntu/Debian:

В Ubuntu 22.04 Python 3.11 уже есть, но если его нет:

​sudo apt update

sudo apt install -y software-properties-common

sudo add-apt-repository -y ppa:deadsnakes/ppa

sudo apt update

sudo apt install -y python3.11 python3.11-venv python3.11-dev

Fedora:

sudo dnf install python3.11

Arch:

yay -S python311


Шаг 3: Проверка установки

python3.11 --version

Ожидаемый результат:

Python 3.11.x


Шаг 4: Настройка alias (если нужно python3python)

В некоторых дистрибутивах Python вызывается только через python3. Чтобы сократить команду, можно сделать alias:

echo "alias python=python3.11" >> ~/.bashrc source ~/.bashrc

Теперь python будет автоматически запускать Python 3.11.

Запуск Python скриптов


Повторюсь. Прочти внимательно README софта, скорее всего там есть инструкция по установке и настройке софта

1) Клонирование Репозитория

Первым делом нам надо установить наш софт. Мы ранее поставили SSH и установка будет происходить через SSH.

Шаг 1: Переходим в директорию

Заходим в терминал. Переходим в нужную нам директорию

Краткая инструкция по работе с терминалом:

  • pwd- Выведет где ты сейчас находишься
  • ls- Выведет все файлы в твоем пути
  • D: или C: - Поменяет диск на Windows
  • cd название папки- Перейдет в нужную тебе папку. Допустим я нахожусь в диске D: и пишу cd soft, я перейду в папку soft. Так же можно указать полный путь находясь где угодно. К примеру я в папке C: и чтобы не идти по всем папкам я могу указать cd D:\soft
  • cd .. - Вернется в прошлую папку

Шаг 2: Копируем ссылку
На странице софта на гите жмем зеленую кнопку Code, выбираем SSH, копируем ссылку

Шаг 3: Клонируем репозиторий

Репозиторий клонируется в отдельную папку со своим названием. Если вы находитесь к примеру D:\Soft и клонируете репозиторий с названием MoneyPrinter, то после клонирования, автоматически создатся папка со всеми файлами внутри


В терминале вводим

git clone ССЫЛКА СО ВТОРОГО ШАГА

У нас клонируется репозиторий(скачается папка) и теперь мы можем перейти в нее используя.

cd НАЗВАНИЕ ПАПКИ

Иногда Git может быть не установлен на вашем устройстве и выдавать ошибку

Для Windows/MacOS:

Скачайте гит с оф.сайта

Перезапустите терминал/ребутнитесь и попробуйте снова клонировать репозиторий

Для Linux(ubuntu):

sudo apt install git

2) Работа со скриптами


После успешного клонирования репозитория нам надо как-то работать с софтами. Здесь я приведу самый распространенный и часто используемый сценарий

Шаг 1: Переходим в директорию с софтом

Вы должны убедиться, что находитесь в директории с софтом. Для этого используйте pwd и ls

Если вы находитесь к примеру D:\Soft, а ваш софт находится в папке MoneyPrinter, то перейдите в нее с помощью cd MoneyPrinter

Шаг 2: установка виртуального окружения

Советую ставить виртуальное окружение под каждый отдельный софт. Это поможет вам избежать ошибок в зависимостях

Вы можете указать более точную версию Python для установки виртуального окружения, после именно эта версия будет использовать в виртуальном окружении. (Смотрите какую версию Python просит ваш скрипт

Linux/MacOS:

python3.11 -m venv venv- Создаем виртуальное окружение(папку) с названием venv и указываем версию python 3.11

source venv/bin/activate - Активируем виртуальное окружение

Windows:

py -3.11 -m venv venv - Создаем виртуальное окружение(папку) с названием venv и указываем версию python 3.11

venv\Scripts\activate - Активируем виртуальное окружение

P.S deactivate - Деактивирует виртуальное окружение(выходит с него)

Шаг 3: Установка зависимостей

Проверьте, что вы в виртуальном окружении, в начале строки должно писаться (venv)

Устанавливаем зависимости:

pip install -r requirements.txt

Установка pip (если не установился)

Python идёт с pip (менеджер пакетов), но если он отсутствует, установи его вручную:

python -m ensurepip --default-pip
Проверь установку pip:

pip --version

Тут тоже внимательно, бывает необходимости установки доп.модулей по тупи playwright. Читайте README

Шаг 4: Работа с софтом

Тут я приведу список команд которые помогут вам работать с вашим софтом:

  • python main.py- Запустит софт для работы(98% софтом запускается именно так)
  • Нажатие клавиш CTRL + C - остановит выполнения софта
  • git pull - Обновит софт до последней версии

Установка JS/TS скриптов

Windows:

Шаг 1: Установка Node.js

  1. Перейди на официальный сайт:
    🔗 https://nodejs.org/en/download
  2. Скачай LTS-версию (Windows Installer .msi)
  3. Открой скачанный .msi файл
  4. Установи, оставляя настройки по умолчанию
  5. После установки перезапусти терминал (PowerShell или CMD)

Шаг 2: Проверка установки

Открой PowerShell (Win + X → Terminal) и введи:

node -v

Ожидаемый результат (пример):

v18.17.0

Проверяем npm:

npm -v

Вывод:

9.6.1


macOS

Шаг 1: Установка Node.js через официальный сайт

  1. Открываем официальный сайт
  2. Скачиваем LTS-версию (.pkg)
  3. Запускаем установщик и следуем инструкциям
  4. После установки перезапускаем терминал

Шаг 1: Альтернативный способ через Homebrew

Если используешь Homebrew, то проще:

brew install node

Шаг 2: Проверка установки

node -v

npm -v


Linux (Ubuntu/Debian/Arch)

Шаг 1: Установка Node.js

Ubuntu/Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt install -y nodejs

Arch Linux

sudo pacman -S nodejs npm

Шаг 2: Проверка

node -v npm -v

Запуск и работа с JS/TS скриптами

Повторюсь. Прочти внимательно README софта, скорее всего там есть инструкция по установке и настройке софта

1) Клонирование Репозитория

Первым делом нам надо установить наш софт. Мы ранее поставили SSH и установка будет происходить через SSH.

Шаг 1: Переходим в директорию

Заходим в терминал. Переходим в нужную нам директорию

Краткая инструкция по работе с терминалом:

  • pwd- Выведет где ты сейчас находишься
  • ls- Выведет все файлы в твоем пути
  • D: или C: - Поменяет диск на Windows
  • cd название папки- Перейдет в нужную тебе папку. Допустим я нахожусь в диске D: и пишу cd soft, я перейду в папку soft. Так же можно указать полный путь находясь где угодно. К примеру я в папке C: и чтобы не идти по всем папкам я могу указать cd D:\soft
  • cd .. - Вернется в прошлую папку

Шаг 2: Копируем ссылку
На странице софта на гите жмем зеленую кнопку Code, выбираем SSH, копируем ссылку

Шаг 3: Клонируем репозиторий

Репозиторий клонируется в отдельную папку со своим названием. Если вы находитесь к примеру D:\Soft и клонируете репозиторий с названием MoneyPrinter, то после клонирования, автоматически создатся папка со всеми файлами внутри


В терминале вводим

git clone ССЫЛКА СО ВТОРОГО ШАГА

У нас клонируется репозиторий(скачается папка) и теперь мы можем перейти в нее используя.

cd НАЗВАНИЕ ПАПКИ

Иногда Git может быть не установлен на вашем устройстве и выдавать ошибку

Для Windows/MacOS:

Скачайте гит с оф.сайта

Перезапустите терминал/ребутнитесь и попробуйте снова клонировать репозиторий

Для Linux(ubuntu):

sudo apt install git

2) Работа со скриптами


После успешного клонирования репозитория нам надо как-то работать с софтами. Здесь я приведу самый распространенный и часто используемый сценарий

Шаг 1: Переходим в директорию с софтом

Вы должны убедиться, что находитесь в директории с софтом. Для этого используйте pwd и ls

Если вы находитесь к примеру D:\Soft, а ваш софт находится в папке MoneyPrinter, то перейдите в нее с помощью cd MoneyPrinter

Шаг 2: Устанавливаем зависимости и запуска софт

npm install - Установит зависимости для работы

npm start - Запустит выполнение

Тут я приведу список команд который поможет вам работать с вашим софтом:

  • Нажатие клавиш CTRL + C - остановит выполнения софта
  • git pull - Обновит софт до последней версии

Работа софта на сервере

Очень часто необходимо, чтобы софт работал долгое время. Ставить его на свой комп не хочется, тогда нам помогут сервера. Дальше по гайду мы купим сервак, подключимся к нему, поставим софт, запустим его. И настроим так, чтобы при следующем подключению к северу вы могли вернутся к вашему софту и посмотреть его логи или же отключить

ВАЖНО!

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

1) Покупка и подключение к серверу

Шаг 1: Выбор хостинга

Очень много вариантов сайта с хостингами, рекомендую выбирать проверенный временем и с отличными отзывами.

Лично я в последнее время пользуюсь:

Aeza

DYOR как говорится

Заходим, регаемся, пополняем балик

Шаг 2: Покупка сервера

Переходим в "Виртуальный сервер" и выбираем сервак на свой вкус и цвет.

ОС выбираем Ubuntu, бэкапы отрубаем

Разницы особой нет, что больше по душе, то и берите. Если в софте не используются прокси, то учтите, что IP будет использоваться сервера.

Но какой выбрать по мощности?

Если вам нужно запускать какой-то простой python скрипт, который не использует эмуляцию браузера(к примеру playwright), то можете брать самый дешевый с 1 ядром и 2гб оперативы. Если использует, то лучше взять подороже.

Так же если у вас в планах запускать множество софтов на серваке, то тоэе лучше взять помощнее.

Шаг 3: Подключение к серверу

После создания сервера во вкладке "Мои услуги" вы найдете все нужные данные для подключения к серверу(ip, password)

  1. Откройте Терминал или PowerShell для Windows.
  2. Введите команду: ssh root@IP-адрес Например ssh root@192.168.1.100
  3. Введите yes, если запрашивается подтверждение.
  4. Введите пароль и нажмите Enter.

Шаг 4: Установка SSH, python, screen

После успешного коннекта к серверу нам нужно

1) Сгенерировать SSH ключ и подключить его к гиту

2) Установить Python/Node

3) Установить Screen

Screen - супер удобная штука с помощью которой при перезаходе на сервер вы можете вернутся к вашему софту и отключить/проверить его при необходимости


Теперь установите screen, если он еще не установлен:
sudo apt install screen

Полезные команды для screen:

  • нажав Ctrl + A, затем D - Выход из screen
  • screen -ls - Выведет все ваши доступные screen
  • screen -r НАЗВАНИЕ - подключит к нужному screen
  • screen -S НАЗВАНИЕ - создаст новый screen

ВАЖНО при отключении от сервера всегда выходите с вашего screen CTRL+A+D

Шаг 5: Клонирование репозитория и запуск скрипта

Для Python

Для JS/TS

Шаг 6: Установка рабочей среды(Опционально)

Иногда для работы софта используется Playwright, зачастую программисты настраивают его так, что он даже не открывает браузер и работает без рабочей среды. Но иногда нужно к примеру самому ручками зайти на сайт или что-нибудь нажать именно руками. Для этого можно установить рабочее пространство и подключаться к нему. Но это бывает крайне редко

99% что вам это не нужно, будьте уверены, что вам необходимо использовать виртуальный рабочий стол. Не загружайте свой сервер просто так


Установи xrdp и среду рабочего стола
sudo apt update && sudo apt upgrade -y

sudo apt install xrdp -y

Теперь нужно выбрать рабочее окружение. Если у тебя сервер без GUI, установи
легковесную среду (например, Xfce):
sudo apt install xfce4 xfce4-goodies -y

echo "xfce4-session" > ~/.xsession

Добавь пользователя xrdp в группу ssl-cert, чтобы он мог работать с GUI:
sudo adduser xrdp ssl-cert

Перезапусти xrdp:
sudo systemctl restart xrdp

sudo systemctl enable xrdp

Проверь, что xrdp слушает на 3389 порту:
sudo netstat -tulpn | grep xrdp

Открой порт 3389 в брандмауэре (если включен UFW)
sudo ufw allow 3389/tcp

sudo ufw reload

Подключение к удаленному рабочему столу

Windows:

  1. Открой Подключение к удаленному рабочему столу (Remote
    Desktop Connection, mstsc)
  2. введи IP-адрес сервера
  3. Введи логин и пароль пользователя Ubuntu,
  4. выбери Xfce в качестве рабочего окружения.

Mac:

  1. Установите Microsoft Remote Desktop из Mac App Store.
  2. Откройте программу и добавьте новое подключение.
  3. Введите IP-адрес Ubuntu, имя пользователя и пароль.
  4. Подключитесь.

Linux:

  1. Установите клиент RDP (например, remmina): sudo apt install remmina -y
  2. Откройте Remmina, выберите тип подключения RDP, укажите IP-адрес и учетные данные.
  3. Подключитесь.

Вот весь гайд и подошел к концу. Собрал всю самую полезную информацию и постарался максимально понятное все показать и объяснить, надеюсь, что вам было полезно!

Donate EVM:
0x7AE96311BEd9Fc1a32Eb99f1d62E9C2aA088bb38

Donate TRX:
TD6JnRN94C4sm313t7xDS9JKQkCypLhcJo

Donate SOL:
HgoYUmW6T6JFPCJjUvA21F5UmJ64dmWozVvcYGaxhENu

My links:

Github

TG Channel