视频加载失败

[开源] Fonu - 专为 fnOS 准备的轻量 DDNS + HTTPS 证书 + 反向代理工具

3912 字
20 分钟
[开源] Fonu - 专为 fnOS 准备的轻量 DDNS + HTTPS 证书 + 反向代理工具
[开源] Fonu - 专为 fnOS 准备的轻量 DDNS + HTTPS 证书 + 反向代理工具

最近一直在折腾飞牛 fnOS 的公网访问。平时真正用得比较多的,其实就几件事:DDNS、HTTPS 证书、反向代理;没有公网 IP 时还得加一层 内网穿透。服务挂出去之后,我还想在首页看见谁在访问、拦了多少、从哪些国家来。

社区里已有 Lucky 等成熟方案,功能非常强。但对我自己来说,长期打开的也就这几项,很多高级能力基本用不到,整体略重。所以干脆写了一个更轻量的:Fonu——面向 fnOS 公网访问,把「域名 → DDNS → 证书 → 反代 → 内网服务」这条链路尽量做简单;没有公网 IP 时还能接上 FRP 把本地 Nginx 网关穿透出去。环境变量、端口,以及从 Docker 迁到 FPK 的细节,见仓库 README(文末链接)。

Fonu 是做什么的#

Fonu 不是「大而全」的网络工具,而是把 NAS 公网访问最常用的几块收进一个 Web 后台:

  • DDNS:IPv4 / IPv6 分开开关。一条任务可以挂多个根域名,同步时把当前公网 IP 写进对应解析。服务商有 Cloudflare、DNSPod、阿里云、腾讯云、火山引擎、华为云。
  • HTTPS 证书:ACME 自动申请和续签(Let’s Encrypt、ZeroSSL),多域名和通配符。DNS-01 跟 DDNS 用同一套服务商,按最长后缀匹配根域。每张证书可以映射到本机目录,或经 SSH 上传,内容变化后可以执行重载命令。快到期会在列表和仪表盘上标出来。
  • 反向代理:HTTP / HTTPS、WebSocket。可以扫描内网里已经开着的 HTTP 服务,填上名称和域名后加进当前入口。默认把客户端的 Host、Origin、Referer 转给上游。每条规则有流量、连接数和访问日志,也能看带中文注释的 Nginx 配置。
  • 访问统计:反代访问写入 SQLite。首页按今天、近 7 天、30 天或全部,看请求、独立 IP、拦截、疑似扫描,以及全球 / 国内地图和来源国家。再往下是相对昨天的 5xx、4xx、耗时和慢请求。统计的是 Fonu Nginx 上的域名流量,不含管理后台。
  • 内网穿透:内置 frpc(v0.71.x)。Web 网关把本地 Nginx 同步到 VPS 上的 frps;TCP/UDP 端口隧道可以单独开关。连接设置可以先保存,不必马上启动。
  • 访问保护:按规则配置大陆 IP 限制(内网段默认放行)、黑白名单、Basic Auth、限流、连接数和安全响应头。
  • 日志:系统日志、访问日志(可按拦截筛选,来源 IP 带归属地)、Nginx 错误,以及 FRP 输出。

有公网 IP 时:

域名 → DDNS → HTTPS 证书 → 反向代理 → fnOS / MoviePilot / Jellyfin / 青龙 / …

没有公网 IP 时,可在 Fonu 里接上 FRP:

外部用户 → frps(VPS)→ frpc → Fonu Nginx → 内网服务

和 PicHost 一样,都是我自己在 NAS 上长期跑着、顺手开源出来的小工具;Fonu 管公网入口,PicHost 管博客配图。


为什么又写一个反代工具#

估计很多人第一反应是:Lucky 已经很成熟了,为什么还要写?

原因很直白:我自己的需求比较单一——就是 DDNS + 证书 + 反代(偶尔加 FRP)。Lucky 功能全面,但很多我用不到;Fonu 的方向不是替代 Lucky,而是:

只把飞牛 NAS 公网访问常用的几项单独做好:简单、轻量、配置直观。

需要非常完整、非常高级的网络能力,Lucky 肯定更合适;如果只是给自己的 fnOS 配域名、证书、反代,可以试试 Fonu。


专为 fnOS,独立 Nginx#

Fonu 目前按 飞牛 fnOS 场景开发和测试,我自己也主要在 fnOS 上用。群晖、威联通、自建 Linux 等环境理论上能跑 Docker 就可能能用,但没有专门做过完整测试,现阶段优先推荐 fnOS 用户。

另一个重要设计:Fonu 跑自己独立的一套 Nginx,不会去改飞牛系统自带的 Nginx 配置。

