簡(jiǎn)介

Bianbu NAS 是在 Bianbu 操作系統(tǒng)基礎(chǔ)上精簡(jiǎn)并深度優(yōu)化的一款專(zhuān)為 NAS 產(chǎn)品設(shè)計(jì)的系統(tǒng)。它集成了應(yīng)用程序（如 openmediavault、docker 和常用軟件）、框架、庫(kù)、運(yùn)行時(shí)環(huán)境、Linux 內(nèi)核、引導(dǎo)加載程序（U-Boot）和監(jiān)管程序接口（OpenSBI）等多種組件。該系統(tǒng)的目標(biāo)是為客戶(hù)提供 NAS 軟件的參考設(shè)計(jì)，并支持驅(qū)動(dòng)和應(yīng)用程序的開(kāi)發(fā)。

軟件組件

Bianbu NAS 的組件包括：

應(yīng)用

框架

運(yùn)行時(shí)

庫(kù)

Linux 內(nèi)核

U-Boot

OpenSBI

上述組件的軟件包均通過(guò) APT 軟件源 進(jìn)行管理，軟件包是標(biāo)準(zhǔn)的 debian 軟件包格式。

應(yīng)用

Openmediavault

Docker

Wi-Fi AP

軟路由

快速U盤(pán)

SMB、NFS等網(wǎng)絡(luò)協(xié)議組件

多媒體框架

FFmpeg (with Hardware Accelerated)

GStreamer (with Hardware Accelerated)

PipeWire

推理框架

onnxruntime (with Hardware Accelerated)

運(yùn)行時(shí)

Python

Java

Node.js

Rust

Go

庫(kù)

OpenCV (with RVV Accelerated)

OpenSSL (with Hardware Accelerated)

MPP，進(jìn)迭時(shí)空多媒體處理平臺(tái)，提供 C API 和 sample

OpenGLES/Vulkan/OpenCL

Linux 內(nèi)核

Linux 內(nèi)核負(fù)責(zé)管理處理器和其他硬件資源，提供用戶(hù)和應(yīng)用程序與硬件之間的接口。主要功能包括中斷和時(shí)鐘管理、進(jìn)程管理、內(nèi)存管理、文件系統(tǒng)管理、設(shè)備驅(qū)動(dòng)管理和網(wǎng)絡(luò)協(xié)議棧等。

版本：6.1。

源碼：https://gitee.com/bianbu-linux/linux-6.1

U-Boot

U-Boot 是一個(gè)引導(dǎo)加載程序，負(fù)責(zé)初始化特定硬件，從介質(zhì)（如 SD 卡、eMMC、SPI Flash、SSD、網(wǎng)絡(luò)）加載 Linux 內(nèi)核鏡像、設(shè)備樹(shù)和初始 RAM 文件系統(tǒng)。

版本：u-boot-2022.10。

源碼：https://gitee.com/bianbu-linux/uboot-2022.10

OpenSBI

OpenSBI 是 RISC-V 架構(gòu)處理器的監(jiān)管程序接口的實(shí)現(xiàn)，運(yùn)行在 M 模式下的固件，提供引導(dǎo)加載程序、hypervisor、操作系統(tǒng)訪(fǎng)問(wèn)硬件的接口。

版本：1.3。

源碼：https://gitee.com/bianbu-linux/opensbi

支持的設(shè)備

目前，Bianbu NAS 支持以下硬件設(shè)備：

BPI-F3

MUSE N1

MUSE Pi

固件

Bianbu NAS 固件現(xiàn)在有兩個(gè)版本，分別基于 Bianbu OS 23.10 和 Bianbu OS 24.04，此處稱(chēng) Bianbu NAS 23.10 和 Bianbu NAS 24.0。前者經(jīng)過(guò)多個(gè)版本迭代，更穩(wěn)定，推薦下載這個(gè)版本；如果要求更新的操作系統(tǒng)和SDK等，可以下載后者，該版本還在迭代中，有不穩(wěn)定的風(fēng)險(xiǎn)。

Bianbu NAS 23.10 最新版本：v1.0.14。

Bianbu NAS 24.04 最新版本：v2.0beta2。

Bianbu NAS 固件地址：https://archive.spacemit.com/image/k1/version/bianbu/

bianbu-*-nas-*.img.zip 是 sdcard 固件，解壓后可以用 dd 命令或者 balenaEtcher 寫(xiě)入 sdcard。

