SSHPortForwarder Support Doc.ru - ai-doge/PublicWiki GitHub Wiki

🌐 English · العربية · Deutsch · Español · Français · Italiano · 日本語 · 한국어 · Nederlands · Português (BR) · Русский · ภาษาไทย · Türkçe · 简体中文 · 繁體中文

Документация поддержки SSH Port Forwarder

Начало работы

SSH Port Forwarder (SSHPortForwarder) — это приложение для macOS, которое создает SSH-проброс портов и SOCKS-прокси. Вы настраиваете удаленные хосты, порты и аутентификацию (пароль или закрытый ключ), затем запускаете проброс, чтобы получить локальный порт или SOCKS-прокси, не покидая терминал и не изменяя конфигурацию SSH. Приложение может работать в строке меню для быстрого запуска/остановки. Ваши конфигурации, пароли (в Keychain) и доступ к файлам ключей остаются на вашем Mac; приложение не загружает ваши данные.

Чтобы начать работу с SSH Port Forwarder

  1. Скачайте и установите приложение (из App Store или вашего канала распространения).
  2. Запустите приложение. Вы можете использовать главное окно для управления конфигурациями или значок в строке меню для быстрого доступа.
  3. Добавьте или выберите конфигурацию проброса:
    • Введите имя, удаленный хост, SSH-порт (по умолчанию 22) и имя пользователя.
    • Выберите Password (Пароль) или Private Key (Закрытый ключ) для аутентификации. Если используете закрытый ключ, нажмите кнопку Browse рядом с путем к ключу, чтобы выбрать файл ключа (это необходимо для доступа приложения к файлу в песочнице).
    • Выберите SOCKS Proxy (локальный SOCKS-прокси) или Local Forward (проброс определенного удаленного порта на локальный порт) и задайте локальный порт (а для Local Forward — также удаленный порт).
  4. При желании используйте Test (Проверить), чтобы убедиться в работоспособности SSH-подключения перед запуском.
  5. Нажмите Start (Запустить), чтобы начать проброс. Используйте значок в строке меню для быстрого запуска или остановки пробросов.
  6. Сохраните конфигурацию, чтобы она сохранилась; если вы используете пароль, он будет сохранен в системной связке ключей (Keychain).

Важно: Файл закрытого ключа и повторный выбор

Если вы используете аутентификацию Private Key (Закрытый ключ) и выбираете файл ключа в приложении:

  • Приложение запоминает доступ к этому файлу через системную закладку (путь + идентификатор файла).
  • Если вы удалите этот файл ключа, а затем создадите новый файл с тем же именем (или по тому же пути), приложение все равно будет указывать на старый файл. Закладка может стать недействительной или указывать на неправильный файл.
  • Вы должны повторно выбрать файл ключа в клиенте: откройте конфигурацию, нажмите Browse рядом с путем к ключу, выберите новый файл ключа, затем Save (Сохранить). В противном случае приложение может не подключиться или показывать ошибки доступа.

Устранение неполадок

  • Не удается подключиться или пройти аутентификацию

    • Проверьте удаленный хост, SSH-порт и имя пользователя.
    • Для аутентификации по паролю: убедитесь, что пароль верен и сохранен (в Keychain).
    • Для закрытого ключа: убедитесь, что вы выбрали ключ через Browse, формат ключа поддерживается (OpenSSH или PEM), и если у ключа есть парольная фраза, введите ее при запросе. Если вы заменили файл ключа (например, удалили и создали новый с тем же именем), повторно выберите файл ключа в приложении и сохраните.

  • «Нет разрешения на чтение файла ключа» или другие ошибки, связанные с ключом

    • Используйте кнопку Browse, чтобы снова выбрать файл закрытого ключа, затем сохраните. Это также требуется после замены файла ключа (например, новый ключ с тем же путем/именем).

  • Локальный порт занят

    • Выберите другой локальный порт в конфигурации или остановите приложение, которое использует текущий порт.

  • Проброс не запускается или остается в состоянии «connecting» (подключение)

    • Запустите Test, чтобы проверить SSH-подключение. Проверьте брандмауэр и сеть. Убедитесь, что удаленный хост разрешает SSH и, для Local Forward, что удаленный порт указан верно.

  • Значок в строке меню или главное окно

    • Приложение может работать только со значком в строке меню. Используйте меню, чтобы открыть полное окно для настройки или запуска/остановки пробросов.

Обратная связь и предложения

Мы ценим ваши отзывы и предложения по улучшению SSH Port Forwarder.
Если у вас есть идеи или предложения, пожалуйста, отправьте их на [email protected].

Спасибо за использование SSH Port Forwarder!