Portal Drive

Библиотеку документов или одну её папку можно открыть как диск в Проводнике / Finder: файлы остаются на портале, на компьютер подтягиваются при открытии.

Это не «Подключить сетевой диск» Windows (WebDAV) и не Samba. Клиент — Portal Drive.

Открыть один Word/Excel из браузера с записью на сервер — другой сценарий: Открытие документов Office. Для него Drive ставить не нужно.

1. Что нужно на компьютере

В библиотеке нажмите Диск. Портал определяет Windows / macOS / Linux и процессор.

На Mac метка должна быть Apple Silicon, если у вас чип M1 и новее. Браузер всегда пишет «Intel» в служебных полях (MacIntel) — на это окно Диск не опирается. Если метка всё же неверна — переключите кнопки.

Один раз на этот компьютер:

Система	Что установить
macOS	Только приложение Portal Drive из окна Диск. Отдельный драйвер не нужен.
Windows	WinFsp и приложение Portal Drive (распакуйте архив и откройте `portal-drive.exe` — оно само пропишется в `%LOCALAPPDATA%\PortalDrive`).
Linux	FUSE 3 (в Debian/Ubuntu пакет `fuse3`, в Fedora/RHEL — тоже `fuse3`) и приложение (распакуйте архив и откройте `portal-drive` — копия появится в `~/.local/bin`).

macOS может один раз спросить про неизвестного разработчика при первом открытии приложения — в том диалоге нажмите «Открыть». Терминал и ручные команды не нужны.

2. Подключить папку

Откройте библиотеку (при необходимости зайдите в папку).
Нажмите Диск → Подключить диск.
Браузер спросит, открыть Portal Drive — нажмите Открыть. Папка появится в Finder / Проводнике / файловом менеджере.

Окно приложения можно свернуть. Закройте его, когда диск больше не нужен.

Токен живёт 7 дней. Выход из портала или смена пароля отключает диск — подключите снова. Права на файлы те же, что в библиотеке.

Сохранение с диска пишет новую версию файла (обычно через пару секунд после Save в Excel/Word). Если документ уже открыт в клиентском Office или в Portal Office, запись с диска будет отклонена, пока документ не закроют.

3. Администратору

Диск не требует отдельной установки хранилища: файлы и так лежат в S3/SeaweedFS портала.

По умолчанию содержимое файлов идёт через портал. Этого достаточно. Чтобы большие файлы не нагружали API, можно открыть хранилище с рабочих мест — см. Portal Drive: как идут файлы.

Готовые клиенты для кнопки Диск собираются так:

./tools/portal-drive/build-clients.sh

Архивы оказываются в frontend/public/downloads/portal-drive/ и входят в Docker/native-сборку фронтенда.

macOS — в архиве Portal Drive.app, ссылка portaldrive://, монтирование через встроенный NFS (macFUSE не нужен).
Windows — portal-drive.exe + WinFsp, ссылка portaldrive:// в реестре текущего пользователя.
Linux — бинарник + FUSE 3, обработчик portaldrive:// через .desktop.

Сторонние лицензии клиента: THIRD-PARTY.txt в архиве и сводка в LICENSES.md (раздел Portal Drive).