Руководство пользователя

Добро пожаловать в 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, клавиши со стрелками и другое.
• Открывайте несколько хостов сразу — каждая сессия представлена вкладкой сверху. Нажмите её название для переключения или красный ✕, чтобы закрыть.
• Нажмите кнопку сниппет, чтобы выполнить сохранённую команду в сессии.

Очки и внешние экраны

Терминал на большом экране

Подключите видеоочки, например VITURE, или монитор либо телевизор — и терминал переедет на этот экран целиком. На телефоне останутся клавиатура и панель клавиш, а на месте терминала появятся файлы сессии.

• Ничего включать не нужно: подключите экран и откройте сессию.
• Если сессия не открыта или свёрнута, очки предложат открыть её на телефоне.
• Нажмите AA вверху, чтобы уменьшить или увеличить текст на очках. Pockterm запомнит размер отдельно от масштаба щипком на телефоне.
• Нажмите кнопку буфера обмена вверху, чтобы вставить текст в терминал. С клавиатуры работает и ⌘V.
• PgUp и PgDn на панели клавиш листают постранично то, что ушло за край экрана очков.
• Если вы скрыли клавиатуру, нажмите кнопку клавиатуры вверху, чтобы вернуть её.
• Отключите экран — и терминал вернётся на телефон.

Сниппеты

Сохраняйте и запускайте многократно используемые команды

Сниппеты — это команды, которыми вы часто пользуетесь.

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

Группы, избранное и поиск

Держите большой список хостов в порядке

• В меню Хосты выберите Управление группами. Группы можно вкладывать друг в друга, а учётные данные и порт группы по умолчанию наследуются её хостами.
• Назначьте хосту группу в редакторе хоста.
• Добавьте хост В избранное (смахните влево), чтобы закрепить его в разделе «Избранное».
• Потяните вниз, чтобы выполнить поиск по метке или адресу. Недавно использованные хосты появляются в разделе «Недавние».

Импорт из ssh_config

Перенесите существующие хосты

• В меню Хосты выберите Импорт из ssh_config.
• Вставьте текст конфигурации или нажмите Выбрать файл.
• Просмотрите найденные хосты, отключите ненужные и нажмите Импорт.

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

Передача файлов (SFTP)

Просматривайте, скачивайте и загружайте файлы

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

Открыть обзор

• Нажмите и удерживайте хост и выберите Обзор файлов.
• Либо задайте для хоста Протокол SFTP (файлы): тогда нажатие открывает обозреватель вместо терминала.
• Уже в сессии? Нажмите кнопку папка на верхней панели терминала.

Скачивание файла

• Нажмите на файл, затем выберите Скачать.
• Файл откроется в меню «Поделиться», поэтому его можно отправить куда угодно — выберите Сохранить в Файлы, чтобы сохранить его, в том числе в iCloud Drive.

Загрузка файла

• Нажмите Загрузить внизу браузера, затем выберите Файлы… или Фото и видео….
• Файлы… открывает системный выбор файлов iPhone, поэтому можно загружать прямо из iCloud Drive, «На iPhone» или любого другого места в «Файлах». Фото и видео… отправляет оригиналы из вашей медиатеки.
• Выбирайте сколько угодно. Они попадут в папку, которую вы просматриваете, и список прокрутится к ним.
• Если файл с таким именем уже есть, Pockterm спросит, Заменить его или Оставить оба. «Оставить оба» добавляет номер, например IMG_0001 2.HEIC.

Управление файлами

• Нажмите на файл или на ⋯ рядом с папкой, чтобы переименовать, изменить Права или удалить.
• Нажмите кнопку с папкой вверху, чтобы создать папку. Потяните вниз, чтобы обновить список.
• Нажмите .. вверху, чтобы подняться на каталог выше.
• Нажмите кнопку сортировки, чтобы упорядочить список по имени или дате. Повторное нажатие на уже выбранный пункт переключает между «сначала новые» и «сначала старые». Pockterm запоминает выбор.

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

Перенаправление портов

Туннелируйте соединения через SSH

Перенаправление портов направляет сетевые соединения через сервер SSH.

• Локальный — порт на вашем устройстве перенаправляет на хост, доступный серверу.
• Удалённый — порт на сервере перенаправляет обратно на ваше устройство.
• Динамическое — прокси SOCKS5 на вашем устройстве направляет каждое соединение через сервер.

Запуск перенаправления

• На вкладке Порты нажмите +, чтобы добавить перенаправление.
• Нажмите на строку, чтобы изменить её.
• Нажмите ▶ для запуска; статус покажет, когда оно активно. Нажмите ⏹, чтобы остановить.

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

Безопасное доверие серверам

При первом подключении к серверу Pockterm показывает отпечаток его ключа и просит вас принять его. Это называется доверием при первом использовании.

• Принимайте, только если отпечаток совпадает с тем, который вы ожидаете от владельца сервера.
• После принятия ключ запоминается, и вопрос больше не появится.
• Если позже сервер предъявит другой ключ, Pockterm предупредит вас перед продолжением: это может значить, что сервер пересоздали или что-то не так.

Ваши данные и конфиденциальность

Где всё хранится

У Pockterm нет учётной записи, и данные ваших подключений остаются на устройстве.

• Хосты, группы, сниппеты и перенаправления хранятся на вашем устройстве.
• Пароли и закрытые ключи хранятся в связке ключей iOS.
• Доверенные ключи хостов запоминаются на вашем устройстве для предупреждений, описанных в разделе Проверка ключей хостов.
• Переписки с ассистентом хранятся на вашем устройстве, по одной на хост, поэтому чат остаётся на месте при повторном подключении. Нажмите корзину в ассистенте, чтобы удалить переписку.

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