bianbu-*-nas-*.zip 適用于 Titan Flasher，刷機(jī)參考 刷機(jī)工具使用手冊(cè)，或者解壓后用 fastboot 命令刷機(jī)。

固件 root 用戶(hù)密碼：bianbu。

登錄

系統(tǒng)登錄

系統(tǒng) root 賬戶(hù)密碼默認(rèn)為：bianbu。

串口查看 NAS 設(shè)備 IP 地址 HOST_IP：

ifconfig

獲取 IP 地址之后，通過(guò) SSH 登錄系統(tǒng)：

ssh root@HOST_IP

Openmediavault Web管理界面登錄

Bianbu NAS 由 Openmediavault 應(yīng)用提供完整的 NAS 功能，Openmediavault 提供 Web 使得用戶(hù)可以方便地管理 NAS 服務(wù)。

Openmediavault Web 管理員帳號(hào)：admin

密碼：openmediavault

NAS 設(shè)備上電上網(wǎng)之后，瀏覽器輸入 http://HOST_IP 訪(fǎng)問(wèn) Openmediavault 應(yīng)用的 Web 管理界面。

Wi-Fi AP

Bianbu NAS 集成了 Wi-Fi AP 功能，刷機(jī)自啟，允許客戶(hù)端通過(guò) Wi-Fi 連接到 NAS 設(shè)備，并通過(guò) DHCP 服務(wù)自動(dòng)分配到 IP 地址。

Wi-Fi AP 默認(rèn) SSID：BianbuAP（密碼：12345678）

Wi-Fi AP 默認(rèn) IP：10.0.0.1

連接上 Wi-Fi 之后，瀏覽器輸入 http://10.0.0.1 訪(fǎng)問(wèn) Openmediavault 應(yīng)用的 Web 管理界面。

必要設(shè)置

更新軟件源

第一次下載軟件包之前，更新軟件源（apt update）是必要的。之后也建議定期更新軟件源，以確保系統(tǒng)始終下載到最新的軟件。

點(diǎn)擊“系統(tǒng) -> 更新管理 -> 設(shè)置”， 勾選“預(yù)發(fā)布更新”，點(diǎn)擊“保存”，等待更新。

掛載rootfs

Bianbu NAS 通過(guò) sharerootfs 插件管理 rootfs，如果要掛載 rootfs 請(qǐng)先下載 sharerootfs 插件。

點(diǎn)擊“系統(tǒng) -> 插件”，選中 sharerootfs 插件，點(diǎn)擊下載按鈕。

下載 sharerootfs 插件之后，點(diǎn)擊“存儲(chǔ)器 -> 文件系統(tǒng)”，可以看到 rootfs 已掛載。

文件共享協(xié)議

文件共享協(xié)議允許通過(guò)網(wǎng)絡(luò)將 Bianbu NAS 上的文件共享給局域網(wǎng)內(nèi)的其他主機(jī)，這是 NAS 產(chǎn)品的核心功能之一。通常，文件共享協(xié)議以 systemd 服務(wù)的形式注冊(cè)到系統(tǒng)中，因此也可以稱(chēng)為文件共享服務(wù)。本節(jié)將以配置 SMB 服務(wù)為例，詳細(xì)介紹文件共享服務(wù)的配置流程，其他文件共享服務(wù)的配置可參照此流程進(jìn)行。

服務(wù)端配置

修改主機(jī)名

SMB 服務(wù)要求主機(jī)名小于15個(gè)字符，所以需要先修改默認(rèn)的主機(jī)名。其他文件共享服務(wù)沒(méi)有這個(gè)要求，可跳過(guò)這一步。

[!NOTE]

修改主機(jī)名的過(guò)程會(huì)再次通過(guò) DHCP 服務(wù)獲取 IP 地址，這意味著 IP 地址可能會(huì)更新。如果修改過(guò)程中出現(xiàn)網(wǎng)頁(yè)跳轉(zhuǎn)或刷新之后提示不存在等問(wèn)題，大概率是 IP 地址更新了，需重新查看并登錄新的 IP 地址進(jìn)行后續(xù)操作。

點(diǎn)擊“網(wǎng)絡(luò) -> 常規(guī)”，設(shè)置主機(jī)名。點(diǎn)擊“保存”。

