ownCloud PDF Viewer: возможности, совместимость, установка и ограничения

ownCloud PDF Viewer — не самостоятельная программа для Windows или macOS, а серверное приложение files_pdfviewer, которое встраивает просмотр PDF в веб-интерфейс ownCloud Classic. В актуальной ветке это особенно важно уточнить: одноимённую задачу в ownCloud Web для Infinite Scale решает другой компонент, а мобильные клиенты имеют собственные механизмы просмотра. Рассматриваемый здесь продукт относится именно к ownCloud Classic 11 и использует встроенную, локально пропатченную копию Mozilla PDF.js.

Скачать ownCloud PDF Viewer

У ownCloud PDF Viewer нет отдельного установщика EXE, MSI, DMG или мобильного APK. Для поддерживаемой конфигурации ownCloud Classic 11 приложение поставляется в составе официального Docker-образа ownCloud вместе с другими приложениями производителя. Поэтому безопасный путь получения — развернуть или обновить сам ownCloud Classic из официального образа, а затем включить Files PDF Viewer в административной панели. Это устраняет необходимость искать сторонний архив с неизвестной подписью или устаревшую копию приложения.

В ownCloud 11 администратор может открыть Settings → Admin → Apps и включить Files PDF Viewer. Альтернатива для поддерживаемой Docker-установки — команда docker compose exec owncloud occ app:enable files_pdfviewer. Документация ownCloud отдельно предупреждает, что приложения, уже содержащиеся в Docker-образе, возвращаются после перезапуска контейнера, если их попытаться удалить как обычный вручную установленный пакет. Для штатного отказа от просмотрщика правильнее отключить его, а не вырезать каталог из образа.

Если администратор работает со старой инсталляцией ownCloud 10, нельзя автоматически брать текущую 1.1.2. Тег 1.0.2 в официальном репозитории объявляет совместимость с ownCloud 10.2–10, тогда как метаданные 1.1.2 ограничены ownCloud 11. Это разные линии совместимости. Для новой установки разумно ориентироваться на Classic 11, а при сопровождении старого сервера — сначала сопоставить версию ownCloud, PHP и конкретный релиз приложения.

Что такое ownCloud PDF Viewer

Официальное имя репозитория — ownCloud PDF Viewer, а имя приложения, отображаемое в его метаданных, — PDF Viewer. Проект размещён в официальной организации ownCloud; в текущем файле сведений указаны авторы Thomas Müller, Lukas Reschke и Viktar Dubiniuk. Назначение узкое: открыть PDF, уже доступный в хранилище ownCloud, прямо в браузере без предварительного ручного сохранения файла на диск.

Интеграция построена вокруг PDF.js. Когда приложение активно, действие просмотра регистрируется для файлов с MIME-типом application/pdf и становится стандартным способом открытия таких объектов в классическом файловом интерфейсе. Для одиночной публичной ссылки на PDF предусмотрено такое же встраивание просмотрщика, если политика общего доступа разрешает получение файла.

Не путать с PDF Viewer в ownCloud Web

ownCloud Web — современный интерфейс для ownCloud Infinite Scale — имеет отдельное приложение pdf-viewer. Документация этого фронтенда описывает его как просмотрщик, опирающийся на нативное отображение PDF в браузере. Classic-приложение files_pdfviewer, наоборот, содержит PDF.js и интегрируется с традиционным ownCloud Server. Нельзя переносить системные требования, функции или инструкции установки между этими решениями только из-за одинакового назначения.

Основные функции ownCloud PDF Viewer

Навигация по документу

Интерфейс текущей ветки содержит переход на предыдущую и следующую страницу, поле номера страницы, команды перехода к первой и последней странице и индикатор общего числа страниц. Боковая панель умеет показывать миниатюры, структуру документа, вложения и слои. Это делает просмотрщик пригодным не только для коротких договоров, но и для многостраничных руководств с закладками и внутренней структурой.

Масштаб, развороты и режим прокрутки

Панель PDF.js предлагает увеличение и уменьшение масштаба, автоматический режим, фактический размер, вписывание страницы и ширины, а также фиксированные значения от 50 до 400 процентов. В дополнительном меню доступны поворот по и против часовой стрелки, вертикальная, горизонтальная и многорядная прокрутка, а также варианты показа разворотов. Это настройки представления: они не переписывают исходный PDF на сервере.

