Skip to content
IceNoproblemPublic

About

飞牛开始页 · 飞牛 NAS 用户专属的浏览器主页:自动发现服务 + 融合飞牛监控

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

fnStart · 飞牛开始页

bilibili

一个飞牛 nas 用户专属的浏览器开始页。 打开浏览器,NAS 上跑的东西全在一屏:能点、能拖、能改,右边挂着飞牛监控那块面板。 粘个链接就能把视频下到 NAS,带农历节日的日历、天气、计时器也都在顶上。

fnStart 界面

↑ 界面展示

功能和亮点

打开浏览器,NAS 在干什么全在眼前。 不用翻收藏夹、不用记端口、不用在几个后台之间来回切。

服务自动发现

装上就有一屏,不用一个个手动加。

  • 读宿主机 /proc/net/tcp,把所有监听端口过一遍,再逐个探活、从页面标题认服务
  • host 网络的容器也认得出——这类容器没有端口映射,大多数工具直接漏掉,而 NAS 上大部分容器恰好都是这个模式
  • 端口反查回容器名:bridge 容器读 Docker API 的端口映射,host 容器顺着 socket inode 找到持有它的进程
  • 404、报错页、目录列表页会被过滤掉,不会给你堆一堆「Error」卡片
  • 图标运行时去各服务页面抓 favicon,抓不到就用名字首字母配个颜色

一屏掌控

  • 卡片能拖、能改、能分组,收藏书签单独一格,用虚线隔开
  • 分组可以自己建:新建、改名、删除、拖着标题调顺序。卡片右键能「移动到」或「复制到」别的组
  • 右键取代了悬停小按钮:编辑、新标签页打开、复制地址、移动到分组、删除,都在右键里;输入框里仍然是系统原生菜单(不然没法复制粘贴)
  • 顶部一条:天气、搜索(百度 / 必应 / 谷歌…)、时间日期,这四项的顺序可以在设置里调
  • 点天气看未来一周,点日期弹出带农历和节日的日历,点时间开计时器(到点有提示音,可以先试听)
  • 搜索框打字时卡片自己亮起来,告诉你命中几张;回车才是真去搜
  • 手机端是重新排过的,不是把桌面版等比缩小

自带监控面板

不用装第三方监控应用,数据全部自己采。

  • 六张卡:CPU、内存、存储、网络、温度、功耗。温度、风扇、盘温、功耗都来自硬件传感器
  • 每个容器的 CPU 和内存占用,按占用从高到低排,谁在吃资源一眼看到
  • 温度那条是 20~100℃ 的标尺,左蓝右红,60℃ 正好在中间
  • 功耗按部件拼算(CPU + 主板 + 硬盘),参数可以按自己的硬件调
  • 存储有几个卷就显示几条,换台机器自动适配
  • 三种形态:折叠成一条胶囊、并排在右侧、或者全屏——全屏时页面上只剩监控,卡片和顶栏都收起来
  • 全屏会多一块「媒体库」:扫一遍媒体目录,数出视频/图片/音频各多少、按目录分类、最近入库哪几个文件(学习资料和下载池不算在内)

粘链接就能下视频

顶栏「视频下载」按钮,把播放页或直链粘进去,剩下的交给 NAS 慢慢下。服务端用 yt-dlp + ffmpeg,不用你在本机装任何东西。

  • 主流站直接认:yt-dlp 内置 1700+ 站点的解析器,B 站、抖音、西瓜、爱奇艺、AcFun 这些直接粘链接就行
  • 野生播放页也能啃:识别不了的页面会去读 HTML,从 DPlayer / xgplayer / video.js / 原生 <video> / 内嵌 JSON 里挖出 m3u8、mp4 地址,还能顺着 iframe 递归找两层
  • 进度是真的:显示真实百分比、已写大小、速度和剩余时间;HLS 分片和 AES 加密流也能跟上,不会卡在 0%
  • 边下边看它在干嘛:解析、取流、下载、合并各阶段的日志实时刷出来
  • 存哪你说了算:默认落在数据目录的「下载」子目录,网页上能随时改 save 位置;想直接进媒体库就把那个子目录在 compose 里单独挂成可写
  • 能取消、能重试、能删:任务状态存在 downloads.json,重启容器不丢;最多两个任务并发,取消会连 ffmpeg 子进程一起收掉,不留半成品
  • 安全上有边界:所有要抓的地址都过 SSRF 校验,私网/环回/云元数据地址一律拦掉;播放页里解出来的直链和 iframe 也要再过一遍

这是类 Downie 的思路,但跑在 NAS 上、用浏览器操作,下完直接躺在你的媒体库目录里。

