Skip to content

v1.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 09 Jan 15:23
· 5 commits to master since this release

🏁 BoomApi v1.0.0: The 14MB Miracle 🚀

这是 BoomApi 的正式发布版。我们不仅实现了一个轻量级的 API Mock 工具,更是在 .NET 10 的前沿阵地上,完成了一次关于体积、性能与安全性的极致探索。

📦 关于 "14MB" 的严谨定义 (Size Breakdown)

为了保持专业与严谨,我们需要明确:

  • 压缩镜像体积 (Compressed Image Size): 14.18 MB。

    这里的 14.18MB 包含了 Ubuntu 24.04 Chiseled 基础层 + 自包含可执行程序 + 内置 Web UI 静态资源。

  • 原生二进制文件 (Native Binary Size): 约 28 MB。

    基于 Native AOT 编译,完全脱离了 .NET 运行时依赖,真正实现了“解压即运行”。

  • 💡 致敬前行者:

    我们深知在底层开发世界中,依然存在通过 Rust/Zig 在 scratch 镜像上构建出的 KB 级奇迹。BoomApi 的初衷并非挑战体积的绝对物理极限,而是在 .NET 生态、**工业级安全性(Chiseled)与丰富交互体验(Web UI)**之间,寻找一个完美的平衡点。


✨ 核心改进 (Final Updates)

  • 🔥 架构封版:移除了 Antiforgery 中间件,改为手动 .DisableAntiforgery(),确保在 AOT 环境下实现真正的“无状态”稳定。
  • 🎨 视觉补完:为 Windows win-x64 发布版嵌入了专属高分辨率图标,告别“白板程序”。
  • 🛡️ 权限防呆:启动时自动检测挂载目录权限。若检测到 UID 1654 无法写入,程序将通过 Log.Fatal 打印清晰的修复指南(chown)并安全退出。
  • 📂 存储隔离:支持 /app/data 与 /app/logs 独立挂载,数据归数据,日志归日志。

🚀 部署指南 (Quick Start)

# 1. 准备并授权目录
mkdir -p mocks logs && sudo chown -R 1654:1654 mocks logs

# 2. 启动 14MB 奇迹
docker run -d \
  -p 8080:8080 \
  -v $(pwd)/mocks:/app/data \
  -v $(pwd)/logs:/app/logs \
  --name boomapi \
  vicenteyu105/boomapi:v1.0.0

"Small, but Uncompromising." 感谢所有对极致性能有追求的开发者。如果你喜欢这个项目,请为它点亮一颗 Star 🌟。

GitHub Repository: https://github.com/vicenteyu/boomapi


Built with ❤️ and .NET 10 Native AOT.