Снимки показывают английский интерфейс; схемы отображаются на языке руководства. Названия элементов в приложении могут отличаться в зависимости от выбранного языка.
Автоматизация с помощью AppleScript и spcli
Запускайте сохраненные соединения и группы тегов из скриптов, сохраняя при этом конфигурацию соединений в приложении.
Встроенный справочник
Откройте Автоматизация. Он предоставляет вкладки AppleScript и Командная строка (spcli) с редактируемыми примерами и элементами управления копированием. Начните с перечисления имен, а не с угадывания их.

Автоматизация – это функция версии Pro после общей семидневной пробной версии. macOS может запросить у вызывающего приложения, например Терминала, разрешение на управление Secure Pipes. Разрешите это только тому абоненту, которому вы доверяете.
Список подключений через AppleScript
osascript -e 'tell application "Secure Pipes" to list connections'
Используйте возвращаемое имя в последующих командах. Если имена повторяются, используйте полное имя с типом подключения, указанным в приложении.
tell application "Secure Pipes"
connect connection "Database Tunnel (Local Forward)"
connection status "Database Tunnel (Local Forward)"
end tell
Запуск соединения является асинхронным. Проверьте статус, а не предполагайте, что возврат команды означает, что туннель готов. Аутентификация, доверие хоста и ошибки могут потребовать внимания пользователя.
Управление группами подключений
Указанные команды групп AppleScript и spcli перебирают профили с нужным тегом. Они не используют настройки параллельного/последовательного запуска и действий при ошибке из окна групп. Запрос может завершиться до подключения SSH; немедленная ошибка запуска останавливает остальные запросы. Для настроенной стратегии запуска используйте управление группами в приложении.
Группы — это теги, присвоенные профилям подключения. Групповые команды действуют на соответствующие профили:
tell application "Secure Pipes"
list connection groups
connect group "engineering"
disconnect group "engineering"
end tell
Проверьте каждого участника, прежде чем создавать группу. Групповая операция может запустить несколько реальных прослушивателей. Используйте disconnect connection, чтобы остановить один профиль, а не всю группу.
Установите и используйте spcli
В разделе Генерал → Инструмент командной строки выберите Установить spcli, если он не установлен. Откройте терминал и запустите:
spcli --help
Используйте справку установленной версии и вкладку Командная строка (spcli) для получения точных команд и параметров. Не допускайте использования закрытых ключей и паролей в аргументах команд, истории оболочки и сценариях. spcli работает на основе сохраненных настроек приложения; это не замена авторизации на стороне сервера.
Общие команды spcli
Начните с обнаружения только для чтения:
spcli list connections
spcli list groups
spcli list connections --json
Замените приведенное ниже имя демонстрационного подключения точным именем, возвращаемым установленным приложением. Запускайте каждую команду, когда вам нужно это действие; этот блок не является сценарием для одновременного запуска.
spcli connect "Database Tunnel (Local Forward)"
spcli status "Database Tunnel (Local Forward)"
spcli status "Database Tunnel (Local Forward)" --json
spcli disconnect "Database Tunnel (Local Forward)"
Как и в случае с AppleScript, успешная команда подключения не доказывает, что пункт назначения готов. Прежде чем приступить к зависимой работе, проверьте состояние и обработайте запросы аутентификации или доверия хоста в приложении.
Для тега с именем engineering используйте spcli connect-group "engineering" или spcli disconnect-group "engineering". Сначала проверьте членство: эти команды влияют на всю соответствующую группу.
| Команда | Эффект |
|---|---|
spcli start |
Запустите Secure Pipes, не показывая его окно. |
spcli show |
Показать и активировать окно приложения |
spcli hide |
Скрыть окна приложения, не выходя из него |
spcli shutdown |
Выйдите из приложения; активные соединения остановлены |
Для сценариев проверьте код выхода: 0 означает успешную команду, 1 — ошибку, сообщенную приложением, 2 — недопустимое использование, 3 — проблему запуска приложения или разрешения автоматизации, а 4 — ошибку отправки события Apple, тайм-аут или ошибку ответа. --json доступен для команд списка и статуса. Сохраняйте возвращаемый текст состояния, а не предполагайте, что это непереведенная константа.
Проверка и управление маршрутизацией
spcli --help группирует установленные команды по назначению. Примеры показывают прокси-серверы, правила, сценарии и состояние и прогнозируют маршрут локального запроса. Замените Office именем существующего сценария.
spcli list proxy-servers --json
spcli list rules --json
spcli list scenarios --json
spcli current-scenario
spcli preview-route example.com 443 com.example.browser TCP --json
spcli switch-scenario "Office"
spcli transparent-proxy-status --json
spcli start-transparent-proxy
spcli sharing-status --json
spcli list flows --json
spcli list logs --json
preview-route прогнозирует решение без подключения к цели. switch-scenario разрывает текущие прокси-соединения. enable-rule, disable-rule и set-rule-scenarios меняют правила; create-scenario, rename-scenario и delete-scenario управляют сценариями. Для общего доступа есть set-sharing-modes, start-sharing и stop-sharing. list sharing-flows и log-detail <log-id> показывают активность; список журналов возвращает не более 200 обезличенных записей. На странице автоматизации есть и соответствующие пояснения AppleScript. Успешное завершение команды не доказывает доставку удалённого трафика.
Скрипты и действия после подключения
Настройки для каждого подключения могут запускать локальный сценарий или поддерживаемое действие завершения после подключения. Удаленная пересылка также предоставляет возможность удаленного сценария. Они отделены от AppleScript, управляющего приложением.
Включайте только те сценарии, которые вы понимаете и которым доверяете. Не помещайте секреты в экспортированные примеры скриптов. Используйте шаблон ограниченного ожидания состояния из встроенных примеров, когда более поздняя задача зависит от готовности соединения, и обрабатывайте состояния сбоя вместо того, чтобы ждать вечно.
Действия после подключения
Измените профиль и выберите отсутствие действия или открытие URL после подключения. Локальные перенаправления также предлагают VNC, а SOCKS — прокси-браузер. Проверьте цель и приложение перед сохранением. Повторное открытие при переподключении настраивается отдельно. Состояние SSH «подключено» запускает действие, но не доказывает исправность целевого сервиса. После общего пробного периода нужна Pro.
Локальные и удалённые скрипты
Локальный скрипт выполняется на Mac после подключения. Перед включением проверьте содержимое и оболочку. Повтор при переподключении независим от действия URL/браузера. Остановка при ошибке управляет скриптом, а не стратегией группы. Удалённое перенаправление также предлагает скрипт на сервере с правами SSH-аккаунта. Переподключения могут повторять скрипты. Не включайте секреты и отключайте действия при диагностике туннеля.
На основе Secure Pipes 2.0.16 · Обновлено 3 ноября 2026 г.