在本教程中，我們將展示如何在 Raspberry Pi 上安裝和運(yùn)行 Paperless-NG。

Paperless-NG 是一款功能強(qiáng)大的軟件，旨在充當(dāng)所有紙質(zhì)文檔的數(shù)字檔案/索引。

當(dāng)送入 Paperless-NG 文檔時(shí)。它將對其執(zhí)行 OCR（光學(xué)字符識別），將圖像轉(zhuǎn)換為可搜索和可選擇的文本。

這只是無紙化功能的冰山一角。如果需要一個(gè)集中的地方來聚合文件，一定要試試這個(gè)軟件。

Raspberry Pi 是無紙化 NG的優(yōu)秀設(shè)備，因?yàn)樗褂玫碗娏?，使其連續(xù)運(yùn)行成本低廉。

為了獲得 Paperless-NG 的最佳體驗(yàn)，應(yīng)該使用具有 4GB 或更多內(nèi)存的 Raspberry Pi 4 或更新版本。此外，如果還使用 64 位操作系統(tǒng)，它會(huì)有所幫助，以便它可以充分利用您設(shè)備的內(nèi)存。

需要的設(shè)備

• 樹莓派

• 微型 SD 卡

• 電源

• 以太網(wǎng)電纜或Wi-Fi

本教程在運(yùn)行最新版本Raspberry Pi OS Bullseye 64 位的Raspberry Pi 400上進(jìn)行了測試。

為無紙化 NG 準(zhǔn)備 Raspberry Pi

本節(jié)將展示為無紙化 NG 準(zhǔn)備 Raspberry Pi 的步驟。

我們需要在這里完成的兩個(gè)主要任務(wù)是安裝“ docker-compose”并創(chuàng)建一個(gè)目錄，Paperless 將在其中獲取文檔。

1.在我們做任何事情之前，我們需要更新包列表并升級任何過時(shí)的包。

要完成這些任務(wù)，請?jiān)诮K端中運(yùn)行以下兩個(gè)命令。

sudoapt updatesudoapt upgrade

2.更新完成后，我們可以安裝運(yùn)行 Paperless-NG 所需的軟件包。由于 Paperless 出現(xiàn)在 docker 容器中，我們只需要安裝 Docker。

可以docker-compose使用以下命令將“ ”安裝到 Raspberry Pi。

sudoaptinstalldocker-compose

3.現(xiàn)在我們已經(jīng)安裝了 Docker，我們需要?jiǎng)?chuàng)建一個(gè)目錄，Paperless 將從中檢索任何新文檔。

對于本教程，我們將在用戶的主目錄中創(chuàng)建一個(gè)名為“ consume”的文件夾，該文件夾將位于另一個(gè)名為“ paperless”的目錄中。

可以在終端中使用以下命令創(chuàng)建這些目錄。

mkdir-p ~/paperless/consume

在 Raspberry Pi 上安裝 Paperless-NG

準(zhǔn)備好 Raspberry Pi 后，我們可以繼續(xù)安裝 Paperless-NG。在這些步驟中，我們將編寫一個(gè)“ docker-compose.yml”文件和一個(gè)安裝和運(yùn)行 Paperless-NG 所需的環(huán)境文件。

1.讓我們首先進(jìn)入我們在前面的步驟中創(chuàng)建的目錄。

可以在終端中使用 cd 命令更改到此目錄。

cd ~/paperless/

創(chuàng)建 docker-compose.yml 文件

2.進(jìn)入“ paperless”目錄后，我們可以使用以下命令開始編寫此 Docker 配置文件。

該文件告訴 Docker 它需要下載和運(yùn)行哪些容器。

nano docker-compose.yml

3.在此配置文件中，鍵入以下行。我們將探索可能想要稍微調(diào)整的幾個(gè)選項(xiàng)。

version:"3.4"services:

 broker:    image: redis:6.0    restart: unless-stopped  webserver:    image: jonaswinkler/paperless-ng:latest    restart: unless-stopped    depends_on:      - broker    ports:      - 8000:8000    healthcheck:      test:["CMD","curl","-f","http://localhost:8000"]      interval: 30s      timeout: 10s      retries:5    volumes:      - data:/usr/src/paperless/data      - media:/usr/src/paperless/media      - ./export:/usr/src/paperless/export      - ./consume:/usr/src/paperless/consume    env_file: docker-compose.env    environment:      PAPERLESS_REDIS: redis://broker:6379volumes:  data:  media:

4.在配置文件中，可能需要針對Paperless-NG進(jìn)行一些調(diào)整以適合 Raspberry Pi。

