# 香橙派折腾日志

> source: 文章/orange-pi/index.md

# 香橙派折腾日志

新买的orange pi 3B带了一个64GB的eMMC模块，想着用这个来做系统盘，这样运行速度说不定也能快一些，但是折腾了好一会还是没搞明白怎么直接把ubuntu镜像直接烧录到eMMC中，所以还是先按照老路子用sd卡先启动系统了，然后再想办法把系统移到eMMC模块中

## 安装Ubuntu系统

我的想法是，先使用sd卡在本地运行系统，然后再下载镜像文件，将镜像安装到尚未挂载的eMMC中，然后关机拔掉sd卡，使用eMMC启动系统，实际上这个方案安装了两次系统，但个人认为这种方法普适性比较强，也不容易出错

### 确认设备

首先查看我们的eMMC模块是否正常被系统识别，使用`lsblk`命令可以列出所有的块设备，包括硬盘，sd卡和eMMC，我们用下面的命令列出系统中所有的分区和设备：

```bash
sudo fdisk -l
```

得到了下面的结果：

```bash
[sudo] password for orangepi:
Disk /dev/ram0: 4 MiB, 4194304 bytes, 8192 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 4096 bytes
I/O size (minimum/optimal): 4096 bytes / 4096 bytes


Disk /dev/zram0: 1.92 GiB, 2056716288 bytes, 502128 sectors
Units: sectors of 1 * 4096 = 4096 bytes
Sector size (logical/physical): 4096 bytes / 4096 bytes
I/O size (minimum/optimal): 4096 bytes / 4096 bytes
GPT PMBR size mismatch (8191 != 32767) will be corrected by write.
The backup GPT table is not on the end of the device.


Disk /dev/mtdblock0: 16 MiB, 16777216 bytes, 32768 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: gpt
Disk identifier: 821AFC38-EF54-4269-8BDA-C1B6C264ACBC

Device           Start   End Sectors  Size Type
/dev/mtdblock0p1    64  1023     960  480K Linux filesystem
/dev/mtdblock0p2  1024  7167    6144    3M Linux filesystem


Disk /dev/mmcblk0: 58.24 GiB, 62537072640 bytes, 122142720 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes


Disk /dev/mmcblk1: 116.06 GiB, 124621160448 bytes, 243400704 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: gpt
Disk identifier: 36F56BAC-8A57-B347-A59D-AC7869D57E7B

Device           Start       End   Sectors   Size Type
/dev/mmcblk1p1   61440   2158591   2097152     1G Linux extended boot
/dev/mmcblk1p2 2158592 240943103 238784512 113.9G Linux filesystem


Disk /dev/zram1: 50 MiB, 52428800 bytes, 12800 sectors
Units: sectors of 1 * 4096 = 4096 bytes
Sector size (logical/physical): 4096 bytes / 4096 bytes
I/O size (minimum/optimal): 4096 bytes / 4096 bytes
```

观察到`mmcblk0`这个设备的容量为`58.24 GiB`，可以确定这个就是eMMC了，sd卡为`mmcblk1`，现在我们就可以开始进行下一步的操作了

### 下载镜像

因为我的设备是 orange pi 3B，所以需要使用香橙派官方提供的镜像，镜像的url是下面这个：

http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html

这里我选择的是 Ubuntu jammy 版本的，由于我没有百度网盘的会员，也懒得下载这个流氓软件，所以我就使用了英文版，英文版存储在 Google Drive 中下载速度很快，找到对应的版本，然后想办法使用Linux进行下载，这里的链接是：