Поиск и работа с текстовым слоем

Встроенный поиск поддерживает переход между совпадениями, выделение всех результатов, учёт регистра и режим целых слов. Он работает с текстом, который уже присутствует в PDF. Если страница является сканом-картинкой без распознанного текстового слоя, ownCloud PDF Viewer не выполняет OCR и не создаёт такой слой. Для поиска по отсканированным архивам сначала нужен отдельный инструмент распознавания.

Печать, скачивание и свойства

В текущем шаблоне есть кнопки печати и загрузки исходного файла, ссылка на текущее представление и окно свойств документа. PDF.js может показывать имя и размер файла, заголовок, автора, тему, ключевые слова, создателя и производителя PDF, версию формата, число и размер страниц и другие метаданные, если они записаны в документе. Это средства чтения и диагностики, а не редактор метаданных.

Пароль, вложения и презентационный режим

Для защищённого паролем PDF предусмотрен диалог ввода пароля. В боковой панели есть просмотр вложенных файлов, а в основной панели — презентационный режим. Наличие этих элементов не превращает приложение в средство управления защитой: оно не заявлено как инструмент снятия пароля, изменения разрешений или повторного шифрования документа.

Публичные ссылки и контроль разрешения на скачивание

Для публичной ссылки приложение получает тот же PDF через механизм ownCloud и может показать его без отдельной учётной записи получателя. Однако перед запуском просмотрщика серверный контроллер проверяет атрибут разрешения на скачивание. Если владелец общего ресурса запретил загрузку, приложение сообщает о запрете и не открывает встроенный PDF Viewer. Практический вывод: фраза «просмотр без необходимости скачивать файл» описывает удобство интерфейса, а не защищённый потоковый режим, скрывающий байты документа от браузера.

Локализация

В репозитории присутствуют русские строки самого приложения, включая действие открытия и уведомление о запрете скачивания, а комплект PDF.js содержит русскую локализацию панели просмотра. Поэтому русский интерфейс предусмотрен. Итоговый язык зависит от выбранной локали ownCloud и ресурсов локализации PDF.js.

Интерфейс и удобство использования

Рабочая логика проста: пользователь остаётся в файловом приложении ownCloud, выбирает PDF и получает встроенную область просмотра поверх текущего интерфейса. Сам документ рендерится внутри iframe с sandbox-атрибутом и явно заданным набором разрешений. Слева при необходимости раскрывается боковая панель, сверху располагаются поиск, навигация и масштаб, справа — печать, скачивание и меню дополнительных инструментов. Закрытие возвращает к списку файлов; в коде также предусмотрена реакция на клавишу Esc, когда просмотрщик открыт из файлового списка.

Интерфейс сохраняет довольно «классический» вид PDF.js и не пытается конкурировать с полнофункциональным Acrobat. В нём нет отдельного рабочего пространства для комментариев, редактирования страниц, OCR или конвертации. Для задачи «быстро прочитать PDF там, где он хранится» это снижает сложность; для документного производства — ограничивает сценарий.

Поддерживаемые форматы и совместимость

На уровне интеграции с ownCloud область поддержки предельно ясна: действие регистрируется для MIME application/pdf. Приложение не объявляет DOCX, XLSX, EPUB, DjVu, XPS, изображения или Adobe Illustrator как собственные форматы верхнего уровня. Если в PDF есть вложения, они могут отображаться в соответствующей панели PDF.js, но это не означает, что Files PDF Viewer становится универсальным просмотрщиком всех типов вложенных файлов.

Экспорт в Word, изображения, EPUB или другой PDF-профиль отсутствует. Кнопка Download сохраняет исходный объект, а Print передаёт документ в механизм печати браузера. Для конвертации, слияния, разделения, компрессии или OCR нужен другой класс программ. Если требуется именно настольная работа с разными форматами, уместнее смотреть в сторону PDF-XChange Editor либо универсального читателя, но это уже другой рабочий процесс.

Совместимость с браузерами