fnOS
├── 飞牛自己的 Nginx
└── Fonu
├── DDNS
├── HTTPS 证书
├── 独立 Nginx → 反向代理
└── frpc → 内网穿透(可选)

增加一条反代规则,不必动系统 Nginx;两边正常情况下互不干扰。飞牛已占用 80/443 时,Fonu 默认用高位端口(如 18080 / 9443)做反代,管理后台在 :6893。


产品展示#

后台基于 Vue 3 + Naive UI,支持跟随系统、浅色和深色。下面是我自己在 fnOS 上实际在用的界面。

仪表盘#

顶上一排是公网 IP、域名、证书和 Nginx 状态。下面按今天、近 7 天、30 天或全部,看请求、独立 IP、拦截和疑似扫描;今天的数字会和昨天比。地图可以在全球和国内之间切换,右侧按国家列出请求数;再往下是异常访问:5xx、4xx、耗时和慢请求。

Fonu 仪表盘
Fonu 仪表盘

DDNS#

任务按服务商分开。左边是任务列表和开关,右边是公网 IP、同步间隔和解析记录;IPv4 / IPv6 可以按任务单独开。一条任务能挂多个根域名,同步时会把当前公网 IP 写进对应解析。启用 FRP 之后,Web 域名应解析到 VPS,而不是 NAS。

Fonu DDNS
Fonu DDNS

HTTPS 证书#

ACME 申请和自动续签,也可以导入已有证书。快到期会在列表和仪表盘上标出来。证书跟的是域名本身:DNS 服务商负责 DNS-01,一张证书可以盖多个域名和通配符。要给别的程序用时,可以把 PEM 映射到本机目录,或通过 SSH 上传,并在内容变化后执行重载命令。

Fonu 证书管理
Fonu 证书管理

反向代理#

规则列表可以看每条服务的运行状态、当前和累计上下行、连接数;列表里就能启停规则。新建时会校验监听端口有没有被占用,顶上的汇总卡片看整体流量。

Fonu 反向代理列表
Fonu 反向代理列表

新建规则尽量保持简单:填前端域名、监听端口、目标地址,勾选 HTTPS 和跳转即可。例如 mp.example.com → http://192.168.1.100:3000。

Fonu 新增反代规则
Fonu 新增反代规则

内网里已经开着的 HTTP 服务可以扫一遍:填规则名称和域名,勾选后加进当前入口。

Fonu 发现内网服务
Fonu 发现内网服务

点进单条规则可看实时流量曲线、累计统计和最近访问;列表里「复制」会打开预填好的表单,确认后再保存(不会悄悄改域名后缀);域名旁可直接复制或打开链接,拖动排序调整优先级。同一页里还有安全策略和大陆 IP。

Fonu 规则详情
Fonu 规则详情

每条规则还可切换 Nginx 页签:默认按基础配置与安全策略自动生成带中文注释的 server 块,也支持手动编辑、保存前备份与回滚。

Fonu 规则 Nginx 配置
Fonu 规则 Nginx 配置

访问保护#

反代出去的可能是 fnOS 后台、青龙、MoviePilot、qBittorrent、Alist 等管理界面。每条规则可单独配安全策略:大陆 IP 限制(内网段默认放行)、黑白名单、Basic Auth、请求限流、连接数限制、安全响应头等;也有「一键推荐」快捷开启常用组合。

Fonu 反代安全设置
Fonu 反代安全设置

内网穿透#

没有公网 IP 时在这一页接 frps。连接设置(地址、端口、Token、TLS)可以先保存,不必马上打开开关。下面分成 Web 穿透、端口穿透、高级设置和运行日志:Web 穿透把已有反代域名同步成 HTTP/HTTPS 网关,转到本地 Nginx;端口穿透单独做 TCP/UDP。高级设置里可以看一份按当前配置生成的 frps.toml 参考。启用之后,Web 域名应解析到 VPS 公网 IP;HTTPS 仍建议用 DNS-01,在 NAS 侧的 Nginx 上终结。

Fonu 内网穿透
Fonu 内网穿透

日志中心#

系统日志、反代访问日志与 Nginx 错误日志分 tab 查看,支持关键词搜索与自动刷新,排障时不用 SSH 翻文件。访问日志可以按拦截筛选,来源 IP 带归属地;FRP 的输出也可以在这里看。

Fonu 日志中心
Fonu 日志中心

设置#

