Fonu

让 NAS 访问更简单

面向 飞牛 fnOS 的轻量公网访问管理工具
反向代理 · DDNS · HTTPS 证书 · 内网穿透 · 一站式 Web 管理

---

简介

Fonu 是一款主要为 飞牛 fnOS 编写的反代与管理工具，帮助你在 NAS 上快速搭建稳定的公网访问能力：通过 Web 界面管理 Nginx 反向代理、自动同步 DDNS、申请与续期 Let's Encrypt 证书，并在一个仪表盘里查看服务状态、访问日志与流量统计。

无需手写 Nginx 配置，也无需在多个工具之间切换。当前开发与测试环境以飞牛 fnOS 为主，群晖、威联通、自建 Linux 等其他环境尚未充分测试，部署前请自行验证。

功能特性

模块	说明
反向代理	多域名、多端口、HTTP/HTTPS、自动重定向；实时访问日志、流量统计、当前连接 IP
DDNS	支持 Cloudflare、DNSPod、阿里云、腾讯云、火山引擎 DNS；单任务多根域名，自动同步公网 IP
HTTPS 证书	ACME 自动申请与续期；证书/私钥/ZIP 下载；申请进度实时日志
仪表盘	公网 IP、域名、证书、服务状态一览；请求趋势与运行健康度
日志中心	系统日志、Nginx 访问日志、Nginx 错误日志；分页筛选与自动刷新
内网穿透	FRP 客户端（Nginx 网关穿透）：无公网 IP 时经 VPS 中转，反代与安全策略不变
系统设置	常规 / 通知 / 安全 / 高级分栏；邮件/Webhook/Telegram 告警、备份与恢复
其他	深色模式、配置导出/导入、GitHub Release 更新提示

技术栈

层级	技术
后端	Go 1.23、标准库 HTTP、SQLite（modernc.org/sqlite）
反向代理	内置 Nginx（动态生成配置、热重载）
证书	go-acme/lego（Let's Encrypt）
DDNS	Cloudflare / DNSPod / 阿里云 / 腾讯云 / 火山引擎 DNS API
内网穿透	FRP 客户端（多服务端）：无公网 IP 时经 VPS 中转，8 种穿透类型与插件，frps.toml 同源生成
前端	Vue 3、TypeScript、Vite、Naive UI、ECharts
部署	Docker 镜像（amd64 / arm64），本地源码构建

部署

本地项目：三个 compose 文件均从源码构建镜像（build: .），不拉取任何仓库镜像，构建产物标签为 fonu:local。

详细部署安装文档：docs/DEPLOYMENT.md —— 环境要求、镜像构建、三种部署方式、首次配置、FRP/DDNS/证书联动、升级回滚与故障排查。 FRPS 服务端管理方案：docs/frps服务端管理方案.md —— 公网 VPS 部署 fonu-agent，SSH 从本地 Fonu 安装/升级/卸载，日常通过本地管理面板调用 API 自动编排 Nginx、frps 与证书。

快速部署（推荐 · 飞牛 fnOS · Host 模式）

飞牛系统已占用 80/443，使用 host 网络 + 高位反代端口，避免与系统 Nginx 冲突。

docker run -d \
  --name fonu \
  --net=host \
  -v ./data:/data \
  --restart unless-stopped \
  fonu:local

入口	地址
管理后台	http://<NAS-IP>:6893
HTTP 反代（默认）	http://<NAS-IP>:18080
HTTPS 反代（默认）	https://<NAS-IP>:9443

• ./data 挂载后自动作为数据目录，存放数据库、Nginx 配置、证书与日志
• 飞牛系统已占用 80/443，容器默认反代端口为 18080、9443，可通过环境变量修改

其他部署方式

Docker Compose

FONU_SESSION_SECRET=your-secret docker compose -f docker-compose.host.yml up -d

Bridge 网络（端口映射，非飞牛环境可自行尝试）

FONU_SESSION_SECRET=your-secret docker compose -f docker-compose.hub.yml up -d --build

本地构建

docker compose up -d --build

首次登录

1. 启动后查看容器/运行日志，获取自动生成的 admin 初始密码
2. 访问 http://<NAS-IP>:6893/login 登录
3. 在 设置 中立即修改管理员密码

FRP 内网穿透（无公网 IP）