Метаданные приложения требуют современный браузер и прямо исключают Internet Explorer и старые версии Microsoft Edge на движке до Chromium. JavaScript интеграции дополнительно проверяет IE и старый Edge и в таком случае не подключает действие просмотрщика, оставляя загрузку файла как запасной путь. Общие системные требования ownCloud 11 перечисляют Firefox 60 ESR+, Chrome 66+, Safari 10+ и актуальный Edge, однако для PDF Viewer действует более строгая собственная оговорка: IE использовать не следует независимо от того, что он ещё фигурирует в общей серверной матрице.

Совместимость с ownCloud

Версия 1.1.2 в текущем manifest ограничена ownCloud 11 и требует PHP 8.3+. Версия 1.0.2, напротив, декларировала ownCloud 10.2–10. Эти ограничения проверяются на стороне платформы и важнее старых инструкций из поисковой выдачи. Нельзя считать пакет универсальным расширением для любого релиза ownCloud или Nextcloud.

Паспорт обратимости операций

Производительность и стабильность

Официальный предел размера PDF и норматив времени открытия для ownCloud PDF Viewer не опубликованы. Рендеринг PDF.js выполняется в браузере, а файл поступает с сервера ownCloud, поэтому на сложных документах важны сеть, память и CPU клиентского устройства. При замедлении следует сравнить скорость загрузки исходного файла, повторить открытие в актуальном браузере и при необходимости проверить локальный ридер. Обещать стабильную работу с любым объёмом файла без такого теста нельзя.

Состояние PDF.js и безопасность

Текущая версия поставляет PDF.js 2.10.0 — это не последняя upstream-линия Mozilla, а встроенная копия с патчами ownCloud. В release 1.1.1 разработчики перенесли исправление CVE-2024-4367, ужесточили обработку FontMatrix и отключили unsafe-eval в Content Security Policy. В 1.1.2 добавлен явный файл учёта версии и патчей, чтобы сканеры уязвимостей и SBOM-инструменты не пропускали библиотеку. Проведённый разработчиками аудит 9 сентября 2026 года указывает, что известные на ту дату advisories для этой копии либо не применимы, либо закрыты перенесённым исправлением.

Следовательно, старый номер PDF.js сам по себе не означает незакрытую уязвимость: ownCloud применяет перенесённые исправления. Но новые функции upstream также не появляются автоматически, поэтому администратору важнее следить за релизами самого приложения и ownCloud.

Лицензирование и версии

ownCloud PDF Viewer распространяется по AGPL и в документации ownCloud 11 находится в списке AGPL Apps, а не Enterprise-only Apps. У просмотрщика нет отдельной подписки, тарифа, пробного периода, рекламного бесплатного режима или платной разблокировки функций. Он является компонентом серверной платформы. Если организация покупает Standard или Enterprise-поддержку ownCloud, это коммерческие отношения вокруг сервера и поддержки, а не лицензия, превращающая PDF Viewer из бесплатного в платный.

Для пользователя нет отдельной регистрации в PDF Viewer: приватный документ открывается в рамках обычной сессии ownCloud. Публичная ссылка может работать без учётной записи получателя, если владелец ресурса разрешил доступ и скачивание. Администратору Marketplace также не нужен отдельный «аккаунт просмотрщика»; в ownCloud 11 основные приложения производителя уже входят в Docker-образ.

Хронология развития и поддержки

История приложения показывает переход от простого встраивания PDF.js к более осторожной модели безопасности. В 2018–2021 годах менялись версия PDF.js, локализация, работа публичных ссылок, отображение шрифтов и поведение ссылок. Выпуск 1.0.0 окончательно закрепил отказ от IE11 и старого Edge. В январе 2024 года обработку JavaScript внутри PDF сделали безопаснее, а летом 2026 года появилась ветка для ownCloud 11.

Самая важная актуальная веха — пара релизов 1.1.1 и 1.1.2. Первая закрыла конкретную уязвимость выполнения JavaScript через специально сформированный FontMatrix и усилила CSP. Вторая документировала фактически поставляемую версию PDF.js, перенесённое исправление и аудит бюллетеней безопасности, а также исправила упаковку, чтобы артефакт релиза содержал только полезную нагрузку приложения. Поэтому оценивать текущее состояние по старым issue 2018–2021 годов или по странице для ownCloud 10 недостаточно.

Системные требования

Сервер ownCloud Classic 11