常规里改主题、时区、DDNS 检查间隔和证书提前续签的天数。访问统计可以设保留天数、独立访客是否排除内网 IP、要不要跳过历史 access.log,以及远程 IP 归属地补齐(默认关,优先用离线库)。配置可以导出,也可以从备份恢复。其它页签是 ACME 邮箱、通知(邮件 / Webhook / Telegram)、安全、Nginx 全局片段,以及更新日志。

Fonu 设置
Fonu 设置


使用教程#

有公网 IP 时,顺序是:装好 → 登录 → DDNS → 证书 → 反代。没有公网 IP,就在反代前后接上 FRP,Web 域名解析到 VPS。包名里的版本号以 Release 为准。

安装#

飞牛上优先装原生 FPK。到 Release 的 Assets 里按 CPU 下载 .fpk,不要用 Actions 里的 zip。

  • fonu_1.3.8_amd64.fpk、fonu_1.3.8_arm64.fpk:以应用用户 fonu 运行,默认装这个。证书要写到别的目录时,在飞牛应用设置里加「访问权限」。
  • fonu_1.3.8_amd64_root.fpk、fonu_1.3.8_arm64_root.fpk:以 root 运行,只在 Release 提供,不上架飞牛商店。能写系统目录、监听特权端口,风险也更大。

两个包的应用名都是 fonu,只装一个,后装的会换掉先装的,数据还在 /var/apps/fonu。安装向导里设置管理员账号,以及管理后台、HTTP、HTTPS 端口。默认是 6893、18080、9443。飞牛已经占用 80/443,反代不要再去听这两个端口。

Docker(host 网络) 也可以:

Terminal window
docker run -d \
--name fonu \
--network host \
-e FONU_SESSION_SECRET=换成你自己的密钥 \
-v ./data:/data \
--restart unless-stopped \
muxui/fonu:latest

数据在 /data,务必挂载 volume,不然更新容器会把配置清掉。FONU_SESSION_SECRET 不要留默认值,它用来加密会话和 DDNS、通知里的密钥。

第一次打开#

浏览器打开 http://<主机IP>:6893/setup,自己填用户名和密码(至少 8 位,再确认一次)。FPK 如果在安装向导里已经设过账号,会直接进登录页。之后可以在设置里改用户名和密码。

域名和证书#

  1. 打开 DDNS,添加任务,选服务商并填密钥。一条任务可以管多个根域名。解析记录填主机名(如 s、www 或 @),类型用 A 或 AAAA。IPv4 / IPv6 按需要单独开。保存后看这条任务是不是「正常」。
  2. 打开 证书管理 申请证书。域名要落在上一步能管的根域里,验证走 DNS-01,Fonu 会用同一套 DNS 凭证写 TXT。一张证书可以带多个域名和通配符。快到期会自动续,列表里也会提前标出来。
  3. 证书要给别的程序用:编辑这张证书,加上本机目录映射,或配 SSH 上传。映射目录必须是 Fonu 进程写得了的路径。Docker 要把宿主机目录挂进容器;FPK 用「应用文件 / fonu/certs」,或在应用设置里授权那个文件夹。

反向代理#

可以新建入口,也可以在已有入口上「发现内网服务」:扫描常见端口上的 HTTP,填规则名称和前端域名,勾选后加进去。

每条规则至少要有前端域名、监听端口和上游地址。飞牛上监听用高位端口,例如 HTTPS 9443。勾选 HTTPS,选刚申请的证书。需要把 HTTP 跳到 HTTPS 的,在规则里打开重定向。

保存后会生成带中文注释的 server 块并重载 Nginx。默认把客户端的 Host、Origin、Referer 转给上游;1Panel、LitePan 这类会校验来源的应用,不要改成「使用目标 Host」。想改限流或错误页,进这条规则的 Nginx 页签,手写前会留一份备份。

管理界面建议打开安全策略:大陆 IP、黑白名单或 Basic Auth。内网地址默认放行。

没有公网 IP#

VPS 上跑 frps,版本和内置 frpc 对齐,用 v0.71.x。Fonu 内网穿透页的 高级设置 里有一份按当前连接生成的 frps.toml 参考。Web 网关至少放行控制端口(默认 7000)以及 80 / 443。

回到 Fonu:

  1. 连接设置填 VPS 地址、端口和 Token,TLS 建议打开,先保存,不必马上启用。
  2. Web 穿透同步已经配好的反代域名。HTTP 转到本地 Nginx 的 18080,HTTPS 转到 9443。域名分流、证书和访问控制仍由 NAS 上的 Nginx 处理。
  3. 只转发某个端口(SSH、游戏等)时用 端口穿透,选 TCP 或 UDP,填 VPS 远程端口和内网地址。可以和 Web 网关同时开。
  4. 打开「启用内网穿透」。这些 Web 域名在 DDNS 里要解析到 VPS 公网 IP,不要写成 NAS 的地址。证书继续用 DNS-01,在 NAS 侧终结。

