fnOS 应用商店

面向 飞牛 fnOS 的第三方应用商店，提供友好的 Web 界面管理第三方应用。

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

功能特性

• 📦 浏览和安装 fnOS 第三方应用
• 🔄 自动检测应用更新
• 📊 实时查看安装进度（SSE 推送）
• 🎯 支持批量更新
• 🌙 暗黑模式支持

技术栈

• 后端: Go 1.25+ (标准库 http)
• 前端: React 19 + TypeScript + Tailwind CSS + shadcn/ui
• 构建: Vite + fnpack

快速开始

开发环境

# 1. 启动后端 (端口 8011)
go run ./cmd/server/

# 2. 启动前端开发服务器 (端口 5173)
cd frontend
npm install
npm run dev

构建

./build.sh

构建产物：

• fnos-apps-store_*.fpk - 可安装到 fnOS 的商店包
• store-server-* - 独立服务器二进制

项目结构

fnos-store/
├── cmd/server/          # 服务端入口
├── internal/
│   ├── api/            # HTTP API 处理器
│   ├── core/           # 业务逻辑 (registry, downloader)
│   ├── platform/       # fnOS 平台抽象
│   ├── source/         # 远程应用源
│   ├── cache/          # 本地缓存
│   ├── config/         # 配置管理
│   └── scheduler/      # 定时任务
├── frontend/           # React 前端
│   └── src/
│       ├── components/
│       └── api/
├── fnos/              # fnOS 包清单和配置
└── web/               # 嵌入的前端构建产物

API 文档

见 API.md（如存在）或查看 internal/api/ 源码。

配置

环境变量：

• LISTEN_ADDR - 监听地址 (默认 :8011)
• APPS_DIR - 已安装应用目录
• DATA_DIR - 数据存储目录
• PROJECT_ROOT - 项目根路径（开发模式）

访问保护

在「设置 → 访问保护」填写至少 16 个字符的随机令牌并保存。随后浏览器会要求登录： 用户名为 fnos，密码为设置的令牌。页面、API、安装包下载和流式操作都会受保护。 修改其他设置时，留空会保留当前令牌；可用「关闭访问保护」按钮关闭并保存。 令牌只以 SHA-256 哈希保存在数据目录的 config.json 中，不会通过设置 API 返回。

默认不启用保护。公网访问前请先启用，并通过 HTTPS 反向代理访问，避免明文传输令牌。 若忘记令牌，可通过 SSH 停止商店，移除 config.json 中的 access_token_hash 字段后重启， 然后重新设置令牌。

参与贡献

如果觉得本项目对你有帮助，请给我们点个 ⭐️ Star！

许可证

MIT License