Для версии ownCloud PDF Viewer 1.1.2 manifest требует ownCloud 11 и PHP не ниже 8.3. Начиная с Classic 11 ownCloud официально поддерживает только Docker-развёртывание. Для Docker-хоста документация указывает Docker Engine 20.10+, Docker Compose v2+, 64-битную архитектуру x86_64/amd64, минимум 512 МБ оперативной памяти и 1 ГБ или больше как рекомендацию. Реальная память для сервера зависит от количества пользователей, файлов и активности; это не специфический объём, который «потребляет PDF Viewer».

В поддерживаемой схеме администратору не требуется вручную собирать PHP 8.3, Apache и базу данных ради самого приложения: нужное окружение находится в официальных контейнерах. Для внешнего доступа к Classic 11 нужен корректно настроенный reverse proxy с TLS, поскольку контейнерный образ не занимается завершением SSL сам.

Клиентский браузер

Практически следует использовать актуальные Chrome/Chromium, Firefox, Safari или Microsoft Edge на Chromium. Общая матрица ownCloud 11 начинается с Firefox 60 ESR, Chrome 66 и Safari 10, но Files PDF Viewer прямо исключает Internet Explorer и старый Edge. Для рендеринга большого документа важны свободная память и производительность клиентского устройства; отдельного официального минимума RAM или GPU для PDF Viewer нет.

Что не требуется

Не нужны Adobe Reader, браузерный плагин Acrobat, Java Runtime, отдельный OCR-движок или лицензия PDF.js на рабочем месте. Не нужен и сторонний облачный сервис для рендеринга: интеграция получает файл из ownCloud и обрабатывает его PDF.js в браузере. Интернет как таковой тоже не является обязательным, если ownCloud развёрнут и доступен внутри локальной сети; нужна именно сетевая доступность собственного сервера.

Карта критических зависимостей

Для администратора эта карта полезнее формального списка «Windows/macOS/Linux». Сервер может находиться на Linux-хосте в Docker, а пользователи — открывать тот же PDF из разных настольных ОС через браузер. Проблемы следует локализовать по слоям: сервер и права, приложение ownCloud, передача файла, затем PDF.js и клиентский браузер.

Преимущества и недостатки ownCloud PDF Viewer

Плюсы и минусы

Нативное место в ownCloud Classic. Пользователь не скачивает файл вручную только ради чтения и не теряет контекст папки.

Открытая лицензия. Files PDF Viewer входит в список AGPL-приложений ownCloud и не имеет отдельной платной редакции.

Достаточный набор функций чтения. Поиск, миниатюры, оглавление, вложения, слои, масштаб, развороты, поворот, печать и свойства покрывают типовую навигацию.

Публичные PDF-ссылки. Просмотр возможен и без обычной учётной записи получателя, если разрешения общего доступа это допускают.

Русская локализация. Она присутствует и для строк интеграции ownCloud, и для панели PDF.js.

Свежие меры безопасности. В 2026 году перенесённое исправление закрыло CVE-2024-4367, а CSP явно запрещает unsafe-eval.

Исходный PDF обычно остаётся неизменным. Основные операции относятся к представлению и легко обратимы.

Минусы

Это не автономный ридер. Без ownCloud Classic продукт не имеет смысла; установить его как обычную программу на ПК нельзя.

Только PDF на уровне файловой интеграции. Нет EPUB, DjVu, XPS, Office-документов и изображений как собственных форматов приложения.

Нет OCR и редактирования. Скан без текстового слоя остаётся картинкой; изменить текст, страницы или метаданные нельзя.

Ограничение публичных ссылок. Запрет скачивания одновременно блокирует встроенный просмотр через это приложение.

Старая базовая версия PDF.js. Версия 2.10.0 пропатчена и аудирована, но не даёт автоматической функциональной паритетности с современной веткой PDF.js.

Нет поддержки IE и старого Edge. Для устаревших корпоративных рабочих мест понадобится обновление браузера или иной способ чтения.

Интерактивный JavaScript в PDF отключён по умолчанию. Это правильная мера безопасности, но отдельные сложные формы могут работать не полностью.

Сравнение с аналогами

ownCloud PDF Viewer корректно сравнивать не с «лучшим PDF-редактором вообще», а с решениями, которые закрывают соседние сценарии. Его главное преимущество — отсутствие перехода из ownCloud Classic. Если документ нужно редактировать, подписывать, распознавать или регулярно читать без доступа к серверу, другой класс продукта выигрывает по определению.

