Одна ссылка neoserver://, один клик, и NeoServer автоматически запускается, подключается к серверу и открывает терминал именно там, где вам нужно — возможно, на каком-то устройстве, в определенной сессии tmux или в нужной директории.

Ее можно сохранить в избранное Safari, заметки, как значок на рабочем столе, добавить в быстрые команды Siri или передать коллеге через AirDrop — она будет работать везде.

一、Как составить ссылку на терминал

Все ссылки на терминал выглядят так:

neoserver://terminal?host=<сервер>&port=<порт>&user=<пользователь>&tmuxName=<сессия-tmux>&zellijName=<сессия-zellij>&workdir=<директория>

⚠️ tmuxName / zellijName / workdir можно указать только один. Если указано несколько, приоритет будет у tmuxName, затем zellijName, и в последнюю очередь workdir.

Просто скопируйте и подставьте свои значения:

# Самый простой: только host
neoserver://terminal?host=1.2.3.4

# Указать порт и пользователя
neoserver://terminal?host=1.2.3.4&port=2222&user=deploy

# При подключении сразу войти в сессию tmux с именем main
neoserver://terminal?host=1.2.3.4&user=root&tmuxName=main

# При подключении сразу войти в сессию zellij с именем dev
neoserver://terminal?host=1.2.3.4&user=root&zellijName=dev

# При подключении автоматически сделать cd в директорию с логами
neoserver://terminal?host=1.2.3.4&user=root&workdir=/var/log/nginx

二、Где остановится терминал после подключения

Это самая полезная часть ссылки на терминал — в зависимости от введенных параметров, терминал после подключения открывается в разных местах:

Зачем разделять эти три варианта?

• Сессии tmux / zellij: при обрыве сети, закрытии приложения или переподключении с другого устройства сессия сохраняется, и процессы не теряются. Поделившись сессией tmux сервера с коллегой, вы оба сможете войти в один и тот же экран для совместного поиска и устранения неисправностей.
• Директория: если вам каждый раз при подключении приходится делать cd /opt/app/logs, проще использовать ссылку, которая сразу перенесет вас в нужное место.

三、Копирование ссылки в приложении (вручную писать не нужно)

При написании ссылки вручную легко допустить ошибку. В NeoServer есть три места, где можно скопировать её в один клик, после чего останется только вставить её куда угодно.

1. Копирование ссылки для «этого сервера»

Вкладка Серверы · Список серверов → свайп влево по нужному серверу → Copy Scheme Link

В результате скопируется:

neoserver://terminal?host=...&port=...&user=...

2. Копирование в быстром (quick) режиме терминала

Вкладка Терминал · Список серверов (режим quick) → долгое нажатие на нужный сервер → Copy Scheme Link

3. Копирование ссылки для «этой сессии» ⭐ Самое полезное

Вкладка Терминал · Список сессий → долгое нажатие на нужную сессию → Copy Scheme Link

Эта ссылка упакует в себя данные о «подключении к сессии Y сервера X»:

• Если это сессия tmux → автоматически добавится &tmuxName=...
• Если это сессия zellij → автоматически добавится &zellijName=...
• Обычная сессия → только host/port/user

При успешном копировании появится всплывающее окно Link Copied, и ссылка будет в буфере обмена.

💡 Сделайте долгое нажатие на запущенной сессии tmux, чтобы скопировать ссылку и отправить её коллеге. Открыв её в NeoServer, он сразу подключится (attach) к той же сессии — вы оба попадете в один и тот же экран терминала.

四、Как открыть эту ссылку

neoserver:// — это протокол ссылок iOS, в любом месте, где можно нажать на ссылку, запускается NeoServer:

• Safari: вставьте в адресную строку и нажмите Enter, или сохраните в избранное и нажмите.
• Заметки / Напоминания: сохраните запись, нажмите для мгновенного перехода.
• Быстрые команды (Команды): вставьте ссылку в действие «Открыть URL» → можно привязать к голосовой команде Siri, значку на рабочем столе или автоматизации.
• AirDrop: отправьте ссылку между двумя iPhone, получателю достаточно нажать на нее для подключения.
• Почта: отправьте ссылку как текст, получатель копирует её в Safari для открытия.

📱 При первом нажатии на neoserver:// на устройстве iOS появится запрос «Открыть в NeoServer?», просто подтвердите, и это сообщение больше не появится.

五、Три практических сценария

🏠 Сценарий 1: Значок на рабочем столе для «подключения к рабочему tmux»

Каждый день вам нужно подключаться к сессии tmux main на рабочем сервере. Вместо того чтобы каждый раз открывать App → искать сервер → подключаться → делать attach, создайте значок:

1. Скопируйте ссылку для этого сервера в приложении и вручную добавьте &tmuxName=main;
2. Откройте iOS «Команды» (Быстрые команды) → Создать → добавьте действие «URL», вставьте эту ссылку;
3. Добавьте действие «Открыть URL»;
4. Нажмите «Поделиться» → Добавить на экран «Домой», назовите «Рабочий сервер» и выберите иконку.

Теперь при нажатии на этот значок на рабочем столе, NeoServer автоматически подключится и войдет в сессию main без дополнительных действий.

🎙️ Сценарий 2: Голосовое подключение

Интегрируйте указанную выше быструю команду в Siri, задав фразу «Привет, Siri, рабочий сервер». После произнесения телефон подключится автоматически.

🤝 Сценарий 3: Передача сессии коллеге

1. Терминал · Список сессий → долгое нажатие на эту сессию → Copy Scheme Link;
2. Отправьте коллеге (через AirDrop / WeChat — любой способ);
3. Он открывает её в NeoServer → автоматический attach к той же сессии tmux.

(Предварительное условие: на его iPhone в базе серверов NeoServer также должна быть возможность подключиться к этому же хосту.)

六、Часто задаваемые вопросы о ссылках на терминал

Q: Нажал на ссылку, но подключился к неправильному серверу? A: NeoServer ищет сервер по host (+ port, если указан + user, если указан). Если в вашей базе есть два сервера с одинаковым host, он подключится к первому совпадению. Указав port или user, вы сможете точно их различить.

Q: Этого сервера нет в базе, что произойдет при нажатии на ссылку? A: Произойдет переход на страницу «Новый сервер», где host/port/user уже будут заполнены за вас. Вы добавляете пароль или приватный ключ → сохраняете → автоматическое подключение, и сессия / директория из исходной ссылки также вступят в силу.

Q: Можно ли передать пароль прямо в ссылке, чтобы не вводить его каждый раз? A: Нет. Это ограничение безопасности — в ссылке никогда не бывает пароля. Даже если вы вручную добавите password=xxx, это будет проигнорировано. Пароли передаются только через связку ключей внутри приложения.

Q: Можно ли указать директорию с китайскими иероглифами или пробелами в workdir? A: Да. Пишите напрямую, например workdir=/home/me/my logs. Специальные символы приложение обработает автоматически. Самый надежный способ — использовать копирование в приложении, а не писать вручную.

Q: Нажал, но нет реакции? A: ① Убедитесь, что ссылка начинается с neoserver://; ② При первом нажатии должно появиться окно подтверждения «Открыть в NeoServer»; ③ Проверьте, что host не пустой; ④ Неважно, если приложение свернуто (не на переднем плане), оно запустится автоматически.

Q: Можно ли открыть на Android / Windows? A: Нет. neoserver:// распознается только на iPhone / iPad с установленным NeoServer.

七、Приложение: Открытие центра уведомлений

Помимо терминала, есть ссылка для открытия центра уведомлений:

neoserver://notifications

При нажатии на виджет уведомлений на рабочем столе срабатывает именно она.