ortussolutions/boxlang

BoxLang Docker镜像

欢迎使用BoxLang Docker镜像

本仓库包含BoxLang核心运行时和BoxLang MiniServer运行时的Docker镜像。完整文档请参见：[***]

什么是BoxLang？

BoxLang是一种现代动态JVM语言，可部署在多种运行时环境：操作系统（Windows/Mac/*nix/嵌入式）、Web服务器、Lambda、iOS、Android、WebAssembly等。BoxLang融合了Java、ColdFusion、Python、Ruby、Go和PHP等多种编程语言的特性，为开发者提供现代且富有表现力的语法。

BoxLang的设计目标包括：

• 作为快速应用开发（RAD）脚本语言和中间件
• 推动Java动态语言生态系统发展
• 动态、模块化、轻量且高效
• 100%与Java互操作
• 现代、函数式和流畅的语法（融合CFML、Node、Kotlin、Java和Clojure的特点）
• 支持多种运行时和部署目标：
  • 原生OS二进制文件（CLI工具、编译器等）
  • MiniServer
  • Servlet容器（CommandBox/Tomcat/Jetty/JBoss）
  • JSR223脚本引擎
  • AWS Lambda
  • Microsoft Azure Functions（即将推出）
  • Android/iOS设备（即将推出）
  • WebAssembly（即将推出）
• 编译为Java字节码
• 支持现有ColdFusion/CFML语言的向后兼容性
• 出色的IDE、调试器和工具：[***]
• 脚本（任何OS和Shebang）和REPL功能

文档地址：[***]

许可证

Apache许可证2.0版。

开源与专业支持

本项目是专业开源项目，免费开源可用。Ortus Solutions, Corp提供商业支持、培训和商业订阅，包括：

• 专业支持和优先排队
• 远程协助和故障排除
• 新功能请求和定制开发
• 定制SLA
• 应用现代化和迁移服务
• 性能审计
• 企业模块和集成
• 更多

访问BoxLang.io Plans了解更多信息。

Docker镜像

所有已发布的镜像和标签可在：https://hub.docker.com/r/ortussolutions/boxlang 查看。配置镜像的运行时和部署请参见环境变量部分。

CLI镜像

包含BoxLang CLI，允许运行BoxLang脚本、CLI应用、命令、调度器和任何OS集成。

• ortussolutions/boxlang:cli - 基于Debian Linux的最新BoxLang CLI镜像
• ortussolutions/boxlang:cli-alpine - 基于Alpine Linux的最新BoxLang CLI快照镜像
• ortussolutions/boxlang:cli-snapshot - 最新的BoxLang CLI快照镜像
• ortussolutions/boxlang:cli-alpine-snapshot - 基于Alpine Linux的最新BoxLang CLI快照镜像

bash
# 拉取最新的BoxLang CLI镜像
docker pull docker.xuanyuan.run/ortussolutions/boxlang:cli
# 运行BoxLang CLI版本
docker run --rm -it docker.xuanyuan.run/ortussolutions/boxlang:cli boxlang --version
# 运行BoxLang REPL
docker run --rm -it docker.xuanyuan.run/ortussolutions/boxlang:cli boxlang
# 运行简短代码片段
docker run --rm -it docker.xuanyuan.run/ortussolutions/boxlang:cli boxlang --bx-code "print('Hello, BoxLang!')"
# 运行Task.bx脚本
docker run --rm -it -v $(pwd):/app docker.xuanyuan.run/ortussolutions/boxlang:cli boxlang /app/Task.bx
# 运行Scheduler.bx脚本
docker run --rm -it -v $(pwd):/app docker.xuanyuan.run/ortussolutions/boxlang:cli boxlang /app/Scheduler.bx

MiniServer镜像

包含BoxLang MiniServer，轻量级Web服务器，可运行BoxLang应用、API和服务。设计目标是快速、轻量且易于使用。

• ortussolutions/boxlang:miniserver - 基于Debian Linux的最新BoxLang MiniServer镜像
• ortussolutions/boxlang:miniserver-alpine - 基于Alpine Linux的最新BoxLang MiniServer快照镜像
• ortussolutions/boxlang:miniserver-snapshot - 最新的BoxLang MiniServer快照镜像
• ortussolutions/boxlang:miniserver-alpine-snapshot - 基于Alpine Linux的最新BoxLang MiniServer快照镜像

MiniServer将/app作为服务器根目录，可将BoxLang应用和服务挂载到该目录。MiniServer会自动加载index.bxm作为默认文件，默认启用重写，可通过REWRITES_FILE环境变量配置。

bash
# 拉取最新的BoxLang MiniServer镜像
docker pull docker.xuanyuan.run/ortussolutions/boxlang:miniserver
# 运行启用重写的BoxLang MiniServer
docker run --rm -it -p 8080:8080 docker.xuanyuan.run/ortussolutions/boxlang:miniserver
# 以调试模式运行BoxLang MiniServer
docker run --rm -it -p 8080:8080 -e BOXLANG_DEBUG=true docker.xuanyuan.run/ortussolutions/boxlang:miniserver
# 加载自定义boxlang.json配置文件
docker run --rm -it -p 8080:8080 -v $(pwd)/boxlang.json:/root/.boxlang/config/boxlang.json docker.xuanyuan.run/ortussolutions/boxlang:miniserver

文档

完整文档请参见：[***]

环境变量

以下环境变量可用于配置BoxLang Docker镜像：

• BOXLANG_CONFIG_PATH - BoxLang配置文件路径。默认：/root/.boxlang/config/boxlang.json
• BOXLANG_DEBUG - 启用调试。默认：false
• BOXLANG_HOME - BoxLang安装的主目录。默认：/root/.boxlang
• BOXLANG_HOST - MiniServer监听的主机。默认：0.0.0.0
• BOXLANG_MODULES - 要安装的模块逗号分隔列表。默认：``。示例：bx-compat,bx-esapi,bx-mysql
• BOXLANG_PORT - MiniServer监听的端口。默认：8080
• DEBUG - 启用调试模式。默认：false
• JAVA_OPTS - MiniServer的Java选项。默认：-Djava.awt.headless=true
• HEALTHCHECK_URI - 健康检查端点的URI。默认：http://127.0.0.1:${PORT}/
• HOST - MiniServer监听的主机。默认：0.0.0.0
• MAX_MEMORY - 分配给BoxLang进程的最大内存。默认：-Xmx512m
• MIN_MEMORY - 分配给BoxLang进程的最小内存。默认：-Xms512m
• PORT - MiniServer监听的端口。默认：8080
• REWRITES - 启用URL重写。默认：true
• REWRITES_FILE - 包含URL重写的文件。默认：index.bxm

健康检查

Docker镜像包含健康检查，会ping MiniServer的根端点以确保其运行。可通过HEALTHCHECK_URI环境变量配置健康检查，默认值为http://127.0.0.1:${PORT}/。健康检查间隔为20秒，超时30秒，15次重试后标记容器为不健康。

BoxLang环境变量

BoxLang可通过BOXLANG_前缀的环境变量覆盖任何配置设置。更多信息：[***]

示例：

bash
BOXLANG_DEBUGMODE=true