Символьные ссылки не работают при SFTP-монтировании — NetDrive

Каталог деплоя на вашем SFTP-сервере хранит символьную ссылку current, указывающую на актуальную папку релиза — current → releases/20260821-1. Это стандартный паттерн для деплоя без простоя, и именно такая вещь незаметно ломается, как только вы подключаете к этому серверу NetDrive. Ссылка отображается как пустой файл, как битый ярлык, либо не появляется вообще, и скрипт, который ожидает, что S:\current\config.yaml просто сработает, вдруг перестаёт работать.

Монтируйте SFTP-серверы с рабочей поддержкой символьных ссылок

NetDrive показывает Google Drive, OneDrive, S3, SFTP, WebDAV и другие хранилища как обычные диски в Windows и macOS — без синхронизации и полной загрузки файлов.

• Символьные ссылки корректно разрешаются на SFTP-дисках начиная с версии 3.17.817
• Аутентификация по паролю или SSH-ключу
• Доступно для Windows, macOS и экспериментальной сборки для Linux

WindowsmacOS

Скачать NetDrive →

Бесплатный пробный период. Доступны бессрочная лицензия и подписка.

Сначала проверьте версию

NetDrive добавил поддержку символьных ссылок для SFTP-подключений в версии 3.17.817 (07.01.2023). На любой более ранней сборке символьная ссылка на сервере не имеет аналога на смонтированной стороне — она может не отображаться либо показываться как файл нулевого размера вместо указания на цель. Это самая частая причина жалоб «у меня не работают символьные ссылки», и стоит исключить эту причину прежде, чем что-либо трогать на сервере.

Чтобы проверить установленную версию, откройте Drive Manager NetDrive, щёлкните по значку NetDrive (системный трей в Windows, строка меню в macOS) и откройте About NetDrive. Если строка версии показывает что-то старее 3.17.817, обновитесь перед тем, как продолжить — актуальный релиз — 3.19.7, доступен на netdrive.net/download.

Уже на 3.17.817 или новее? Проверьте саму ссылку

Если дело не в версии, обычно проблема в конфигурации самой символьной ссылки. Пройдите по этим пунктам со стороны сервера, через обычную SSH-сессию:

• Абсолютные и относительные цели. Относительная символьная ссылка (current → releases/20260821-1) разрешается относительно своего собственного каталога и, как правило, хорошо переносится через монтирование. Абсолютная символьная ссылка (current → /var/www/app/releases/20260821-1) разрешается корректно только если этот точный абсолютный путь тоже существует и доступен из собственного представления файловой системы у SFTP-аккаунта — а это не гарантировано, если аккаунт находится в chroot-окружении внутри подкаталога.

  # Run this on the server to see how the link is defined
  ls -la /var/www/app/current

• Цель за пределами корня SFTP-аккаунта. Некоторые серверы ограничивают SFTP-пользователей chroot-окружением, привязанным к их домашнему каталогу или конкретному пути. Символьная ссылка, указывающая куда-либо за пределы этого корня, невидима для SFTP-сессии — а значит, и для NetDrive — независимо от того, какая версия NetDrive у вас установлена. Убедитесь, что путь цели находится внутри того же корня, к которому привязан SFTP-аккаунт.

• Оборванная цель. Если каталог релиза, на который указывает ссылка, был удалён или переименован (незавершённый деплой, скрипт очистки, запустившийся слишком рано), сама ссылка в порядке, но ей нечего разрешать. ls -la на сервере покажет ссылку другим цветом или пометит её как битую — в зависимости от настроек вашей оболочки.

• Права доступа к цели, а не только к ссылке. Сам файл символьной ссылки может быть доступен для чтения, в то время как права на его целевой каталог блокируют SFTP-аккаунт. Проверьте оба варианта.

Подтверждение исправления через смонтированный диск

Убедившись в версии и в том, что ссылка относительная, находится внутри корня и указывает на существующий объект, переподключите диск в NetDrive (щёлкните правой кнопкой мыши по подключению в Drive Manager и выберите Reconnect, либо отключите и подключите заново) и проверьте смонтированный путь напрямую:

# Windows PowerShell — replace S: with your assigned drive letter
dir S:\current

# macOS / Linux Terminal
ls -la /Volumes/sftp-mount/current

Если содержимое целевой папки теперь отображается корректно, значит символьная ссылка разрешается. Если она всё ещё показывается пустой или отсутствующей после проверки и версии, и корректности самой ссылки, то остающийся фактор — это, как правило, конфигурация SFTP-подсистемы на стороне сервера, а именно отключена ли у процесса sftp-server на сервере обработка символьных ссылок — это вопрос к администратору сервера, а не настройка NetDrive.

Итог

Работа символьных ссылок на SFTP-диске сводится к двум независимым вещам: поддерживает ли это вообще ваша сборка NetDrive (3.17.817+) и валидна ли сама ссылка с точки зрения SFTP-аккаунта. Сначала проверьте версию — это более быстрое исправление — а затем разберитесь с целью ссылки, прежде чем считать, что виноват NetDrive. Подробнее о более широких проблемах с SFTP-подключением см. Fix SFTP Authentication Failures in NetDrive, а о первоначальной настройке — Mount an SFTP Server on Windows.

— Morgan, NetDrive