Общие удалённые сеансы

zshell-server сохраняет оболочку и задания на узле macOS или Linux. Поддерживаются оба терминальных движка Zshell. Закрытие клиента или потеря сети не завершают задания. Повторное подключение восстанавливает экран, историю прокрутки, курсор и режимы терминала.

УстановкаКопировать ссылку

В Удалённые хосты… выберите Установить / Обновить сервер через SSH. Для Mac той же архитектуры используется встроенная программа. Для Linux выберите zshell-server нужной платформы и архитектуры. Перед заменой проверяются передача и совместимость. Работающий daemon сохраняет версию до перезапуска, который завершает его задачи. Можно собрать на хосте:

cargo build --locked --release --manifest-path remote/Cargo.toml
install -d "$HOME/.local/bin"
install -m 755 remote/target/release/zshell-server "$HOME/.local/bin/zshell-server"

Клиент получает доступ к оболочке и файлам серверной учётной записи. Поддерживаются macOS и Linux.

SSHКопировать ссылку

Сначала проверьте ключ узла и вход с ключом или агентом:

ssh devbox true

Откройте удалённые узлы в сетевом меню боковой панели. Введите имя, ssh://me@devbox:22 или псевдоним SSH и ~/.local/bin/zshell-server. Подключение загружает существующие проекты и сеансы. Укажите каталог вроде ~/repo и откройте удалённый проект, чтобы создать оболочку. Пробелы в путях поддерживаются; новые вкладки и разделения также работают удалённо.

SSH автоматически запускает daemon и использует ваши настройки OpenSSH, ключи, агент и доверенные ключи узлов. Неизвестные ключи и ошибки входа отображаются явно. Файлы и Git используют SSH к тому же узлу даже при терминальном соединении через Tailscale. Удалённые пути не открывают файлы Mac. ZSHELL_SSH_CONFIG_FILE позволяет указать абсолютный путь к отдельному читаемому файлу OpenSSH.

TailscaleКопировать ссылку

Войдите в Tailscale на обоих устройствах и запустите частный порт до создания сеансов:

zshell-server serve --listen tailscale://:7373

Добавьте tailscale://devbox:7373. Поддерживаются MagicDNS и адреса Tailscale IPv4/IPv6; публичные адреса отклоняются. По умолчанию разрешены только устройства без тегов владельца узла. --allow-user разрешает другое точное имя входа, но клиенты с тегами по-прежнему отклоняются. На самом сервере используйте SSH. ACL сети Tailscale также действуют. Разрешённый клиент получает доступ к Unix-аккаунту службы.

Подключите Tailscale и выберите Поделиться этим Mac в Удалённые хосты…. Укажите порт и при необходимости точные разрешённые логины. Общий доступ включается только по запросу; Остановить общий доступ или выход из Zshell завершает общие сессии.

Совместная работа и завершениеКопировать ссылку

Все клиенты получают одинаковый вывод. Фокус терминала или захват управления даёт клиенту ввод и изменение размера. При отключении управление получает самый ранний оставшийся клиент. Панель информации показывает состояние, число клиентов и владельца управления, позволяет отсоединиться и подключиться снова. Сетевые сбои повторяются автоматически; ввод без соединения отбрасывается. Сохранённая раскладка возвращается к тому же удалённому UUID.

Закрытие панели, проекта или окна и оба варианта выхода из приложения лишь отсоединяют клиента. Завершение удалённого сеанса требует подтверждения и останавливает оболочку с заданиями для всех. На сервере: zshell-server terminate --project ~/repo --session UUID.

Файлы и снимкиКопировать ссылку

Скопируйте обычные файлы или снимок и вставьте в удалённую панель. Zshell загружает их в закрытый каталог хоста и вставляет пути с экранированием для оболочки. До 32 файлов, по 32 MiB, всего 64 MiB; каталоги и символические ссылки запрещены. Общие загрузки хранятся семь дней. Обычные панели Unix SSH также поддерживаются.

Удалённые разговоры AgentКопировать ссылку

Активность, прогресс, запросы подтверждения и завершение удалённых Agents используют существующие статусы и уведомления. История разговоров Agent включает Claude Code, Codex, OpenCode и Pi хоста. Продолжить подключает живой разговор или запускает точную сессию на исходном хосте и в каталоге. Разговоры переживают перезапуск daemon; задачи терминала и прокрутка — нет. Нужны исходные программа, конфигурация или файл сессии.

ОграниченияКопировать ссылку

Сеансы сохраняются только пока жив daemon, без переживания перезагрузки узла, аварии или перезапуска daemon. Недоступный сеанс вызывает ошибку и не заменяется новой оболочкой. Пределы: 128 сеансов, снимок терминала 16 MiB и очередь 1 MiB на клиента. Медленные клиенты не блокируют остальных. История хранится в памяти сервера. Службы и CLI описаны в справочнике сервера.