如果愿意堅(jiān)持使用默認(rèn)設(shè)置，則可以跳到下一步。

更改無紙化 NG 運(yùn)行的端口

可能想要更改的第一件事是 Paperless-NG 在 Raspberry Pi 上使用的端口。

默認(rèn)情況下，它將在端口上運(yùn)行，8000但可以將其更改為另一個(gè)端口。

要更改端口，需要替換冒號左側(cè)的數(shù)字。

ports:

     - 8000:8000

例如，如果想更改它以便 Paperless 在端口上運(yùn)行8080，可以將其更改為如下所示。

ports:      - 8080:8000

更改攝取目錄

可能想要更改的另一個(gè)選項(xiàng)是 Paperless 將在 Raspberry Pi 上查找文件的位置。默認(rèn)情況下，這將是名稱為“ consume”的相對目錄（我們在本教程的前面部分為此創(chuàng)建了一個(gè)位置）。

如果要更改 Paperless 從中導(dǎo)入文檔的目錄，則需要更改列左側(cè)的目錄。

- ./consume:/usr/src/paperless/consume

例如，如果想從安裝在“ /mnt/paperless”的共享中導(dǎo)入文件夾，可以將此行更改為如下所示。

- /mnt/paperless:/usr/src/paperless/consume

5.完成此文件的編輯后，可以按CTRL+保存并退出X，然后按Y，然后按ENTER。

編寫無紙化 NG 環(huán)境文件

6.我們需要一個(gè)隨機(jī)字符串作為 Paperless-NG 的密鑰。

可以在終端中使用以下命令生成隨機(jī)密鑰。

cat /dev/urandom |tr-dc'a-zA-Z0-9'|fold-w64|head-n1

運(yùn)行此命令后，應(yīng)該會(huì)得到如下所示的結(jié)果。復(fù)制此字符串，因?yàn)槲覀儗⒃谙乱徊街惺褂盟?/p>

McziUH4c8lidzd4wggZj5q1tpgBv7DcPMtFv5RD7f0rFUrQFOmh8rSOiuMwp9N6P

7.我們可以docker-compose.env通過運(yùn)行以下命令開始編寫“”文件。

nano docker-compose.env

8.在此文件中，您需要編寫以下行。我們將在插入時(shí)解釋每一部分。我們將添加的第一行設(shè)置無紙化的密鑰。將“ ”替換在第 6 步Y(jié)OURSECRETKEY中生成的密鑰。

PAPERLESS_SECRET_KEY=YOURSECRETKEY

9.讓我們從“ USERMAP”選項(xiàng)開始。這些選項(xiàng)將 Docker 容器映射到特定的用戶和組。使用 Raspberry Pi OS 時(shí)，主要用戶的 ID 為1000.

如果使用的是不同的，則需要更改這些值

USERMAP_UID=1000USERMAP_GID=1000

10.下一個(gè)選項(xiàng)允許為無紙化添加其他語言以支持 Raspberry Pi。如果只需要默認(rèn)語言，則可以跳過添加此選項(xiàng)。

默認(rèn)情況下，Paperless 支持英語、德語、意大利語、西班牙語和法語。但是，通過查看 Debian 軟件包列表，該軟件可以支持更多。

每種附加語言都應(yīng)通過其三字母代碼（EGces表示捷克語）進(jìn)行引用?？梢酝ㄟ^用一個(gè)空格分隔每種語言來添加多種其他語言

PAPERLESS_OCR_LANGUAGES=ADDITIONAL LANGS HERE

11.默認(rèn)情況下，Paperless-NG 將使用 UTC 時(shí)區(qū)。PAPERLESS_TIME_ZONE但是，我們可以通過設(shè)置“ ”選項(xiàng)將其更改為您當(dāng)?shù)氐臅r(shí)區(qū)。

可以在維基百科上找到時(shí)區(qū)列表。要的值在“ TZ database name”列中。

例如，我們將使用以下行將時(shí)區(qū)設(shè)置為澳大利亞霍巴特。

PAPERLESS_TIME_ZONE=Australia/Hobart

12.我們將在本節(jié)中探討的最后一個(gè)選項(xiàng)是設(shè)置無紙化將在 Raspberry Pi 上用于 OCR 的默認(rèn)語言。

應(yīng)該將此選項(xiàng)設(shè)置為大部分文檔將使用的語言。

通過我們在下面添加的行，我們將默認(rèn)語言設(shè)置為英語。

PAPERLESS_OCR_LANGUAGE=eng

13.完成后，可以按CTRL+保存并退出X，然后按Y, 然后按ENTER鍵。

