用途:本技能指导开发者使用 ComputeSDK 的统一 API,在 Railway 基础设施上创建和管理自托管沙箱环境,适合需要自托管沙箱、持久化服务与容器化开发的场景。Railway 提供即时部署与自动 SSL。
前置条件:需先将 ComputeSDK 沙箱模板部署到自己的 Railway 账户(一次性设置),该模板会部署一个轻量二进制,把 Railway 转换为沙箱提供方。
安装与配置:
npm install computesdk
在 .env 中配置: COMPUTESDK_API_KEY=your_computesdk_api_key RAILWAY_API_KEY=your_railway_api_key RAILWAY_PROJECT_ID=your_railway_project_id RAILWAY_ENVIRONMENT_ID=your_railway_environment_id
ComputeSDK 密钥可在 https://console.computesdk.com/register 获取。Railway 凭据获取:API Token 在 Railway 工作区设置 -> Tokens -> New Token;Project ID 在 Project -> Settings -> Project Info;Environment ID 可在 URL railway.com/project/{PROJECT_ID}/settings?environmentId=={ENVIRONMENT_ID} 中找到。
快速开始:从 computesdk 导入 compute,它会根据环境变量自动识别 Railway。调用 compute.sandbox.create() 创建沙箱,用 sandbox.runCode 运行代码并读取 result.output,最后用 sandbox.destroy() 销毁。多提供方或需显式指定时,可用 compute.setConfig 设置 computesdkApiKey、provider: 'railway' 及 railway 下的 apiToken、projectId、environmentId。
配置项:RailwayConfig 支持 apiToken、projectId、environmentId,未设置时分别回退到对应环境变量。
完整 API:ComputeSDK 在所有提供方上提供一致 API,包括文件系统操作、shell 命令、托管服务器、overlays、终端和客户端访问。安装主技能获取完整参考:
npx skills add https://github.com/computesdk/sandbox-skills --skill computesdk
更多文档见 https://www.computesdk.com/docs/reference/sandbox/。
限制:资料未提供收费、价格、配额、性能或平台兼容性等细节,暂未提供。