Difference between revisions of "APITestPage"

Revision as of 05:37, 20 April 2024

English

1 OpenMediaVault版本信息
2 旧版本的OpenMediaVault文档
3 OpenMediaVault运行界面
4 支持的平台
5 查看IP地址
6 登录OpenMediaVault网页后台
7 设置网页登录密码
8 默认的Linux帐号与密码
9 设置网页超时时间
10 通过ssh登录
11 更新用户密码
12 配置网络与时区
13 切换国内软件源
14 配置硬盘
- 14.1 第一步：清除硬盘
- 14.2 第二步：创建文件系统
15 创建共享文件夹
16 创建NAS用户
17 创建Samba共享
18 创建NFS共享
- 18.1 Mac下测试挂载NFS
- 18.2 Linux下测试挂载NFS
19 Docker的使用
- 19.1 将Docker数据移动至硬盘
- 19.2 Docker安装nextcloud网盘
- 19.3 Docker安装Filebrowser
- 19.4 Docker安装Jellyfin影音服务器
- 19.5 安装Docker可视化容器管理工具Portainer
20 系统的备还与还原
- 20.1 备份eMMC中的系统
- 20.2 还原系统到eMMC
21 系统重装后恢复硬盘数据
22 常见问题与解决办法
- 22.1 问题: Raid阵列出现如下状态Clean, Resyncing (PENDING)
- 22.2 问题: 挂载文件系统时，未列出存储设备
23 OpenMediaVault软件包一览

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运行界面

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

界面如下:

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级别，在"设备"一栏钩选存储设备，保存后，状态如下所示：

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

进入 存储器 -> 文件系统，点击“+”，类型建议选择"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个文件夹，名称分别为nfs和samba，我们接下来将用这些文件夹来测试nfs和samba共享。
(注：如果硬盘中存在同名的共享文件夹，重新创建同名的文件夹，数据会得到保留)

16 创建NAS用户

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

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

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 文件系统支持插件。

