超实用,不踩坑! Nano Pi R4S安装Openwrt教程#

安装配套散热风扇 (可选)#

买的就是这种PWM控制的散热风扇，不占用USB接口，风扇安装教程，据说还不支持温控。

构建需要安装的镜像#

1. 打开NanoPi R4S 构建 immortalwrt 镜像网站，选择 R4S，版本选择 24.10.6

   24.10.6这个版本是最后一个能支持opkg安装软件包的版本，后续的版本就迁移使用apk安装包，不再支持opkg安装软件包了，为了良好的兼容性，建议还是使用有opkg安装包的版本(24.10.6也支持使用apk安装)。

2. 在预安装软件包后面添加一个主题luci-theme-argon，点击请求构建
3. 下载镜像，选择 SYSUPGRADE (EXT4) 格式的，方便后续/overlay的扩容

   如果选择 SYSUPGRADE (SQUASHFS)，默认的/overlay分区只有300MB，安装大量软件包后会经常不够用。

4. 使用rpi-imager或者win32diskimager将镜像写入TF卡，写入完成后将TF卡继续插在电脑上，准备进行overlay分区扩容。

overlay分区扩容#

这里使用gparted工具进行分区扩容，gparted是一个开源的分区管理工具，支持Linux、Windows和MacOS系统。

1
sudo gparted

调整了根目录的空间后，剩余的分给了/overlay分区，就足足差不多有32GB的空间了

开机打开web管理界面#

开机后，有线连接NanoPi R4S和电脑，打开192.168.1.1的web管理界面，默认用户名密码为root/空密码

如果你出现502无法访问web界面的问题，但是能curl访问192.168.1.1，关闭梯子软件或者手动设置系统的梯子代理即可

进来就可以看到熟系的界面了

设置风扇开启自转脚本#

在系统-启动项-本地启动脚本中添加一下内容，保存即可

1
# NanoPi R4S fan fixed speed (90%)
2

3
PWM=/sys/class/pwm/pwmchip1
4

5
[ -d "$PWM/pwm0" ] || echo 0 > "$PWM/export"
6

7
sleep 1
8

9
echo 0 > "$PWM/pwm0/enable"
10
echo 50000 > "$PWM/pwm0/period"
11
echo 45000 > "$PWM/pwm0/duty_cycle"
12
echo 1 > "$PWM/pwm0/enable"

安装openclash#

1. 现在自己电脑上打开https://github.com/vernesong/OpenClash/releases，下载最新版的ipk
2. 使用scp指令将ipk文件传到NanoPi R4S的/tmp目录下，scp指令如下：

   1
   scp luci-app-openclash_0.47.133_all.ipk root@192.168.1.1:/tmp
   

3. ssh登录NanoPi R4S，执行以下命令安装ipk包：

   1
   opkg install /tmp/luci-app-openclash_0.47.133_all.ipk
   

4. 安装完成后，退出openwrt web管理界面重新登录一下，就可以在服务-OpenClash中看到OpenClash的设置界面了，刚开始会提示安装clash内核，安装即可。

在插件设置-外部控制中，可以修改clash的web管理界面(如zashborad)的密码，保存设置，然后应用设置

配置filebrowser#

在openwrt上安装部署filebrowser也超简单，在软件包中安装filebrowser后，退出重登openwrt就可以在服务中看到filebrowser了。

在这里我仿照《绝区零》的风格编写了一套美化的css，在全局设置-品牌信息文件夹路径添加上文件夹路径，配置好后好看多了。

开源链接：https://github.com/riyuexingchennnn/filebrowser-zzz-style

硬件与系统#

• 硬件：NanoPi R4S（4GB 内存版，RK3399，aarch64）
• 系统：ImmortalWrt 24.10.6 (r33869)
• 根分区：29.3GB（overlay 扩容后，安装大量软件包也不慌）
• 存储：2TB USB SSD（/mnt/nas，做 NAS 和个人网盘）

登录后就是这个熟悉的界面了，可以看到系统状态、CPU 负载、内存占用等实时信息。

目前安装的常用软件包#

笔者目前的装机清单（按用途分类）：

• 主题美化：luci-theme-argon + luci-app-argon-config（Argon 主题设置）
• 容器：luci-app-docker + luci-app-dockerman（Docker 管理面板）
• 网盘：luci-app-openlist（OpenList 网盘聚合）
• 文件管理：luci-app-filebrowser-go（FileBrowser）
• 内网穿透：luci-app-frpc、luci-app-ddns-go（DDNS）、luci-app-easytier（EasyTier 组网）、luci-app-tailscale-community（Tailscale）
• 代理：luci-app-openclash
• NAS：luci-app-samba4（SMB 共享）
• 监控：luci-app-netdata、luci-app-statistics
• 网络优化：luci-app-sqm（智能队列管理）
• 工具：luci-app-ttyd（网页终端）、luci-app-cpufreq（CPU 调频）、adguardhome（DNS 广告过滤）

小技巧：如果软件包列表更新慢，可以在”系统-软件包”里先点”更新列表”，再搜索安装，速度会快很多。

部署一个容器（以 Vaultwarden 为例）#

1
docker run -d \
2
  --name vaultwarden \
3
  --restart unless-stopped \
4
  -p 18080:80 \
5
  -v /mnt/nas/docker/vaultwarden:/data \
6
  vaultwarden/server:latest

注意：数据目录记得放到 NAS 盘（/mnt/nas）上，这样重刷系统不丢数据。另外容器数据目录的权限要给对（chown 1000:1000），不然容器会报 “unable to open database file”。

风扇固定转速#

在”系统-启动项-本地启动脚本”中保留风扇脚本，开机自动调速：

1
# NanoPi R4S fan fixed speed (90%)
2
PWM=/sys/class/pwm/pwmchip1
3
[ -d "$PWM/pwm0" ] || echo 0 > "$PWM/export"
4
sleep 1
5
echo 0 > "$PWM/pwm0/enable"
6
echo 50000 > "$PWM/pwm0/period"
7
echo 45000 > "$PWM/pwm0/duty_cycle"
8
echo 1 > "$PWM/pwm0/enable"

开机自动启动所有 Docker 容器#

虽然容器都设置了 --restart unless-stopped，但为了保险，笔者在 rc.local 里加了一段”遍历启动所有容器”的脚本，双保险：

1
# Auto-start all Docker containers on boot
2
if command -v docker >/dev/null 2>&1; then
3
    # Wait for the Docker daemon to become ready (max 30s)
4
    i=0
5
    while [ $i -lt 30 ]; do
6
        docker info >/dev/null 2>&1 && break
7
        sleep 1
8
        i=$((i+1))
9
    done
10
    # Start every stopped container
11
    for cid in $(docker ps -aq); do
12
        state=$(docker inspect -f '{{.State.Running}}' "$cid" 2>/dev/null)
13
        if [ "$state" = "false" ]; then
14
            docker start "$cid" >/dev/null 2>&1
15
        fi
16
    done
17
fi

为什么要加这段？因为 Docker 守护进程启动比 rc.local 慢，直接执行 docker 命令可能失败，所以先循环等待 daemon 就绪，再遍历启动所有容器。实测软路由断电重启后，6 个容器全部自动拉起，非常稳。

服务列表一览#

在”服务”菜单里可以看到所有已安装的服务，OpenClash、DDNS、EasyTier、FileBrowser、FRPC、Tailscale 等都集中在这里管理，非常方便。

小提示：Tailscale 和 EasyTier 都是组网工具，功能有重叠，如果只用其中一个，可以把另一个停掉，省一点内存。