Difference between revisions of "APITestPage"

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
(updated by API)
(98 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[NanoPi M4B|English]]
+
[[Getting Started with OpenMediaVault|English]]
==介绍==
+
==OpenMediaVault版本信息==
[[File:NanoPi M4B-01B.jpg|thumb|Overview]]
+
* OS: Debian 12<br />
[[File:NanoPi M4B-A01.jpg|thumb|Front]]
+
* OpenMediaVault: 7.0.5-1 (Sandworm)<br />
[[File:NanoPi M4B-B01.jpg|thumb|Back]]
+
* Docker: 26.0.1<br />
*NanoPi M4B是基于RK3399 SoC设计的一款接口尺寸与树莓派3兼容的嵌入式ARM计算机。它的尺寸只有85x56mm,接口丰富, 布局紧凑, 非常适合二次开发, 并方便嵌入到最终产品中去。
+
* Others: 已安装OMV-Extras软件包<br />
*NanoPi M4B板载2.4G & 5G双频WiFi蓝牙模组, 除了带有2个USB3.0 A型主口, 2个USB2.0 A型主口 1个千兆以太网口, 1个HDMI 2.0 A型口, 1个3.5mm耳机输出, 还带有丰富的扩展接口,包括40Pin树莓派兼容口, 双摄像头接口MIPI-CSI, PCIe x2,红外输入接口, eMMC模块接口, RTC等接口。
+
==旧版本的OpenMediaVault文档==
*NanoPi M4B 标配双通道2GB DDR3, 可使用TF卡启动运行系统,并可外扩eMMC模块启动运行系统。
+
Link to → [[Getting Started with OpenMediaVault6/zh|Getting Started with OpenMediaVault6]]
*NanoPi M4B支持运行Ubuntu Desktop 18.04 (64-bit), Lubuntu 16.04(32-bit), Ubuntu Core 18.04(64-bit), Android 8等多种系统, 它们均带有GPU和VPU加速处理,依托于强大的计算性能和丰富接口,它非常适用于基于机器视觉和人工智能的门禁系统,深度计算,自主机器人,工业控制,工业相机,广告机,游戏机,区块链等方面的应用。
+
==OpenMediaVault运行界面==
 +
[[File:Openmediavault7-zh.png|600px]]
 +
==支持的平台==
 +
* RK3328<br />
 +
* RK3399<br />
 +
* RK3568<br />
 +
* RK3588<br />
 +
==查看IP地址==
 +
由于主机名默认为开发板的型号, 所以可以使用ping命令来获得IP地址,例如CM3588,可以用命令:
 +
<syntaxhighlight lang="bash">
 +
ping CM3588
 +
</syntaxhighlight>
 +
==登录OpenMediaVault网页后台==
 +
在网页浏览器输入开发板的IP地址, 网页登录帐号默认为:
 +
<syntaxhighlight lang="bash">
 +
用户名: admin
 +
密码: openmediavault
 +
</syntaxhighlight>
 +
==设置网页登录密码==
 +
网页上点击右上角的头像,选择 “更改密码”
 +
==默认的Linux帐号与密码==
 +
普通用户:<br/>
 +
&nbsp;&nbsp;&nbsp;&nbsp;用户名: pi<br/>
 +
&nbsp;&nbsp;&nbsp;&nbsp;密码: pi<br/>
 +
<br/>
 +
Root用户:<br/>
 +
&nbsp;&nbsp;&nbsp;&nbsp;用户名: root<br/>
 +
&nbsp;&nbsp;&nbsp;&nbsp;密码: fa<br/>
 +
==设置网页超时时间==
 +
进入 '''系统 -> 工作台''',设置"自动登出"时间。
 +
==通过ssh登录==
 +
<syntaxhighlight lang="bash">
 +
ssh pi@YourIPAddress
 +
</syntaxhighlight>
 +
pi用户的初始密码为 pi
 +
==更新用户密码==
 +
<syntaxhighlight lang="bash">
 +
sudo passwd root
 +
sudo passwd pi
 +
</syntaxhighlight>
 +
==配置网络与时区==
 +
用root用户登录ssh:
 +
<syntaxhighlight lang="bash">
 +
ssh root@IPAddress
 +
</syntaxhighlight>
 +
执行如下命令:
 +
<syntaxhighlight lang="bash">
 +
omv-firstaid
 +
</syntaxhighlight>
 +
界面如下:<br />
 +
[[File:Omv-firstaid.png|400px]]
 +
==切换国内软件源==
 +
<syntaxhighlight lang="bash">
 +
sudo sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list
 +
sudo apt update
 +
</syntaxhighlight>
 +
==配置硬盘==
 +
(注:如果硬盘之前已经初始化,无需重新擦除,RAID可以得到保留,直接挂载即可)<br />
 +