在 Raspberry Pi 上運(yùn)行無紙化 NG 安裝

14.最后，我們可以使用以下命令在樹莓派上運(yùn)行無紙化。

Docker 將立即開始下載所有需要的容器并使用我們的配置啟動(dòng)它們。

sudodocker-compose up -d

15.一旦 Paperless-NG 在 Raspberry Pi 上啟動(dòng)并運(yùn)行，將需要?jiǎng)?chuàng)建一個(gè)用戶。

要啟動(dòng)此過程，必須在終端中運(yùn)行以下命令。

sudodocker-compose run --rm webserver createsuperuser

16.將被要求的第一件事是為新用戶指定一個(gè)用戶名。

如果在ENTER不輸入任何內(nèi)容的情況下按下，Paperless 將創(chuàng)建名為“ paperless”的用戶。

Username (leave blank to use 'paperless'):

17.現(xiàn)在將要求選擇性地輸入該用戶的電子郵件地址。

如果不想給用戶分配電子郵件，可以離開這個(gè)空間。

Email address:

18.接下來，將需要輸入該用戶的密碼。確保這是安全的，并且不會(huì)與電子郵件地址或用戶名過于接近。

Password:

將需要重新輸入密碼以進(jìn)行確認(rèn)。

Password (again):

20.如果 Paperless-NG 用戶已成功創(chuàng)建，應(yīng)該會(huì)在終端中看到以下消息。

現(xiàn)在可以繼續(xù)在 Raspberry Pi 上登錄和使用 Paperless。

Superuser created successfully.

使用 Raspberry Pi 的無紙化網(wǎng)絡(luò)界面

在接下來的幾節(jié)中，我們將向您展示如何訪問和使用 Paperless-NG 的網(wǎng)絡(luò)界面。

本節(jié)只需要您最喜歡的網(wǎng)絡(luò)瀏覽器和與 Raspberry Pi 的連接。

訪問無紙化網(wǎng)絡(luò)界面

1.要訪問 Raspberry Pi 上的 Paperless-NG 網(wǎng)絡(luò)界面，需要知道它的 IP 地址。

獲取 Raspberry Pi IP 的最簡單方法是在終端中使用主機(jī)名命令。

hostname-I

通常，分配給 Pi 的 IP 將是列出的第一個(gè)地址。

2.知道 Raspberry Pi 的 IP 地址后，將需要轉(zhuǎn)到以下地址。

確保IPADDRESS用 IP 替換“ ”。8000如果更改了 Docker 配置文件中的端口，還需要更改端口“ ”。

http://IPADDRESS:8000

3.現(xiàn)在將看到無紙化登錄屏幕。在此屏幕上，需要填寫在上一節(jié)中設(shè)置的用戶名和密碼 ( 1. )。

填寫登錄詳細(xì)信息后，click“ Sign in”按鈕 ( 2. )。

4.現(xiàn)在將看到 Paperless-NG 儀表板?？梢允褂么藘x表板查看所有文檔并進(jìn)行管理。

甚至可以使用此界面將文檔手動(dòng)上傳到 Paperless 進(jìn)行處理。

通過 Web 界面將文檔上傳到無紙化

5.要通過無紙化將文件上傳到 Raspberry Pi，需要將其拖放到左側(cè)邊欄中，如圖所示。

或者，可以點(diǎn)擊click“ Browse files”按鈕，手動(dòng)選擇要上傳的文件。

6.將文件上傳到 Paperless 后，它將自動(dòng)開始處理文檔。

此過程可能需要時(shí)間，因?yàn)樗枰獟呙枵麄€(gè)文檔。

編輯已處理的文檔

7.將文檔上傳到無紙化后，就可以編輯為其生成的元數(shù)據(jù)。這對于正確分類上傳的所有不同文檔很有用。

編輯元數(shù)據(jù)還有助于 Paperless 的機(jī)器學(xué)習(xí)自動(dòng)對文檔進(jìn)行分類。

要編輯文檔，可以在上傳后立即click“ Open document”（1. ）。

Documents或者，可以在“ ”頁面 ( 2. )上找到這些文檔

8.下面，可以看到我們上傳到 Paperless 的屏幕截圖的編輯屏幕。

它試圖掃描文檔，讓輕松突出顯示和復(fù)制文本。

可以使用文檔屏幕編輯有關(guān)此文檔的各種詳細(xì)信息，例如標(biāo)題、標(biāo)簽、文檔類型等。

結(jié)論

現(xiàn)在應(yīng)該已經(jīng)在 Raspberry Pi 上啟動(dòng)并運(yùn)行了 Paperless-NG。