sllwakeup/piscina repository overview

# sllwakeup/piscina

基于 Node.js 24 和 Piscina 5.3.2 的独立 JavaScript 执行服务，用于运行 IoT 平台的产品自定义函数。PHP 通过 HTTP 调用本服务，无需在 PHP 镜像中安装 Node.js。

## 镜像特性

- Worker 数量按负载在最小值与最大值之间扩容，额外空闲 Worker 默认 5 分钟后回收
- 支持有界排队、排队超时、编译超时和执行超时
- 限制请求体、源码、返回值、日志和 effects 的大小
- 提供健康检查、线程池资源信息和 JavaScript 执行接口
- 支持 Token 鉴权，使用非 root 用户运行

## 拉取镜像

```bash
docker pull sllwakeup/piscina:latest

docker run -d \
  --name piscina \
  --restart unless-stopped \
  -p 127.0.0.1:8787:8787 \
  -e NODE_RUNNER_TOKEN=your-secret-token \
  -e NODE_RUNNER_MIN_WORKERS=4 \
  -e NODE_RUNNER_MAX_WORKERS=24 \
  -e NODE_RUNNER_QUEUE_CAPACITY=64 \
  sllwakeup/piscina:latest

services:
  node-runner:
    image: sllwakeup/piscina:latest
    restart: unless-stopped
    environment:
      NODE_RUNNER_HOST: 0.0.0.0
      NODE_RUNNER_PORT: 8787
      NODE_RUNNER_TOKEN: your-secret-token
      NODE_RUNNER_MIN_WORKERS: 4
      NODE_RUNNER_MAX_WORKERS: 24
      NODE_RUNNER_IDLE_TIMEOUT_MS: 300000
      NODE_RUNNER_QUEUE_CAPACITY: 64
      NODE_RUNNER_QUEUE_TIMEOUT_MS: 1000
    expose:
      - "8787"

{
  "ok": true,
  "pool": {
    "threads": 4,
    "min_threads": 4,
    "max_threads": 24,
    "idle_threads": 4,
    "queued": 0,
    "in_flight": 0,
    "completed": 0
  }
}

curl http://127.0.0.1:8787/resources \
  -H 'Authorization: Bearer your-secret-token'

{
  "ok": true,
  "process": {
    "name": "node-runner",
    "pid": 12345,
    "status": "running"
  },
  "pools": [
    {
      "name": "piscina",
      "type": "worker_threads",
      "size": {
        "current": 4,
        "min": 4,
        "max": 24
      },
      "usage": {
        "idle": 4,
        "in_use": 0,
        "queued": 0
      },
      "status": "healthy"
    }
  ]
}

curl -X POST http://127.0.0.1:8787/run \
  -H 'Authorization: Bearer your-secret-token' \
  -H 'Content-Type: application/json' \
  -d '{"code":"async function onMessage(message, ctx) { return message }","message":{"device_status":1},"ctx":{},"timeout":15}'

{
  "success": true,
  "result": {
    "device_status": 1
  },
  "error": null,
  "logs": [],
  "effects": [],
  "duration_ms": 5
}