@@ Line 1: / Line 1: @@
-====烧写系统到eMMC====
+[[Getting Started with OpenMediaVault|English]]
-=====方法1: 在网页上烧写=====
+==OpenMediaVault版本信息==
-使用刷写了FriendlyWrt固件的TF卡启动{{{1}}}, 登录FriendlyWrt页面, 在网页菜单上点击 "系统" -> "eMMC刷机助手" 进入eMMC刷机助手界面, 点击界面上的 "选择文件" 按钮, 选择你要刷写的文件 (官方固件以rk3399-sd开头), 亦可选择第三方固件, 文件支持 .gz 格式的压缩文件, 或者以 .img 作为扩展名的raw格式。<br/><br/>
+* OS: Debian 12<br />
-选择文件后, 点击 “上传并烧写” 按钮, 开始上传并烧写, 如下图所示:<br/>
+* OpenMediaVault: 7.0.5-1 (Sandworm)<br />
-[[File:Friendlywrt-emmctools2-cn.png|frameless|600px]]<br/>
+* Docker: 26.0.1<br />
-烧写完成后,请弹出SD卡,设备会自动重启, 并从eMMC引导新系统，可留意指示灯的状态, 在系统状态灯闪烁，同时网卡状态灯亮起时，表示系统启动完成, 如果eMMC安装的系统是 FriendlyWrt, 则可以通过点击“进入首页”进入FriendlyWrt管理页面。<br />
+* Others: 已安装OMV-Extras软件包<br />
-需要注意的是, 如果烧写的是FriendlyElec的固件, 网页烧写需要选用文件名带 "-sd-" 字样的镜像文件, 类拟如下的文件名:
+==旧版本的OpenMediaVault文档==
-{| class="wikitable"
+Link to → [[Getting Started with OpenMediaVault6/zh|Getting Started with OpenMediaVault6]]
-|-
+==OpenMediaVault运行界面==
-  | rk3399-sd-friendlywrt-21.02-YYYYMMDD.img.gz
+[[File:Openmediavault7-zh.png|600px]]
-|-
+==支持的平台==
-  | rk3399-sd-friendlywrt-21.02-docker-YYYYMMDD.img.gz
+* RK3328<br />
-|}
+* RK3399<br />
-第三方固件由于命名不规则,你需要确认的是:此固件是支持从eMMC启动的,如果文件格式是7z、zip或者rar格式, 需要先解压缩, 如果文件太大无法写入, 可以先压缩成 .gz 格式再尝试。
+* RK3568<br />
+* RK3588<br />
-=====方法2: 用TF启动卡进行自动烧写=====
+==查看IP地址==
-======烧写系统固件到eMMC======
+由于主机名默认为开发板的型号, 所以可以使用ping命令来获得IP地址，例如CM3588，可以用命令:
-* 此方法是通过SD卡启动一个小型的Linux系统, 然后自动运行一个名为EFlasher的工具来将固件烧写到eMMC中。<br />
+<syntaxhighlight lang="bash">
-* 通过LED灯来掌握烧写进度。<br />
+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 />
-访问[http://download.friendlyelec.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}} 此处的下载地址]下载需要的固件文件(位于"01_系统固件/02_SD卡刷机固件(SD-to-eMMC)"目录)和烧写工具(位于"05_工具软件"目录)：<br />
+* 点击'''用户 -> 用户组'''，点击 '''"+"''' 图标创建一个名为 '''nasuser''' 的用户组。
-{| class="wikitable"
+* 点击'''用户 -> 用户'''，点击 '''"+"''' 图标后创建一个名为 '''nasuser'''，Shell选择/usr/sbin/nologin, 用户组钩选'''nasuser'''和'''users'''的用户。
-|-
+==创建Samba共享==
-  | colspan=2 | '''固件文件'''
+* 点击'''服务 -> SMB/CIFS -> 设置''', 钩选最上面的 "已启动", 最低协议版本选择 '''"SMB1"'''，然后点 "保存"；
-|-
+* 点击'''服务 -> SMB/CIFS -> 共享''', 点击 '''"+"''' ，在 '''"Shared folder"''' 处选择要共享的文件夹，这里我选择samba文件夹。
-  | rk3399-eflasher-friendlywrt-21.02-YYYYMMDD.img.gz
+测试访问: <br />
-  | [[How to Build FriendlyWrt|FriendlyWrt]]系统固件，基于OpenWrt 21.02.3构建，内核版本 5.15.y
+在Mac系统下右击Finder，选择连接服务器后输入 smb://YourIPAddress（换成真实IP)，会弹出验证对话框，输入用户名nasuser以及密码即可以访问。
-|-
+==创建NFS共享==
-  | rk3399-eflasher-friendlywrt-21.02-docker-YYYYMMDD.img.gz
+* 点击"服务" -> "NFS" -> "设置", 钩选最上面的 "已启动", 在"版本"一栏中，钩选所有版本包括'''“NFSv2”'''，然后点 "保存"并应用设置；
-  | 预装了Docker的[[How to Build FriendlyWrt|FriendlyWrt]]系统固件，基于OpenWrt 21.02.3构建，内核版本 5.15.y
+* 点击"服务" -> "NFS" -> "共享", 点击 '''"+"''' ，在 '''"Shared folder"''' 处选择要共享的文件夹，这里我选择 nfs 文件夹。在客户端一栏中输入 192.168.1.0/24 (换成真实网段,或指定仅允许访问的IP)，权限处选择 "读/写"，在扩展选项中输入:
-|-
+<syntaxhighlight lang="bash">
-  | rk3399-eflasher-debian-buster-desktop-4.19-arm64-20220725.img.gz
+rw,async,insecure,no_subtree_check,all_squash,anonuid=0,anongid=0
-  | Debian10系统固件，内核版本 4.19.y
+</syntaxhighlight>
-|-
+然后点 "保存"并应用设置；
-  | rk3399-eflasher-friendlycore-lite-focal-5.15-arm64-YYYYMMDD.img.gz
+===Mac下测试挂载NFS===
-  | 精简版64位FriendlyCore系统固件，基于Ubuntu core 20.04构建，内核版本 5.15.y
+命令行查看OpenMediaVault的NFS共享信息
-|-
+<syntaxhighlight lang="bash">
-  | colspan=2 | '''Flash Utility:'''
+# showmount -e YourIPAddress
-|-
+Exports list on YourIPAddress:
-  | win32diskimager.rar
+/export                             192.168.1.0/24
-  | Windows utility. Under Linux users can use "dd"
+/export/nfs                         192.168.1.0/24
-|}
+</syntaxhighlight>
-详细操作步骤如下：<br />
+在Mac上右击Finder，选择连接服务器，在地址栏输入
-* 准备一张8G或以上容量的SDHC卡;
+<syntaxhighlight lang="bash">
-* 下载并解压 固件文件rk3399-eflasher-OSNAME-YYYYMMDD.img.gz 和 工具win32diskimager;
+nfs://YourIPAddress/export/nfs
-* 在Windows下以管理员身份运行 win32diskimager，在界面上选择你的SD卡盘符，选择解压后的[[EFlasher/zh|EFlasher]]固件，点击 Write 按钮烧写到SD卡; 或者在 Linux下使用 dd 命令将 rk3399-eflasher-OSNAME-YYYYMMDD.img 写入 SD卡;
+</syntaxhighlight>
-* 将SD卡从电脑端弹出，插入{{{1}}}的microSD卡槽;
+===Linux下测试挂载NFS===
-* 连接{{{1}}}的电源，系统会从SD卡启动，并自动启动 [[EFlasher/zh|EFlasher]] 烧写工具将系统安装到 eMMC, 可以通过板载 LED 灯来了解安装进度:
+安装软件包
-{| class="wikitable"
+<syntaxhighlight lang="bash">
-|-
+sudo apt install nfs-common
-! 进度
+</syntaxhighlight>
-! SYS灯 (红灯)
+挂载
-! LAN灯(绿灯)
+<syntaxhighlight lang="bash">
-! WAN灯(绿灯)
+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
-* 烧写完成后，切断电源，然后从{{{1}}}端弹出SD卡，重新上电开机，{{{1}}}会从eMMC启动你刚刚烧写的系统;
+docker-data       -> Location of persistent container data
-======烧写flash镜像文件到eMMC======
+docker-app        -> 自用，存放Dockerfile和数据
-* 自动烧写(默认行为)
+</syntaxhighlight>
-) 从[http://download.friendlyelec.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}} 网盘]上下载文件名带 '''eflasher''' 字样的任意固件, 解压后烧进TF卡;<br />
+进入'''服务 -> Compose'''，进入设置界面，设置"Compose 文件"的Shared folder为docker-compose, 设置"Data“的Shared folder为docker-data，<br />
-) 重新拨插一次TF卡, PC上会出现一个名为FriendlyARM的盘符(Linux下是FriendlyARM目录), 将 .img 或者 .gz结尾的固件复制进去;<br />
+<br />
-) 编辑TF卡上的 eflasher.conf 配置文件, 修改 autoStart= 后面的值指定为你的固件文件名, 例如:<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 \
+    -v $PWD/data:/var/www/html --restart=always \
+    --privileged=true  arm64v8/nextcloud
+</syntaxhighlight>
+完成后在网页浏览器访问http://YourIPAddress:8888/即可看到nextcloud网盘的页面，如果无法访问，建议重启一下设备。
+===Docker安装Filebrowser===
+命令行界面输入以下命令即可：
+<syntaxhighlight lang="bash">
+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
+</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 \
+-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
+</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 \
+  --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
+      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">
-autoStart=openwrt-rockchip-armv8_nanopi-ext4-sysupgrade.img.gz
+apt install openmediavault-diskstats
 </syntaxhighlight>
