// ПОСІБНИК КОРИСТУВАЧА

// ДОДАВАННЯ ХОСТУ

Натисніть кнопку + на екрані хостів, щоб додати новий сервер.

Обов'язкові поля

• Hostname / IP — адреса або IP сервера. Підтримуються IPv4 та IPv6.
• Порт — за замовчуванням 22. Змініть, якщо ваш сервер використовує інший SSH-порт.
• Ім'я користувача — Unix-користувач, під яким ви хочете увійти (наприклад ubuntu, root, deploy).
• Автентифікація — оберіть між паролем або SSH ключем (рекомендується).

Перевірка відбитку хосту

При першому підключенні SSHBorg показує відбиток сервера та просить прийняти його. Це перевірка безпеки: вона гарантує, що ви підключаєтесь до правильної машини, а не до зловмисника. Перевірте, що відбиток збігається з наданим адміністратором сервера, перш ніж приймати.

Після прийняття відбиток зберігається локально. Якщо він зміниться при наступному підключенні, SSHBorg попередить вас — це може вказувати на перевстановлення сервера, ротацію ключів або атаку man-in-the-middle.

ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

// ФАЙЛОВИЙ МЕНЕДЖЕР SFTP

Файловий менеджер SFTP дозволяє переглядати, завантажувати, скачувати, перейменовувати та видаляти файли на сервері безпосередньо з телефону. Відкрийте сеанс SFTP з екрана хостів, торкнувшись SFTP.

Навігація

Торкніться папки, щоб відкрити її. Використовуйте стрілку назад або торкніться будь-якого сегмента рядка шляху, щоб піднятися вгору по дереву каталогів.

Символічні посилання відображаються з маленьким значком ланцюжка. Торкання символічного посилання переходить до його цілі: якщо воно вказує на каталог — ви входите до нього; якщо на файл — поводиться як звичайний файл.

Завантаження файлів на сервер

Торкніться кнопки завантаження (↑) щоб вибрати один або кілька файлів зі сховища телефону. Завантаження починається негайно, прогрес відображається у верхній частині екрана.

Скачування файлів і папок

Торкніться будь-якого файлу, щоб одразу його скачати. Щоб скачати цілу папку, торкніться значка скачування поруч з нею — SSHBorg скачає все дерево каталогів і збереже його в папці Завантаження на телефоні.

Якщо файл вже існує в місці призначення, з'явиться діалог із запитом: замінити, пропустити файл або скасувати весь трансфер.

Множинний вибір та пакетні операції

Утримуйте будь-який елемент, щоб увійти в режим вибору, потім торкайтеся інших елементів для додавання до вибору. Панель інструментів показує доступні дії:

• Скачати — скачує всі вибрані файли та папки одночасно з діалогом прогресу та можливістю скасування.
• Видалити — видаляє всі вибрані елементи. Видалення непорожньої папки рекурсивно видаляє весь її вміст. Скасувати цю дію неможливо.

// SSH КЛЮЧІ

Автентифікація за ключем безпечніша за паролі та після налаштування не вимагає нічого запам'ятовувати чи вводити.

Генерація ключа

Перейдіть до Налаштування → SSH ключі → Згенерувати новий ключ. SSHBorg підтримує:

• Ed25519 — рекомендовано. Швидкий, компактний та безпечний.
• ECDSA (P-256 / P-384) — хороша сумісність зі старими серверами.
• RSA (2048 / 4096 біт) — максимальна сумісність, але повільніший.

Дайте ключу значущу назву (наприклад мій-vps або робочий-сервер), щоб легко його знайти пізніше.

Авторизація ключа на сервері

Після генерації ключа натисніть на нього, щоб побачити публічний ключ. Скопіюйте його та вставте у файл ~/.ssh/authorized_keys сервера для потрібного користувача.

1. На телефоні відкрийте SSHBorg → Налаштування → SSH ключі → натисніть на ключ → скопіюйте публічний ключ.
2. Увійдіть на свій сервер (з паролем або іншим ключем, який вже є).
3. Додайте публічний ключ до файлу авторизованих ключів:

   mkdir -p ~/.ssh
   chmod 700 ~/.ssh
   echo "ssh-ed25519 AAAA...вашскопійованийключ..." >> ~/.ssh/authorized_keys
   chmod 600 ~/.ssh/authorized_keys

4. Спробуйте підключитися через SSHBorg — він має увійти без запиту пароля.

Додаткове шифрування ключа

SSHBorg пропонує необов'язкову додаткову парольну фразу для ваших ключів (Налаштування → SSH ключі → натисніть на ключ → Увімкнути шифрування). Коли активовано, ключ шифрується фразою, яку SSHBorg не зберігає — вона запитуватиметься кожного разу при використанні ключа.