點(diǎn)擊保存之后只是將更改保存到了數(shù)據(jù)庫(kù)里，要將其應(yīng)用到底層系統(tǒng)，需要進(jìn)一步點(diǎn)擊"應(yīng)用更改"，此時(shí)系統(tǒng)會(huì)調(diào)用 salt 命令將數(shù)據(jù)庫(kù)的記錄寫(xiě)到系統(tǒng)配置，并重啟系統(tǒng)服務(wù)。

掛載磁盤(pán)

共享的數(shù)據(jù)存儲(chǔ)在磁盤(pán)上，故先掛載磁盤(pán)。如果該磁盤(pán)分區(qū)沒(méi)有格式化，請(qǐng)先格式化（這一步要謹(jǐn)慎?。。。?。

點(diǎn)擊“存儲(chǔ)器 -> 文件系統(tǒng) -> 掛載”，選擇要共享的磁盤(pán)并掛載。

創(chuàng)建共享文件夾

磁盤(pán)掛載之后不能直接使用，需要進(jìn)一步創(chuàng)建共享文件夾，方便進(jìn)行權(quán)限管理和數(shù)據(jù)隔離。

點(diǎn)擊“存儲(chǔ)器 -> 共享文件夾”，選擇目標(biāo)磁盤(pán)，在上面創(chuàng)建共享文件夾（以 smb-share 為例）。共享時(shí)將該文件夾通過(guò)網(wǎng)絡(luò)服務(wù)共享出去。

創(chuàng)建SMB服務(wù)實(shí)例

點(diǎn)擊“服務(wù) -> SMB/CIFS -> 設(shè)置”，配置 SMB 服務(wù)，這里的設(shè)置是全局的，對(duì)所有 SMB 服務(wù)實(shí)例有效。

進(jìn)一步，點(diǎn)擊“服務(wù)- > SMB/CIFS -> 共享”，設(shè)置具體的 SMB 服務(wù)實(shí)例，這一步要選擇共享文件夾（以 smb-share 為例）。

設(shè)置用戶(hù)權(quán)限

共享服務(wù)的目的是在遠(yuǎn)端訪(fǎng)問(wèn)服務(wù)器資源，遠(yuǎn)端訪(fǎng)問(wèn)的時(shí)候需要權(quán)限，確保遠(yuǎn)端登錄的用戶(hù)對(duì)訪(fǎng)問(wèn)的共享文件夾具備相應(yīng)權(quán)限。這里以創(chuàng)建一個(gè)用戶(hù)并設(shè)置權(quán)限為例。

點(diǎn)擊“用戶(hù) -> 用戶(hù)”，創(chuàng)建用戶(hù)（以 bianbu 用戶(hù)為例，設(shè)置用戶(hù)名和密碼均為 bianbu）。

點(diǎn)擊“用戶(hù) -> 用戶(hù) -> 共享文件夾權(quán)限 ”，設(shè)置用戶(hù)對(duì)共享文件夾的權(quán)限。設(shè)置 bianbu 用戶(hù)對(duì) smb-share 共享文件夾的權(quán)限為可讀可寫(xiě)。

在客戶(hù)端連接 SMB 服務(wù)的時(shí)候，以該用戶(hù)進(jìn)行登錄，即對(duì)共享的 SMB 服務(wù)具備預(yù)先設(shè)置的權(quán)限。

客戶(hù)端連接

本節(jié)介紹不同客戶(hù)端連接 SMB 服務(wù)的方法。假設(shè)：

服務(wù)端 IP 地址為 HOST_IP；

已搭建 SMB 服務(wù)實(shí)例，SMB 共享文件夾名為 smb-share；

已創(chuàng)建用戶(hù)并設(shè)置對(duì) smb-share 的權(quán)限為可讀可寫(xiě)，用戶(hù)名和密碼均為 bianbu。

Windows 文件管理器

打開(kāi)“文件資源管理器”，選擇“計(jì)算機(jī) -> 映射網(wǎng)絡(luò)驅(qū)動(dòng)器”，輸入共享文件夾地址：

\HOST_IPsmb-share

Linux Nautilus 文件管理器

打開(kāi) Nautilus 文件管理器，選擇“Other Locations”，輸入共享文件夾地址：

smb://HOST_IP/smb-share

Linux CLI

mount.cifs //{HOST_IP}/smb-share /your_mount_path -o user=bianbu,password=bianbu

Docker服務(wù)

介紹 Docker 服務(wù)的設(shè)置、陳列已移植的 Docker 鏡像、介紹主流 Docker 應(yīng)用的部署。

