fnos-plugin-bun 是为飞牛OS(FnOS)打造的 Bun 运行时环境支持插件。Bun 是一款快速、可渐进式采用的一体化 JavaScript、TypeScript 和 JSX 工具包,可作为 Node.js 的高性能替代方案。

• 🔥 高性能运行时 - 基于 JavaScriptCore 引擎,启动速度比 Node.js 快 4 倍
• 📦 内置工具链 - 集成打包器、测试运行器、包管理器,无需额外配置
• ⚡ 快速安装 - 智能安装程序支持在线/离线安装,自动检测系统架构
• 🔄 Node.js 兼容 - 致力于实现 100% 的 Node.js API 兼容性
• 🎯 开箱即用 - 自动配置环境变量,无需手动设置

• 操作系统: FnOS (飞牛OS)
• 架构支持:
  • ✅ x86_64 (AMD64) - 支持离线/在线安装
  • ✅ ARM64 (aarch64) - 仅支持在线安装
• 依赖: unzip

支持所有架构,自动下载最新版本。

1. 打开飞牛「应用中心」
2. 选择 「手动安装」 并上传 fnos-plugin-bun.fpk
3. (可选) 配置 GitHub 镜像地址加速下载
4. 等待下载和安装完成

💡 : 在线安装时建议配置代理或使用 GitHub 镜像以提高下载速度。

适用于内网环境或网络受限场景,预装 Bun v1.3.6 baseline 版本(仅包含 x86_64 架构离线包)。

1. 打开飞牛「应用中心」
2. 选择 「手动安装」 并上传 fnos-plugin-bun.fpk
3. 在安装引导选择「离线安装」
4. 等待解压安装完成

如果您的飞牛应用需要使用 Bun 环境,请在 manifest 文件中声明依赖:

install_dep_apps=fnos-plugin-bun

在您的应用脚本 (cmd/*) 中添加以下内容:

export PATH=/var/apps/fnos-plugin-bun/target/bin:$PATH

之后即可使用 Bun 的所有功能:

# 运行 JavaScript/TypeScript 文件
bun run index.ts
# 安装依赖
bun install
# 运行测试
bun test
# 打包应用
bun build ./index.ts --outdir ./dist

fnos-plugin-bun/
├── app/ # 应用资源目录
│ └── bun-linux-x64-baseline.zip # 离线安装包
├── cmd/ # 命令脚本
│ ├── main # 主程序入口
│ ├── install_init # 安装初始化
│ ├── install_callback # 安装回调
│ ├── upgrade_init # 升级初始化
│ ├── upgrade_callback # 升级回调
│ ├── uninstall_init # 卸载初始化
│ ├── uninstall_callback # 卸载回调
│ ├── config_init # 配置初始化
│ └── config_callback # 配置回调
├── config/ # 配置目录
│ ├── privilege # 权限配置
│ └── resource # 资源配置
├── wizard/ # 安装向导
│ └── install # 安装配置界面
├── manifest # 应用清单文件
├── ICON.PNG # 应用图标
├── ICON_256.PNG # 应用图标 (256x256)
└── README.md # 项目说明文档

• 安装目录: /var/apps/fnos-plugin-bun/
• 可执行文件: /var/apps/fnos-plugin-bun/target/bin/bun

欢迎提交 Issue 和 Pull Request!

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

• Bun 官方网站
• Bun 官方文档
• Bun GitHub 仓库
• 飞牛OS 官网

本插件仅为飞牛OS提供 Bun 运行时环境支持,Bun 软件本身由 oven-sh 开发和维护。使用本插件即表示您同意 Bun 的相关许可协议。