一些我在意的细节

  • 零依赖:没有前端框架、没有 npm install、没有构建步骤。node server.js 就跑起来了(下载引擎 yt-dlp / ffmpeg 是镜像里单独装的二进制,不算 npm 依赖)
  • 点阵数字是增量的:改一个数字只切几十个圆点的显示状态,不重建整棵 SVG——实测 500 次刷新省掉 7.4 万个 DOM 节点
  • 温度做了平滑:这颗 U 空闲 27℃、一个请求就窜到 50℃,硬显示会像传感器坏了,所以上升跟得快、下降拖得慢
  • 拿不到数据不清空面板:监控断连时保留上次的数字并变暗,而不是把整块换成一行错误字
  • 静态资源压完再发:brotli q9 + gzip 二选一,app.js 131KB → 37KB、style.css 61KB → 15KB。q9 不是 q11:q11 多花 126ms 只换回 2KB,而那 126ms 正好压在第一个访客的请求上
  • 长缓存只发给带哈希的地址:服务端把首页里的 /css /js 引用改写成 ?v=<内容哈希>,哈希对得上才给一年 immutable,对不上退回 no-cache。固定文件名配长缓存,用户会一直看到旧版本
  • 首页永远全量:no-store 且不响应条件请求。这页上有内网服务地址,省 0.2ms 不值得把「连磁盘都别写」降级
  • 监控采集不在请求路径上:后台每 5 秒自己刷一遍,接口只读内存,30~78ms → 0.77ms。面板每次刷新都干等一次传感器扫描,就是「点下去慢半拍」的来源
  • 一份 JSON 就是全部数据:data/ 拷走就等于搬家,也能 GET /api/export 导一份
  • 界面字号四档:小屏、远看、电视上都调得动
  • 想上公网有底子:访问令牌 + Docker socket 收进只读代理,不是「裸奔着就上线了」

装它

前提是能 SSH 进 NAS。飞牛里「设置 → 系统设置 → SSH」打开就行。

1 · 粘这一块

curl -fsSL https://raw.githubusercontent.com/IceNoproblem/fnstart/main/scripts/deploy.sh | sudo bash

它干四件事:下 compose 文件 → 生成访问令牌 → 拉现成镜像 → 起容器。不构建、不需要源码,一句就完事。

看到 ✓ 装好了 就成了。脚本会打印访问地址和访问令牌——令牌只显示这一次,马上抄进密码管理器。

国内拉不动 raw.githubusercontent.com(大概率):把 URL 前的 https:// 换成 https://ghfast.top/https://。即 curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/...。

想改代码、自己构建:git clone 下来跑 sudo bash scripts/install.sh,那条路会本地构建镜像(约 10 秒,需要拉得到 node:22-alpine)。

纯 docker compose 装法(不想 curl | bash 走这条)

下面这份就是完整的 docker-compose.yml,直接复制存成文件就能用。它只拉现成镜像、不构建,所以不需要源码、不需要 Dockerfile、也不需要 node:22-alpine。

services:
  docker-proxy:
    image: icenoproblem/fnstart:latest
    container_name: fnstart-docker-proxy
    restart: unless-stopped
    network_mode: host
    command: ["node", "docker-proxy.mjs"]
    environment:
      PROXY_LISTEN: 127.0.0.1:2375
      DOCKER_SOCK_INNER: /var/run/docker.sock
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    healthcheck:
      disable: true

  fnstart:
    image: icenoproblem/fnstart:latest
    container_name: fnstart
    restart: unless-stopped
    network_mode: host
    environment:
      PORT: 3721
      DATA_DIR: /data
      DOCKER_SOCK: http://127.0.0.1:2375
      PROBE_TIMEOUT: 2500
      ACCESS_TOKEN: ${ACCESS_TOKEN:-}
      TRUST_PROXY: "1"
    cap_drop: [ALL]
    cap_add: [SYS_PTRACE, DAC_OVERRIDE, DAC_READ_SEARCH]
    security_opt: [no-new-privileges:true]
    volumes:
      - ./data:/data
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro

使用步骤:

  1. 把上面这份存成 docker-compose.yml
  2. 在同目录建 .env,填访问令牌(纯内网可留空,要暴露公网必须设):
    printf 'ACCESS_TOKEN=%s\n' "$(openssl rand -hex 16)" > .env
  3. 启动:
    docker compose up -d

看到 docker compose ps 里两个容器都是 running 就成了。令牌在 .env,随时 grep ACCESS_TOKEN .env 查。