Место относительно Sumatra PDF. Sumatra PDF рациональнее, когда файлы уже лежат локально на Windows-компьютере, важны скорость запуска, portable-режим и несколько документных форматов. ownCloud PDF Viewer рациональнее, когда первичен сам серверный контекст: пользователь должен открыть PDF из общей папки или публичной ссылки, не создавая отдельный локальный процесс. Эти продукты скорее дополняют друг друга: один — локальный читатель, другой — встроенный веб-просмотрщик.

Если нужна привычная настольная альтернатива с более насыщенными инструментами, на сайте также есть обзоры Foxit Reader и Xodo PDF Reader. Выбор между ними и ownCloud PDF Viewer следует делать по месту хранения и требуемым операциям, а не по числу кнопок.

Инструкция по установке

Поддерживаемый путь для ownCloud Classic 11

Шаг 1. Убедитесь, что сервер действительно работает на ownCloud Classic 11 в поддерживаемой Docker-конфигурации, а не на ветке 10.x или Infinite Scale.

Шаг 2. Проверьте, что Docker-хост соответствует базовым требованиям ownCloud 11 и что сама инсталляция открывается через настроенный домен и TLS-прокси.

Шаг 3. Войдите в ownCloud с правами администратора и откройте Settings → Admin → Apps.

Шаг 4. Найдите Files PDF Viewer и включите приложение. В Docker CLI эквивалентное действие — docker compose exec owncloud occ app:enable files_pdfviewer.

Шаг 5. Откройте раздел Files и выберите обычный PDF с MIME application/pdf. Документ должен открыться во встроенной области PDF.js.

Шаг 6. Проверьте базовые функции: переход между страницами, масштаб и закрытие viewer с возвратом к списку файлов.

Первый запуск и безопасные настройки

Отдельного профиля или мастера активации нет. Для первого контроля откройте небольшой PDF с текстовым слоем, проверьте поиск, навигацию, печать и Download, а при использовании публичных ссылок — отдельную ссылку с реальными разрешениями. Параметр files_pdfviewer.enableScripting безопаснее оставить выключенным: значение yes оправдано только для доверенной формы после оценки риска.

Обновление и удаление

Обновляйте приложение через штатный набор ownCloud и официальный образ, предварительно зафиксировав его версию и настройку scripting. Для отказа от просмотрщика используйте Apps или docker compose exec owncloud occ app:disable files_pdfviewer: удалять поставляемый каталог бессмысленно, поскольку встроенные приложения возвращаются с образом. PDF-файлы при отключении не удаляются.

Практические кейсы

Быстрый поиск пункта в многостраничном договоре

Цель: найти конкретный термин в PDF, не создавая локальную копию вручную. Подготовка: документ уже загружен в ownCloud и содержит настоящий текстовый слой. Шаги: открыть PDF, вызвать поиск, ввести термин, при необходимости включить целые слова или учёт регистра и переходить между совпадениями. Проверка: число и подсветка результатов соответствуют ожидаемому фрагменту. Ограничение: изображение скана без OCR-текста этим способом не индексируется.

Чтение документа по публичной ссылке

Цель: дать внешнему получателю возможность открыть PDF в браузере. Подготовка: владелец создал публичную ссылку и политика share разрешает получение файла. Шаги: открыть ссылку в поддерживаемом браузере, дождаться встроенного просмотрщика и пролистать несколько страниц. Проверка: файл отображается без входа в обычную учётную запись ownCloud. Ограничение: если атрибут download запрещён, files_pdfviewer сознательно откажется запускаться; это нужно решать политикой доступа, а не обходом в браузере.

Проверка защищённого паролем PDF

Цель: прочитать документ, для открытия которого известен пароль. Подготовка: загрузить PDF в разрешённую папку и иметь пароль от самого документа. Шаги: открыть файл, ввести пароль в диалоге PDF.js и перейти к нужной странице. Проверка: содержимое отображается и навигация работает. Ограничение: просмотрщик не снимает пароль и не превращает документ в незашифрованную копию.

Передача оригинала коллеге без конвертации

