我想用飞牛nas做对象存储,于是我开发了fnos-oss.fpk

一台 24 小时开着的飞牛 NAS,躺着几 TB 空闲硬盘,却没法给我的博客当图床用
这件事困扰了我挺久。
后来我干脆自己写了一个。

使用元宝生成的应用宣发图.png
使用元宝生成的应用宣发图.png

你当访问文章中的图片,就使用了 fnos-oss.fpk 服务

起因:存储就在那儿,却"够不着"

玩飞牛 fnOS 的人都知道,NAS 天生就是家里的​存储中心​:硬盘大、常开机、有 FN Connect 还能远程访问。但写博客时却很别扭:

  • 附件全塞在服务器的 usr/uploads 里,迁移一次 VPS 就要搬一次图;
  • 想上 CDN、想发预签名临时链接、想让别的自建服务共用一套图,全得靠"对象存储"这套语义,而不是 SMB/NFS 那种挂载盘;
  • 云厂商的 OSS 当然香,可我的照片和附件,凭什么要按月给别人的桶交钱?硬盘明明就插在我自己机器上。

社区里其实早有解法:装个 ​MinIO​、或者新一点的 ​RustFS​,都是 S3 兼容,能用。但我用下来总觉得差点意思——

它们是"它们都太面向企业",不是"面向个人的一个应用"。

数据目录要手动授权、端口要自己记、控制台是另一个 IP:端口、升级得先卸载再装、卸载了还得惦记着清容器。我想要的是应用中心点一下就装、桌面点图标就进控制台、改端口像改系统设置一样自然的那种体验。

于是就有了 ​fnos-oss.fpk​。

fnos-oss.fpk 运行界面截图
fnos-oss.fpk 运行界面截图

它到底是什么

一句话:一个能装进飞牛应用中心的单机 S3 兼容对象存储,打包成 .fpk。

几个我刻意做的取舍:

维度 我的选择 为什么
后端 单个 Go 二进制​ 无运行时依赖,不怕 NAS 上 Python/Node 版本打架,启动就是一瞬间
管理端 ​内嵌进二进制​,走飞牛统一网关 不额外占端口,桌面图标点开即在 fnOS 窗口内打开,像原生应用
S3 API ​独立 TCP 端口​(默认9100) 给 rclone / AWS CLI / boto3 / 图床这些"标准 S3 客户端"留正门
协议面 S3 Signature V4​ + path-style Header 签名、预签名 GET/PUT、分块上传都齐,主流 SDK 零改造直连
形态 ​单节点​,不搞分布式 NAS 就是一块盘的事,上纠删码/多节点纯属自我感动

换句话说:它不跟 MinIO 抢"企业级分布式"的活,它只把​"我家这块盘,变成一个标准 S3 端点"​这件事做到最省心。

打包这件事,比写代码还磨人

功能其实两天就跑通了,真正花时间的是 ​fpk 化​。

飞牛对原生二进制应用有个硬规矩:manifest 里的 platform 必须和实际架构对得上,写错了应用中心直接拒装。而飞牛用户的机器一半 x86、一半 ARM(所以需要双平台适配)。​
一个 fpk 塞进两种架构的二进制​,
安装包太大,且容易出错,所以我最后的方案很朴素
——​同一版本,打两个包​:

fnos-oss_1.0.10_x86.fpk   # x86_64 设备
fnos-oss_1.0.10_arm.fpk   # ARM64 设备

再按顺序把飞牛那套生命周期脚本补齐(cmd/main 启停、install_callback 初始化、config_callback 改端口热重启……),config/privilege 里声明好数据目录权限,wizard/install 里只问用户一件事:

S3 端口用哪个?(默认 9100,范围 1024–65535)

就这一个输入框。装完点桌面图标进管理端 → 建 Access Key → 建桶,齐活。以后想换端口,"应用设置"里改完保存,​服务自动重启​,不用 SSH 上去碰一行配置。

💡 踩过的坑:飞牛是按应用用户单独授权目录的。数据目录一定要先在「访问权限」里授权、再去「数据存放位置」里指向它,顺序反了就是一句冷冰冰的"数据目录不可写"。这个我替你踩平了,向导里已经是正确顺序。

让它真正干活的那一刻:Typecho 插件

对象存储立起来只是"能连",得有个每天都在用的场景才算活了。于是顺手写了 Typecho-fnos-oss​ 插件,适配个人用户。

  • 插件可以根据开发文档,自行开发

它的设计原则只有一条:不能因为我上了对象存储,就把退路堵死。

所以上传时的动作是——

附件进来 → 先落本地 usr/uploads(永远有这份)
          → 再复制一份进 fnos-oss 的 typecho 桶

本地那份是​回退副本​:哪天 NAS 关机了、插件关了、桶删了,文章里的图照样能开,​停用插件即自动回退到本地地址​,绝不给我留一堆裂图。

插件里就填五项:

配置项 示例
Endpoint http://192.168.1.10:9100
存储桶 typecho
Access Key / Secret Key 管理端「访问密钥」页创建
对象前缀 typecho(最终键:typecho/uploads/2026/11/1a2b3c.png)
访问方式 直链 / 预签名 / 代理

三种访问方式对应三种洁癖:

  • ​直链​(推荐):桶设 public-read,URL 就是 https://s3.example.com/typecho/uploads/...,配 CDN 一路起飞,性能最好;
  • ​预签名​:桶保持私有,URL 带 X-Amz-Signature,N 分钟内有效——发临时图、防外链盗刷很舒服;
  • ​代理​:URL 指向本站 proxy.php,由插件从私有桶读出来转发——图不想暴露 NAS 真实地址时用,代价是走一身 PHP。

还有一个我私心最爱的面板:​「历史附件迁移」​。保存配置、点一下"测试连接",展开面板点"开始迁移",过往几年堆在 usr/uploads 里的老图会被逐个搬进桶里,​本地原件不动​。等哪天真要换服务器,我 rsync 的是代码,不是几十 G 的图。

现在它在我这儿长什么样

博客(Typecho) ──插件双写──┐
   图床(PicGo/rclone) ───────┤
   备份脚本(OpenSync) ───────┤──▶ fnos-oss.fpk ─▶ 飞牛那几块盘
   临时分享(预签名) ──────────┘         │
                                    └── 管理端:桌面图标点开即用

一台机器,同时是相册、是影视库、是下载机,现在​还是我所有自建服务的 S3 底座​。没有月费,没有厂商绑定——哪天我不爽了,rclone 一条 sync 就能把桶整个搬走去别的 S3,业务代码一行不用改。这正是 S3 协议最迷人的地方:它把"存储"变成了可迁移的标准件。

写在最后

fnos-oss 不想成为下一个 MinIO。它只解决一个很小、但很真实的问题:

让一块插在飞牛里的硬盘,用起来像一朵只属于你的、按一下就装好的私有云。

  • 项目主页 / 下载:infowe.site/projects/11(x86 + ARM 双架构 .fpk,附 SHA256)
  • Typecho 插件:infowe.site/projects/12
  • 对接文档:标准 ​S3 SigV4 + path-style​,任何语言拿 AWS SDK 填 Endpoint/AK/SK 就能连,不用等我出插件。
fnos-oss.fpk 运行界面中 内置了开发文档
fnos-oss.fpk 运行界面中 内置了开发文档

欢迎来博客找我拍砖。要是你也有一块"躺着没事干"的盘,不妨让它干点对象存储的活 🌱

本文采用 CC BY-NC-SA 4.0 许可协议

评论 0

还没有评论,来抢沙发吧~

写下你的想法… 写评论 收起评论框
0 / 2000