Настійно рекомендується, якщо ви зберігаєте конфіденційні облікові дані на телефоні або біометричне блокування вимкнено.

// ПІДКАЗКИ КОМАНД

SSHBorg показує панель підказок над клавіатурою під час введення в терміналі. Підказки беруться з історії оболонки користувача, під яким ви підключились.

Як це працює

При відкритті термінальної сесії SSHBorg читає файл історії оболонки з віддаленого сервера. Перевіряються такі розташування за порядком:

1. ~/.bash_history — за замовчуванням для Bash
2. ~/.zsh_history — за замовчуванням для Zsh (також перевіряється як $HISTFILE, якщо встановлено)
3. ~/.local/share/fish/fish_history — для користувачів Fish shell

Використовується перший існуючий та доступний файл. Під час введення команди фільтруються в реальному часі та відображаються як чіпи на панелі підказок. Натисніть на чіп, щоб вставити команду.

Усунення проблем

Підказки не з'являються

• Файл історії може ще не існувати (перший вхід або оболонка не налаштована для збереження історії).
• Переконайтеся, що ваша оболонка налаштована для збереження історії. Для Bash додайте до ~/.bashrc:

  HISTFILE=~/.bash_history
  HISTSIZE=10000
  HISTFILESIZE=20000

• Для Zsh додайте до ~/.zshrc:

  HISTFILE=~/.zsh_history
  HISTSIZE=10000
  SAVEHIST=10000
  setopt APPEND_HISTORY SHARE_HISTORY

Підказки від неправильного користувача

// ЖЕСТИ ТЕРМІНАЛУ

Термінал реагує на кілька жестів дотику крім введення тексту:

• Прокрутка історії — проведіть вгору або вниз для перегляду буфера прокрутки терміналу.
• Масштабування — зведіть пальці для збільшення або зменшення розміру тексту.
• Копіювання тексту — утримуйте в будь-якому місці терміналу для входу в режим виділення. Перетягніть маркери для налаштування виділеної області, потім натисніть Копіювати вибране для виділеного тексту, або Копіювати все для всього виводу. Торкніться за межами для скасування.
• Вставка — використовуйте кнопку Вставити на панелі додаткових клавіш (видима, коли клавіатура відкрита).

// ПАНЕЛЬ ДОДАТКОВИХ КЛАВІШ

Коли екранна клавіатура відкрита, над нею з'являється ряд кнопок швидкого доступу. Прокрутіть панель горизонтально, щоб побачити всі клавіші.

Клавіші-модифікатори

Ctrl та Alt — це перемикачі з фіксацією: натисніть один, потім натисніть буквену клавішу для надсилання комбінації. Вони автоматично скидаються після наступного натискання клавіші.

• Ctrl+C — перериває процес, що виконується.
• Ctrl+D — надсилає EOF / закриває shell.
• Ctrl+Z — призупиняє процес.
• Ctrl+L — очищає екран.

Режим слів

Іконка перевірки орфографії перемикає клавіатуру між режимом термінала і режимом слів. У режимі термінала (за замовчуванням) автокорекція і підказки слів вимкнені — ідеально для команд і шляхів до файлів. У режимі слів клавіатура поводиться як звичайне текстове поле з увімкненими підказками і автокорекцією. Корисно при введенні природної мови через SSH, наприклад з Claude Code або іншими інтерактивними інструментами.

Навігація та редагування

• ESC — клавіша Escape.
• Tab — автодоповнення shell.
• ↑ ↓ ← → — клавіші зі стрілками.
• Home / End — перейти на початок або кінець рядка.
• PgUp / PgDn — сторінка вгору / сторінка вниз.
• Del — видалення вперед (символ праворуч від курсора).
• Вставити — вставити вміст буфера обміну в термінал.

Функціональні клавіші

Прокрутіть панель праворуч, щоб дістатися клавіш від F1 до F12.

// AGENT FORWARDING

SSH agent forwarding дозволяє використовувати ключі, збережені в SSHBorg, для автентифікації додаткових з'єднань, зроблених зсередини віддаленого сервера — наприклад, для git clone приватного репозиторію або для переходу на другу машину.

Увімкнення forwarding у SSHBorg

При додаванні або редагуванні хосту увімкніть перемикач Agent forwarding. SSHBorg діятиме як SSH агент для цієї сесії.

Налаштування на сервері

Сервер має дозволяти agent forwarding. Перевірте /etc/ssh/sshd_config:

AllowAgentForwarding yes

Це значення за замовчуванням на більшості систем. Після зміни перезапустіть SSH-демон:

sudo systemctl restart sshd

Налаштування клієнта для хосту (необов'язково)

Якщо ви також підключаєтесь до цього сервера з ноутбука або комп'ютера, можна постійно налаштувати forwarding у локальному ~/.ssh/config:

Host myserver
    HostName 203.0.113.42
    User ubuntu
    ForwardAgent yes

// ОБРИВИ З'ЄДНАННЯ ТА ТЕРМІНАЛЬНІ МУЛЬТИПЛЕКСОРИ

SSH — це активне TCP-з'єднання між вашим телефоном і сервером. Якщо з'єднання перервалося — навіть на секунду — сесія та все, що в ній виконувалося, втрачається.

Чому з'єднання обриваються на мобільному

Мобільні мережі особливо схильні до обривів з'єднання з кількох причин:

• Зміна IP-адреси — під час подорожі або зміни вежі оператор може призначити вам нову публічну IP. Оскільки TCP-з'єднання прив'язані до IP-адреси, існуюча SSH-сесія стає недійсною негайно.
• Перехід Wi-Fi ↔ мобільні дані — перемикання між Wi-Fi мережею та мобільними даними (або навпаки) змінює вашу IP і розриває будь-яке відкрите TCP-з'єднання.
• Таймаути бездіяльності — оператори та NAT-роутери часто закривають неактивні з'єднання через кілька хвилин. Активні але мовчазні сесії (спостереження за логами, очікування введення) вразливі до цього.
• Втрата сигналу — тунелі, підземні паркінги або просто слабкий сигнал можуть короткочасно перервати мережу, чого достатньо для завершення сесії.

Рішення: tmux або screen

Термінальний мультиплексор запускає постійну сесію на сервері, повністю незалежну від вашого SSH-з'єднання. Якщо з'єднання обривається, сесія та все, що в ній виконується, продовжує працювати. Після повторного підключення ви відновлюєте сесію і знаходите все точно так, як залишили.

Це найкорисніша звичка для тих, хто керує серверами з телефону.

Швидкий старт з tmux

tmux доступний на більшості сучасних дистрибутивів Linux і є рекомендованим вибором.

# Запустити нову іменовану сесію
tmux new -s work

# Від'єднатися від сесії (залишити її працювати)
Ctrl+B, потім D

# Переглянути запущені сесії
tmux ls

# Приєднатися до сесії
tmux attach -t work

# Приєднатися до останньої сесії
tmux attach

Швидкий старт з screen

screen старіший, але доступний практично на кожній Unix-системі, включаючи мінімальні серверні образи, де tmux може бути не встановлений.

# Запустити нову іменовану сесію
screen -S work

# Від'єднатися від сесії
Ctrl+A, потім D

# Переглянути запущені сесії
screen -ls

# Приєднатися до сесії
screen -r work

Рекомендований робочий процес на мобільному

1. Підключіться до сервера через SSHBorg.
2. Негайно запустіть або відновіть сесію tmux/screen: tmux attach || tmux new -s main
3. Виконуйте команди всередині мультиплексора.
4. Якщо з'єднання обірвалося, просто підключіться знову — ваша сесія все ще там.

// JUMP HOSTS

Jump host (також відомий як bastion host) — це проміжний сервер, через який потрібно пройти, щоб дістатися до цільового сервера, який не доступний безпосередньо з інтернету. SSHBorg нативно підтримує одно- та багаторівневі ланцюги переходів.

Налаштування jump host у SSHBorg

1. Додайте проміжний сервер як звичайний хост у SSHBorg (наприклад bastion).
2. Додайте цільовий сервер як інший хост.
3. У налаштуваннях цільового хосту встановіть Jump host на створений bastion.
4. Увімкніть Agent forwarding для запису bastion — це дозволяє вашому ключу пересилатися через bastion для автентифікації на цілі.

Багаторівневі ланцюги

Якщо потрібно пройти через кілька проміжних серверів (наприклад інтернет → bastion → dmz → target), створіть запис для кожного переходу та з'єднайте їх ланцюгом:

• bastion — без jump host, agent forwarding увімкнено
• dmz — jump host = bastion, agent forwarding увімкнено
• target — jump host = dmz

Еквівалентне ручне налаштування (для довідки)

Еквівалентне налаштування у ~/.ssh/config на комп'ютері виглядає так:

Host bastion
    HostName bastion.example.com
    User admin
    ForwardAgent yes

Host target
    HostName 10.0.1.50
    User ubuntu
    ProxyJump bastion
    ForwardAgent yes

З цим налаштуванням ssh target на ноутбуці прозоро переходить через bastion.

Вимоги до брандмауера

• Телефон має мати доступ до bastion по його SSH-порту (зазвичай 22).
• Bastion має мати доступ до target по його SSH-порту.
• Target не повинен бути доступний безпосередньо з вашого телефону.

// КІЛЬКА СЕСІЙ

SSHBorg дозволяє одночасно тримати відкритими кілька SSH-термінальних сесій та сесій файлового менеджера SFTP, навіть до різних серверів.

• Відкрийте сесію з екрану хостів, натиснувши Термінал або SFTP.
• Перемикайтеся між відкритими сесіями за допомогою селектора сесій у верхній частині екрану.
• Сесії залишаються активними у фоновому режимі, поки мережеве з'єднання триває.
• Список хостів показує маленький значок біля кожного хосту з кількістю активних SSH та SFTP сесій, щоб одразу бачити, що відкрито.

// БЕЗПЕКА ЗАСТОСУНКУ

Біометричне блокування

Увімкніть біометричне блокування в Налаштування → Безпека → Біометричне блокування. Коли активовано, SSHBorg вимагає відбиток пальця або розпізнавання обличчя перед показом будь-яких хостів, облікових даних або даних сесії.

Ви можете встановити таймаут бездіяльності — після цієї кількості хвилин у фоновому режимі застосунок автоматично заблокується.

Захист знімків екрана

За замовчуванням SSHBorg блокує знімки екрана та запис екрана, щоб конфіденційний вміст терміналу не потрапив через екран останніх застосунків або інструменти захоплення екрана.

Якщо потрібно зробити знімок (наприклад, щоб поділитися виведенням терміналу), можна тимчасово вимкнути захист у Налаштування → Безпека → Дозволити знімки.

Зберігання облікових даних

Всі облікові дані (паролі, приватні ключі, парольні фрази) зберігаються в зашифрованому вигляді за допомогою Android Keystore — апаратно захищеного сховища, доступного на Android 10+. Вони ніколи не записуються на зовнішнє сховище і не передаються нікуди.

// РЕЗЕРВНЕ КОПІЮВАННЯ КОНФІГУРАЦІЇ

SSHBorg може експортувати та імпортувати конфігурації хостів у форматі JSON. Це дозволяє перенести список серверів на інший пристрій або зберегти портативну резервну копію налаштувань.

Експорт

Перейдіть до Налаштування → Резервна копія → Експортувати хости. Виберіть місце збереження файлу за допомогою системного вибору файлів. За замовчуванням файл називається sshborg_hosts.json.

Імпорт

Перейдіть до Налаштування → Резервна копія → Імпортувати хости. Виберіть файл .json, попередньо експортований (або створений вручну). SSHBorg об'єднає його з наявним списком хостів:

• Хости, назва яких збігається з наявним записом, оновлюються.
• Хости з новою назвою додаються.
• Хости, відсутні у файлі, залишаються без змін.

Формат JSON

Експортований файл є звичайним об'єктом JSON. Його можна також створити вручну для масового імпорту списку серверів з іншого джерела.

{
  "version": 1,
  "exported_at": "2026-05-14T10:00:00Z",
  "hosts": [
    {
      "label":           "Мій VPS",
      "hostname":        "203.0.113.42",
      "port":            22,
      "username":        "ubuntu",
      "agentForwarding": false,
      "jumpMode":        "simple",
      "jumpHosts":       null,
      "jumpHostIdList":  null,
      "portForwardings": null,
      "sftpStartMode":   "last",
      "sftpStartDir":    null
    }
  ]
}

Довідник полів

• label — назва, що відображається в SSHBorg. Використовується як унікальний ключ для об'єднання при імпорті. Обов'язкове.
• hostname — адреса або IP сервера (IPv4 або IPv6). Обов'язкове.
• port — порт SSH. За замовчуванням: 22.
• username — ім'я користувача для входу. Обов'язкове.
• agentForwarding — true для увімкнення пересилання SSH-агента. За замовчуванням: false.
• jumpMode — "simple" (використовує текст jumpHosts) або "host_list" (використовує внутрішні ID SSHBorg). Використовуйте "simple" під час ручного створення файлу.
• jumpHosts — список jump-хостів через кому у форматі [користувач@]хост[:порт]. Використовується лише коли jumpMode — "simple".
• portForwardings — правила локального переспрямування портів через новий рядок у синтаксисі SSH -L, напр. "8080:localhost:8080".
• sftpStartMode — початкова директорія SFTP: "last" (запам'ятати останню відвідану), "fixed" (завжди використовувати sftpStartDir), "home" (домашня директорія сервера). За замовчуванням: "last".
• sftpStartDir — шлях для використання, коли sftpStartMode — "fixed".