记录牧安平台从 0 到 1 的开发过程，一个待业在家的网安老兵边做边想。

上一期聊了一个探针的数据库事故，这一期还是聊探针。

最近边做边想，探针的部署场景应该是什么样的，一定要绝对简单，最好是插电即用。那么就涉及到一个问题，要把探针的软件封装到一个硬件里面，才能实现插电即用。硬件不能太大，有些项目现场甚至于没有机房。机顶盒大小，也许刚刚好。旁路，勿扰🔕。

手头没有合适的硬件，但是有台NAS，于是乎，后面的事情就开始歪楼了。

家里那台 NAS（fnOS），派上了用场。兴许客户也有飞牛呢。不想看中间废话，就直接看后面的实现步骤。

把探针的程序装进飞牛里面，有两个方案：

飞牛应用中心，本质上就是个 Docker Compose 工程。官方给个 `fnpack` CLI，把你的工程目录压成一个 `.fpk`。

有个事一开始让我发懵：打出来的包，才 5KB。我第一反应是"是不是漏东西了"。后来才搞明白fpk 只是个配置壳，真正的镜像从远程仓库拉，不进包。所以体积小数 KB 是正常的，不是 bug。这后来排进了我的"假坑清单"，但当时确实愣了一下。

L3 探针有点特殊：它用 `scapy` 抓镜像流量，又在同一进程里跑 HTTP:8802 的 Web。这就意味着打包时有个绕不开的问题。

抓镜像流量得 network_mode: host 加 cap_add: [NET_ADMIN, NET_RAW]。bridge 模式收不到 L2 镜像帧，这功能就废了。所以一个 fpk 工程，核心不是别的，就是得把这几行写对。数据是 SQLite（`safety-net.db`），得持久化到 `/data`，不然容器一重建数据就没了。

所以第一个待办就是，我得搞一个远程镜像仓库。

fnpack1.2.x 的工程结构是定死的：

这部分没啥好讲的，官方有文档，照着拼就行。真正讲头在下面。

我把踩过的列一遍，挑几个印象深的：

最戏剧性的一坑，和早年栽过的如出一辙。

装完 8802 一直卡"初始化"，浏览器报 401。我第一反应是认证挂了。结果不是——根因是 `static/app.js` **第 750 行一个对象被提前 `};` 闭合**，整个 SPA 解析失败，401 只是假象。

这让我想起之前写过的：当年整 `app.js` 因为外层 `try` 缺 `catch`，整文件解析失败白屏。一模一样的味道——**一个括号的位置，就能让整个前端看起来"登录不上"**。先在容器里热修（`sed`）验证，再修主源、`build.sh` 重建镜像、`fnpack` 重打包、飞牛卸载重装，才算固化。

这里有个经验值得记：容器里热修只改了可写层，重建/重装会丢，必须回主源重建镜像固化。别贪快。

这些不是客气的"未来优化"，是实打实没跑通。一个探针能不能在项目现场稳稳待着，这些才是真问题——比"能打包"重要得多。不藏着：

1、确认飞牛架构：SSH 进 fnOS 跑 uname -m → x86_64 对应 platform=x86；aarch64 需另推 arm64 镜像（双架构）。

3、准备阿里云 ACR 仓库：现申请的，记下完整地址。

如 crpi-xxx.cn-beijing.personal.cr.aliyuncs.com/shepherd_l3

4、本机装工具：Docker Desktop（Windows）、下载git bush、下载 fnpack 1.2.3（windows-amd64，指你开发机不是目标设备）。

5、建目录树：manifest、app/docker、cmd/(9脚本) 、 config、app/ui、wizard、ICON.PNG、ICON_256.PNG。

6、写 manifest（INI）：appname=l3-platform、platform=x86、version、图标路径。

7、写docker-compose.yaml：单服务 shepherd-l3，network_mode: host + cap_add: [NET_ADMIN, NET_RAW]，卷 ${TRIM_PKGVAR}:/data，环境变量 PORT/PROBE_IFACE，镜像指向 ACR :0.6。

8、写Dockerfile：FROM python:3.9-slim，装libpcap0.8 tcpdump curl，pip 装cryptography+scapy，entrypoint 软链配置到 /data 并 export SAFETYNET_DB=/data/safety-net.db。

9、写4个严格JSON：严禁 # 注释，否则 fnpack 直接报 invalid character，config/resource、config/privilege、app/ui/config、wizard/install 。

10、写 9 个 cmd 脚本（main + install/upgrade/uninstall/config 各 init/callback）并 chmod +x —— fnpack 1.2.3 缺任何一个都报 Required file missing。

11、确认本机已拉取 python:3.9-slim（提示挂vpn手动拉取吧）。

12、跑 PLATFORMS=linux/amd64 TAG=0.6 L3_SRC="源码路径" bash build/build.sh → 推到 ACR(阿里云镜像仓库)。

13、登录 ACR 控制台确认镜像 :0.6 已存在。

14、跑 ./fnpack.exe build → 产出 l3-platform.fpk（约 5KB 正常，镜像不进包）。

15、应用中心 → 手动安装 → 上传 l3-platform.fpk。（有报错的话 就修）

16、向导：设管理员密码；流量网卡名

19、查看探针功行不行，host 抓包：Web「流量探针」选 enpXs0 + 上游做端口镜像(SPAN)，看能否收包（家庭路由常无 SPAN，功能可能用不上）。

20、持久化：/data（/vol1/@appstore/l3-platform/）里 SQLite+配置，看看卸载重装数据还在不在。

1、上传文件，（想玩的朋友，fpk文件找我要，后台私信“共建”）。

2、设置一个密码，默认admin123，进去再改

3、设置一个网卡名字，按图上抄，大部分都一样。

4、等待即可，记得这个时候飞牛得能联网。

5、安装完成，浏览器 http://ip:8802，或者在飞牛桌面直接点。再往后就是L3的操作部分了。

说一下L3安装完成后，需要知道几个事情：

本系列记录牧安平台从 0 到 1 的开发过程，一个待业在家的网安老兵边做边想。

AI开发牧安 ·第9期 探针跑着跑着，把磁盘吃满了

AI开发牧安 ·第10期 秀儿！把探针打包进一台NAS

探针的部署场景应该是什么样的，一定要绝对简单，最好是插电即用。那么就涉及到一个问题，要把探针的软件封装到一个硬件里面，才能实现插电即用。硬件不能太大，有些项目现场甚至于没有机房。机顶盒大小，也许刚刚好。旁路，勿扰🔕。

人工智能

运维

开发工具

牧安平台探针从0到1开发实战：基于飞牛NAS实现插电即用部署。详解fnpack打包全流程，避坑指南涵盖buildx兼容性、fnpack版本匹配、JSON注释陷阱等关键问题。提供完整实现步骤，从环境准备到镜像构建再到安装验证，助你快速上手L3探针部署。

数据库

Windows

容器

Docker

路由

SQLite

JSON

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

AI开发牧安 ·第10期秀儿！把探针打包进一台NAS

AI开发牧安 ·第10期秀儿！把探针打包进一台NAS

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

AI开发牧安 ·第10期 秀儿！把探针打包进一台NAS

AI开发牧安 ·第10期 秀儿！把探针打包进一台NAS

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

AI开发牧安 ·第10期秀儿！把探针打包进一台NAS

AI开发牧安 ·第10期秀儿！把探针打包进一台NAS