?Docker應(yīng)用列表

當(dāng)前已移植了一些典型的 Docker 應(yīng)用，名稱(chēng)和地址為：

?docker-compose插件

Bianbu NAS 使用 docker-compose 工具來(lái)部署 Docker 服務(wù)。當(dāng)單個(gè)容器無(wú)法滿(mǎn)足應(yīng)用的運(yùn)行環(huán)境需求時(shí)，docker-compose 可以方便地定義和管理多個(gè)容器。

?NextCloud

Nextcloud 是一個(gè)開(kāi)源的文件同步和共享平臺(tái)，類(lèi)似于私人云存儲(chǔ)服務(wù)。它允許用戶(hù)在自己的服務(wù)器上托管文件、日歷、聯(lián)系人等數(shù)據(jù)，確保數(shù)據(jù)的完全控制和隱私保護(hù)。Nextcloud 支持文件同步、在線(xiàn)協(xié)作、共享以及與各種應(yīng)用和服務(wù)的集成，廣泛應(yīng)用于企業(yè)、組織和個(gè)人的云解決方案。

?Kodbox

Kodbox 是一款開(kāi)源的在線(xiàn)文件管理系統(tǒng)，類(lèi)似于私人云盤(pán)。它支持多用戶(hù)管理和文件共享，允許用戶(hù)通過(guò)瀏覽器方便地管理、預(yù)覽、編輯和分享文件。Kodbox 具備文件上傳下載、在線(xiàn)預(yù)覽、文檔編輯、多格式支持等功能，適合個(gè)人和團(tuán)隊(duì)在局域網(wǎng)或服務(wù)器上搭建私有云盤(pán)進(jìn)行文件管理。它支持豐富的插件擴(kuò)展，界面友好，常用于企業(yè)內(nèi)部文件管理或團(tuán)隊(duì)協(xié)作。

?Frigate

Frigate 是一個(gè)開(kāi)源的視頻監(jiān)控系統(tǒng)，專(zhuān)為實(shí)時(shí)對(duì)象檢測(cè)設(shè)計(jì)，通常用于家庭安全攝像頭管理。它利用機(jī)器學(xué)習(xí)模型（如 YOLO）進(jìn)行實(shí)時(shí)的物體檢測(cè)，能夠檢測(cè)和識(shí)別攝像頭捕獲的運(yùn)動(dòng)物體（如人、車(chē)輛等）。Frigate 支持硬件加速（如使用 GPU 或 Google Coral TPU），能夠提高視頻處理性能。它集成了Home Assistant，并支持錄制、事件檢測(cè)和通知功能，非常適合智能家居監(jiān)控場(chǎng)景。

?Immich

Immich 是一個(gè)開(kāi)源的自托管照片和視頻備份解決方案，專(zhuān)為個(gè)人和家庭用戶(hù)設(shè)計(jì)

Docker應(yīng)用列表

當(dāng)前已移植了一些典型的 Docker 應(yīng)用，名稱(chēng)和地址為：

Docker應(yīng)用名稱(chēng)	鏡像地址
Nextcloud	harbor.spacemit.com/application/nextcloud:28.0.3
Kodbox	harbor.spacemit.com/application/kodbox:1.50.02
Frigate	harbor.spacemit.com/application/frigate:v26
Immich_Machine_Learning	harbor.spacemit.com/application/immich-machine-learning:v1.107.2
Immich_Server	harbor.spacemit.com/application/immich-server:v1.107.2
Filebrowser	harbor.spacemit.com/application/filebrowser:2.28.0

上述 Docker 鏡像均可使用 docker pull 命令拉取。

docker-compose插件

Bianbu NAS 使用 docker-compose 工具來(lái)部署 Docker 服務(wù)。當(dāng)單個(gè)容器無(wú)法滿(mǎn)足應(yīng)用的運(yùn)行環(huán)境需求時(shí)，docker-compose 可以方便地定義和管理多個(gè)容器。

啟動(dòng)Docker后臺(tái)服務(wù)

在創(chuàng)建 Docker 服務(wù)實(shí)例之前，需先確保 Docker 后臺(tái)服務(wù)已啟動(dòng)。執(zhí)行下述操作開(kāi)啟 Docker 后臺(tái)服務(wù)：

掛載磁盤(pán)和創(chuàng)建共享文件夾，至少創(chuàng)建三個(gè)共享文件夾。

下載 compose 插件，下載后在“服務(wù)”頁(yè)查看 compose 插件。

打開(kāi)“服務(wù) -> Compose -> 設(shè)置”，選擇共享文件夾，啟動(dòng) Docker 服務(wù)。

創(chuàng)建Docker服務(wù)實(shí)例

以 Filebrowser 程序（一個(gè)開(kāi)源的基于 Web 的文件管理工具）為例，介紹如何在 Bianbu NAS 上創(chuàng)建和訪(fǎng)問(wèn) Docker 服務(wù)實(shí)例。

點(diǎn)擊“服務(wù) -> Compose -> 文件”，點(diǎn)擊“?”添加 docker-compose.yml 文件：

填寫(xiě)內(nèi)容如下：

version: '3.8' services: filebrowser: image: harbor.spacemit.com/application/filebrowser:2.28.0 container_name: filebrowser volumes: - ./filebrowser_data:/srv # 將文件掛載到宿主機(jī)目錄 - ./filebrowser_config:/config # 配置文件目錄 ports: - "8080:8080" # 將 8080 端口映射到容器的 8080 端口 restart: unless-stopped

填寫(xiě)之后，點(diǎn)擊保存，等待檢查 docker-compose.yml 文件格式。檢查無(wú)誤，點(diǎn)擊“??”按鈕拉取服務(wù)。

如果本地沒(méi)有下載 Docker 鏡像，第一次拉取會(huì)比較耗時(shí)，因?yàn)橐螺d鏡像。拉取完成之后，瀏覽器輸入 https://HOST_IP:8080 訪(fǎng)問(wèn) Filebrowser，初始帳號(hào)和密碼均為 admin。

docker-compose指令解釋

docker-compose up

解析 docker-compose.yml 文件，拉取鏡像（如果本地沒(méi)有鏡像）、創(chuàng)建網(wǎng)絡(luò)、容器和卷、啟動(dòng)服務(wù)。

docker-compose stop

停止運(yùn)行的容器，但保留容器的狀態(tài)和數(shù)據(jù)，可通過(guò) docker-compose up 指令恢復(fù)。

docker-compose down

停止容器，并刪除容器、網(wǎng)絡(luò)、卷等相關(guān)數(shù)據(jù)和狀態(tài)，不能通過(guò) docker-compose up 恢復(fù)。

查看服務(wù)運(yùn)行日志

NextCloud

Nextcloud 是一個(gè)開(kāi)源的文件同步和共享平臺(tái)，類(lèi)似于私人云存儲(chǔ)服務(wù)。它允許用戶(hù)在自己的服務(wù)器上托管文件、日歷、聯(lián)系人等數(shù)據(jù)，確保數(shù)據(jù)的完全控制和隱私保護(hù)。Nextcloud 支持文件同步、在線(xiàn)協(xié)作、共享以及與各種應(yīng)用和服務(wù)的集成，廣泛應(yīng)用于企業(yè)、組織和個(gè)人的云解決方案。

NextCloud 的 docker-compose.yml 內(nèi)容如下：

version: '3.2' networks: default: name: nextcloud services: app: image: harbor.spacemit.com/application/nextcloud:28.0.3 # 移植的NextCloud鏡像 restart: unless-stopped volumes: - ./Nextcloud_docker/app:/var/www/html environment: - MYSQL_PASSWORD=nextcloud_password # 按需修改 - MYSQL_DATABASE=nextcloud - MYSQL_USER=nextcloud - MYSQL_HOST=db - TZ=Asia/Shanghai ports: - 8443:443 # 映射 HTTPS 端口 networks: - default db: image: harbor.spacemit.com/application/mariadb:10.11.6 # 移植的MariaDB鏡像 restart: unless-stopped volumes: - ./Nextcloud_docker/db:/var/lib/mysql environment: - MYSQL_ROOT_PASSWORD=nextcloud_mysql_password # 按需修改 - MYSQL_PASSWORD=nextcloud_password # 按需修改 - MYSQL_DATABASE=nextcloud - MYSQL_USER=nextcloud - TZ=Asia/Shanghai networks: - default

拉取服務(wù)后，瀏覽器輸入 https://HOST_IP:8443 訪(fǎng)問(wèn) NextCloud，管理員賬號(hào)和密碼自行設(shè)置。

Kodbox