适用于无法端口映射、无公网 IPv4 的场景。Fonu 内置 frpc，支持多台公网服务端与全部 8 种穿透类型（tcp / udp / http / https / tcpmux / stcp / sudp / xtcp）及插件（static_file / socks5 / https2http 等）。

典型流量路径（tcp 规则 + 本地反代）：用户 → DNS（解析到 VPS）→ frps → frpc → Fonu Nginx → 内网服务

1. VPS 部署 frps

在服务端「详情」弹窗点 「frps.toml」 一键生成与 frpc 侧同源的服务端配置（bindPort / 认证 / webServer / 传输参数 / vhost 端口与防火墙清单全部对齐），复制到 VPS 保存后 frps -c frps.toml 启动，按文件末尾清单放行防火墙端口。

2. Fonu 配置 frpc

在侧栏 FRP 穿透 页面：

• 添加服务端：主机地址 / 端口（frps bindPort，默认 7000）/ 认证方式与 Token，与 frps 一致；可选填 frps 管理接口（webServer）用于拉取穿透流量；
• 添加穿透规则：按需选择类型——tcp / udp 填远程端口，http / https / tcpmux 填自定义域名，stcp / sudp / xtcp 凭 secretKey 访问；
• 保存后「应用配置」弹窗内校验并应用；服务端「详情」含五项诊断与独立日志。

3. DNS 与证书

• DDNS：IP 来源留空=检测本机（域名指家庭宽带）；填自定义 IP=VPS 的 IP（域名直接指 VPS，Web 服务经 VPS 对外时使用）；VPS 动态 IP 场景把服务端地址填 DDNS 域名即可自动跟随；
• HTTPS 证书：ACME DNS-01 验证（复用 DDNS 服务商凭证，含火山引擎）；「统一入口」方案证书在本地 Nginx 终结，「直通」方案在 VPS 侧终止。

组合场景详解已内置页面：FRP 页右上「使用说明」→「组合场景详解」标签，覆盖十个典型部署场景与故障排查。

环境变量

变量	默认值	说明
FONU_LISTEN	:6893	管理后台监听地址
FONU_DATA_DIR	/data	数据目录（数据库、Nginx 配置、证书、日志）
FONU_SESSION_SECRET	change-me-in-production	会话加密密钥，生产环境请自行修改
FONU_NGINX_HTTP_PORT	80	新建 HTTP 反代规则的默认监听端口
FONU_NGINX_HTTPS_PORT	443	新建 HTTPS 反代规则的默认监听端口
FONU_NGINX_BIN	nginx	Nginx 可执行文件路径（本地开发可指定）
FONU_FRPC_BIN	frpc	frpc 可执行文件路径（Docker 镜像内置 0.71.0）
FONU_FRP_PID	{DATA_DIR}/frp/frpc.pid	frpc 进程 PID 文件路径

注意事项

1. 生产环境务必设置 FONU_SESSION_SECRET，不要使用默认值。
2. 端口冲突：宿主机已有 Nginx（如飞牛系统）占用 80/443 时，不要让 Fonu 反代规则监听 80/443；使用 18080/9443 或 host 模式 + 环境变量。
3. 已有反代规则：修改 FONU_NGINX_HTTP_PORT / FONU_NGINX_HTTPS_PORT 后，不会自动更新数据库中已有规则的端口，需在反代页手动修改并保存。
4. 访问日志：仅统计经 Fonu Nginx 反代的域名流量，不包含管理后台 :6893 的请求。
5. 证书与 DNS：HTTPS 申请前请确保域名 DNS 已解析到本机，且 DDNS 凭证能管理对应根域。
6. 数据持久化：Docker 部署请挂载 volume 到 FONU_DATA_DIR，避免容器重建后配置丢失。
7. 备份：可通过设置页导出配置；重要证书与数据库建议定期备份 FONU_DATA_DIR 目录。

本地开发

# 前端热更新
cd web && npm ci && npm run dev

# 后端（需先把 web/dist 复制到 cmd/fonu/web/dist）
cd web && npm run build
go run ./cmd/fonu

# 测试
go test ./...
cd web && npm run typecheck

发版版本号以根目录 VERSION 文件为单一来源，docker compose build 自动读取并注入前后端；本地 go run / 未注入时默认显示 dev。

开源协议

本项目采用 GPL-3.0 开源。