openruntimes/deno

Deno Serverless Runtime 镜像文档

镜像概述

Deno Serverless Runtime是一个基于Deno运行时的无服务器环境镜像，专为快速部署和运行JavaScript/TypeScript无服务器应用设计。该镜像整合了Deno的安全特性与无服务器架构的灵活性，可作为轻量级执行环境用于开发、测试和生产环境中的无服务器函数及微服务。

核心功能与特性

安全执行环境

• 默认禁用文件系统、网络和环境变量访问，需通过显式权限配置开启（遵循Deno安全模型）
• 支持细粒度权限控制（如--allow-net网络访问、--allow-read文件读取等）

开发友好特性

• 原生支持TypeScript，无需额外编译步骤
• 内置代码格式化、 linting 和测试工具（基于Deno内置工具链）
• 热重载支持，适合开发阶段快速迭代

无服务器优化

• 轻量级镜像设计，启动速度快（冷启动时间<100ms）
• 低资源占用，适合边缘计算和资源受限场景
• 兼容主流无服务器平台函数格式（如AWS Lambda、Cloudflare Workers函数结构）

使用场景

典型应用场景

• 轻量级API服务与微服务后端
• 事件驱动型应用（如消息队列处理、webhook响应）
• 定时任务与自动化脚本（如数据同步、日志处理）
• 边缘计算场景（CDN边缘函数、低延迟内容处理）

适用开发模式

• 快速原型验证
• 无服务器架构（Serverless Architecture）开发
• 微服务拆分后的独立功能模块部署

使用方法与配置说明

基本使用（Docker Run）

部署单文件函数

bash
# 运行当前目录下的index.ts作为入口函数
docker run -d \
  -v $(pwd)/index.ts:/app/index.ts \
  -e DENO_ENTRY=/app/index.ts \
  -e DENO_PERMISSIONS="--allow-net=0.0.0.0:8080" \
  -p 8080:8080 \
  deno-serverless-runtime

入口文件示例（index.ts）

typescript
// 简单HTTP服务示例
import { serve } from "https://deno.land/std@0.192.0/http/server.ts";

serve((req) => {
  return new Response("Hello from Deno Serverless Runtime!", {
    status: 200,
    headers: { "content-type": "text/plain" },
  });
}, { port: 8080 });

Docker Compose 配置示例

yaml
version: '3.8'
services:
  deno-function:
    image: deno-serverless-runtime
    volumes:
      - ./functions:/app/functions  # 挂载函数目录
    environment:
      - DENO_ENTRY=/app/functions/main.ts  # 指定入口文件
      - DENO_PERMISSIONS="--allow-net --allow-read=/app/data"  # 权限配置
      - PORT=3000  # 服务端口
    ports:
      - "3000:3000"
    restart: unless-stopped

环境变量配置

权限配置说明

Deno默认禁用所有系统访问权限，需通过DENO_PERMISSIONS显式配置：

高级配置

自定义启动命令

如需覆盖默认启动命令，可通过docker run的command参数指定：

bash
docker run -v $(pwd):/app deno-serverless-runtime deno run --allow-net /app/custom-entry.ts

依赖缓存

为加速部署，可挂载Deno缓存目录：

bash
docker run -v $(pwd):/app -v deno-cache:/root/.cache/deno deno-serverless-runtime

注意事项

• 生产环境中应遵循最小权限原则，仅授予必要权限
• TypeScript文件无需预先编译，运行时会自动转译
• 大规模部署建议结合容器编排工具（Kubernetes）或无服务器平台（AWS ECS/Fargate）使用
• 镜像定期更新Deno版本，建议通过版本标签固定生产环境镜像版本（如deno-serverless-runtime:1.37.0）