安裝 DocuBrowse

適用於 Linux(RPM、DEB、tarball)、Windows(zip)和 macOS(dmg)的安裝套件。請從 GitHub Releases 頁面下載。完整的逐步指南見 INSTALL.md。

系統需求

	最低	建議
記憶體	8 GB	12 GB
CPU	x86_64 或 ARM64	x86_64 或 ARM64
GPU	無(摘要較慢)	4 GB 以上顯示記憶體(NVIDIA 或 Apple Silicon)
磁碟	2 GB 可用空間,外加你的文件與索引	—

不支援 32 位元系統(Ollama 不提供 32 位元版本)。UI 使用現代瀏覽器(Chrome、Firefox、Safari、Edge)。

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

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

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 分類下建立桌面選單項目。

解壓縮 zip 並按兩下 Install.bat。需要預先安裝 Python 3.9+ 和 Ollama。安裝到 %USERPROFILE%\DocuBrowse 並建立「開始」選單捷徑,無需系統管理員權限。捷徑出現前,你可能需要登出後重新登入。

開啟 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),然後安裝、啟動或下載缺少的部分。

預設未設定文件目錄。首次掃描前,請按一下 Web UI 中的齒輪圖示,或在 docubrowse.config 中設定 doc_dir。

語言: 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 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 watch limit reached。可以安全忽略。若要消除它,在 /etc/sysctl.conf 中把 fs.inotify.max_user_instances 提高到 256 或 512,然後執行 sudo sysctl -p。

它們會以預留位置索引並列入 ocr_list_pdfs.txt,但在執行 OCR 之前不會比對到搜尋。