安装 DocuBrowse

面向 Linux(RPM、DEB、tarball)、Windows(zip)和 macOS(dmg)的安装包。请从 GitHub Releases 页面下载。完整的分步指南见 INSTALL.md。

系统要求

不支持 32 位系统(Ollama 不提供 32 位版本)。UI 使用现代浏览器(Chrome、Firefox、Safari、Edge)。

安装

Fedora / RHEL

sudo dnf install ./docubrowser-foss-<VERSION>-<RELEASE>.noarch.rpm

Debian / Ubuntu / Mint

sudo apt install ./docubrowser-foss_<VERSION>-<RELEASE>_all.deb

任意 Linux(tarball)

tar xzf docubrowser-foss-<VERSION>-<RELEASE>.tar.gz
cd docubrowser-foss-<VERSION>-<RELEASE>
sudo ./install.sh

所有 Linux 方式都会安装到 /opt/docubrowser/(带 Python 虚拟环境),在 /usr/bin/docubrowser 和 /usr/bin/docuback 放置 CLI 包装器,并在 Office 分类下创建桌面菜单项。

Windows

解压 zip 并双击 Install.bat。需要预先安装 Python 3.9+ 和 Ollama。安装到 %USERPROFILE%\DocuBrowse 并创建开始菜单快捷方式,无需管理员权限。快捷方式出现前,你可能需要注销并重新登录。

macOS

打开 dmg 并双击 Install.command(脚本未签名,首次请右键 → 打开)。需要 Python 3.9+。安装到 ~/Applications/DocuBrowse/,带 CLI 包装器和 DocuBrowse.app 启动器。

首次运行

docubrowser rescan   # 扫描并索引你的文档
docubrowser start    # 启动服务器
docubrowser open     # 在浏览器中打开 UI

start 会检查 Ollama 是否已安装、正在运行,并具备两个所需模型(用于嵌入的 nomic-embed-text:latest 和用于摘要的 dolphin3:latest),然后安装、启动或拉取缺失的部分。

语言: DocuBrowse 以英语启动。在终端中首次 docubrowser start 时,它会询问你想用的语言(英语、日语、韩语、简体或繁体中文),你也可以随时在设置中更改。见 语言。

先决条件

打包安装会从 requirements.txt 引入 Python 依赖。若使用克隆的仓库,你需要 Python 3.9+ 以及:

• pdfplumber、pypdf:PDF 提取
• python-docx、python-pptx、openpyxl:Office 文件
• ebooklib、beautifulsoup4、mobi:电子书
• striprtf:RTF(没有它 .rtf 仅按元数据索引)
• psutil:硬件检测
• Calibre:MOBI/AZW3/AZW 必需(sudo dnf install calibre 或 sudo apt install calibre)
• libvisio-tools(可选):旧版二进制 Visio 文件的正文文本
• DjVuLibre(可选):DjVu 文件的文本
• Ollama:若缺失,docubrowser start 会自动安装

卸载

sudo dnf remove docubrowser-foss       # RPM
sudo apt remove docubrowser-foss       # DEB
sudo ./uninstall.sh                    # tarball

Windows:双击 Uninstall.bat。macOS:双击 Uninstall.command。

故障排查

Ollama 无法启动

ollama serve
ollama list
ollama pull nomic-embed-text:latest
ollama pull dolphin3:latest

扫描进度看起来卡住

tail -f /var/log/docubrowser.log
# 或
tail -f ~/.local/share/docubrowser/docubrowser.log

inotify 监视上限

大型集合可能在日志中出现 inotify watch limit reached。可以安全忽略。若要消除它,在 /etc/sysctl.conf 中把 fs.inotify.max_user_instances 提高到 256 或 512,然后运行 sudo sysctl -p。

扫描件(纯图像)PDF

它们以占位符索引并列入 ocr_list_pdfs.txt,但在运行 OCR 之前不会匹配搜索。