Kodbox 是一款開(kāi)源的在線(xiàn)文件管理系統(tǒng)，類(lèi)似于私人云盤(pán)。它支持多用戶(hù)管理和文件共享，允許用戶(hù)通過(guò)瀏覽器方便地管理、預(yù)覽、編輯和分享文件。Kodbox 具備文件上傳下載、在線(xiàn)預(yù)覽、文檔編輯、多格式支持等功能，適合個(gè)人和團(tuán)隊(duì)在局域網(wǎng)或服務(wù)器上搭建私有云盤(pán)進(jìn)行文件管理。它支持豐富的插件擴(kuò)展，界面友好，常用于企業(yè)內(nèi)部文件管理或團(tuán)隊(duì)協(xié)作。

Kodbox 的 docker-compose.yml 內(nèi)容如下：

version: '3.5' services: kodbox: image: harbor.spacemit.com/application/kodbox:1.50.02 # 移植的docker鏡像 restart: always ports: - 8080:80 # 左邊8080是使用端口，可以修改 volumes: - "./site:/var/www/html" #./site是站點(diǎn)目錄位置，可以修改

拉取服務(wù)之后，瀏覽器輸入 http://HOST_IP:8080 訪(fǎng)問(wèn) Kodbox，管理員賬號(hào)和密碼自行設(shè)置。

Frigate

Frigate 是一個(gè)開(kāi)源的視頻監(jiān)控系統(tǒng)，專(zhuān)為實(shí)時(shí)對(duì)象檢測(cè)設(shè)計(jì)，通常用于家庭安全攝像頭管理。它利用機(jī)器學(xué)習(xí)模型（如 YOLO）進(jìn)行實(shí)時(shí)的物體檢測(cè)，能夠檢測(cè)和識(shí)別攝像頭捕獲的運(yùn)動(dòng)物體（如人、車(chē)輛等）。Frigate 支持硬件加速（如使用 GPU 或 Google Coral TPU），能夠提高視頻處理性能。它集成了Home Assistant，并支持錄制、事件檢測(cè)和通知功能，非常適合智能家居監(jiān)控場(chǎng)景。

Frigate 的 docker-compose.yml 內(nèi)容如下：

version: '3' services: frigatev26: image: harbor.spacemit.com/application/frigate:v26 container_name: frigatev26 restart: unless-stopped tmpfs: - /tmp/cache:rw,exec,size=1000000000 devices: - /dev/dri/renderD128 - /dev/tcm - /dev/udma - /dev/udmabuf - /dev/video0 shm_size: 64m volumes: - /root/workspace/frigate/storage:/media/frigate - /root/workspace/frigate/config:/config - /etc/localtime:/etc/localtime:ro environment: - FRIGATE_RTSP_PASSWORD=password ports: - "5000:5000" - "8554:8554" - "8555:8555/udp"

Frigate 服務(wù)需要通過(guò)串口或者 SSH 登錄系統(tǒng)，在 /root/workspace/frigate/config/ 目錄下添加配置文件。從 https://pan.baidu.com/s/1rejOs5FukCM6gq6AjTlgxw?pwd=pc9w（提取碼: pc9w）下載 frigate-config.tar 壓縮包，解壓到 config 目錄，解壓之后的文件如下：

配置好之后，重新拉取服務(wù)。拉取完成等待30秒左右，瀏覽器輸入 http://HOST_IP:5000 訪(fǎng)問(wèn) Frigate。

Immich

Immich 是一個(gè)開(kāi)源的自托管照片和視頻備份解決方案，專(zhuān)為個(gè)人和家庭用戶(hù)設(shè)計(jì)。它允許用戶(hù)在自己的服務(wù)器上備份、管理和查看照片和視頻內(nèi)容，類(lèi)似于 Google Photos 的功能。Immich 提供了自動(dòng)化的備份功能，通過(guò)移動(dòng)設(shè)備上的客戶(hù)端應(yīng)用自動(dòng)同步媒體文件，支持高效的存儲(chǔ)和快速的搜索。

Immich 的 docker-compose.yml 內(nèi)容如下：

