Посібник користувача

Ласкаво просимо до Pockterm

Що таке Pockterm і як він влаштований

Pockterm — повноцінний клієнт SSH для iPhone. Ви можете підключатися до серверів, працювати в інтерактивному терміналі, передавати файли через SFTP і налаштовувати тунелі переспрямування портів.

Використовуйте вкладки внизу, щоб переходити між розділами Хости, Сніпети, Ключі і Порти.

Усе лишається на вашому пристрої — подробиці див. у розділі Ваші дані та приватність.

Додавання хоста

Створіть сервер, до якого можна підключитися

Створення хоста

• На вкладці Хости торкніться +, потім Новий хост.
• Введіть Мітку, Адресу (ім'я хоста або IP) і Порт (типово 22).
• Виберіть Облікові дані, щоб Pockterm знав, як виконати вхід. Якщо їх ще немає, торкніться Нові облікові дані.
• Торкніться Зберегти.

Дії з хостом

• Торкніться хоста, щоб підключитися.
• Проведіть ліворуч для дій «Змінити», «В обране» або «Видалити».
• Проведіть праворуч і торкніться Файли, щоб переглянути їх через SFTP.

Облікові дані та ключі SSH

Як Pockterm виконує вхід

Облікові дані — це ім'я користувача та спосіб автентифікації: пароль або ключ SSH.

Створення ключа

• На вкладці Ключі торкніться +, виберіть Згенерувати ключ Ed25519… і надайте ключу мітку.
• Pockterm створює пару ключів Ed25519 і зберігає закритий ключ у зв'язці ключів iOS.
• Додайте показаний рядок відкритого ключа до файлу ~/.ssh/authorized_keys на сервері.

Імпорт ключа, який у вас уже є

• На вкладці Ключі торкніться + і виберіть Імпортувати наявний ключ…
• Вставте файл закритого ключа повністю, разом із рядками BEGIN і END. Підтримуються ключі Ed25519 та RSA у форматі OpenSSH.
• Або торкніться Вибрати файл…, щоб вибрати ключ у Файлах.
• Якщо ключ має пароль, Pockterm запитає його один раз і збереже у зв'язці ключів разом із ключем.

Ключ, який починається з -----BEGIN RSA PRIVATE KEY-----, записано у старому форматі PEM. Перетворіть його командою ssh-keygen -p -f <file> — вона перезаписує файл, не змінюючи ключ — і потім імпортуйте.

Створення облікових даних

• У редакторі хоста виберіть Нові облікові дані.
• Введіть ім'я користувача та виберіть Пароль або Ключ.
• Для варіанта Ключ виберіть один зі своїх ключів.

Термінал

Підключення та робота в сесії

Торкніться хоста, щоб відкрити сесію термінала.

• На панелі над клавіатурою є esc, ctrl, tab, клавіші зі стрілками та інше.
• Відкривайте кілька хостів одночасно — кожна сесія є вкладкою вгорі. Торкніться її назви, щоб перемкнутися, або червоного ✕, щоб закрити.
• Торкніться кнопки сніпет, щоб виконати збережену команду в сесії.

Сніпети

Зберігайте та виконуйте багаторазові команди

Сніпети — це команди, якими ви часто користуєтесь.

• На вкладці Сніпети торкніться +, щоб зберегти команду з міткою.
• Під час підключення торкніться кнопки сніпета в терміналі, щоб виконати його.
• Призначте хосту Стартовий сніпет, щоб він виконувався автоматично під час підключення.

Групи, обране та пошук

Тримайте великий список хостів упорядкованим

• У меню Хости виберіть Керування групами. Групи можуть бути вкладеними, а типові облікові дані й порт групи успадковують її хости.
• Призначте хосту групу в редакторі хоста.
• Додайте хост В обране (проведіть ліворуч), щоб закріпити його в розділі «Обране».
• Потягніть донизу, щоб виконати пошук за міткою або адресою. Нещодавно використані хости з'являються в розділі «Нещодавні».

Імпорт із ssh_config

Перенесіть наявні хости

• У меню Хости виберіть Імпорт із ssh_config.
• Вставте текст своєї конфігурації або торкніться Вибрати файл.
• Перегляньте виявлені хости, вимкніть непотрібні, потім торкніться Імпорт.

Pockterm читає налаштування Host, HostName, User і Port. Для кожного імені користувача створюються облікові дані з паролем, щоб ви могли ввести секрет пізніше.

Передавання файлів (SFTP)

Переглядайте, завантажуйте та вивантажуйте файли

Кожен хост має файловий оглядач SFTP. SFTP працює поверх того самого з'єднання SSH, тож нічого додатково налаштовувати не потрібно.

Відкрити огляд

• Торкніться й утримуйте хост і виберіть Огляд файлів.
• Або задайте для хоста Протокол SFTP (файли): тоді дотик відкриває оглядач замість термінала.
• Уже в сесії? Торкніться кнопки папка на верхній панелі термінала.

Завантаження файлу

• Торкніться й утримуйте файл, потім виберіть Завантажити.
• Файл відкриється в меню поширення, тож ви можете надіслати його будь-куди — виберіть Зберегти у Файли, щоб зберегти його, зокрема в iCloud Drive.

Вивантаження файлу

• Торкніться +, потім Вивантажити файл.
• Відкриється власний вибір файлів iPhone, тож ви можете вивантажити файл просто з iCloud Drive, «На iPhone» чи будь-якого іншого місця у «Файлах».
• Файл потрапить до папки, яку ви зараз переглядаєте.

Керування файлами

• Торкніться й утримуйте файл, щоб перейменувати його, змінити його Права або видалити.
• Торкніться +, щоб створити папку. Потягніть донизу, щоб оновити список.
• Торкніться .. угорі, щоб піднятися на каталог вище.

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

Переспрямування портів

Тунелюйте з'єднання через SSH

Переспрямування портів скеровує мережеві з'єднання через сервер SSH.

• Локальний — порт на вашому пристрої переспрямовує на хост, доступний серверу.
• Віддалений — порт на сервері переспрямовує назад на ваш пристрій.
• Динамічне — проксі SOCKS5 на вашому пристрої надсилає кожне з'єднання через сервер.

Запуск переспрямування

• На вкладці Порти торкніться +, щоб додати переспрямування.
• Торкніться рядка, щоб змінити його.
• Торкніться ▶, щоб запустити; стан показує, коли воно активне. Торкніться ⏹, щоб зупинити.

Перевірка ключів хостів

Безпечна довіра до серверів

Під час першого підключення до сервера Pockterm показує відбиток його ключа й просить вас прийняти його. Це називається довірою під час першого використання.

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

Ваші дані та приватність

Де все зберігається

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

• Хости, групи, сніпети та переспрямування зберігаються на вашому пристрої.
• Паролі та закриті ключі зберігаються у зв'язці ключів iOS.
• Довірені ключі хостів запам'ятовуються на вашому пристрої для попереджень, описаних у розділі Перевірка ключів хостів.
• Розмови з асистентом зберігаються на вашому пристрої, по одній на хост, тож чат лишається на місці, коли ви підключаєтеся знову. Торкніться кошика в асистенті, щоб видалити розмову.

ШІ-асистент — єдиний виняток: коли ви ним користуєтесь, відповідний вивід термінала (і будь-які прикріплені файли) надсилається до провайдера моделей, якого ви налаштували — Anthropic, OpenAI, OpenRouter чи Hugging Face — з використанням вашого власного ключа API. Нічого не надсилається, доки ви не скористаєтесь асистентом, а ваш ключ зберігається у зв'язці ключів iOS. Ознайомтеся з політикою приватності свого провайдера, щоб дізнатися, як він обробляє ці дані.