kernoio/ts-sandbox

TypeScript沙盒环境镜像

镜像概述

该Docker镜像提供了一个隔离的TypeScript运行环境，专门用于安全地编译和执行TypeScript脚本。通过沙盒机制确保脚本运行过程不会影响主机系统，同时提供一致的TypeScript编译环境，避免因本地环境差异导致的执行问题。

核心功能与特性

• 沙盒隔离：采用隔离机制限制脚本对主机系统的访问，提升运行安全性
• TypeScript支持：内置TypeScript编译器(tsc)，可直接编译.ts文件
• 环境一致性：统一的运行环境配置，消除本地开发环境差异带来的兼容性问题
• 轻量级设计：基于精简基础镜像构建，减少资源占用

使用场景

• 开发人员快速测试TypeScript代码片段
• 教学环境中演示TypeScript语法和执行效果
• 自动化流程中安全执行第三方TypeScript脚本
• 多版本TypeScript兼容性测试（通过指定版本标签）

使用方法

基本使用（编译TS文件）

将本地TypeScript文件挂载到容器内并编译：

bash
docker run -v $(pwd):/app sandbox-ts-env tsc /app/your-script.ts

此命令会将当前目录挂载到容器的/app目录，并使用tsc编译指定的TypeScript文件。

运行编译后的JS文件

编译完成后运行生成的JavaScript文件：

bash
docker run -v $(pwd):/app sandbox-ts-env node /app/your-script.js

交互式使用

启动交互式终端，在沙盒环境中手动编写和测试代码：

bash
docker run -it sandbox-ts-env /bin/sh

进入容器后，可使用tsc命令编译代码或node命令执行脚本。

配置说明

环境变量

• TS_VERSION：指定TypeScript编译器版本（默认使用最新稳定版）
• NODE_VERSION：指定Node.js运行时版本（默认与TypeScript版本兼容）

版本标签

通过镜像标签指定特定版本，例如：

bash
docker run sandbox-ts-env:4.9.5 tsc --version

数据卷挂载

推荐将需要处理的TypeScript文件通过-v参数挂载到容器内，避免文件永久存储在容器中。常用挂载路径：

• /app：默认工作目录，建议将本地项目目录挂载至此