name: immich services: immich-server: container_name: immich_server image: harbor.spacemit.com/application/immich-server:${IMMICH_VERSION:-release} #extends: # file: hwaccel.transcoding.yml # service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding volumes: - ${UPLOAD_LOCATION}:/usr/src/app/upload - /etc/localtime:/etc/localtime:ro # 映射視頻解碼設(shè)備 devices: - /dev/video0:/dev/video0 # 可以映射多個(gè)USB攝像頭 - /dev/video1:/dev/video1 - /dev/dri/card0:/dev/dri/card0 - /dev/dri/renderD128:/dev/dri/renderD128 env_file: - .env ports: - 2283:3001 depends_on: - redis - database restart: always privileged: true immich-machine-learning: container_name: immich_machine_learning # For hardware acceleration, add one of -[armnn, cuda, openvino] to the image tag. # Example tag: ${IMMICH_VERSION:-release}-cuda image: harbor.spacemit.com/application/immich-machine-learning:${IMMICH_VERSION:-release} # extends: # uncomment this section for hardware acceleration - see https://immich.app/docs/features/ml-hardware-acceleration # file: hwaccel.ml.yml # service: cpu # set to one of [armnn, cuda, openvino, openvino-wsl] for accelerated inference - use the `-wsl` version for WSL2 where applicable volumes: - model-cache:/cache env_file: - .env ports: - 3003:3003 restart: always redis: container_name: immich_redis image: harbor.spacemit.com/application/redis:6.2-alpine3.20 healthcheck: test: redis-cli ping || exit 1 restart: always database: container_name: immich_postgres image: harbor.spacemit.com/application/pgvector:pg15-bianbu-mantic environment: POSTGRES_PASSWORD: ${DB_PASSWORD} POSTGRES_USER: ${DB_USERNAME} POSTGRES_DB: ${DB_DATABASE_NAME} POSTGRES_INITDB_ARGS: '--data-checksums' volumes: - ${DB_DATA_LOCATION}:/var/lib/postgresql/data command: ["postgres", "-c" ,"shared_preload_libraries=/usr/lib/postgresql/15/lib/vector.so", "-c", 'search_path="$$user", public, vector', "-c", "logging_collector=on", "-c", "max_wal_size=2GB", "-c", "shared_buffers=512MB", "-c", "wal_compression=on"] restart: always volumes: model-cache:

同目錄下創(chuàng)建環(huán)境變量文件.env：

# The location where your uploaded files are stored UPLOAD_LOCATION=./library # The location where your database files are stored DB_DATA_LOCATION=./postgres # TZ=Etc/UTC # The Immich version to use. You can pin this to a specific version like "v1.71.0" IMMICH_VERSION="v1.107.2" # Connection secret for postgres. You should change it to a random password DB_PASSWORD=postgres # The values below this line do not need to be changed ################################################################################### DB_USERNAME=postgres DB_DATABASE_NAME=immich DB_VECTOR_EXTENSION=pgvector

拉取服務(wù)之后，瀏覽器輸入 http://HOST_IP:2283 訪(fǎng)問(wèn) Immich，初次登錄需設(shè)置管理員賬號(hào)和密碼。

入門(mén)設(shè)置

切換中文：點(diǎn)擊 "設(shè)置 -> 賬戶(hù)設(shè)置 -> 應(yīng)用設(shè)置 -> 語(yǔ)言 -> Chinese(Simplified)"。

查看和執(zhí)行任務(wù)：點(diǎn)擊“管理 -> 任務(wù)”，可以查看后臺(tái)任務(wù)執(zhí)行情況，同時(shí)可以手動(dòng)執(zhí)行單個(gè)任務(wù)。

人臉識(shí)別：Immich 可以識(shí)別照片和視頻中的人臉，并將它們分組為人物，在“探索”頁(yè)面可以查看。同時(shí)，可以為這些人物分配姓名并搜索他們。

智能搜索：Immich 支持文搜圖和圖搜圖功能，在首頁(yè)點(diǎn)擊“搜索”，輸入文字描述來(lái)搜索圖片，或者點(diǎn)擊人物來(lái)搜索特定人物，同時(shí)，可以設(shè)置條件過(guò)濾圖片。

設(shè)置：點(diǎn)擊“管理 -> 設(shè)置”，可以切換機(jī)器學(xué)習(xí)模型、設(shè)置視頻轉(zhuǎn)碼參數(shù)等。

點(diǎn)擊 Immich Docs 查看 Immich 的更多介紹。

定制化固件

基于 Bianbu NAS 進(jìn)行裁剪、針對(duì)特定應(yīng)用場(chǎng)景定制化的固件。

?kodbox

針對(duì)企業(yè)的私有云解決方案，集成 Kodbox，開(kāi)箱即用，用戶(hù)無(wú)需額外配置即

審核編輯 黃宇