SuperAPI AI 工具集

boxlang-runtime-miniserver

通用与其它

查看项目

更新于 10-16 03:13

技能介绍

用途:BoxLang MiniServer 是 BoxLang 应用的官方轻量级 Web 服务器,基于 Undertow,并非 Servlet 容器,而是为 BoxLang 打造的快速 Web 运行时。适用于开发服务器,以及不需要完整 Java EE 容器的生产部署。

主要能力:二进制为 boxlang-miniserver(Windows 为 boxlang-miniserver.bat),默认绑定 0.0.0.0:8080,以当前工作目录为 webroot。支持自定义端口与 webroot、URL 重写(SPA 或前端控制器模式,重写到 index.bxm)、调试模式、健康检查端点、预热 URL、Undertow 线程与缓冲调优、WebSocket 帧大小设置。

使用方式:命令行示例包括 boxlang-miniserver、boxlang-miniserver --port 9000 --webroot ./public、boxlang-miniserver --rewrites、boxlang-miniserver --port 8080 --health-check --health-check-secure。CLI 标志有 --port/-p、--host、--webroot/-w、--debug/-d、--rewrites/-r、--configPath/-c、--serverHome/-s、--health-check、--health-check-secure、--version、--help。环境变量在 CLI 参数之前扫描,CLI 优先,包括 BOXLANG_CONFIG、BOXLANG_DEBUG、BOXLANG_HOME、BOXLANG_HOST、BOXLANG_PORT、BOXLANG_REWRITES、BOXLANG_REWRITE_FILE、BOXLANG_WEBROOT、BOXLANG_HEALTH_CHECK、BOXLANG_HEALTH_CHECK_SECURE、BOXLANG_MINISERVER_OPTS。可通过 --configPath 传入 miniserver.json,或使用 .boxlang.json 项目约定;配置优先级为 CLI 参数 > JSON 配置文件 > 环境变量 > 默认值。

健康检查:启用 --health-check 后提供 /health(完整 JSON 信息)、/health/ready(就绪探针)、/health/live(存活探针);--health-check-secure 使远程调用者仅获得最少信息。

环境文件:启动时自动加载 webroot 下的 .env,变量加入 Java System Properties,可用 getSystemSetting() 读取,建议用它而非 server.system.environment。

安全与限制:以 . 开头的文件或目录自动返回 404 且不可禁用;.env 文件禁止 HTTP 访问;健康检查端点不暴露环境值。预热 URL 在服务器初始化后顺序执行,失败仅记录日志不中止启动。Undertow 与 socket、websocket 参数可按并发调整。其余未在资料中说明的收费、平台或效果暂未提供。