看访问和排障#

仪表盘可以切今天、近 7 天、30 天或全部,看请求、拦截和地图。对不上的时候去日志中心:访问日志能按拦截筛选,来源 IP 带归属地;FRP 的输出在内网穿透的运行日志和日志中心里都能看。设置里可以改统计保留天数,独立访客默认排除内网 IP。


版本轨迹#

  1. 2026-11-10
    v1.3.8

    DDNS 与证书 DNS-01 新增华为云。腾讯云、DNSPod 申请证书时,TXT 的 TTL 改为 600 秒,避免低于服务商下限。

  2. 2026-11-06
    v1.3.4–v1.3.7

    DNS-01 与 DDNS 一样按最长后缀匹配根域;根域名和泛域名同时申请时,同一条挑战记录保留两条 TXT。访问地图可以缩放、拖动。证书映射说明按 Docker、飞牛普通包、root 包分开写。

  3. 2026-11-04
    v1.3.3

    反代默认转发客户端的 Host、Origin、Referer。飞牛额外提供 root 包,只在 Release 里,不上架商店。设置里的「版本」改为「更新日志」。备份改为数据库快照,恢复放到下次启动再生效。

  4. 2026-11-02
    v1.3.0–v1.3.2

    访问统计:请求、独立 IP、拦截、疑似扫描写入 SQLite;首页有全球 / 国内地图、来源国家,以及相对昨天的 5xx、4xx、耗时和慢请求。日志里的来源 IP 带归属地。

  5. 2026-10-28
    v1.2.1–v1.2.2

    飞牛原生 FPK:安装向导里设置账号和端口,内置 nginx 1.30.x。第一次打开走 /setup 自己设管理员,不再生成随机密码。

  6. 2026-10-23
    v1.2.0

    每张证书可以映射到本机目录,或经 SSH 上传到别的机器;内容变化后可以执行重载命令。

  7. 2026-10-09
    v1.1.0–v1.1.10

    反代改成入口加规则,可以扫描发现内网服务后批量添加。证书申请可以直接选 DNS 服务商。DDNS 探测失败时沿用上次成功的公网 IP,不会把内网地址写进去。

  8. 2026-09-21
    v1.0.3–v1.0.8

    内网穿透加上 TCP/UDP 端口隧道,连接设置可以先保存、之后再启动。日志中心可以看 FRP 输出。

  9. 2026-09-18
    v1.0.0

    1.0:邮件、Webhook、Telegram 通知;日志中心分成系统、访问和 Nginx 错误。DDNS 与证书支持火山引擎。

  10. 2026-09-16
    v0.1.26–v0.1.31

    内网穿透:内置 frpc,把本地 Nginx 的 HTTP/HTTPS 同步到 VPS。单条规则的 Nginx 配置可以查看和手改,保存前留备份。

  11. 2026-09-12
    v0.1.0

    首个公开版本:多域名 DDNS、多域名与通配符证书、独立 Nginx 反代,以及多架构 Docker 镜像。


写在最后#

公网访问这件事,对我来说不需要一个「全能网络中枢」,只需要把域名、证书、反代(以及偶尔需要的 FRP 穿透)做得顺手、别跟系统 Nginx 打架,首页还能看见访问从哪来、拦了多少。Fonu 就是按这个思路写的;若你也在 fnOS 上折腾同类需求,欢迎 Star、Issue 或评论区聊。

相关链接#

O96u
/
Fonu
面向飞牛fnOS的轻量公网访问管理工具
—
—
GPL-3.0
Go
muxui
/
fonu
面向飞牛fnOS的轻量公网访问管理工具
19.5K
0

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

[开源] Fonu - 专为 fnOS 准备的轻量 DDNS + HTTPS 证书 + 反向代理工具
https://muxui.com/posts/fonu-fnos-ddns-https-reverse-proxy/
作者
Muxui
发布于
2026-09-15
许可协议
CC BY-NC-SA 4.0

评论区

Profile Image of the Author
Muxui
写代码、记笔记,把折腾过的东西留给未来的自己。
公告
欢迎来到我的博客!这是一则示例公告。
统计
分类
标签
站点统计
文章
24
分类
3
标签
30
总字数
63,759
运行时长
0 天
天气预报
定位中...
----
高温 --°C / 低温 --°C
站点信息
构建平台
GitHub Actions
博客版本
Firefly v6.16.9
文章许可
CC BY-NC-SA 4.0
文章目录