fnOS Apps

面向飞牛 fnOS 的第三方应用打包仓库。自动跟踪上游版本，构建可直接安装的 .fpk 包。

⭐️ 如果觉得本项目对你有帮助，请右上角点个 Star！

应用一览

💡 推荐先安装 fnOS Apps 应用中心，可一键管理以下所有应用的安装与更新。

📦 应用中心

	App	端口	说明	下载
	fnOS Apps	8011	第三方应用中心，一键安装与更新	Release

🎬 媒体服务

	App	端口	说明	下载
	Plex	32400	媒体服务器，支持硬件转码	Release
	Emby	8096	媒体管理与流式传输	Release
	Jellyfin	8097	开源媒体系统，内置 FFmpeg	Release
	Navidrome	4533	音乐流媒体服务器	Release
	Koel	8060	个人音乐流媒体，默认账号 admin@koel.dev/KoelIsCool	Release
	Immich	2283	自托管照片/视频备份，支持人脸识别	Release
	Kavita	5000	漫画/电子书阅读	Release
	tinyMediaManager	5800	影视元数据管理	Release

⬇️ 下载工具

	App	端口	说明	下载
	qBittorrent	8085	BitTorrent 客户端，默认账号 admin/adminadmin	Release
	Transmission	9091	轻量级 BitTorrent 客户端	Release
	Gopeed	9999	高速下载器，支持 HTTP/BT/Magnet	Release
	Syncthing	8384	文件同步工具，P2P 架构	Release

📚 内容管理

	App	端口	说明	下载
	ANI-RSS	7789	动漫 RSS 自动追番，默认账号 admin/admin	Release
	AutoBangumi	7892	RSS 自动追番下载整理，默认账号 admin/adminadmin	Release
	Audiobookshelf	13378	有声书和播客服务器	Release
	MoviePilot	3000	影视自动化管理	Release
	OpenList	5244	文件列表/WebDAV	Release
	KodBox	8500	私有云存储/在线文档协作	Release

🔧 系统工具

	App	端口	说明	下载
	Sun-Panel	3002	服务器/NAS 导航面板	Release
	Certimate	8090	SSL 证书管理	Release
	Vaultwarden	8880	密码管理（Bitwarden 兼容）	Release
	Nginx	8888	HTTP 服务与反向代理	Release
	Nginx UI	9000	Nginx 可视化管理面板，内置 Nginx 引擎	Release
	Gotify	8070	自托管推送通知服务	Release
	DDNS-GO	9876	动态 DNS 解析客户端	Release
	WolGoWeb	9090	网络唤醒 (Wake-on-LAN) 管理	Release
	AdGuardHome	3080	全网广告拦截与 DNS 管理	Release

🌐 浏览器

	App	端口	说明	下载
	Firefox	5801	远程浏览器，支持中文	Release
	Chromium	5802	远程浏览器，支持中文	Release

反馈与请求

• 新应用请求：Open App Request
• 问题反馈：Open Bug Report

快速开始

安装

1. 下载对应 App 的 Release 页面中的 .fpk 文件
2. 在 fnOS 应用中心选择「手动安装」
3. 上传 .fpk 并完成安装

本地构建

# 构建单个应用（以 plex 为例）
cd apps/plex && ./update_plex.sh

# 通用格式
cd apps/<app> && ./update_<app>.sh

构建产物统一输出到仓库根目录 dist/。

项目结构

fnos-apps/
├── apps/                    # 各应用的 fnOS 包定义与构建脚本
├── shared/                  # 通用生命周期脚本与向导模板
├── scripts/
│   ├── build-fpk.sh         # 通用 fpk 打包器
│   ├── new-app.sh           # 新应用脚手架
│   ├── apps/<app>/          # 每个应用的构建合约
│   └── ci/resolve-release-tag.sh
└── .github/workflows/       # 入口 workflow + 可复用构建 workflow

新增应用（维护者）

./scripts/new-app.sh <app-slug> "<display-name>" <port>
# example
./scripts/new-app.sh jellyfin "Jellyfin" 8097

推荐流程：

1. 在 apps/<app>/ 完成 fnOS 清单和启动脚本
2. 在 scripts/apps/<app>/ 完成版本探测与 app.tgz 组装
3. 新增 .github/workflows/build-<app>.yml 入口 workflow
4. 将 app 名称加入 reusable-build-app.yml 的 VALID_APPS

CI/CD 设计

• 统一使用 scripts/build-fpk.sh 打包，减少各应用行为漂移
• 统一使用 reusable-build-app.yml 实现版本检查、矩阵构建、发布
• 标签策略由 scripts/ci/resolve-release-tag.sh 管理，支持 -r2/-r3 修订版自动递增
• 日常构建由定时任务和手动触发驱动，不由普通 push 触发

变更记录

项目变更记录请查看 CHANGELOG.md。

致谢

• 应用图标来自 Dashboard Icons（MIT License）

安全与透明

• 本仓库仅下载并重打包官方发布内容，不修改上游业务逻辑
• 当前应用均按非 root 用户运行（提升默认安全性）
• 构建脚本、CI 流程与发布记录均公开可审计