-支持文件名带 "-sd-" 字样的镜像文件, 如下所示:
+这是每个软件包的功能列表:<br />
-{| class="wikitable"
+openmediavault-diskclone: 用于克隆磁盘的工具。<br />
-|-
+openmediavault-diskstats: 显示磁盘使用统计信息的工具。<br />
-  | rk3399-sd-friendlywrt-21.02-YYYYMMDD.img.gz
+openmediavault-downloader: 下载管理器，用于管理下载任务。<br />
-|-
+openmediavault-fail2ban: 防火墙软件，用于防范暴力攻击。<br />
-  | rk3399-sd-friendlywrt-21.02-docker-YYYYMMDD.img.gz
+openmediavault-filebrowser: 文件浏览器，用于浏览和管理文件。<br />
-|-
+openmediavault-flashmemory: 用于将系统日志和临时文件存储在内存中以减少对磁盘的写入。<br />
-  | rk3399-sd-friendlywrt-22.03-YYYYMMDD.img.gz
+openmediavault-forkeddaapd: 支持 iTunes 的 DAAP 服务器。<br />
-|-
+openmediavault-ftp: FTP 服务器，用于文件传输。<br />
-  | rk3399-sd-friendlywrt-22.03-docker-YYYYMMDD.img.gz
+openmediavault-kernel: 内核更新工具。<br />
-|}
+openmediavault-kvm: 虚拟化解决方案，用于运行虚拟机。<br />
-) 安全弹出TF卡, 将TF卡放在{{{1}}}上上电启动, 会自动烧写你的固件, 通过板载 LED 灯来了解安装进度;<br />
+openmediavault-locate: 文件搜索工具。<br />
-=====方法3: 通过USB烧写=====
+openmediavault-luksencryption: 提供磁盘加密功能。<br />
-======步骤1: 安装USB驱动和工具======
+openmediavault-lvm2: 逻辑卷管理器。<br />
-从[http://download.friendlyelec.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}} 网盘]的tools目录下载瑞芯微的USB驱动: DriverAssitant_v5.1.1.zip, 解压后安装; <br />
+openmediavault-mergerfs: 提供 Union 文件系统功能，将多个文件系统合并成一个逻辑文件系统。<br />
-在相同目录下, 下载瑞芯微开发工具: RKDevTool_Release_v2.84.zip, 解压后备用; <br />
+openmediavault-minidlna: DLNA 服务器，用于在网络上共享媒体文件。<br />
-======步骤2: 将{{{1}}}与电脑连接, 并进入刷机模式======
+openmediavault-nut: 用于监控 UPS（不间断电源系统）的网络通信软件。<br />
-) 断开{{{1}}}上连接的USB和电源线, 弹出TF卡;<br />
+openmediavault-omvextrasorg: 提供额外的插件和软件包。<br />
-) 按住Mask按键不放, 插上电源, 保持按住Mask键, 状态灯亮起3秒后即可松开;<br />
+openmediavault-onedrive: 用于与 OneDrive 云存储服务进行集成。<br />
-) 用USB A-to-A数据线 (也叫USB公对公数据线), 将{{{1}}}与电脑进行连接, 连接方法参照下图, 需要连接靠近外侧的USB端口:<br />
+openmediavault-owntone: 用于配置 UPnP/DLNA 媒体服务器。<br />
-[[File:Nanopir4se-usba-to-usba.jpg|frameless|400px]]<br />
+openmediavault-photoprism: 相片管理软件。<br />
-======步骤3: 烧写固件到eMMC======
+openmediavault-remotemount: 远程挂载管理器。<br />
-固件格式一般有两种格式, 一种是单个的image文件, 通常第三方固件会使用这种打包方式, 另一种是多个分区镜像, FriendlyELEC的固件采用这种方式, 下面分别对这两种格式的固件进行说明:
+openmediavault-resetperms: 重置文件和文件夹权限的工具。<br />
-* 选项1: 烧写打包成单个image文件的固件<br />
+openmediavault-rsnapshot: 快照备份工具。<br />
-在电脑上双击 RKDevTool_Release_v2.84 目录下的 RKDevTool.exe 启动瑞芯微开发工具, 与电脑连接正常的情况下, 瑞芯微开发工具界面上会显示 "发现一个Maskrom设备";<br />
+openmediavault-s3: S3 存储服务插件。<br />
-在瑞芯微开发工具界面上, 点击 “升级固件”, 再点击 “固件” 按钮, 选择你要烧写的image文件, 点击 “升级” 然后等待烧写完成即可, 完成后设备会自动重启, 并从eMMC启动你刚刚安装的系统;<br />
+openmediavault-sftp: SFTP 服务器。<br />
-* 选项2: 烧写由多个分区镜像组成的固件<br />
+openmediavault-shairport: AirPlay 音频服务器。<br />
-根据需要到[http://download.friendlyelec.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}} 网盘]上下载对应的压缩包, 在电脑上解压:
+openmediavault-sharerootfs: 允许共享根文件系统的工具。<br />
-{| class="wikitable"
+openmediavault-snapraid: SnapRAID 数据保护工具。<br />
-|-
+openmediavault-snmp: SNMP（简单网络管理协议）插件。<br />
-  | colspan=2 | '''固件文件'''
+openmediavault-symlinks: 符号链接管理工具。<br />
-|-
+openmediavault-tftp: TFTP（Trivial File Transfer Protocol）服务器。<br />
-  | rk3399-usb-friendlywrt-21.02-YYYYMMDD.img.gz
+openmediavault-tgt: iSCSI 目标服务器。<br />
-  | 精简版[[How to Build FriendlyWrt|FriendlyWrt]]系统固件，基于OpenWrt 21.02.3构建，内核版本 5.15.y
+openmediavault-usbbackup: USB 备份插件。<br />
-|-
+openmediavault-wakealarm: 用于通过计划的时间唤醒系统的工具。<br />
-  | rk3399-usb-friendlywrt-21.02-docker-YYYYMMDD.img.gz
+openmediavault-webdav: WebDAV 服务器。<br />
-  | 预装了Docker的[[How to Build FriendlyWrt|FriendlyWrt]]系统固件，基于OpenWrt 21.02.3构建，内核版本 5.15.y
+openmediavault-wetty: Web 终端工具。<br />
-|-
+openmediavault-wireguard: WireGuard VPN 插件。<br />
-  | rk3399-usb-debian-buster-desktop-arm64-YYYYMMDD.img.gz
+openmediavault-wol: Wake-on-LAN 工具。<br />
-  | Debian10 系统固件，内核版本 4.19.y
+openmediavault-anacron: 任务调度工具。<br />
-|-
+openmediavault-apttool: APT（Advanced Package Tool）管理工具。<br />
-  | rk3399-usb-friendlycore-lite-focal-5.10-arm64-YYYYMMDD.img.gz
+openmediavault-autoshutdown: 自动关机工具。<br />
-  | 精简版64位FriendlyCore系统固件，基于Ubuntu core 20.04构建，内核版本 5.15.y
+openmediavault-backup: 备份工具。<br />
-|}
+openmediavault-borgbackup: BorgBackup 工具。<br />
-解压后, 可以看到固件目录下已内置了瑞芯微开发工具和预设好的配置文件, 双击 RKDevTool.exe 启动瑞芯微开发工具, 界面上会显示 "发现一个Maskrom设备", 点击界面上的“执行”按钮, 稍等片刻即可完成烧写, 完成后设备会自动重启, 并从eMMC启动你安装的系统;<br />
+openmediavault-clamav: ClamAV 来检测恶意软件和病毒的防病毒软件。<br />
+openmediavault-compose: Docker Compose 工具。<br />
+openmediavault-cputemp: 用于监控 CPU 温度的工具。<br />
+openmediavault-zfs: ZFS 文件系统支持插件。<br />

Difference between revisions of "APITestPage"

Revision as of 05:37, 20 April 2024

Contents

1 OpenMediaVault版本信息

2 旧版本的OpenMediaVault文档

3 OpenMediaVault运行界面

4 支持的平台

5 查看IP地址

6 登录OpenMediaVault网页后台

7 设置网页登录密码

8 默认的Linux帐号与密码

9 设置网页超时时间

10 通过ssh登录

11 更新用户密码

12 配置网络与时区

13 切换国内软件源

14 配置硬盘

14.1 第一步：清除硬盘

14.2 第二步：创建文件系统

14.2.1 方案1: 配置MD RAID

14.2.2 方案2: 配置Btrfs RAID

14.2.3 方案3: 不使用RAID阵列

15 创建共享文件夹

16 创建NAS用户

17 创建Samba共享

18 创建NFS共享

18.1 Mac下测试挂载NFS

18.2 Linux下测试挂载NFS

19 Docker的使用

19.1 将Docker数据移动至硬盘

19.2 Docker安装nextcloud网盘

19.3 Docker安装Filebrowser

19.4 Docker安装Jellyfin影音服务器

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

20 系统的备还与还原

20.1 备份eMMC中的系统

20.2 还原系统到eMMC

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

22 常见问题与解决办法

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

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

23 OpenMediaVault软件包一览

Navigation menu

Search