[Orangepi3b_1.0.6_ubuntu_jammy_desktop_xfce_linux5.10.160.7z](https://drive.google.com/file/d/1bxjwzKvuwo4-km_05Gyg_rO-dngd58AH/view?usp=drive_link)

我们需要拿到这个链接中的`ID`，然后使用`gdown`进行下载，这个工具需要安装一下

```bash
sudo apt update
sudo apt install python3-pip
pip3 --version

# 安装gdown
pip3 install gdown
```

安装好了以后就可以用这个工具下载镜像文件了：

```bash
gdown https://drive.google.com/uc?id=1bxjwzKvuwo4-km_05Gyg_rO-dngd58AH
```

如果提示找不到工具`gdown`而我们确实已经安装了，我们需要手动将`pip`的安装目录添加到`PATH`环境变量中

```bash
vim ~/.bashrc
```

加上下面这一行：

```bash
export PATH=$HOME/.local/bin:$PATH
```

保存文件，重新加载一下

```bash
source ~/.bashrc
gdown --version
```

现在就可以下载镜像文件了

下载完成后需要安装`7z`解压工具

```bash
sudo apt install p7zip-full
```

将镜像文件解压到当前目录

```bash
7z x ubuntu.7z
```

### 写入镜像

使用`dd`命令将镜像写入eMMC

```bash
sudo dd if=/home/orangepi/Documents/Orangepi3b_1.0.6_ubuntu_jammy_desktop_xfce_linux5.10.160.img of=/dev/mmcblk0 bs=4M status=progress
```

对于上面这个命令：

- `if=/home/orangepi/Documents/Orangepi3b_1.0.6_ubuntu_jammy_desktop_xfce_linux5.10.160.img`指定输入文件
- `of=/dev/mmcblk0`指定输出设备
- `bs=4M`设置块大小为4MB，以提高传递速度
- `status=progress`显示进度信息

同步数据：

```bash
sudo sync
```

重启系统并拔掉sd卡：

```bash
sudo shutdown -h now
```

重启后就可以正常开机了，需要注意一下进行ssh连接时的主机，把原来`/.ssh/known_hosts`中的连接信息删除掉，才能正常连接

## 挂载磁盘

查看设备

```bash
$ lsblk

NAME         MAJ:MIN RM  SIZE RO TYPE MOUNTPOINTS
sda            8:0    0  1.8T  0 disk
├─sda1         8:1    0  200M  0 part
└─sda2         8:2    0  1.8T  0 part
mtdblock0     31:0    0   16M  0 disk
mmcblk0      179:0    0 58.2G  0 disk
├─mmcblk0p1  179:1    0    1G  0 part /boot
└─mmcblk0p2  179:2    0 56.6G  0 part /var/log.hdd
                                      /
mmcblk0boot0 179:32   0    4M  1 disk
mmcblk0boot1 179:64   0    4M  1 disk
zram0        254:0    0  1.9G  0 disk [SWAP]
zram1        254:1    0   50M  0 disk /var/log
```

<!-- fold -->

可以发现检测到了大小1.8T的机械硬盘`sda`，并且其上有两个分区`sda1`和`sda2`，我们首先格式化现有分区为ext4文件系统：

```bash
sudo mkfs.ext4 /dev/sda2
```

随后我们将分区挂载到一个目录下：

```bash
sudo mkdir /mnt/my_hdd
sudo mount /dev/sda2 /mnt/my_hdd
```

使用下面的命令来查看是否挂载成功：

```bash
$ df -h

Filesystem      Size  Used Avail Use% Mounted on
tmpfs           393M  6.0M  387M   2% /run
/dev/mmcblk0p2   56G  5.1G   50G  10% /
tmpfs           2.0G     0  2.0G   0% /dev/shm
tmpfs           5.0M  4.0K  5.0M   1% /run/lock
tmpfs           2.0G   12K  2.0G   1% /tmp
/dev/mmcblk0p1 1022M  125M  898M  13% /boot
/dev/zram1       47M  2.8M   41M   7% /var/log
tmpfs           393M   76K  393M   1% /run/user/1000
overlaid        393M   76K  393M   1% /run/user/1000/orangepi-chromium
/dev/sda2       1.8T   28K  1.7T   1% /mnt/my_hdd
```

我们可以看到`/dev/sda2`已经成功挂载到了`/mnt/my_hdd`目录下了

```bash
sudo fdisk /dev/sda
```

添加自动挂载，使操作系统在启动的时候能够自动挂载这个文件系统，无需每次启动后都手动挂载，在`/etc/fstab`文件中添加配置就可以实现，首先获取分区的`UUID`

```bash
$ sudo blkid /dev/sda2

/dev/sda2: UUID="6a087af8-cff6-4dd9-b04b-d725b8fe5138" BLOCK_SIZE="4096" TYPE="ext4" PARTUUID="de917428-c440-4581-989f-f7682598a1be"
```

然后编辑`/etc/fstab`文件

```bash
sudo vim /etc/fstab
```

加上这样一行：

```bash
UUID="6a087af8-cff6-4dd9-b04b-d725b8fe5138" /mnt/my_hdd ext4 defaults 0 2
```

上面的这一行配置的含义分别为：

- UUID：分区的唯一标识
- 挂载点：分区要挂载到的目录
- 文件系统类型：ext4
- 挂载选项：defaults表示使用默认的挂载选项
- dump选项：一般设为0，表示不进行文件系统备份
- fsck选项：设为2，表示在系统启动时进行文件系统检查的优先级

对于一个尚未挂载使用的磁盘，我们可以用下面这个脚`setup_hdd.sh`本来自动挂载：

```bash
#!/bin/bash

# 创建分区表和分区
sudo parted /dev/sda --script mklabel gpt
sudo parted /dev/sda --script mkpart primary ext4 0% 100%

# 格式化分区
sudo mkfs.ext4 /dev/sda1

# 创建挂载点
sudo mkdir -p /mnt/my_hdd

# 挂载硬盘
sudo mount /dev/sda1 /mnt/my_hdd

# 添加到 /etc/fstab
echo "/dev/sda1 /mnt/my_hdd ext4 defaults 0 2" | sudo tee -a /etc/fstab

# 确认挂载
df -h
```

然后给这个脚本权限并运行：

```bash
chmod +x setup_hdd.sh
./setup_hdd.sh
```

这样，硬盘`/dev/sda`将会被格式化并挂载到`/mnt/my_hdd`，并且在每次启动时自动挂载

## 状态显示

如果要显示CPU占用率、温度，内存、存储占用率，进程等信息，可以采用以下工具

### Neofetch

```bash
sudo apt install neofetch
neofetch
```

```bash
            .-/+oossssoo+/-.               orangepi@orangepi3b
        `:+ssssssssssssssssss+:`           -------------------
      -+ssssssssssssssssssyyssss+-         OS: Ubuntu 22.04.4 LTS aarch64
    .ossssssssssssssssssdMMMNysssso.       Host: Rockchip RK3566 OPi 3B
   /ssssssssssshdmmNNmmyNMMMMhssssss/      Kernel: 5.10.160-rockchip-rk356x
  +ssssssssshmydMMMMMMMNddddyssssssss+     Uptime: 28 mins
 /sssssssshNMMMyhhyyyyhmNMMMNhssssssss/    Packages: 1749 (dpkg)
.ssssssssdMMMNhsssssssssshNMMMdssssssss.   Shell: bash 5.1.16
+sssshhhyNMMNyssssssssssssyNMMMysssssss+   Resolution: 1920x1080
ossyNMMMNyMMhsssssssssssssshmmmhssssssso   WM: Xfwm4
ossyNMMMNyMMhsssssssssssssshmmmhssssssso   WM Theme: Numix
+sssshhhyNMMNyssssssssssssyNMMMysssssss+   Theme: Adwaita [GTK3]
.ssssssssdMMMNhsssssssssshNMMMdssssssss.   Icons: Adwaita [GTK3]
 /sssssssshNMMMyhhyyyyhdNMMMNhssssssss/    Terminal: /dev/pts/0
  +sssssssssdmydMMMMMMMMddddyssssssss+     CPU: (4) @ 1.800GHz
   /ssssssssssshdmNNNNmyNMMMMhssssss/      Memory: 655MiB / 3922MiB
    .ossssssssssssssssssdMMMNysssso.
      -+sssssssssssssssssyyyssss+-
        `:+ssssssssssssssssss+:`
            .-/+oossssoo+/-.

```

### Glances

如果在终端中，可以使用Glances，它也支持打开一个端口在Web洁面查看实时信息

安装使用下面的命令：

```bash
sudo apt-get update
sudo apt-get install -y glances
sudo apt-get install -y python3-pip
pip3 install glances[all]
```

上面的命令会花费一段不短的时间

最后使用`glances`命令就可以启动Glances，如果希望通过Web洁面进行监控，可以增加一个参数`-w`，默认情况下会在端口61208上运行

### Conky

Conky可以在桌面上显示，使用下面的命令安装：

```bash
sudo apt-get update
sudo apt-get install -y conky-all
```

然后写入配置文件`~/.conkyrc`

```bash
conky.config = {
    background = true,
    use_xft = true,
    font = 'DejaVu Sans Mono:size=10',
    xftalpha = 0.8,
    update_interval = 1,
    total_run_times = 0,
    own_window = true,
    own_window_type = 'desktop',
    own_window_transparent = true,
    own_window_argb_visual = true,
    own_window_argb_value = 50,
    double_buffer = true,
    minimum_width = 200,
    minimum_height = 200,
    maximum_width = 300,
    draw_shades = false,
    draw_outline = false,
    draw_borders = false,
    draw_graph_borders = true,
    default_color = 'white',
    alignment = 'top_right',
    gap_x = 50,
    gap_y = 50,
    no_buffers = true,
    cpu_avg_samples = 2,
    override_utf8_locale = true,
    use_spacer = 'none',
};

conky.text = [[
${color grey}System Information ${hr 2}
${color grey}Uptime:${color} $uptime
${color grey}Frequency (in MHz):${color} $freq
${color grey}Frequency (in GHz):${color} $freq_g
${color grey}RAM Usage:${color} $mem/$memmax - $memperc% ${membar 4}
${color grey}Swap Usage:${color} $swap/$swapmax - $swapperc% ${swapbar 4}
${color grey}CPU Usage:${color} $cpu% ${cpubar 4}
${color grey}CPU Temperature:${color} ${hwmon 0 temp 1}°C
${color grey}Processes:${color} $processes  ${color grey}Running:${color} $running_processes

${color grey}File systems:${color} ${fs_used /}/${fs_size /} ${fs_bar 6 /}

${color grey}Name              PID     CPU%   MEM%
${color} ${top name 1} ${top pid 1} ${top cpu 1} ${top mem 1}
${color} ${top name 2} ${top pid 2} ${top cpu 2} ${top mem 2}
${color} ${top name 3} ${top pid 3} ${top cpu 3} ${top mem 3}
${color} ${top name 4} ${top pid 4} ${top cpu 4} ${top mem 4}
]];
```

为了让程序能够开机自动启动，我们可以创建一个脚本

```bash
vim ~/.config/autostart/conky.desktop
```

添加下面的内容：

```bash
[Desktop Entry]
Type=Application
Exec=conky
Hidden=false
NoDisplay=false
X-GNOME-Autostart-enabled=true
Name=Conky
Comment=System monitor
```

最后为脚本添加可执行权限

```bash
chmod +x ~/.config/autostart/conky.desktop
```

也可以配置系统服务，但是我尝试后怎么都执行不起来

## 桌面美化

安装GNOME即可

```bash
sudo apt install ubuntu-gnome-desktop
```

然后重启就可以拥有新桌面了，整个安装过程很快

## 文件共享

### Samba

轻量级的文件共享可以使用Samba，它可以让Linux和Windows系统之间实现文件和打印机共享

首先安装：

```bash
sudo apt update
sudo apt install samba
```

配置Samba

编辑这个路径下的配置文件：`/etc/samba/smb.conf`

```bash
sudo vim /etc/samba/smb.conf
```

在文件末尾加上：

```bash
[Shared]
   path = /mnt/my_hdd/shares
   available = yes
   valid users = orangepi
   read only = no
   browsable = yes
   public = yes
   writable = yes
```

注意更改`path`和`valid users`，其中`valid users`指的是Ubuntu的用户名，然后确保这个路径文件夹已经存在了，如果不存在则创建一个，随后确保 Samba 用户对文件夹有正确的权限：

```bash
sudo chown -R orangepi:orangepi  /mnt/my_hdd/shares
sudo chmod -R 0755 /mnt/my_hdd/shares
```

上面的命令如果权限不够，则加上`-f`强制修改

然后创建 Samba 用户

```bash
sudo smbpasswd -a orangepi
```

重启 Samba 服务

```bash
sudo systemctl restart smbd
```

然后在其他电脑上输入`smb://192.168.x.xxx`就可以正常访问共享文件夹了，进入其中会显示一个`shared`文件夹，在这里显示共享的文件，需要注意的是，在Linux主机下，我将这个共享的文件夹命名成了`shared`

### Nextcloud

在局域网内实现文件共享，还可以采用Nextcloud，它提供一个端口进行图形化界面的访问，有更高级的功能，用户界面也更友好，首先安装`Apache`，`MySQL`和`PHP`

```bash
sudo apt update
sudo apt install apache2 mysql-server php libapache2-mod-php php-mysql php-gd php-json php-curl php-mbstring php-intl php-imagick php-xml php-zip
```

然后下载安装Nextcloud

```bash
wget https://download.nextcloud.com/server/releases/latest.zip
unzip latest.zip
sudo mv nextcloud /var/www/
```

这里注意Nextcloud安装的目录为`/var/www/`

设置Nextcloud数据目录权限：

```bash
sudo chmod 777 /mnt/my_hdd
mkdir /mnt/my_hdd/nextcloud_storage
sudo chown -R www-data:www-data /mnt/my_hdd/nextcloud_storage
sudo chmod -R 750 /mnt/my_hdd/nextcloud_storage
```

这里我们允许所有用户读、写和执行该目录，然后创建一个`nextcloud_storage`用来存储Nextcloud的数据

随后创建一个新的`Apache`配置文件：

```bash
sudo vim /etc/apache2/sites-available/nextcloud.conf
```

在配置文件中添加：

```apache
<VirtualHost *:80>
   DocumentRoot /var/www/nextcloud/
   ServerName 192.168.2.230

   <Directory /var/www/nextcloud/>
      Options +FollowSymlinks
      AllowOverride All

      <IfModule mod_dav.c>
         Dav off
      </IfModule>

      SetEnv HOME /var/www/nextcloud
      SetEnv HTTP_HOME /var/www/nextcloud

   </Directory>
</VirtualHost>
```

启用配置文件和Apache必要模块：

```bash
sudo a2ensite nextcloud.conf
sudo a2enmod rewrite headers env dir mime setenvif ssl
sudo systemctl restart apache2
```

配置MySQL：

```bash
sudo mysql -u root -p

CREATE DATABASE nextcloud;
CREATE USER 'orangepi'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON nextcloud.* TO 'orangepi'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```

使用下面的命令测试是否能正常登录数据库：

```bash
mysql -u orangepi -p -h localhost nextcloud
```

现在就可以访问端口了：

![image-00060616184705749](https://mdstore.oss-cn-beijing.aliyuncs.com/markdown/image-00060616184705749.png)

如果遇到数据库权限问题，要注意一下挂载的硬盘格式是否正确、是否有权限

信息填写如下：

<img src="https://mdstore.oss-cn-beijing.aliyuncs.com/markdown/image-00060616204133804.png" alt="image-00060616204133804" style="zoom:70%;" />

等待一小会后就可以正常使用了

## 下载工具

作为一个二次元🐭🐭，网盘不拿来存放番剧就没有存在的意义了，所以我希望安装一个BitTorent客户端，在这里我就选择了最常用的轻量级客户端Transmission，下载命令：

```bash
sudo apt update
sudo apt install transmission-cli transmission-daemon
```

创建下载目录并设置权限：

```bash
mkdir /mnt/my_hdd/transmission_downloads
sudo chown -R debian-transmission:www-data /mnt/my_hdd/transmission_downloads
sudo chmod -R 777 /mnt/my_hdd/transmission_downloads
```

接下来配置Transmission

停止Transmission 的守护进程：

```bash
sudo systemctl stop transmission-daemon
```

编辑配置文件：

```bash
sudo vim /etc/transmission-daemon/settings.json
```

修改用户名和登录密码，这是用来登录下载Web界面的，也修改`rpc-port`，指定访问端口，默认为`9091`，为了让其他设备也能访问，需要关闭白名单，并且将`rpc-whitelist`的值改为`*`，这样只要携带用户名和密码就能通过任何设备访问这个端口了，然后修改下载的路径到`/mnt/my_hdd/transmission_downloads`

最后启动进程：

```bash
sudo systemctl start transmission-daemon
```

上传一个torrent文件，经过测试，可以正常下载：

![image-00060617152744579](https://mdstore.oss-cn-beijing.aliyuncs.com/markdown/image-00060617152744579.png)

## 优化使用

到现在我们算是有了基本的使用功能了，但是各个部分的体验还是蛮割裂的，比如我们没法通过Linux文件系统直接访问Nextcloud中储存的文件，因此如果我们要在Linux本机中将数据传递到Nextcloud网盘中，竟然还要转一道手！这显然很不方便；因此Transmission中下载到Linux本地的文件也不能同步到Nextcloud中；此外，Transmission下载文件需要url或torrent文件，这需要我们的终端远程上传，我们希望服务器能够更灵活、自动化一些，如读取RSS订阅内容

### Nextcloud挂载本地

我们希望能将Nextcloud作为本地存储使用，可以使用WebDAV，将其挂载为本地文件系统（这部分会比较麻烦）

安装davfs2

```bash
sudo apt update
sudo apt install davfs2
```

创建挂载点`/mnt/nextcloud`

```bash
sudo mkdir /mnt/nextcloud
```

挂载Nextcloud WebDAV 到本地目录：

```bash
sudo mount -t davfs  https://192.168.2.230/remote.php/dav/files/kihara /mnt/nextcloud
```

之后会提示输入用户名和密码，正确后会继续进行挂载

⚠️ 这一步需要有`SSL`证书，否则挂载会失败，因此如果要继续进行这一步，建议在想要将Nextcloud暴露在公网中使用时再搞，不然会比较繁琐

### RSS订阅

使用Flexget从RSS源中获取种子文件并自动添加到Transmission中

参考链接: https://flexget.com/Cookbook/Transmission

安装：

```bash
sudo apt update
sudo apt install python3-pip
pip3 install flexget
```

这个过程要安装很多依赖，保证网络稳定

随后创建Flexget的配置文件`~/.flexget/config.yml`，包含RSS源和Transmission的配置：

```yaml
tasks:
  rss_to_transmission:
    rss:
      url: 'http://example.com/rss'  # 替换为 RSS 源地址
    accept_all: yes
    transmission:
      host: 'localhost'
      port: 9091
      username: 'your_username'      # 如果有设置用户名和密码
      password: 'your_password'      # 如果有设置用户名和密码
```

对于多任务，请这样配置：

```yaml
tasks:
  rss_gbc:
    rss:
      url: 'https://nyaa.si/?page=rss&q=girls+band+cry+%5B%E5%96%B5%E8%90%8CProduction%26LoliHouse%5D&c=0_0&f=0'
    accept_all: yes
    transmission:
      host: 'localhost'
      port: 9091
      username: 'kihara' 
      password: 'your_password'

  rss_shuumatsu:
    rss:
      url: 'https://nyaa.si/?page=rss&q=%E7%BB%88%E6%9C%AB%E5%88%97%E8%BD%A6+%5B%E5%96%B5%E8%90%8C%E5%A5%B6%E8%8C%B6%E5%B1%8B%26LoliHouse%5D&c=0_0&f=0'
    accept_all: yes
    transmission:
      host: 'localhost'
      port: 9091
      username: 'kihara'
      password: 'your_password'
```

测试配置文件是否正确：

```bash
flexget check
```

手动运行任务，测试是否能从RSS源中获取种子并添加到Transmission:

```bash
flexget execute
```

如果不能运行，则需要安装一下`transmission-rpc`

```bash
pip install 'transmission-rpc>=7.0.3,<8.0.0'
```

再次运行测试一下，如果能显示到订阅信息，则说明运行成功✅

以上我们的程序都还是手动运行的，需要输入命令才能进行一次运行，我们使用RSS的初衷就是为了解放双手，让服务器自动检测更新并获取订阅内容，因此我们需要自动化RSS订阅，每隔一段时间运行一次命令，检查是否有更新，使用`cron`定期运行Flexget任务：

```bash
crontab -e
```

添加以下行：

```bash
0 * * * * /usr/local/bin/flexget execute
```

这将每小时运行一次Flexget，并将新种子添加到Transmission中，具体规则在运行`corn`后的配置文件中有写，这里不再赘述，可以发现这时程序已经在下载RSS中的资源了

![image-00060617161735208](https://mdstore.oss-cn-beijing.aliyuncs.com/markdown/image-00060617161735208.png)

## Nextcloud接入公网

上面的一系列步骤终于使得我们的服务器能够正常运行功能，但是作为一个网盘，如果不能实现远程访问，和一个锁在家里的保险柜也并无二致，如果资源只能自娱自乐而不能分享的话，那它的意义就不大了，我们希望将网盘的访问范围从家庭局域网扩展到公网上，这样我们不仅可以在任何有网络的地方进行访问，传递数据，也能将网盘中的数据分享出去

### 配置端口转发和动态DNS

首先进入我们的家庭网关，需要对设备配置端口转发，这里我使用的网关是openwrt，按照openwrt的配置`网络>>防火墙>>端口转发`进入设置

![image-00060618112935765](https://mdstore.oss-cn-beijing.aliyuncs.com/markdown/image-00060618112935765.png)

名称填合适的有辨识度的就行，外部端口意思是从外部网络访问我们的公网ip下网关服务的端口，如果我们在这里填80，就代表在外部访问时只需要输入公网ip或域名就可以访问，因为浏览器会自动添加80端口；内部IP地址填我们指定的开启Web服务的Linux主机的IP，内部端口填我们在之前设置的，在内部局域网中能够访问Web界面服务的端口，这里都是80。如果要配置HTTPS服务，则再添加一个端口转发，把端口改成443即可

然后设置动态DNS

由于我们的公网IP在一般情况下都是动态的，可能会改变，因此我们需要有一种方法能够追踪IP的变化，否则我们现在能用这个IP连接到服务，可能过个几十分钟就不行了，这里采用动态DNS技术(DDNS)，简而言之就是使用一个固定的域名，我们将当前IP与域名相绑定，当IP改变时，域名服务商会获取到改变的IP，然后始终将域名与最新的IP相绑定，这样，我们只需要访问固定的域名就能获取到服务了，不需要关心公网IP是否变化。在这里由于我的域名是在阿里云买的，所以DDNS服务也使用阿里云的

首先我们进入阿里云控制台，进入域名的解析设置，添加记录：

- 记录类型`A`：将域名指向一个IPv4地址
- 主机记录：`nextcloud.limuyuan.top`，这里的`nextcloud`是我自己家的次级域名，后面的这一堆是我的域名本身，因为我想使用这个域名来访问Nextcloud，并且不影响这个域名下的其他服务
- 记录值：`填写当前查询到的公网IP`
- TTL：`10分钟`

然后再在openwrt中进入`服务>>动态DDNS`，添加一个新的服务项：

![image-00060618114341303](https://mdstore.oss-cn-beijing.aliyuncs.com/markdown/image-00060618114341303.png)

这里的用户名和密码都是阿里云的`Accesskey`和密钥，正常来说申请一个就可以了

到现在动态DDNS就已经做好了

### 获取并配置SSL证书

安装Cerbot：

```bash
sudo apt update
sudo apt install certbot python3-certbot-nginx
```

获取SSL证书：

由于我的域名是从阿里云买的，因此域名解析服务也是使用的阿里云，这里要添加两条主机记录`www.limuyuan.top`和`limuyuan.top`，记录类型为A，记录值填当前的网关公网地址 

```bash
sudo certbot --nginx -d nextcloud.limuyuan.top -d www.nextcloud.limuyuan.top
```

这里运行后按照提示输入电子邮件地址，并且同意服务条款。这里后面我的运行报错，排查原因是Nginx服务在尝试绑定到端口80时失败，因为80端口已经被我现在运行的nextcloud给占用，因此要先把这个服务停掉：

```bash
sudo systemctl stop nextcloud
```

查看80端口是否还有服务运行：

```bash
sudo lsof -i :80
```

然后使用：

```bash
sudo kill -9 <PID>
```

杀掉进程，如果一直杀不掉，直接杀掉`apache2`：

```bash
sudo systemctl stop apache2
```

### 配置Nginx(可选)

Apache和Nginx都是Web服务器，Apache更为成熟稳定，而Nginx的优势在于高性能和低资源消耗，在高并发场景下性能优越，处理静态内容时效率很高，因此在作网盘功能的时候，选用Nginx性能会更好，此外，Nginx的反向代理和负载均衡功能很强大，适用于分布式系统和微服务架构。以上是Nginx的优点，在这里选用Apache也够用，但是还是介绍一下Nginx，[技术蛋老师](https://space.bilibili.com/327247876)的这期视频也刚好讲到了这个问题：[Nginx实战 - 配置HTTPS | 数字证书和私钥 | Docker Compose容器](https://www.bilibili.com/video/BV1uH4y1w7je/)

⚠️ 如果要使用Nginx的话，建议直接卸载Apache2，这样就防止Apache2开机的时候抢占端口，导致出现一些奇怪的问题，而且手动关闭的话，有时候它会很快重新启动，这一点很烦，不如直接卸载了

⚠️ 还需要注意的一点是，我在配置Nginx的时候出现了一些未知问题，我在设备上挂载了一块机械硬盘，并且Nextcloud也是配置在这块机械硬盘中的，使用Nginx时会出现Nextcloud中文件读取不出来的问题，一直也没有解决，到最后我也使用的是Apache2的方案

> 卸载Apache2:
>
> 停止Apache2服务：
>
> ```bash
> sudo systemctl stop apache2
> ```
>
> 卸载：
>
> ```bash
> sudo apt-get purge apache2 apache2-utils apache2-bin apache2.2-common
> ```
>
> 删除Apache2配置文件和目录：
>
> ```bash
> sudo apt-get autoremove
> sudo apt-get autoclean
> sudo rm -rf /etc/apache2
> 
> ```

接下来先安装PHP-FPM：

```bash
sudo apt update
sudo apt install php8.1-fpm
```

启动PHP-FPM服务：

```bash
sudo systemctl start php8.1-fpm
sudo systemctl enable php8.1-fpm
```

使用下面的命令查看PHP-FPM服务状态：

```bash
sudo systemctl status php8.1-fpm
```

编辑配置文件，确保配置文件中有正确的监听地址：

```bash
sudo vim /etc/php/8.1/fpm/pool.d/www.conf
```

确保`listen`指令正确:

```php
listen = /var/run/php/php8.1-fpm.sock
```

确保 listen.owner 和 listen.group 设置正确：

```php
listen.owner = www-data
listen.group = www-data
```



安装Nginx：

```bash
sudo apt-get update
sudo apt-get install nginx
```

删除默认站点配置：

```bash
sudo rm /etc/nginx/sites-enabled/default
sudo rm /etc/nginx/sites-available/default
```

然后为Nextcloud设置配置文件：

```bash
sudo vim /etc/nginx/sites-available/nextcloud
```

添加配置文件信息：

```bash
server {
    listen 80;
    server_name nextcloud.limuyuan.top;

    root /var/www/nextcloud/;
    index index.php index.html index.htm;

    client_max_body_size 512M;
    fastcgi_buffers 64 4K;

    gzip off;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ ^/\.well-known/acme-challenge {
        allow all;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # 根据版本修改
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}
```

这里我们暂时只监听80端口，即只有HTTP生效，不需要证书

启用站点：

```bash
sudo ln -s /etc/nginx/sites-available/nextcloud /etc/nginx/sites-enabled/
sudo nginx -t
```

重启以应用新的配置：

```bash
sudo systemctl restart php8.1-fpm
sudo systemctl restart nginx
```

如果出现错误可以使用下面的命令打印日志进行调试：

```bash
sudo tail -f /var/log/nginx/error.log

sudo tail -f /var/log/php8.1-fpm.log
```

### 最后的nextcloud配置

禁用默认站点配置：

```bash
sudo a2dissite 000-default.conf
```

要接入公网，需要将IP地址改为域名，修改配置文件：

```bash
sudo vim /etc/apache2/sites-available/nextcloud.conf
```

将配置改成下面的这个：

```bash
<VirtualHost *:80>
   DocumentRoot /var/www/nextcloud/
   ServerName nextcloud.limuyuan.top
   ServerAlias 192.168.2.230

   <Directory /var/www/nextcloud/>
      Options +FollowSymlinks
      AllowOverride All

      <IfModule mod_dav.c>
         Dav off
      </IfModule>

      SetEnv HOME /var/www/nextcloud
      SetEnv HTTP_HOME /var/www/nextcloud

   </Directory>
   ErrorLog ${APACHE_LOG_DIR}/nextcloud_error.log
   CustomLog ${APACHE_LOG_DIR}/nextcloud_access.log combined
</VirtualHost>
```

启用Nextcloud站点配置并重启Apache2服务：

```bash
sudo a2ensite nextcloud.conf
sudo systemctl restart apache2
```

遇到HTTP不受信任，需要修改目录`/var/www/nextcloud/config/config.php`下的配置文件，将域名添加至`trusted_domains`，进入配置文件：

```bash
sudo vim /var/www/nextcloud/config/config.php
```

然后在文件中加上域名就可以

```bash
<?php
$CONFIG = array (
  'instanceid' => 'occ8qul20u5h',
  'passwordsalt' => 'your_passwordsalt',
  'secret' => 'your_secret',
  'trusted_domains' =>
  array (
    0 => '192.168.2.230',
    1 => 'nextcloud.limuyuan.top'
  ),
  'datadirectory' => '/mnt/my_hdd/nextcloud_storage',
  'dbtype' => 'mysql',
  'version' => '29.0.2.2',
  'overwrite.cli.url' => 'http://192.168.2.230',
  'dbname' => 'nextcloud',
  'dbhost' => 'localhost:3306',
  'dbport' => '',
  'dbtableprefix' => 'oc_',
  'mysql.utf8mb4' => true,
  'dbuser' => 'orangepi',
  'dbpassword' => 'your_password',
  'installed' => true,
);
```

最后别忘了重启一下Apache2服务：

```bash
sudo systemctl restart apache2
```

这样，我们的服务器就被部署到了公网上，通过域名就可以进行访问了！

![image-00060617235811588](https://mdstore.oss-cn-beijing.aliyuncs.com/markdown/image-00060617235811588.png)

## 访问的问题

现在我通过iPhone 4G网络在Chrome中进行测试，发现没有办法加载出Nextcloud Web服务，只能通过连接本地网络，然后访问域名访问，如果直接通过公网IP访问会显示默认的Apache2的界面，这说明我们的配置还有问题

## 服务器内部访问

### 手动更新

现在我的Transmission下载路径为`/mnt/my_hdd/transmission_downloads/`，并不能将文件同步到nextcloud中，首先我们需要查询nextcloud将文件数据储存到了哪个目录下：

```bash
sudo ls /mnt/my_hdd/nextcloud_storage/kihara/files
```

在这个目录下找到了存储的文件，注意这里需要使用`sudo`来访问，否则权限不够，然后我们同步到这个目录下即可：

```bash
sudo rsync -av /mnt/my_hdd/transmission_downloads/ /mnt/my_hdd/nextcloud_storage/kihara/files/transmission_downloads/
```

到这里还没完，需要给Web服务器用户`www-data`文件权限：

```bash
sudo chown -R www-data:www-data /mnt/my_hdd/nextcloud_storage/kihara/files/transmission_downloads/
```

最后让nextcloud识别新加入的文件，需要通过命令行更新文件索引：

```bash
sudo -u www-data php /var/www/nextcloud/occ files:scan kihara
```

最后跟的是你的nextcloud用户名

### 自动更新

创建符号连接：

```bash
ln -s /mnt/my_hdd/transmission_downloads/ /mnt/my_hdd/nextcloud_storage/kihara/files/transmission_downloads/
```

设置共享目录权限，让`www-data`能够访问：

```bash
sudo chown -R www-data:www-data  /mnt/my_hdd/transmission_downloads/ 
sudo chown -R www-data:www-data  /mnt/my_hdd/nextcloud_storage/kihara/files/transmission_downloads/
```

更新文件索引：

```bash
sudo -u www-data php /var/www/nextcloud/occ files:scan --path="kihara/files/transmission_downloads"
```

设置定时任务(cron job)定期扫描并更新文件索引

```bash
sudo crontab -e

0 * * * * sudo -u www-data php /var/www/nextcloud/occ files:scan --path="kihara/files/transmission_downloads"
```

这种方法实现了自动化，但是感觉还是差点意思，下面有更好的方法

进入Nextcloud的设置界面，我们可以看见它默认支持了WebDAV：

![image-00060622145513601](https://mdstore.oss-cn-beijing.aliyuncs.com/markdown/image-00060622145513601.png)

我们需要在命令行中安装一下`davfs2`，这是Linux下的WebDAV文件系统：

```bash
sudo apt-get install davfs2
```

创建一个挂载点：

```bash
sudo mkdir -p /mnt/nextcloud
```

修改`/etc/fstab`添加配置以自动挂载：

```bash
vim /etc/fstab

http://nextcloud.limuyuan.top/remote.php/dav/files/kihara /mnt/nextcloud davfs _netdev,uid=www-data,gid=www-data 0 0
```

然后挂载WebDAV：

```bash
sudo mount -a
```

随后会要求输入nextcloud的用户名和密码，完成后弹出警告也不用管

配置WebDAV认证信息，我们可以点击上面的网页访问，可以发现提示我们只能使用WebDAV进行访问

```bash
sudo vim /etc/davfs2/secrets

/mnt/nextcloud your-nextcloud-username your-nextcloud-password
```

更改Transmission的下载目录：

```bash
sudo systemctl stop transmission-daemon
sudo vim /etc/transmission-daemon/settings.json
```

这里必须先停止服务，否则更改保存以后看起来是更改了，实际上并不会被更改

```json
"download-dir": "/mnt/nextcloud/transmission_downloads/",
```

重启Transmission服务：

```bash
sudo systemctl restart transmission-daemon
```



## 配置公网ssh访问

现在如果我们需要远程使用服务器，就需要配置端口转发，首先登录路由器`192.168.2.1`，这个本地局域网的IP地址因人而异，在我的openwrt系统中，将入站的端口`666`转发到`192.168.2.230`的`666`端口

同时在防火墙中允许这个端口的访问：

```bash
sudo ufw allow 666/tcp
```



## 疑问进阶

下面是我作为一个网络和操作系统小白在这个过程中产生的问题：

1. 为什么要使用数据库？
2. 为什么使用了数据库就可以在不同系统上访问文件数据



## Archive 服务器部署

关于文章档案服务器的部署，我推荐采用下面两种方案：mdBook和MkDocs，配合GitHub Action可以很方便地搭建网站

mdBook的介绍参考：[https://rust-lang.github.io/mdBook/guide/reading.html](https://rust-lang.github.io/mdBook/guide/reading.html)

MkDocs能做的事比mdBook更多一些，包括Blog插件，这件事在mdBook上可能就会比较麻烦，因为不方便分类展示，mdBook的逻辑更接近于一本书，或者是一个分章节的大的Markdown文档，MkDocs更接近于一个文档展示网站，因此我更倾向于使用MkDocs

### 准备环境

安装一下依赖：

```bash
sudo apt -get update
sudo apt install curl
sudo apt install build-essential

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
sudo apt install python3-pip
pip install mkdocs
pip install mkdocs-material
```

我们在`~/.bashrc`中添加mkdocs命令的路径：

```bash
echo "export PATH=$PATH:~/.local/bin" >> ~/.bashrc
```

然后重新加载一下`bashrc`：

```bash
source ~/.bashrc
```

### 启动mkdocs服务

使用下面的命令在服务器中启动服务：

```bash
nohup mkdocs serve -a 0.0.0.0:8000 &
```

正常情况下，启动的服务只能在本机访问，因此我们需要添加参数`-a`，并且监听所有端口`0.0.0.0`，这样我们就能从别的机器上通过ip地址和端口来访问服务了，使用`nohup`可以在退出终端环境后程序仍然运行

构建mkdocs文档查看下面的两个链接：

- [mkdocs](https://www.mkdocs.org/getting-started/)
- [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/getting-started/)

### CLI程序

进入程序以后，可以通过命令名称(不是相对地址)加上参数进行一些操作