Цель: убедиться, что получатель получит исходный PDF, а не результат браузерной печати. Подготовка: документ открыт во встроенном просмотрщике. Шаги: использовать Download, передать полученную копию разрешённым каналом и открыть её независимым PDF-ридером. Проверка: имя, размер, число страниц и содержание совпадают с серверным оригиналом. Ограничение: Print и системная «печать в PDF» создают новый вывод и могут потерять формы, вложения, слои или другую интерактивность.

Контроль перед сохранением и передачей

Убедитесь, что скачивается именно исходный PDF, если важны подписи, вложения, формы или точные метаданные.

Проверьте разрешения общей ссылки до отправки получателю: встроенный просмотрщик зависит от разрешения download.

Для конфиденциального документа не включайте PDF-scripting только ради удобства без согласования рисков.

Если файл — скан, заранее проверьте наличие текстового слоя, когда получателю нужен поиск.

Откройте скачанную копию другим ридером, если документ должен использоваться вне ownCloud.

При печати сравните количество страниц и ориентацию, особенно после ручного поворота только в интерфейсе.

Навигатор по сбоям

Часто задаваемые вопросы

Как узнать установленную версию Files PDF Viewer?

Администратор может посмотреть состояние приложений в Settings → Admin → Apps или через occ. В Docker-конфигурации собственные команды ownCloud запускаются как docker compose exec owncloud occ …; список приложений показывает версии установленных компонентов. Это надёжнее, чем судить о версии по внешнему виду панели.

Стоит ли вручную заменять встроенный PDF.js на более новый?

Для рабочей системы — нет. ownCloud поставляет конкретную сборку PDF.js вместе с собственными патчами и CSP-настройками. Самовольная замена может разрушить совместимость и лишить перенесённых исправлений. Обновлять движок следует через официальный релиз приложения.

Создаёт ли просмотрщик дополнительную копию PDF на сервере?

Штатный сценарий открывает существующий объект через URL загрузки ownCloud и не заявляет создание новой серверной копии только ради просмотра. Локальная копия появляется, когда пользователь сознательно нажимает Download.

Можно ли пользоваться просмотрщиком без доступа к интернету?

Глобальный интернет не обязателен, если сервер ownCloud доступен по локальной сети. Но сам просмотрщик не является офлайн-программой: браузеру всё равно нужен доступ к ownCloud, чтобы получить документ и компоненты приложения.

Нужно ли отдельно резервировать настройки просмотрщика?

Код поставляемого приложения восстанавливается из официального образа. Для аварийного восстановления важнее обычная резервная копия данных и конфигурации ownCloud; отдельно стоит зафиксировать нестандартную настройку scripting. Ручные изменения файлов приложения лучше не использовать как способ настройки.

Почему одинаковое имя PDF Viewer не гарантирует одинаковое поведение в разных ownCloud?

Classic и Infinite Scale используют разные фронтенды и разные PDF-компоненты. Поэтому при миграции нужно заново проверять функции и браузерную совместимость, а не переносить ожидания от files_pdfviewer на ownCloud Web.

Вывод

ownCloud PDF Viewer 1.1.2 — логичный компонент для организаций, которые уже используют ownCloud Classic 11 и хотят читать PDF прямо из файлового интерфейса. Его сильная сторона не в уникальных функциях PDF, а в правильном месте выполнения: документ остаётся в контексте ownCloud, открывается в браузере, поддерживает поиск, миниатюры, оглавление, вложения, масштаб, печать и скачивание, а приложение не требует отдельной лицензии.

Продукт не подходит как универсальный PDF-комбайн. Для OCR, редактирования текста и страниц, конвертации, сложных комментариев и подписей нужен специализированный инструмент; для автономного чтения на Windows без сервера удобнее Sumatra PDF; для развитой работы с формами и аннотациями — Acrobat Reader или иной полноценный клиент. Если организация использует ownCloud Infinite Scale, следует выбирать встроенный PDF-компонент ownCloud Web, а не files_pdfviewer для Classic.

Главные эксплуатационные условия просты: держать ownCloud и приложение на поддерживаемых версиях, использовать современный браузер, не включать JavaScript внутри PDF без необходимости и помнить, что запрет скачивания публичного ресурса блокирует и встроенный просмотр. При таком профиле ownCloud PDF Viewer выполняет свою узкую задачу без лишней сложности.