Repository navigation
🏁 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.