请参考 [[#系统重装后恢复硬盘数据]]
 +
===第一步:清除硬盘===
 +
'''注意备份你的数据'''<br />
 +
进入 '''存储器 -> 磁盘''',选中你的存储器,点击'''“擦除"'''图标进行擦除,一般选'''“快速”'''即可。<br />
 +
如果硬盘无法擦除,你需要先移除此硬盘上的共享文件夹并取消挂载。
 +
===第二步:创建文件系统===
 +
本章节所介绍的两种Raid配置的区别:
 +
* MD RAID:性能更好,因为它在并行写入和读取分块方面做得更好。
 +
* Btrfs RAID:数据安全性更好,因为校验和使其能够确定块的哪个副本出错,当只有一个副本出错时,并且它能够判断两个副本是否都有问题。
 +
注:不支持为USB接口的硬盘创建RAID队列, 更详细内容请参考官方指南: [https://docs.openmediavault.org/en/latest/administration/storage/raid.html RAID]
 +
====方案1: 配置MD RAID====
 +
* 进入 '''存储器 -> 多重装置''',点击'''“+”'''图标,在'''"级别"'''一栏选择RAID级别,在'''"设备"'''一栏钩选存储设备,保存后,状态如下所示:
 +
[[File:Omv-raid-resyncing.png|center|400px]]<br/>
 +
你需要等待状态从 resyncing 转为 clean,完成后如下图所示:<br />
 +
[[File:Omv-raid-clean.png|center|400px]]<br/>
 +
* 进入 '''存储器 -> 文件系统''',点击'''“+”''',类型建议选择'''"BTRFS"''',选择'''"Single"'''并在"设备"栏中钩选你的存储设备,如果在上一步中创建了RAID,设备名是以"/dev/md"开头的,如果你的设备在'''"设备"'''栏中没法列出,可能是设备中已存在共享文件夹等数据,尝试点击 '''►''' 图标直接挂载,如果数据可以被丢弃,则可以考虑使用如下命令擦除硬盘数据:
 +
<syntaxhighlight lang="bash">
 +
# 注意:硬盘中的所有数据将会丢失
 +
sudo wipefs --all /dev/mdX
 +
</syntaxhighlight>
 +
/dev/mdX需要换成真实的设备,通过"cat /proc/partitions"命令查看。
 +
* 格式化完成后,OpenMediaVault 将提示您挂载该设备。
 +
====方案2: 配置Btrfs RAID====
 +
* 进入 '''存储 -> 文件系统''',点击 '''"+"''' 图标,选择 '''"BTRFS"''',选择 RAID 级别,选择您的硬盘,然后保存设置。<br />
 +
* 格式化完成后,OpenMediaVault 将让您选择要挂载的文件系统,它不会列出RAID阵列中的所有硬盘,选择位于阵列中的其中一个硬盘即可。
 +
====方案3: 不使用RAID阵列====
 +
* 进入 '''存储 -> 文件系统''',点击 '''"+"''' 图标,选择 '''"BTRFS"''',选择 Single 级别,选择您的硬盘,然后保存设置。<br />
 +
* 格式化完成后,OpenMediaVault 将提示您挂载该设备。
 +
==创建共享文件夹==
 +
进入'''存储器 -> 共享文件夹''',添加'''"+"'''图标创建2个文件夹,名称分别为'''nfs'''和'''samba''',我们接下来将用这些文件夹来测试nfs和samba共享。<br />
 +
(注:如果硬盘中存在同名的共享文件夹,重新创建同名的文件夹,数据会得到保留)
 +
==创建NAS用户==
 +
Debian系统的用户或通过命令行创建的Linux会缺少诸如samba之类服务的访问权限,因此这里推荐使用OpenMediaVault界面创建一个用户用于访问samba和nfs共享,这里我会创建一个名为'''nasuser'''的用户和组:<br />
 +
<br />
 +
* 点击'''用户 -> 用户组''',点击 '''"+"''' 图标创建一个名为 '''nasuser''' 的用户组。
 +
* 点击'''用户 -> 用户''',点击 '''"+"''' 图标后创建一个名为 '''nasuser''',Shell选择/usr/sbin/nologin, 用户组钩选'''nasuser'''和'''users'''的用户。
 +
==创建Samba共享==
 +
* 点击'''服务 -> SMB/CIFS -> 设置''', 钩选最上面的 "已启动", 最低协议版本选择 '''"SMB1"''',然后点 "保存";
 +
* 点击'''服务 -> SMB/CIFS -> 共享''', 点击 '''"+"''' ,在 '''"Shared folder"''' 处选择要共享的文件夹,这里我选择samba文件夹。
 +
测试访问: <br />
 +
在Mac系统下右击Finder,选择连接服务器后输入 smb://YourIPAddress(换成真实IP),会弹出验证对话框,输入用户名nasuser以及密码即可以访问。
 +
==创建NFS共享==
 +
* 点击"服务" -> "NFS" -> "设置", 钩选最上面的 "已启动", 在"版本"一栏中,钩选所有版本包括'''“NFSv2”''',然后点 "保存"并应用设置;
 +
* 点击"服务" -> "NFS" -> "共享", 点击 '''"+"''' ,在 '''"Shared folder"''' 处选择要共享的文件夹,这里我选择 nfs 文件夹。在客户端一栏中输入 192.168.1.0/24 (换成真实网段,或指定仅允许访问的IP),权限处选择 "读/写",在扩展选项中输入:
 +
<syntaxhighlight lang="bash">
 +
rw,async,insecure,no_subtree_check,all_squash,anonuid=0,anongid=0
 +
</syntaxhighlight>
 +
然后点 "保存"并应用设置;
 +
===Mac下测试挂载NFS===
 +
命令行查看OpenMediaVault的NFS共享信息
 +
<syntaxhighlight lang="bash">
 +
# showmount -e YourIPAddress
 +
Exports list on YourIPAddress:
 +
/export                             192.168.1.0/24
 +
/export/nfs                         192.168.1.0/24
 +
</syntaxhighlight>
 +
在Mac上右击Finder,选择连接服务器,在地址栏输入
 +
<syntaxhighlight lang="bash">
 +
nfs://YourIPAddress/export/nfs
 +
</syntaxhighlight>
 +
===Linux下测试挂载NFS===
 +
安装软件包
 +
<syntaxhighlight lang="bash">
 +
sudo apt install nfs-common
 +
</syntaxhighlight>
 +
挂载
 +
<syntaxhighlight lang="bash">
 +
sudo mount -t nfs YourIPAddress:/export/nfs /mnt/nfs
 +
</syntaxhighlight>
 +
查看状态
 +
<syntaxhighlight lang="bash">
 +
# df -h | grep nfs
 +
YourIPAddress:/export/nfs  7.3G  3.5M  6.8G    1% /mnt/nfs
 +
</syntaxhighlight>
 +
设置开机自动挂载,添加如下内容到 /etc/fstab
 +
<syntaxhighlight lang="bash">
 +
YourIPAddress:/export/nfs /mnt/nfs nfs defaults 0 0
 +
</syntaxhighlight>
 +
==Docker的使用==
 +
===将Docker数据移动至硬盘===
 +
先安装openmediavault-compose插件, 通过SSH登录然后执行如下命令:
 +
<syntaxhighlight lang="bash">
 +
sudo apt update
 +
sudo apt install -y openmediavault-compose
 +
</syntaxhighlight>
 +
刷新网页后,进入'''存储器 -> 共享文件夹''',添加 '''"+"''' 图标创建3个文件夹,分别为
 +
<syntaxhighlight lang="bash">
 +
docker            -> Docker数据目录,在/etc/docker/daemon.json中定义
 +
docker-compose    -> Location of compose files
 +
docker-data      -> Location of persistent container data
 +
docker-app        -> 自用,存放Dockerfile和数据
 +
</syntaxhighlight>
 +
进入'''服务 -> Compose''',进入设置界面,设置"Compose 文件"的Shared folder为docker-compose, 设置"Data“的Shared folder为docker-data,<br />
 +
<br />
 +
进入ssh终端,输入以下命令,将docker数据移动到共享文件夹, 其中,'''/srv/dev-disk-by-uuid-XXYYZZ/docker''' 是共享文件夹的绝对路径,可以在网页 '''存储器 -> 共享文件夹''' 列表中得到:
 +
<syntaxhighlight lang="bash">
 +
su root
 +
systemctl stop docker.socket docker.service
 +
mv /var/lib/docker/* /srv/dev-disk-by-uuid-XXYYZZ/docker/
 +
</syntaxhighlight>
 +
在页面上设置 '''Docker存储''' 为该docker共享文件夹的绝对路径,保存并应用后, 重启开发板。
 +
<br />GUI 上填写的最终数值:<br />
 +
<syntaxhighlight lang="text">
 +
Compose Files's Shared folder  -> on /dev/md0, docker-compose
 +
Data's Shared folder          -> on /dev/md0, docker-data
 +
Docker's Docker storage        -> on /srv/dev-disk-by-uuid-XXYYZZ/docker/
 +
</syntaxhighlight>
 +
===Docker安装nextcloud网盘===
 +
命令行界面输入以下命令即可:
 +
<syntaxhighlight lang="bash">
 +
su root
 +
cd $(readlink -f /srv/dev-disk-by-uuid-*/docker-app)
 +
mkdir nextcloud
 +
cd nextcloud
 +
mkdir data
  
==硬件特性==
+
docker run -d -p 8888:80 --name nextcloud \
* 主控芯片: Rockchip RK3399
+
     -v $PWD/data:/var/www/html --restart=always \
** CPU: big.LITTLE大小核架构,双Cortex-A72大核(up to 2.0GHz)+四Cortex-A53小核结构(up to 1.5GHz)
+
     --privileged=true arm64v8/nextcloud
** GPU: Mali-T864 GPU,支持OpenGL ES1.1/2.0/3.0/3.1, OpenCL, DX11, 支持AFBC(帧缓冲压缩)
+
</syntaxhighlight>
** VPU: 支持4K VP9 and 4K 10bits H265/H264 视频解码,高达60fps, 双VOP显示等视频编解码功能
+
完成后在网页浏览器访问http://YourIPAddress:8888/即可看到nextcloud网盘的页面,如果无法访问,建议重启一下设备。
* 电源管理单元: RK808-D PMIC, 搭配独立DC/DC, 支持动态调压, 软件关机, 按键开机, RTC唤醒, 睡眠唤醒等功能
+
===Docker安装Filebrowser===
* 内存: 双通道2GB DDR3
+
命令行界面输入以下命令即可:
* Flash: 支持扩展eMMC模块
+
<syntaxhighlight lang="bash">
* 有线网络: 原生千兆以太网
+
su root
* Wi-Fi/蓝牙: 802.11a/b/g/n/ac, Bluetooth 5.0 双频Wi-Fi蓝牙模块, 单天线
+
cd $(readlink -f /srv/dev-disk-by-uuid-*/docker-app)
* 视频输入1个或2个4线MIPI-CSI, 双ISP像素处理能力高达13MPix/s,支持双路摄像头数据同时输入
+
mkdir filebrowser
* 视频输出
+
cd filebrowser
** HDMI: HDMI 2.0a, 支持4K@60Hz显示,支持HDCP 1.4/2.2
+
** LCD Interface: 一个4线MIPI-DSI
+
* Audio Out: 3.5mm 双通道耳机接口, 或者通过HDMI输出
+
* Audio In: 3.5mm耳机接口集成麦克风输入
+
* USB: 2个独立带宽USB 3.0 Host,2个独立带宽USB 2.0 Host
+
* microSD Slot x 1
+
* 40Pin GPIO 扩展接口:
+
** 2 X 3V/1.8V I2C, up to 1 x 3V UART, 1 X 3V SPI, 1 x SPDIF_TX, up to 8 x 3V GPIOs
+
** 1 x 1.8V 8通道 I2S
+
* 24Pin 扩展接口:
+
** PCIe x2
+
** PWM x1, PowerKey, 红外输入
+
* 按键:一个电源按键(PowerKey),一个系统恢复按键(RecoveryKey)
+
* 调试串口: 4 Pin 2.54mm 调试串口, 3V电平, 波特率为1500000
+
* LED: 1 x power LED and 1 x GPIO Controled LED
+
* RTC电池座子: 2 Pin 1.27/1.25mm RTC备份电池接口
+
* 供电电源: DC 5V/3A
+
* PCB: 8 Layer, 85 mm x 56 mm
+
* 环境工作温度: -20℃ to 70℃
+
 
+
==接口布局和尺寸==
+
===接口布局===
+
[[File:NanoPi_M4B_Layout.jpg |thumb|600px|NanoPi M4B Layout]]
+
[[File:NanoPi_M4B_eMMC.jpg |thumb|600px|NanoPi M4B eMMC]]
+
* '''40-Pin GPIO1 引脚定义'''
+
::{| class="wikitable"
+
|-
+
|'''Pin#''' || '''Assignment'''          ||'''Pin#'''  || '''Assignment'''      
+
|-
+
|1    || VCC3V3_SYS  ||2    || VDD_5V
+
|-
+
|3    || I2C2_SDA(3V)      ||4    || VDD_5V
+
|-
+
|5    || I2C2_SCL(3V)      ||6    || GND
+
|-
+
|7    || GPIO1_A0(3V)      ||8    || GPIO4_C1/I2C3_SCL(3V)
+
|-
+
|9    || GND          ||10    || GPIO4_C0/I2C3_SDA(3V)
+
|-
+
|11  || GPIO1_A1(3V)      ||12    || GPIO1_C2(3V)
+
|-
+
|13  || GPIO1_A3(3V)      ||14    || GND
+
|-
+
|15  || GPIO1_A4(3V)      ||16    || GPIO1_C6(3V)
+
|-
+
|17  || VCC3V3_SYS ||18    || GPIO1_C7(3V)
+
|-
+
|19  || SPI1_TXD/UART4_TX(3V)  ||20    || GND
+
|-
+
|21  || SPI1_RXD/UART4_RX(3V)    ||22    || GPIO1_D0(3V)
+
|-
+
|23  || SPI1_CLK(3V)    ||24    || SPI1_CSn0(3V)
+
|-
+
|25  || GND          ||26    || GPIO4_C5/SPDIF_TX(3V)
+
|-
+
|27  || I2C2_SDA(1.8V)      ||28    || I2C2_SCL(1.8V)
+
|-
+
|29  || I2S0_LRCK_RX(1.8V)      ||30    || GND
+
|-
+
|31  ||I2S0_LRCK_TX(1.8V)    ||32    || I2S_CLK(1.8V)
+
|-
+
|33  || I2S0_SCLK(1.8V)      ||34    || GND
+
|-
+
|35  || I2S0_SDI0(1.8V)    ||36    || I2S0_SDO0(1.8V)
+
|-
+
|37  || I2S0_SDI1SDO3(1.8V)    ||38    || I2S0_SDI2SDO2(1.8V)
+
|-
+
|39  || GND          ||40    || I2S0_SDI3SDO1(1.8V)
+
|}
+
 
+
* '''24-Pin GPIO2 引脚定义'''
+
::{| class="wikitable"
+
|-
+
|'''Pin#''' || '''Assignment'''          ||'''Pin#'''  || '''Assignment'''      
+
|-
+
|1    || VCC5V0_SYS  ||2    || VCC5V0_SYS
+
|-
+
|3    || PCIE_RX1_P      ||4    || PCIE_TX1P
+
|-
+
|5    || PCIE_RX1_N      ||6    || PCIE_TX1N
+
|-
+
|7    || GND      ||8    || GND
+
|-
+
|9    || PCIE_RX0_P          ||10    || PCIE_TX0P
+
|-
+
|11  || PCIE_RX0_N      ||12    || PCIE_TX0N
+
|-
+
|13  || GND      ||14    || GND
+
|-
+
|15  || PCIE_REF_CLKP      ||16    ||
+
|-
+
|17  || PCIE_REF_CLKN ||18    ||
+
|-
+
|19  || GND    ||20    || GND
+
|-
+
|21  || PWR_KEY    ||22    ||
+
|-
+
|23  || GPIO4_C6/PWM1(3V)    ||24    || IR_RX
+
|}
+
 
+
* '''MIPI-CSI接口引脚定义'''
+
:: 0.5mm FPC 连接器
+
:: MIPI-CSI2也可作为MIPI-DSI接口连接LCD显示屏
+
::{| class="wikitable"
+
|-
+
|'''Pin#''' ||  '''MIPI-CSI1'''  ||  '''MIPI-CSI2'''  ||  '''Description ''' 
+
|-
+
|1    ||  VCC5V0_SYS  || VCC5V0_SYS  ||  5V Power ouput
+
|-
+
|2    ||  VCC5V0_SYS || VCC5V0_SYS    ||  5V Power ouput
+
|-
+
|3    ||    GND    ||  GND          ||  Return current path
+
|-
+
|4    || VCC_CSI_AF2.8V || VCC_CSI_AF2.8V || 2.8V Power for VCM
+
|-
+
|5    || VCC_CSI_1.2V  || VCC_CSI_1.2V  || 1.2V Power for image sensor core circuit
+
|-
+
|6    ||  VCC1V8_CAM ||  VCC1V8_CAM  || 1.8V power for I/O circuit
+
|-
+
|7    ||  VCC_CSI_2.8V || VCC_CSI_2.8V || 2.8V power for image sensor analog circuit
+
|-
+
|8    ||  VCC_CSI_1.0V || VCC_CSI_1.0V || 1.0V Power for image sensor core circuit
+
|-
+
|9    || I2C1_SCL ||  I2C2_SCL        || 1.8V I2C clock signal
+
|-
+
|10    || I2C1_SDA || I2C2_SDA        ||  1.8V I2C data signal
+
|-
+
|11    || MIPI_CSI0_RST || MIPI_CSI1_RST || reset  camera module
+
|-
+
|12    || MIPI_CSI0_PWN || MIPI_CSI1_PWN  || Power down camera module
+
|-
+
|13    ||  GND          ||      GND          || Return current path
+
|-
+
|14    || GPIO2_B3_CIF_CLKOUTA || GPIO2_B3_CIF_CLKOUTA || MCLK to camera module
+
|-
+
|15      || GND          ||    GND            || Return current path
+
|-
+
|16    ||  MIPI_RX0_D3P  || MIPI_TX1/RX1_D3P  || MIPI CSI positive differential data line transceiver output
+
|-
+
|17    ||  MIPI_RX0_D3N || MIPI_TX1/RX1_D3N    || MIPI CSI negative differential data line transceiver output
+
|-
+
|18    ||  GND    || GND                      || Return current path
+
|-
+
|19    || MIPI_RX0_D2P || MIPI_TX1/RX1_D2P  || MIPI CSI positive differential data line transceiver output
+
|-
+
|20    || MIPI_RX0_D2N || MIPI_TX1/RX1_D2N    || MIPI CSI negative differential data line transceiver output
+
|-
+
|21    || GND || GND    || Return current path
+
|-
+
|22    ||  MIPI_RX0_D1P  || MIPI_TX1/RX1_D1P  || MIPI CSI positive differential data line transceiver output
+
|-
+
|23    || MIPI_RX0_D1N || MIPI_TX1/RX1_D1N    || MIPI CSI negative differential data line transceiver output
+
|-
+
|24    || GND || GND    || Return current path
+
|-
+
|25    || MIPI_RX0_CLKP || MIPI_TX1/RX1_CLKP  || MIPI CSI positive differential clock line transceiver output
+
|-
+
|26    || MIPI_RX0_CLKN || MIPI_TX1/RX1_CLKN    || MIPI CSI negative differential clock line transceiver output
+
|-
+
|27    || GND ||  GND  || Return current path
+
|-
+
|28    || MIPI_RX0_D0P || MIPI_TX1/RX1_D0P || MIPI CSI positive differential data line transceiver output
+
|-
+
|29    || MIPI_RX0_D0N || MIPI_TX1/RX1_D0N  || MIPI CSI negative differential data line transceiver output
+
|-
+
|30    || GND      ||  GND    || Return current path
+
|}
+
 
+
* '''eMMC Socket接口引脚定义'''
+
::{| class="wikitable"
+
|-
+
|'''Pin#''' || '''Assignment'''          ||'''Pin#'''  || '''Assignment'''   
+
|-
+
|1    || EMMC_D0  ||2    || EMMC_D1
+
|-
+
|3    || EMMC_D2    ||4    || EMMC_D3
+
|-
+
|5    || EMMC_D4      ||6    || EMMC_D5
+
|-
+
|7    || EMMC_D6    ||8    || EMMC_D7
+
|-
+
|9    || EMMC_STRB          ||10    || GND
+
|-
+
|11  || EMMC_CMD      ||12    || EMMC_CLKO
+
|-
+
|13  || N/C    ||14    || GND
+
|-
+
|15  || N/C    ||16    || VCC1V8_S3
+
|-
+
|17  || eMMC_RST  ||18    || VCC3V3_S3
+
|-
+
|19  || GND    ||20    || GND
+
|}
+
 
+
* '''调试串口引脚定义'''
+
:: 3V电平, 波特率1500000bps
+
::{| class="wikitable"
+
|-
+
|'''Pin#''' ||'''Assignment''' ||  '''Description ''' 
+
|-
+
|1    || GND                || 0V
+
|-
+
|2    || VCC5V0_SYS          || 5V power output
+
|-
+
|3    || UART2DBG_TX        || output
+
|-
+
|4    || UART2DBG_RX        || intput
+
|}
+
 
+
*'''USB接口'''
+
::每个USB 3.0 接口独立输出2A电流, 独立带宽, 其中上面的接口可切换为ADB调试接口。
+
::2个USB 2.0 接口共享2A输出电流, 独立带宽。
+
 
+
*'''RTC'''
+
::我们实测的RTC备份电流为27uA.
+
::连接器型号: Molex 53398-0271
+
:'''其他说明'''
+
::#只能从Type-C或40-pin GPIO接口的第2和第4脚给板子供电, 电压范围4.7~5.5V
+
::#板子原理图: [http://wiki.friendlyarm.com/wiki/images/1/16/NanoPi-M4B-1909-Schematic.pdf NanoPi-M4B-1909-Schematic.pdf]
+
 
+
===尺寸===
+
::PCB dxf文件, 仅供做产品时结构设计使用: [http://wiki.friendlyarm.com/wiki/images/0/0b/NanoPi_M4B_1909_dxf.zip NanoPi_M4B_1909_dxf.zip]
+
 
+
==快速入门==
+
===准备工作===
+
要开启你的NanoPi-M4B,请先准备好以下硬件:
+
* NanoPi-M4B主板
+
* Type-C数据线
+
* TF卡: Class10或以上的8GB microSD卡
+
* USB转串口适配器(可选,用于调试或PC上进行操作)
+
* 一个5V/3A或以更大功率的电源适配器
+
* 一台支持HDMI输入的显示器或者电视(或选购LCD配件)
+
* 一套USB键盘鼠标,同时连接更多USB的设备时还需要USB HUB
+
* 一台电脑,需要联网,建议使用<b>Ubuntu 18.04 64位系统</b>
+
 
+
{{RK3399-BootFromSDCard/zh|NanoPi-M4B}}
+
{{RK3399-DebugPort/zh|NanoPi-M4B}}
+
==FriendlyDesktop系统的使用==
+
{{FriendlyDesktop-Intro/zh|NanoPi-M4B}}
+
{{FriendlyDesktop-Contents/zh|NanoPi-M4B}}
+
===FriendlyDesktop下使用NVME SSD===
+
请参考: [[Template:RK3399 Linux Using NVME SSD|Linux-Using-NVME-SSD]]<br />
+
{{FriendlyCoreGeneral/zh|NanoPi-M4B}}
+
{{FriendlyCoreRunX11Application/zh|NanoPi-M4B}}
+
{{RK3399 Linux mpv/zh|NanoPi-M4B}}
+
==同时适用于FriendlyDesktop与FriendlyCore系统的功能特性==
+
{{Linux-RK3399MIPICamera/zh|NanoPi-M4B}}
+
{{RK3399-Linux-Install-Docker/zh|NanoPi-M4B}}
+
{{RK3399 Linux FFmpeg/zh|NanoPi-M4B}}
+
{{RK3399 Linux Using NVME SSD/zh|NanoPi-M4B}}
+
===Linux下使用4G EC20模块===
+
请参考: [[How to use 4G Module on NanoPC-T4/zh]]<br />
+
==Buildroot Linux系统的使用==
+
{{RK3399 Buildroot Intro/zh|NanoPi-M4B}}
+
<br />
+
关于Buildroot系统更详细的说明,请参考: [[Buildroot for RK3399/zh|Buildroot for RK3399]]<br />
+
==Lubuntu 系统的使用==
+
看这里: [[Lubuntu desktop 16.04 for RK3399/zh]]<br />
+
Lubuntu下使用NVME SSD: [[Template:RK3399 Linux Using NVME SSD/zh|Linux-Using-NVME-SSD]]<br />
+
{{RK3399-Android8/zh|NanoPi-M4B}}
+
{{RK3399-Android-USBCamera/zh|NanoPi-M4B}}
+
{{RK3399-Android-4G-EC20/zh|NanoPi-M4B}}
+
{{RK3399-Android-SSD/zh|NanoPi-M4B}}
+
==Android7.1 系统的使用==
+
看这里: [[RK3399-Android7|Android7]]
+
{{RK3399-BuildFromSource/zh|NanoPi-M4B}}
+
==选配配件eMMC模块的使用==
+
[[File:nanopim4emmc.jpg|frameless|500px]]
+
{{RK3399-BurnOS-To-EMMC/zh|NanoPi-M4B}}
+
{{RK3399-HWAccess/zh|NanoPi-M4B}}
+
{{RK3399-SourceCodeURLs/zh|NanoPi-M4B}}
+
  
== 查看瑞芯微原厂资料==
+
docker run -d -v $(readlink -f /srv/dev-disk-by-uuid-*):/srv \
*请访问以下网址查看:https://gitlab.com/friendlyelec/rk3399-nougat/tree/nanopc-t4-nougat/RKDocs
+
    -v $PWD/filebrowserconfig.json:/etc/config.json \
*[http://opensource.rock-chips.com/images/6/60/Rockchip_RK3399_Datasheet_V1.6-20170301.pdf RK3399 datasheet V1.6]
+
    -v $PWD/database.db:/etc/database.db -p 8080:80 \
*[http://opensource.rock-chips.com/images/e/ee/Rockchip_RK3399TRM_V1.4_Part1-20170408.pdf RK3399TRM V1.4]
+
    --restart=always --name filebrowser \
 +
    filebrowser/filebrowser
 +
</syntaxhighlight>
 +
完成后在网页浏览器访问http://YourIPAddress:8080/即可看到Filebrowser的页面,默认管理员的帐号与密码都是admin。
 +
===Docker安装Jellyfin影音服务器===
 +
进入 '''存储器 -> 共享文件夹''',添加 '''"+"''' 图标创建media文件夹用于存放影音资源,然后在命令行终端输入以下命令安装Jellyfin:
 +
<syntaxhighlight lang="bash">
 +
su root
 +
cd $(readlink -f /srv/dev-disk-by-uuid-*/docker-app)
 +
mkdir jellyfin
 +
cd jellyfin
 +
mkdir config cache
  
==原理图、尺寸图==
+
docker run -d --name jellyfin \
*原理图: [http://wiki.friendlyarm.com/wiki/images/1/16/NanoPi-M4B-1909-Schematic.pdf NanoPi-M4B-1909-Schematic.pdf]
+
-v $PWD/config:/config \
*尺寸图:[http://wiki.friendlyarm.com/wiki/images/0/0b/NanoPi_M4B_1909_dxf.zip NanoPi_M4B_1909_dxf.zip]
+
-v $PWD/cache:/cache \
 +
-v $(readlink -f /srv/dev-disk-by-uuid-*/media):/media \
 +
-p 8096:8096 \
 +
--restart=always \
 +
jellyfin/jellyfin
 +
</syntaxhighlight>
 +
完成后在网页浏览器访问http://YourIPAddress:8096/即可看到Jellyfin的页面。
 +
===安装Docker可视化容器管理工具Portainer===
 +
命令行界面输入以下命令即可:
 +
<syntaxhighlight lang="bash">
 +
su root
 +
cd $(readlink -f /srv/dev-disk-by-uuid-*/docker-app)
 +
mkdir portainer
 +
cd portainer
 +
mkdir data
  
==更新日志==
+
docker run -d \
{{RK3399-UpdateLog/zh|NanoPi-M4B}}
+
  --name portainer \
 +
  --restart=always \
 +
  -e TZ=Asia/Shanghai \
 +
  -p 8000:8000 \
 +
  -p 9000:9000 \
 +
  -v /var/run/docker.sock:/var/run/docker.sock \
 +
  -v $PWD/data:/data \
 +
  portainer/portainer-ce:latest
 +
</syntaxhighlight>
 +
完成后在网页浏览器访问http://YourIPAddress:9000/即可看到Portainer的页面,默认管理员的帐号与密码都是admin。
 +
==系统的备还与还原==
 +
===备份eMMC中的系统===
 +
使用tar命令备份文件系统的内容:
 +
<syntaxhighlight lang="bash">
 +
su root
 +
cd /
 +
tar --warning=no-file-changed -cvpzf /rootfs.tar.gz \
 +
    --exclude=/rootfs.tar.gz --exclude=/var/lib/docker/runtimes \
 +
    --exclude=/etc/firstuser --exclude=/etc/friendlyelec-release \
 +
    --exclude=/usr/local/first_boot_flag --one-file-system /
 +
</syntaxhighlight>
 +
===还原系统到eMMC===
 +
使用SD卡启动,启动Linux系统(例如Debian或Ubuntu均可),使用如下命令查询eMMC上的系统根分区:
 +
<syntaxhighlight lang="bash">
 +
root@CM3588:~# sudo parted -s /dev/mmcblk2 unit MiB print | grep rootfs
 +
8      140MiB  59000MiB  58860MiB  ext4        rootfs
 +
</syntaxhighlight>
 +
根据上面的序号8可以得知根分区的设备名为/dev/mmcblk2p8,下面对它重新格式化并挂载,然后解压rootfs.tar.gz到此处:
 +
<syntaxhighlight lang="bash">
 +
sudo mkfs.ext4 /dev/mmcblk2p8
 +
sudo mkdir /mnt/rootfs
 +
sudo mount /dev/mmcblk2p8 /mnt/rootfs
 +
sudo tar xvzfp /path/to/rootfs.tar.gz -C /mnt/rootfs --numeric-owner --same-owner
 +
sudo poweroff
 +
</syntaxhighlight>
 +
关机后,拨出SD卡,重新上电从eMMC启动系统。
 +
==系统重装后恢复硬盘数据==
 +
* 进入 '''存储器 -> 文件系统''', 点击 '''►''' 图标,在 '''文件系统''' 一栏选择你的设备,点保存。
 +
* 进入 '''存储器 -> 共享文件夹''', 创建同名共享文件名,例如本文示例中的nfs, samba, docker, docker-app, docker-compose和docker-data。
 +
==常见问题与解决办法==
 +
===问题: Raid阵列出现如下状态Clean, Resyncing (PENDING)===
 +
Execute following command to switch array to read-write state and begin resync process:
 +
<syntaxhighlight lang="bash">
 +
mdadm --readwrite /dev/md0
 +
</syntaxhighlight>
 +
More details → [https://sleeplessbeastie.eu/2015/03/23/how-to-clear-up-pending-resync-on-raid-array/ How to clear up pending resync on RAID array]
 +
===问题: 挂载文件系统时,未列出存储设备===
 +
先使用如下命令擦除硬盘数据:
 +
<syntaxhighlight lang="bash">
 +
# 注意:硬盘中的所有数据将会丢失
 +
sudo wipefs --all /dev/mdX
 +
</syntaxhighlight>
 +
==OpenMediaVault软件包一览==
 +
你可以使用apt命令安装OpenMediaVault的软件包,例如:
 +
<syntaxhighlight lang="bash">
 +
apt install openmediavault-diskstats
 +
</syntaxhighlight>
 +
这是每个软件包的功能列表:<br />
 +
openmediavault-diskclone: 用于克隆磁盘的工具。<br />
 +
openmediavault-diskstats: 显示磁盘使用统计信息的工具。<br />
 +
openmediavault-downloader: 下载管理器,用于管理下载任务。<br />
 +
openmediavault-fail2ban: 防火墙软件,用于防范暴力攻击。<br />
 +
openmediavault-filebrowser: 文件浏览器,用于浏览和管理文件。<br />
 +
openmediavault-flashmemory: 用于将系统日志和临时文件存储在内存中以减少对磁盘的写入。<br />
 +
openmediavault-forkeddaapd: 支持 iTunes 的 DAAP 服务器。<br />
 +
openmediavault-ftp: FTP 服务器,用于文件传输。<br />
 +
openmediavault-kernel: 内核更新工具。<br />
 +
openmediavault-kvm: 虚拟化解决方案,用于运行虚拟机。<br />
 +
openmediavault-locate: 文件搜索工具。<br />
 +
openmediavault-luksencryption: 提供磁盘加密功能。<br />
 +
openmediavault-lvm2: 逻辑卷管理器。<br />
 +
openmediavault-mergerfs: 提供 Union 文件系统功能,将多个文件系统合并成一个逻辑文件系统。<br />
 +
openmediavault-minidlna: DLNA 服务器,用于在网络上共享媒体文件。<br />
 +
openmediavault-nut: 用于监控 UPS(不间断电源系统)的网络通信软件。<br />
 +
openmediavault-omvextrasorg: 提供额外的插件和软件包。<br />
 +
openmediavault-onedrive: 用于与 OneDrive 云存储服务进行集成。<br />
 +
openmediavault-owntone: 用于配置 UPnP/DLNA 媒体服务器。<br />
 +
openmediavault-photoprism: 相片管理软件。<br />
 +
openmediavault-remotemount: 远程挂载管理器。<br />
 +
openmediavault-resetperms: 重置文件和文件夹权限的工具。<br />
 +
openmediavault-rsnapshot: 快照备份工具。<br />
 +
openmediavault-s3: S3 存储服务插件。<br />
 +
openmediavault-sftp: SFTP 服务器。<br />
 +
openmediavault-shairport: AirPlay 音频服务器。<br />
 +
openmediavault-sharerootfs: 允许共享根文件系统的工具。<br />
 +
openmediavault-snapraid: SnapRAID 数据保护工具。<br />
 +
openmediavault-snmp: SNMP(简单网络管理协议)插件。<br />
 +
openmediavault-symlinks: 符号链接管理工具。<br />
 +
openmediavault-tftp: TFTP(Trivial File Transfer Protocol)服务器。<br />
 +
openmediavault-tgt: iSCSI 目标服务器。<br />
 +
openmediavault-usbbackup: USB 备份插件。<br />
 +
openmediavault-wakealarm: 用于通过计划的时间唤醒系统的工具。<br />
 +
openmediavault-webdav: WebDAV 服务器。<br />
 +
openmediavault-wetty: Web 终端工具。<br />
 +
openmediavault-wireguard: WireGuard VPN 插件。<br />
 +
openmediavault-wol: Wake-on-LAN 工具。<br />
 +
openmediavault-anacron: 任务调度工具。<br />
 +
openmediavault-apttool: APT(Advanced Package Tool)管理工具。<br />
 +
openmediavault-autoshutdown: 自动关机工具。<br />
 +
openmediavault-backup: 备份工具。<br />
 +
openmediavault-borgbackup: BorgBackup 工具。<br />
 +
openmediavault-clamav: ClamAV 来检测恶意软件和病毒的防病毒软件。<br />
 +
openmediavault-compose: Docker Compose 工具。<br />
 +
openmediavault-cputemp: 用于监控 CPU 温度的工具。<br />
 +
openmediavault-zfs: ZFS 文件系统支持插件。<br />

Revision as of 05:37, 20 April 2024

English

1 OpenMediaVault版本信息

  • OS: Debian 12
  • OpenMediaVault: 7.0.5-1 (Sandworm)
  • Docker: 26.0.1
  • Others: 已安装OMV-Extras软件包

2 旧版本的OpenMediaVault文档

Link to → Getting Started with OpenMediaVault6

3 OpenMediaVault运行界面

Openmediavault7-zh.png

4 支持的平台

  • RK3328
  • RK3399
  • RK3568
  • RK3588

5 查看IP地址

由于主机名默认为开发板的型号, 所以可以使用ping命令来获得IP地址,例如CM3588,可以用命令:

ping CM3588

6 登录OpenMediaVault网页后台

在网页浏览器输入开发板的IP地址, 网页登录帐号默认为:

用户名: admin
密码: openmediavault

7 设置网页登录密码

网页上点击右上角的头像,选择 “更改密码”

8 默认的Linux帐号与密码

普通用户:
    用户名: pi
    密码: pi

Root用户:
    用户名: root
    密码: fa

9 设置网页超时时间

进入 系统 -> 工作台,设置"自动登出"时间。

10 通过ssh登录

ssh pi@YourIPAddress

pi用户的初始密码为 pi

11 更新用户密码

sudo passwd root
sudo passwd pi

12 配置网络与时区

用root用户登录ssh:

ssh root@IPAddress

执行如下命令:

omv-firstaid

界面如下:
Omv-firstaid.png

13 切换国内软件源

sudo sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list
sudo apt update

14 配置硬盘

(注:如果硬盘之前已经初始化,无需重新擦除,RAID可以得到保留,直接挂载即可)
请参考 #系统重装后恢复硬盘数据

14.1 第一步:清除硬盘

注意备份你的数据
进入 存储器 -> 磁盘,选中你的存储器,点击“擦除"图标进行擦除,一般选“快速”即可。
如果硬盘无法擦除,你需要先移除此硬盘上的共享文件夹并取消挂载。

14.2 第二步:创建文件系统

本章节所介绍的两种Raid配置的区别:

  • MD RAID:性能更好,因为它在并行写入和读取分块方面做得更好。
  • Btrfs RAID:数据安全性更好,因为校验和使其能够确定块的哪个副本出错,当只有一个副本出错时,并且它能够判断两个副本是否都有问题。

注:不支持为USB接口的硬盘创建RAID队列, 更详细内容请参考官方指南: RAID

14.2.1 方案1: 配置MD RAID

  • 进入 存储器 -> 多重装置,点击“+”图标,在"级别"一栏选择RAID级别,在"设备"一栏钩选存储设备,保存后,状态如下所示:
Omv-raid-resyncing.png

你需要等待状态从 resyncing 转为 clean,完成后如下图所示:

Omv-raid-clean.png

  • 进入 存储器 -> 文件系统,点击“+”,类型建议选择"BTRFS",选择"Single"并在"设备"栏中钩选你的存储设备,如果在上一步中创建了RAID,设备名是以"/dev/md"开头的,如果你的设备在"设备"栏中没法列出,可能是设备中已存在共享文件夹等数据,尝试点击 图标直接挂载,如果数据可以被丢弃,则可以考虑使用如下命令擦除硬盘数据:
# 注意:硬盘中的所有数据将会丢失
sudo wipefs --all /dev/mdX

/dev/mdX需要换成真实的设备,通过"cat /proc/partitions"命令查看。

  • 格式化完成后,OpenMediaVault 将提示您挂载该设备。

14.2.2 方案2: 配置Btrfs RAID

  • 进入 存储 -> 文件系统,点击 "+" 图标,选择 "BTRFS",选择 RAID 级别,选择您的硬盘,然后保存设置。
  • 格式化完成后,OpenMediaVault 将让您选择要挂载的文件系统,它不会列出RAID阵列中的所有硬盘,选择位于阵列中的其中一个硬盘即可。

14.2.3 方案3: 不使用RAID阵列

  • 进入 存储 -> 文件系统,点击 "+" 图标,选择 "BTRFS",选择 Single 级别,选择您的硬盘,然后保存设置。
  • 格式化完成后,OpenMediaVault 将提示您挂载该设备。

15 创建共享文件夹

进入存储器 -> 共享文件夹,添加"+"图标创建2个文件夹,名称分别为nfssamba,我们接下来将用这些文件夹来测试nfs和samba共享。
(注:如果硬盘中存在同名的共享文件夹,重新创建同名的文件夹,数据会得到保留)

16 创建NAS用户

Debian系统的用户或通过命令行创建的Linux会缺少诸如samba之类服务的访问权限,因此这里推荐使用OpenMediaVault界面创建一个用户用于访问samba和nfs共享,这里我会创建一个名为nasuser的用户和组:

  • 点击用户 -> 用户组,点击 "+" 图标创建一个名为 nasuser 的用户组。
  • 点击用户 -> 用户,点击 "+" 图标后创建一个名为 nasuser,Shell选择/usr/sbin/nologin, 用户组钩选nasuserusers的用户。

17 创建Samba共享

  • 点击服务 -> SMB/CIFS -> 设置, 钩选最上面的 "已启动", 最低协议版本选择 "SMB1",然后点 "保存";
  • 点击服务 -> SMB/CIFS -> 共享, 点击 "+" ,在 "Shared folder" 处选择要共享的文件夹,这里我选择samba文件夹。

测试访问:
在Mac系统下右击Finder,选择连接服务器后输入 smb://YourIPAddress(换成真实IP),会弹出验证对话框,输入用户名nasuser以及密码即可以访问。

18 创建NFS共享

  • 点击"服务" -> "NFS" -> "设置", 钩选最上面的 "已启动", 在"版本"一栏中,钩选所有版本包括“NFSv2”,然后点 "保存"并应用设置;
  • 点击"服务" -> "NFS" -> "共享", 点击 "+" ,在 "Shared folder" 处选择要共享的文件夹,这里我选择 nfs 文件夹。在客户端一栏中输入 192.168.1.0/24 (换成真实网段,或指定仅允许访问的IP),权限处选择 "读/写",在扩展选项中输入:
rw,async,insecure,no_subtree_check,all_squash,anonuid=0,anongid=0

然后点 "保存"并应用设置;

18.1 Mac下测试挂载NFS

命令行查看OpenMediaVault的NFS共享信息

# showmount -e YourIPAddress
Exports list on YourIPAddress:
/export                             192.168.1.0/24
/export/nfs                         192.168.1.0/24

在Mac上右击Finder,选择连接服务器,在地址栏输入

nfs://YourIPAddress/export/nfs

18.2 Linux下测试挂载NFS

安装软件包

sudo apt install nfs-common

挂载

sudo mount -t nfs YourIPAddress:/export/nfs /mnt/nfs

查看状态

# df -h | grep nfs
YourIPAddress:/export/nfs  7.3G  3.5M  6.8G    1% /mnt/nfs

设置开机自动挂载,添加如下内容到 /etc/fstab

YourIPAddress:/export/nfs /mnt/nfs nfs defaults 0 0

19 Docker的使用

19.1 将Docker数据移动至硬盘

先安装openmediavault-compose插件, 通过SSH登录然后执行如下命令:

sudo apt update
sudo apt install -y openmediavault-compose

刷新网页后,进入存储器 -> 共享文件夹,添加 "+" 图标创建3个文件夹,分别为

docker            -> Docker数据目录,在/etc/docker/daemon.json中定义
docker-compose    -> Location of compose files
docker-data       -> Location of persistent container data
docker-app        -> 自用,存放Dockerfile和数据

进入服务 -> Compose,进入设置界面,设置"Compose 文件"的Shared folder为docker-compose, 设置"Data“的Shared folder为docker-data,

进入ssh终端,输入以下命令,将docker数据移动到共享文件夹, 其中,/srv/dev-disk-by-uuid-XXYYZZ/docker 是共享文件夹的绝对路径,可以在网页 存储器 -> 共享文件夹 列表中得到:

su root
systemctl stop docker.socket docker.service
mv /var/lib/docker/* /srv/dev-disk-by-uuid-XXYYZZ/docker/

在页面上设置 Docker存储 为该docker共享文件夹的绝对路径,保存并应用后, 重启开发板。
GUI 上填写的最终数值:

Compose Files's Shared folder  -> on /dev/md0, docker-compose
Data's Shared folder           -> on /dev/md0, docker-data
Docker's Docker storage        -> on /srv/dev-disk-by-uuid-XXYYZZ/docker/

19.2 Docker安装nextcloud网盘

命令行界面输入以下命令即可:

su root
cd $(readlink -f /srv/dev-disk-by-uuid-*/docker-app)
mkdir nextcloud
cd nextcloud
mkdir data
 
docker run -d -p 8888:80  --name nextcloud \
    -v $PWD/data:/var/www/html --restart=always \
    --privileged=true  arm64v8/nextcloud

完成后在网页浏览器访问http://YourIPAddress:8888/即可看到nextcloud网盘的页面,如果无法访问,建议重启一下设备。

19.3 Docker安装Filebrowser

命令行界面输入以下命令即可:

su root
cd $(readlink -f /srv/dev-disk-by-uuid-*/docker-app)
mkdir filebrowser
cd filebrowser
 
docker run -d -v $(readlink -f /srv/dev-disk-by-uuid-*):/srv \
    -v $PWD/filebrowserconfig.json:/etc/config.json \
    -v $PWD/database.db:/etc/database.db -p 8080:80 \
    --restart=always --name filebrowser \
    filebrowser/filebrowser

完成后在网页浏览器访问http://YourIPAddress:8080/即可看到Filebrowser的页面,默认管理员的帐号与密码都是admin。

19.4 Docker安装Jellyfin影音服务器

进入 存储器 -> 共享文件夹,添加 "+" 图标创建media文件夹用于存放影音资源,然后在命令行终端输入以下命令安装Jellyfin:

su root
cd $(readlink -f /srv/dev-disk-by-uuid-*/docker-app)
mkdir jellyfin
cd jellyfin
mkdir config cache
 
docker run -d --name jellyfin \
-v $PWD/config:/config \
-v $PWD/cache:/cache \
-v $(readlink -f /srv/dev-disk-by-uuid-*/media):/media \
-p 8096:8096 \
--restart=always \
jellyfin/jellyfin

完成后在网页浏览器访问http://YourIPAddress:8096/即可看到Jellyfin的页面。

19.5 安装Docker可视化容器管理工具Portainer

命令行界面输入以下命令即可:

su root
cd $(readlink -f /srv/dev-disk-by-uuid-*/docker-app)
mkdir portainer
cd portainer
mkdir data
 
docker run -d \
  --name portainer \
  --restart=always \
  -e TZ=Asia/Shanghai \
  -p 8000:8000 \
  -p 9000:9000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $PWD/data:/data \
  portainer/portainer-ce:latest

完成后在网页浏览器访问http://YourIPAddress:9000/即可看到Portainer的页面,默认管理员的帐号与密码都是admin。

20 系统的备还与还原

20.1 备份eMMC中的系统

使用tar命令备份文件系统的内容:

su root
cd /
tar --warning=no-file-changed -cvpzf /rootfs.tar.gz \
    --exclude=/rootfs.tar.gz --exclude=/var/lib/docker/runtimes \
    --exclude=/etc/firstuser --exclude=/etc/friendlyelec-release \
    --exclude=/usr/local/first_boot_flag --one-file-system /

20.2 还原系统到eMMC

使用SD卡启动,启动Linux系统(例如Debian或Ubuntu均可),使用如下命令查询eMMC上的系统根分区:

root@CM3588:~# sudo parted -s /dev/mmcblk2 unit MiB print | grep rootfs
 8      140MiB   59000MiB  58860MiB  ext4         rootfs

根据上面的序号8可以得知根分区的设备名为/dev/mmcblk2p8,下面对它重新格式化并挂载,然后解压rootfs.tar.gz到此处:

sudo mkfs.ext4 /dev/mmcblk2p8
sudo mkdir /mnt/rootfs
sudo mount /dev/mmcblk2p8 /mnt/rootfs
sudo tar xvzfp /path/to/rootfs.tar.gz -C /mnt/rootfs --numeric-owner --same-owner
sudo poweroff

关机后,拨出SD卡,重新上电从eMMC启动系统。

21 系统重装后恢复硬盘数据

  • 进入 存储器 -> 文件系统, 点击 图标,在 文件系统 一栏选择你的设备,点保存。
  • 进入 存储器 -> 共享文件夹, 创建同名共享文件名,例如本文示例中的nfs, samba, docker, docker-app, docker-compose和docker-data。

22 常见问题与解决办法

22.1 问题: Raid阵列出现如下状态Clean, Resyncing (PENDING)

Execute following command to switch array to read-write state and begin resync process:

mdadm --readwrite /dev/md0

More details → How to clear up pending resync on RAID array

22.2 问题: 挂载文件系统时,未列出存储设备

先使用如下命令擦除硬盘数据:

# 注意:硬盘中的所有数据将会丢失
sudo wipefs --all /dev/mdX

23 OpenMediaVault软件包一览

你可以使用apt命令安装OpenMediaVault的软件包,例如:

apt install openmediavault-diskstats

这是每个软件包的功能列表:
openmediavault-diskclone: 用于克隆磁盘的工具。
openmediavault-diskstats: 显示磁盘使用统计信息的工具。
openmediavault-downloader: 下载管理器,用于管理下载任务。
openmediavault-fail2ban: 防火墙软件,用于防范暴力攻击。
openmediavault-filebrowser: 文件浏览器,用于浏览和管理文件。
openmediavault-flashmemory: 用于将系统日志和临时文件存储在内存中以减少对磁盘的写入。
openmediavault-forkeddaapd: 支持 iTunes 的 DAAP 服务器。
openmediavault-ftp: FTP 服务器,用于文件传输。
openmediavault-kernel: 内核更新工具。
openmediavault-kvm: 虚拟化解决方案,用于运行虚拟机。
openmediavault-locate: 文件搜索工具。
openmediavault-luksencryption: 提供磁盘加密功能。
openmediavault-lvm2: 逻辑卷管理器。
openmediavault-mergerfs: 提供 Union 文件系统功能,将多个文件系统合并成一个逻辑文件系统。
openmediavault-minidlna: DLNA 服务器,用于在网络上共享媒体文件。
openmediavault-nut: 用于监控 UPS(不间断电源系统)的网络通信软件。
openmediavault-omvextrasorg: 提供额外的插件和软件包。
openmediavault-onedrive: 用于与 OneDrive 云存储服务进行集成。
openmediavault-owntone: 用于配置 UPnP/DLNA 媒体服务器。
openmediavault-photoprism: 相片管理软件。
openmediavault-remotemount: 远程挂载管理器。
openmediavault-resetperms: 重置文件和文件夹权限的工具。
openmediavault-rsnapshot: 快照备份工具。
openmediavault-s3: S3 存储服务插件。
openmediavault-sftp: SFTP 服务器。
openmediavault-shairport: AirPlay 音频服务器。
openmediavault-sharerootfs: 允许共享根文件系统的工具。
openmediavault-snapraid: SnapRAID 数据保护工具。
openmediavault-snmp: SNMP(简单网络管理协议)插件。
openmediavault-symlinks: 符号链接管理工具。
openmediavault-tftp: TFTP(Trivial File Transfer Protocol)服务器。
openmediavault-tgt: iSCSI 目标服务器。
openmediavault-usbbackup: USB 备份插件。
openmediavault-wakealarm: 用于通过计划的时间唤醒系统的工具。
openmediavault-webdav: WebDAV 服务器。
openmediavault-wetty: Web 终端工具。
openmediavault-wireguard: WireGuard VPN 插件。
openmediavault-wol: Wake-on-LAN 工具。
openmediavault-anacron: 任务调度工具。
openmediavault-apttool: APT(Advanced Package Tool)管理工具。
openmediavault-autoshutdown: 自动关机工具。
openmediavault-backup: 备份工具。
openmediavault-borgbackup: BorgBackup 工具。
openmediavault-clamav: ClamAV 来检测恶意软件和病毒的防病毒软件。
openmediavault-compose: Docker Compose 工具。
openmediavault-cputemp: 用于监控 CPU 温度的工具。
openmediavault-zfs: ZFS 文件系统支持插件。