Установка
Агент поставляется одним файлом без зависимостей: nurl.exe на Windows и nurl на Linux и macOS. Ставится за минуту одной командой.
Системные требования.
- Windows 10 или 11, 64 бита (x86_64).
- Linux на x86_64: любой дистрибутив, агент собран статически и не зависит от версии glibc.
- macOS на Apple Silicon (M1 и новее) или Intel.
Linux на ARM (Raspberry Pi, серверы на ARM) пока не поддерживается.
Windows#
Откройте PowerShell или Windows Terminal и выполните:
irm https://nurl.pw/install.ps1 | iexСкрипт скачает последнюю версию агента с сервера Nurl, сверит контрольную сумму SHA-256, положит nurl.exe в %LOCALAPPDATA%\nurl\bin и добавит эту папку в PATH пользователя. Права администратора не нужны. В этом окне команда nurl доступна сразу, в уже открытых окнах — после их перезапуска.
Команда рассчитана на PowerShell: в обычной командной строке cmd она не сработает.
Linux и macOS#
Откройте терминал и выполните:
curl -fsSL https://nurl.pw/install.sh | shСкрипт сам определит систему и процессор, скачает подходящий файл агента с сервера Nurl и сверит контрольную сумму SHA-256. Если curl нет, подойдёт wget:
wget -qO- https://nurl.pw/install.sh | shКуда ставится агент:
- в
/usr/local/bin, если у вас есть права на запись в эту папку, например вы запустили скрипт от root; - иначе в
~/.local/bin, безsudo.
Если этой папки нет в PATH, скрипт допишет строку export PATH=... в файл настроек оболочки: ~/.zshrc для zsh (по умолчанию на macOS), ~/.bashrc для bash на Linux, ~/.bash_profile для bash на macOS, ~/.profile для остальных оболочек. Новые окна терминала увидят команду nurl сами, а в текущем выполните команду, которую напечатает скрипт, например:
. ~/.zshrcНастройки скрипта задаются переменными окружения перед sh:
curl -fsSL https://nurl.pw/install.sh | NURL_INSTALL_DIR=$HOME/bin shВручную#
Если скрипт запустить нельзя, например на рабочем компьютере с ограничениями, скачайте файл со страницы релизов:
Рядом с каждым файлом лежит .sha256 с контрольной суммой.
Windows:
- Переименуйте файл в
nurl.exe. - Положите в постоянную папку, например
C:\Users\<вы>\bin. - Добавьте эту папку в
PATH: «Пуск» → «Изменение переменных среды текущего пользователя» → переменнаяPath→ «Изменить» → «Создать» → путь к папке. - Откройте новое окно терминала.
Сверить контрольную сумму:
Get-FileHash .\nurl.exe -Algorithm SHA256Linux и macOS: переименуйте файл в nurl, положите в папку из PATH и разрешите запуск. Например, для macOS на Apple Silicon:
mkdir -p ~/.local/bin
mv nurl-0.2.0-aarch64-apple-darwin ~/.local/bin/nurl
chmod +x ~/.local/bin/nurlЕсли ~/.local/bin нет в PATH, добавьте строку export PATH="$HOME/.local/bin:$PATH" в ~/.zshrc или ~/.bashrc и откройте новое окно терминала.
На macOS файл, скачанный через браузер, помечается как загруженный из интернета, и система откажется его запускать. Снимите пометку:
xattr -d com.apple.quarantine ~/.local/bin/nurlСверить контрольную сумму: shasum -a 256 <файл> на macOS, sha256sum <файл> на Linux.
Проверка#
nurl --versionКоманда печатает версию, например nurl 0.2.0. Если терминал отвечает «не является внутренней или внешней командой» (Windows) или command not found (Linux, macOS), папки с агентом нет в PATH или окно терминала открыто до установки.
Обновление#
Агент сам сообщает о новой версии: при запуске туннеля в шапке появляется строка «Обновление: доступна 0.3.0 · nurl update».
nurl updateАгент скачает новую версию, сверит SHA-256 и заменит свой файл. Если сумма не совпала, файл не тронут. Если агент стоит в папке, куда у вас нет прав на запись, например в /usr/local/bin после установки от root, запустите обновление с теми же правами: sudo nurl update. Повторный запуск установочного скрипта тоже ставит последнюю версию поверх старой.
Устаревшие агенты помечаются в панели, в разделе «Сессии».
Удаление#
Перед удалением выполните nurl logout, чтобы отозвать токен на сервере.
Windows. Удалите папку %LOCALAPPDATA%\nurl и уберите %LOCALAPPDATA%\nurl\bin из PATH пользователя. Если ставили вручную, удалите nurl.exe и уберите его папку из PATH. Вход в аккаунт хранится отдельно, в %APPDATA%\nurl\config.json: удалите папку %APPDATA%\nurl.
Linux и macOS. Удалите файл агента и папку со входом:
rm "$(command -v nurl)"
rm -rf ~/.config/nurlЕсли задана переменная XDG_CONFIG_HOME, вход хранится в $XDG_CONFIG_HOME/nurl.
Если скрипт дописывал PATH в ~/.zshrc, ~/.bashrc, ~/.bash_profile или ~/.profile, удалите эту строку.