(不想自己存文件,也可以直接下载仓库里这份带注释的完整版:curl -fsSLO https://raw.githubusercontent.com/IceNoproblem/fnstart/main/docker-compose.yml,再建 .env 走上面第 2、3 步。)

几个要点:

  • 只拉镜像、不构建:这份 compose 里没有 build:,只有 image: icenoproblem/fnstart:latest。以前把 build: 写在这儿,镜像拉不到时 compose 会自动回退到本地构建,而只下了 yml 的机器没有 Dockerfile,就报 failed to read dockerfile —— 看起来像文件丢了,其实只是网络问题。所以构建单独放进了 docker-compose.build.yml 叠加层,只用这份 yml 的人永远不会踩这个坑。
  • 拉镜像要连 Docker Hub。国内直连多半超时(context deadline exceeded):给 daemon 配个镜像加速器(飞牛「Docker → 设置 → 镜像源」),或把上面下载 URL 换成 https://ghfast.top/https://raw.githubusercontent.com/...。
  • 多个存储卷(/vol2、/vol3…):compose 不写死卷,按机器实际存在的 /volN 建个 docker-compose.override.yml 只读挂进去,会自动合并。
  • 想改代码自己构建:git clone 后 docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build。
  • 每个参数为什么这么写、镜像源替换的完整写法:见 docs/compose-install.md。

2 · 打开

浏览器输入 http://你的NAS地址:3721,贴令牌,进去。

想设成首页:Chrome / Edge → 设置 → 启动时 → 打开特定网页。

3 · 监控面板不用装东西了

从 1.4 起,右边那块面板的数据是自己采的:读宿主机的 /proc 和 /sys,CPU、内存、温度、功耗、风扇、盘温、网络、每个容器的占用都是直读,不需要任何外部应用。

采不到的只有几样:硬盘 SMART 详细属性(重映射扇区、通电小时)、RAID 阵列卡状态、IPMI/BMC、GPU 利用率。想要这些,可以另外装 飞牛监控 fnMonitor(MisiteQ 写的第三方开源应用,MIT,仓库),装上后面板会自动改用它的数据;不装也不影响任何核心指标。

sudo bash /vol1/docker/fnstart/scripts/install-fnmonitor.sh

有几个存储卷就显示几个。安装脚本会自动探测宿主机的 /vol1…/vol8,存在哪些挂哪些,不用手动配。

装不上

卡在哪 怎么办
failed to read dockerfile / open Dockerfile: no such file or directory 你在用 --build,但目录里没有源码。默认那份 docker-compose.yml 只拉镜像、不构建,不会报这个错;一旦加上 --build 或 -f docker-compose.build.yml,build: . 里的 . 就要求「compose 文件所在目录」里有 Dockerfile。ls Dockerfile 确认;没有就 git clone 全量源码(别用 ZIP 解压后套了一层的目录),或者干脆去掉 --build 改走拉镜像
context deadline exceeded / 拉不到 node:22-alpine 连不上 Docker Hub。在 .env 里加一行 NODE_IMAGE=<你能访问的镜像源>/library/node:22-alpine,再 docker compose up -d --build
一行命令跑完卡在拉镜像 这台机器连不上 Docker Hub。给 daemon 配个镜像加速器(飞牛「Docker → 设置 → 镜像源」)再重跑同一条命令
页面打不开 docker logs fnstart --tail 20,看最后一行
卡在构建镜像 NAS 拉不到 node:22-alpine,先按上面换 NODE_IMAGE;还是不行就改用下面「其它装法 → docker run」(不构建镜像,也就不需要 Dockerfile)
忘了令牌 grep ACCESS_TOKEN /vol1/docker/fnstart/.env
右边读不到监控 看容器有没有挂到宿主 sysfs:docker exec fnstart ls /host/sys/class/hwmon,有输出就有数据
监控里没有温度/风扇/功耗 同上,说明 /sys 没挂。CPU、内存、网络、磁盘不受影响
卡片没有容器名 docker logs fnstart-docker-proxy,看它起来没有
想整体体检 docker exec fnstart node /app/scripts/selftest.mjs
其它装法 — 源码构建 / docker run / 不用 Docker / 飞牛图形界面

下面是几种进阶变体。纯 compose 拉镜像的标准装法见上面「纯 docker compose 装法」一节,这里不重复。

源码构建(要改了代码再跑,或者不想用我发的镜像)

git clone https://github.com/IceNoproblem/fnstart.git /vol1/docker/fnstart
cd /vol1/docker/fnstart
./scripts/new-token.sh --write
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

build: 不写在默认的 docker-compose.yml 里,而是放在 docker-compose.build.yml 这个叠加层。 所以只下载 yml 的人永远不会碰到「找不到 Dockerfile」——那份文件只拉镜像,不构建。 需要构建时多带一个 -f 就够。

docker run 两行流(没有 compose 插件,或构建不起来时用)

这条路不构建镜像、也不需要 Dockerfile:源码直接挂进去,容器只是那个 node 镜像。唯一要求是机器上有个 Node 22 镜像——node:22-alpine 拉不到的话,把下面两处镜像名换成你能访问的源。

先起 socket 代理,只有它挂 socket:

docker run -d --name fnstart-docker-proxy --network host --restart unless-stopped \
  -v /vol1/docker/fnstart:/app:ro \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -w /app -e PROXY_LISTEN=127.0.0.1:2375 \
  node:22-alpine node docker-proxy.mjs

再起主应用,不挂 socket:

docker run -d --name fnstart --network host --restart unless-stopped \
  --cap-drop=ALL \
  --cap-add=SYS_PTRACE --cap-add=DAC_OVERRIDE --cap-add=DAC_READ_SEARCH \
  --security-opt=no-new-privileges:true \
  -v /vol1/docker/fnstart:/app -v /vol1/docker/fnstart/data:/data \
  -v /proc:/host/proc:ro -v /sys:/host/sys:ro \
  -w /app -e PORT=3721 -e DATA_DIR=/data \
  -e DOCKER_SOCK=http://127.0.0.1:2375 \
  -e ACCESS_TOKEN=你的令牌 \
  node:22-alpine node server.js

不用 Docker(有 Node 22 就行)

git clone https://github.com/IceNoproblem/fnstart.git && cd fnstart
PORT=3721 DATA_DIR=./data node server.js

飞牛图形界面 — 项目路径填 /vol1/docker/fnstart。点「创建」之前,这个目录里必须已经有源码,镜像是从源码构建的:

# SSH 里先跑,目录已存在、里面已有 compose 文件也行,这一步只补源码
git clone --depth 1 https://github.com/IceNoproblem/fnstart.git /tmp/fnstart-src
cp -a /tmp/fnstart-src/. /vol1/docker/fnstart/
rm -rf /tmp/fnstart-src

顺序反过来(先建项目、只把 yml 贴进去)会报 open Dockerfile: no such file or directory——build: . 里的 . 只认 compose 文件所在目录,目录空着就没有 Dockerfile 可读。

怎么用

扫服务 — 顶栏「扫描服务」。第一次打开页面时也会自动跑一次,所以通常你什么都不用点。

导入书签 — 把浏览器导出的 bookmarks.html 拖进去,收藏夹链接归到下面「收藏书签」分组,跟服务卡用一条虚线隔开。

视频下载 — 顶栏「视频下载」,粘播放页地址或 m3u8/mp4 直链,点「加入下载」。任务卡片上能看到进度、速度和实时日志,下完点「打开文件」定位到成品。「保存位置」那一栏可以改成任意容器内可写的目录(比如单独挂出来的媒体库子目录),点「应用」后记住。取消、重试、删除都在卡片上。要下需要登录/Cookie/DRM 的站点,得自己换更专业的工具,这个通用解析器不碰鉴权。

改卡片 — 鼠标移上去右上角出现编辑/删除。名字、地址、图标、颜色、备注都能改,图标也能自己传。

拖排序 — 按住拖,实时让位,松手落位。分组之间也能拖。

搜索顺手找卡 — 搜索框打字,卡片名字/描述对得上就直接亮起来,下面告诉你命中几张。回车才是真去搜。

看右侧面板 — 六张卡(CPU / 内存 / 存储 / 网络 / 温度 / 功耗),下面接存储明细、容器占用和系统信息。几个细节:

  • 存储卡上是所有卷的平均占用,不是最满的那一个;想看每卷单独的数字,看下面的明细区
  • 容器按资源占用从高到低排、两列,每行带 CPU% 和内存。25 个容器也就十几行
  • 温度卡底下那条是 20~100℃ 的标尺,左蓝右红,60℃ 正好落在中间
  • 卡片右上角的词(平稳 / 宽裕 / 传输中 / 偏热…)是跟着数值走的,不是写死的

设置 — 右上角:标题、副标题、界面字号(四档)、背景(极光 / 纯色 / 图片)、每行列数、天气城市、时区,还有每张卡单独的开关(不想让家里人看到某些入口时有用)。「飞牛监控」那页底下还有三个功耗参数,见功耗是怎么算的。

手机端是重排过的,不是等比缩小:搜索独占一行,天气时间落第二行;卡片单列更紧凑;没有悬停所以编辑/删除直接常显;不能拖拽(手指一滑就得滚页面,两者必然打架),改成长按弹面板上移/下移/编辑/删除;输入框字号锁 16px,免得 iOS 一点就放大整页。

它是怎么扫出来的

这部分有点技术含量,简单说:

  1. 读宿主机 /proc/net/tcp,拿所有 LISTEN 端口——所以 host 网络的容器也能发现
  2. 每个端口先 TCP 探活,再发一次轻量 HTTP 请求,从 <title> 猜服务名;404/报错页会过滤掉,不给你生成 "Error" 卡片
  3. 认容器名:bridge 容器直接读 Docker API 的端口映射;host 容器没有映射,就反查——端口 → socket inode → 持有它的进程 → 属于哪个容器。这一步要容器能看见宿主机进程表:
cap_drop: [ALL]                        # 先全丢掉,再按需加回
cap_add:
  - SYS_PTRACE                         # 读 /proc/<pid>/fd 需要
  - DAC_OVERRIDE                       # /data 在宿主机用户名下时,建临时文件需要
  - DAC_READ_SEARCH                    # 同理,读宿主 proc 下的路径需要
security_opt: [no-new-privileges:true]
volumes:
  - /proc:/host/proc:ro                # 看见宿主机的进程

SYS_PTRACE 听着吓人,它只用来"读进程开了哪些 socket",没有写操作、不 attach、不注入。不给也能跑,只是 host 容器认不出名字,卡片退回用网页标题命名。

  1. 图标是运行时去各服务页面抓 favicon,存到 data/icons/;抓不到就用名字首字母配个颜色,所以离线也能看。

配置项

全是环境变量,改 .env 或 docker-compose.yml。

变量 默认 说明
PORT 3721 监听端口
DATA_DIR /data 数据目录(卡片、图标、背景、快照);下载默认落在它下面的「下载」子目录
DOWNLOAD_DIR <DATA_DIR>/下载 视频下载保存目录。改成其它路径时要在 compose 里把宿主目录挂进来并给写权限
DOWNLOAD_MAX_CONCURRENT 2 同时跑几个下载任务
YTDLP_PATH yt-dlp yt-dlp 二进制路径,镜像里已装好,裸机部署才可能需要改
FFMPEG_PATH ffmpeg ffmpeg 二进制路径,同上
MEDIA_ROOT 自动 媒体库根目录,给「全屏媒体库」统计用;留空自动探测(容器内 /host/vol1)
MONITOR_URL 空 监控地址。留空 = 自动用「访问本页的主机名:8777」,换 IP 不用改
MONITOR_PORT 8777 上面那个自动地址用的端口
WEATHER_CITY 北京 天气默认城市,页面上也能改
PUBLIC_HOST 空 强制卡片地址用这个主机名(反代/域名场景)
DOCKER_SOCK http://127.0.0.1:2375 走 socket 代理。改成 /var/run/docker.sock 就是直连(不建议,见下文)
PROC_ROOT 自动 宿主机 procfs 挂载点,默认探测 /host/proc
PROBE_TIMEOUT 2500 单端口探测超时(毫秒),服务多可调 3000
PROBE_PORTS 空 额外扫的端口,逗号分隔(拿不到 /proc 时兜底)
ACCESS_TOKEN 空 访问令牌。留空 = 不校验;要暴露到公网就必须设。用 ./scripts/new-token.sh --write 生成,写 .env
BLOCK_PRIVATE_FETCH 跟随令牌 禁止服务端抓内网图标(防 SSRF)。设了令牌会自动开,纯内网想关就显式设 0。注意:自动扫描自己发现的服务不受这条限制
POWER_BASE_W 8 功耗估算里的主板基础开销(主板 + 网卡 + 风扇)。一般不用改这个,去设置里调
POWER_DISK_W 8 功耗估算里的单块硬盘功耗。同上,设置里有对应的输入框

数据全在 DATA_DIR:data.json(卡片与设置)、icons/、backgrounds/、last-monitor.json / last-weather.json(网络抖一下时的兜底快照)。备份这个目录就等于备份了整个站,或者 GET /api/export 导一份 JSON。

接口想接自动化?都在 server.js 的 handleApi 里,一眼能看完,我没单独写文档。

功耗是怎么算的

面板上那个功耗数字不是电表读数,是按部件拼出来的:

整机功耗 = CPU + 主板基础 + 硬盘数 × 单盘

CPU 那部分有两条路,在设置 → 飞牛监控里选:

CPU 最大功耗 填什么 怎么算 适合谁
留 0(默认) RAPL 实测——CPU 自己报的封装能耗 + 内存 想贴近真实
填 TDP(比如 91) TDP × CPU 占用率 想数字稳定、能手算核对

剩下两项同理可改:主板基础功耗(默认 8W,给主板、网卡、风扇留的)、单块硬盘(默认 8W,机械盘;全闪可以调到 4~5)。改完下一轮刷新就生效。

为什么填了 TDP 反而可能更不准? 因为「TDP × 占用率」是线性假设。实际上 CPU 在不同频率、不同核心数下效率差很多——50% 的占用往往只花 30% 的功耗,不是一半。所以默认用 RAPL。

和飞牛监控的数字对不上? 正常。它也是这么估的(RAPL 打底 + 经验值补),但两边采样时刻不同、温度测点不同、基础功耗取值也不一样,差个 5~10W 属于正常范围,不是谁算错了。

要上公网?先看完这节

我不建议你把 3721 直接怼到公网。这不是吓唬人。

令牌

一、怎么生成。 一条命令,写进 .env(权限 600,.gitignore 挡住了不会进仓库):

./scripts/new-token.sh --write
docker compose up -d

生成完立刻抄进密码管理器。我也没做「首次启动自动生成」——隐式生成的密码最容易丢,躺在日志或容器环境变量里,换台机器就找不回来。

二、它不会变。 令牌是你自己设的死值,程序不会自动生成也不会自动换。会过期的是登录 cookie(7 天),不是令牌。 cookie 还是滑动续期:每次打开主页就把 7 天重新算起,天天用就永远不会掉;真闲置超过 7 天才需要重登,而重登也只是把同一串再贴一次。

手机上懒得手打那一长串,用一次性链接 http://你的地址:3721/?token=那串令牌,打开后立刻换发 cookie 并跳回干净地址。但链接本身带着令牌,会留在浏览器历史、聊天记录、反代日志里,只在自己的设备之间传。

三、忘了怎么办。 没后门、没有找回邮件,但它就写在 .env 里:

grep ACCESS_TOKEN .env

.env 也丢了就从容器读(这是它唯一还会留下的地方):docker inspect fnstart --format '{{range .Config.Env}}{{println .}}{{end}}' | grep ACCESS_TOKEN。两处都没有就换一把新的,卡片数据在 data/ 里,跟令牌无关。

顺带说一句:启动日志只报「已开启(令牌 N 位)」,永远不打印令牌本身。因为 docker logs 是很多人会随手贴到群里求助的东西。

四、怎么把设备踢下线。 没有单独吊销功能。手机丢了就换一把令牌——重建容器后所有已登录设备的 cookie 立刻失效,包括你自己的。一个令牌一个开关,就这个思路。

要让家里人用,别把令牌给他们(那等于管理员权限,能删你的卡、导你的备份)。把认证放到反代层:Caddy 的 basic_auth、Nginx 的 auth_basic、或者雷池 WAF 的「身份认证」,每个账号由那一层管,fnStart 的令牌只属于你自己。

Docker socket 我收进了只读代理

要把端口反查成容器名,就得读 Docker API。但直接挂 /var/run/docker.sock 有个坑::ro 不等于只读——我在容器里实测过,POST /containers/create 照样打到 API。也就是说主进程一旦被攻破,攻击者就拿得到宿主机 root。

所以现在是两个容器:

fnstart               ← 主应用,完全不挂 socket
fnstart-docker-proxy  ← 只有它挂 socket,只放行三个 GET,其余一律 403
                        绑 127.0.0.1:2375,局域网和公网都碰不到

放行的只有 /version、/containers/json、/containers/<id>/json,正好是它需要的全部。实测 POST /containers/create → 405,/secrets、/images/json、/containers/x/export → 403。于是「被攻破」的后果从宿主机 root 降到只能读容器列表。

想退回单容器(省 10MB 内存),把 DOCKER_SOCK 改回 /var/run/docker.sock 并把 socket 挂回来。不建议。

再套一层 HTTPS

令牌走明文 HTTP 等于没设。Caddy 两条就够:

start.example.com {
  basic_auth {
    you <用 caddy hash-password 生成的 bcrypt 串>
  }
  reverse_proxy 127.0.0.1:3721
}
Nginx 版本
location / {
  auth_basic "fnStart";
  auth_basic_user_file /etc/nginx/.htpasswd;
  proxy_pass http://127.0.0.1:3721;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  # 监控面板要转 WebSocket
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
  proxy_read_timeout 300s;
}

服务端替你去抓图标,这事得管住

卡片可以填任意网址、让服务端去抓 favicon。端口一旦暴露,这个接口就成了「让别人用我的服务器探测我内网」的跳板——而且抓到的内容会存成文件,再通过 /icons/ 读回来,等于能把内网服务的响应读出来。

最早的做法是拿正则在主机名上找 127.、192.168. 这类前缀。这个思路本身是错的:127-0-0-1.sslip.io 解析出来就是 127.0.0.1,可字符串里连个 127 都看不出来,正则必然漏。

现在判断落在解析出来的 IP 上,而且:

  • 校验放在 DNS 的 lookup 里 —— 判定用的 IP 和真正要连的 IP 是同一个,没有 DNS 重绑定的时间窗;
  • 每一次 302 跳转都重新判,不是只查第一跳;
  • 守卫模式下禁用连接池。这条是实测踩出来的:Node 19+ 默认 keepAlive,池里留着一条连过的 socket 时,下一次请求直接复用、根本不走 DNS,守卫形同虚设。先裸跑连一次,再开守卫,照样返回 200。

顺带把图标类型也收紧了:只接受真正的图片(content-type 或文件头魔数任一能认出),返回 HTML 的地址不再被存成「图标」。

登录失败按 IP 算,不是全局

原来是一个模块级计数器,全世界共用一个数。任何人连错几次,接下来所有人登录都要被拖慢到 5 秒——既能把你自己锁在门外,又拦不住换 IP 接着试。

现在按来源 IP 记:阈值以内只让这个 IP 逐渐变慢(300ms → 1.2s),到 8 次就回 429 + Retry-After,别的 IP 完全不受影响。锁定期内输对了照样放行——锁是防猜的,猜对了本来就没有拦的理由。

转发头默认不认。X-Forwarded-For 谁都能写,默认信任等于把限速作废。只有确认前面挂了反代、并且直连方确实是本机/可信网段时,才看 X-Real-IP 或 XFF 的最后一个(那才是紧邻反代看到的地址;取第一个等于让攻击者自己指定 IP):

environment:
  TRUST_PROXY: "1"          # 前面有反代才开
  # TRUST_PROXY_CIDRS: "172.18.0.0/16"   # 反代不在本机时填

反代在同一台机器上时,还可以顺手把应用收窄到只听本机,局域网里别人就没法绕过反代的 WAF 和限速直连:

environment:
  HOST: "127.0.0.1"

(收窄之后记得把反代的上游也改成 127.0.0.1:3721,不然会连不上。)

说句实在话:能不暴露就别暴露

Tailscale / WireGuard 组网之后,出门直接开 http://100.x.x.x:3721,端口根本不出公网——上面所有问题一次性消失,还自带加密和身份认证。代价只是每台设备装个客户端。我现在就是这么用的。

权限:能力砍到只剩三项

容器仍然以 root 运行——这条是架构性的,读宿主 /proc/<pid>/fd(把端口反查到进程)要权限,非 root 会让「自动发现 host 网络容器」直接退化,而那是这个项目的核心功能。

但拿到 root 不等于拿到一切。现在先 cap_drop: ALL,再只加回真正需要的三项:

能力 为什么要
SYS_PTRACE 读 /proc/<pid>/fd,把端口反查回容器名
DAC_OVERRIDE /data 挂在宿主机用户名下、755,缺它建不了临时文件,原子写会失败
DAC_READ_SEARCH 同上,读宿主机 proc 下的路径

NET_ADMIN、SYS_ADMIN、MKNOD、NET_RAW、SETUID 这些一律没有,另外加了 no-new-privileges,进程不能再靠 setuid 把权限拿回来。实测收敛后功能零退化:温度/功耗照读、容器列表 25/25、自动发现仍能认出 10 个容器名。

要说还剩下的风险:host 网络 + 只读 proc/sys 这套组合,是为了「不装任何东西就能看见宿主机上的服务」。真被拿下的话,攻击者看得到宿主机全部进程——所以我更建议直接用 Tailscale,不要把它挂到公网。

常见问题

fnMonitor 现在还要不要装?

不要也能用。1.4 起面板数据是自己采的(读 /proc 和 /sys),核心指标一个不缺。它只补三样我确实采不到的:硬盘 SMART 详细属性、RAID 阵列卡、IPMI/BMC。

为什么从来没把它写进 compose:它不是容器型应用,是个宿主机监控代理,工作就是摸硬件——smartctl 读 SMART、sensors 读温度、ipmitool 读 BMC,还要读 /sys/class/hwmon、/proc/*、/dev/sd*,甚至 /dev/port(直接读 I/O 端口,兼容 NEC/联想商用机那种走私有 EC 邮箱的风扇)。要塞进容器就得 privileged: true、挂一堆 /sys /dev /proc /vol1/@appcenter,再装齐那堆工具——等于把整台 NAS 交给一个容器,比装 FPK 危险得多,还会丢掉应用中心的升级管理。

所以分工是:fnMonitor 用它自己的方式装,fnStart 用容器跑,两边只通过 :8777/api/overview 说话。谁升级都不影响谁。

右边一直是"读不到监控数据"? 第 3 步没做,或者 8777 不通。curl http://你的NAS:8777/api/overview 试一下。用反代/HTTPS 的话把 MONITOR_URL 写死。

只扫出来一半服务? 先看端口数对不对——大概率是 host 容器没认领到名字(不是没发现),加 SYS_PTRACE 和 /proc 挂载即可。另外 PROBE_TIMEOUT 太小会漏掉慢服务,调到 3000 试试。

卡片地址变成了 127.0.0.1? 说明你是从 NAS 本机用 127.0.0.1 打开的。程序会自动换成局域网 IP,但多网卡时可能挑错,这种时候设 PUBLIC_HOST=192.168.x.x。

天气显示 --? 天气走 wttr.in,需要外网。墙内偶尔抽风,失败会退回上次成功的快照,一般只短暂显示旧数据。

视频下载失败或一直 0%? 先看任务日志里卡在哪一步。主流站失败多半是站点改了解析规则,等 yt-dlp 更新即可;野生播放页可以点「重试」让它重新挖直链。需要登录、Cookie 或 DRM 的站点这个通用解析器不处理。进度显示 0% 但文件在涨,通常是 AES 加密的 HLS 流,等探测完总时长就会跟上。保存位置必须是容器内可写且已挂进来的目录,写不进去会直接报错。

改了代码为什么没生效? 看你是怎么装的:compose 装的话 /app 里的文件是构建进镜像的,docker restart 只重启进程、不换代码,改完源码必须 docker compose up -d --build,判断方法是 docker exec fnstart grep 新函数名 /app/lib/xxx.js,搜不到就是没重建(这个坑我自己踩过)。如果是 docker run 装的(安装脚本构建失败时会自动退回这条路),源码是挂进去的,docker restart fnstart 就生效。

改了设置为什么不生效? 设置在 data/data.json 里,本来就存着。如果你是直接改这个文件,需要重启容器——进程里有一份缓存。

会往外发我的数据吗? 没有统计、没有遥测、没有回连。对外请求只有两类:天气(wttr.in,只发城市名)和你主动提交的下载链接(由 yt-dlp 去访问对应站点取流)。不点下载就完全不会有第二类。访问令牌只在本机校验,不会往外发。

用了谁的东西

飞牛监控 fnMonitor — 右边那块面板的视觉语言参考了它(深色底、点阵数字、细计量条)。1.4 起数据改为自己采,它变成可选增强。作者 Misite齊(@MisiteQ),MIT 许可,仓库 https://github.com/MisiteQ/fnmonitor。纯 Python 标准库 + 单文件前端,零依赖,数据只留在本机 SQLite,确实下了功夫,推荐去点个 star。

需要说明的是:本仓库不包含 fnMonitor 的任何代码或样式表,我们只是消费者,通过 HTTP 读它的 /api/overview。早期原型为了对照效果引用过它的 CSS,开源前已整份删除,重写成 public/css/fn-theme.css(约 4KB,全是我自己写的规则),点阵字模也是自己写的 5×7 位图表。本项目与 fnMonitor 作者、与飞牛官方都没有隶属或背书关系。

飞牛 fnOS — 运行平台。依赖它提供的 /proc/net/tcp、Docker,以及应用中心装出来的 fnMonitor。与飞牛官方无隶属关系。

wttr.in — 天气数据,免费免密钥。https://wttr.in/。早期用 open-meteo,但它在容器网络下经常超时,换成 wttr.in 后稳定了。

yt-dlp — 视频下载的站点解析引擎,1700+ 站点,Unlicense 许可。https://github.com/yt-dlp/yt-dlp。

ffmpeg — HLS 解密、音视频合并、封装,LGPL/GPL 许可,由 Alpine 社区源提供。https://ffmpeg.org/

Node.js — 运行时,MIT。

图标 — 界面上所有 SVG(搜索、编辑、扫描、全屏…)都是我手写的 path;卡片图标是运行时从各服务页面抓的 favicon,版权归各服务方。

没用到的 — React / Vue / Tailwind / 任何 npm 包。package.json 的 dependencies 是空的,你 npm install 会得到 "up to date" 然后无事发生。

许可

MIT © 2026 IceNoproblem

随便用、随便改、随便商用,出事了别找我(MIT 的原话比这长一点,意思一样)。

最后

这是个自己用着顺手、顺手做完整的小工具。如果你也是飞牛用户,希望它能让你每天少点几下鼠标。

有问题、有想法、发现它在你机器上认不出某些服务,欢迎开 issue 把端口和现象贴上来——尤其是扫描漏掉的服务,给我端口号和那个页面的 curl -I 结果,基本能定位。

About

飞牛开始页 · 飞牛 NAS 用户专属的浏览器主页:自动发现服务 + 融合飞牛监控

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages