
Node.js-Sandbox zum Ausführen von nicht vertrauenswürdigem JavaScript im selben Prozess, unter Verwendung von Proxies und kontrolliertem require, um den Zugriff auf integrierte und externe Module einzuschränken.
vm2 ist eine Sandbox, die nicht vertrauenswürdigen Code mit auf einer Whitelist stehenden eingebauten Node-Modulen ausführen kann.
Für einen detaillierten Einblick in die Interna von vm2 lesen Sie die Datei CONTRIBUTING.md.
Probieren Sie es selbst aus:
import { runInNewContext } from "node:vm";
runInNewContext('this.constructor.constructor("return process")().exit()');
console.log('Never gets executed.');
import { VM } from 'vm2';
new VM().run('this.constructor.constructor("return process")().exit()');
// Throws ReferenceError: process is not defined
npm install vm2
import { VM } from 'vm2';
const vm = new VM();
vm.run(`process.exit()`); // TypeError: process.exit is not a function
import { NodeVM } from 'vm2';
const vm = new NodeVM({
require: {
external: true,
root: './',
},
});
vm.run(
`
var request = require('request');
request('http://www.google.com', function (error, response, body) {
console.error(error);
if (!error && response.statusCode == 200) {
console.log(body); // Show the HTML for the Google homepage.
}
});
`,
'vm.js',
);
VM ist eine einfache Sandbox, um nicht vertrauenswürdigen Code synchron ohne die require-Funktion auszuführen. Es sind nur die in JavaScript integrierten Objekte und Nodes Buffer verfügbar. Planungsfunktionen (setInterval, setTimeout und setImmediate) sind standardmäßig nicht verfügbar.
Optionen:
timeout - Skript-Timeout in Millisekunden. WARNUNG: Sie sollten diese Option möglicherweise zusammen mit allowAsync=false verwenden. Darüber hinaus kann das Arbeiten mit zurückgegebenen Objekten aus der Sandbox beliebigen Code ausführen und das Timeout umgehen. Man sollte mit typeof prüfen, ob das zurückgegebene Objekt ein primitiver Wert ist, und es andernfalls vollständig verwerfen (auch das Protokollieren oder Erstellen von Fehlermeldungen mit einem solchen Objekt kann erneut beliebigen Code ausführen).sandbox - Das globale Objekt der VM.compiler - javascript (Standard), typescript, coffeescript oder eine benutzerdefinierte Compiler-Funktion. Die Bibliothek erwartet, dass der Compiler vorinstalliert ist, wenn der Wert auf typescript oder coffeescript gesetzt ist.eval - Wenn auf false gesetzt, lösen alle Aufrufe von eval oder Funktionskonstruktoren (Function, GeneratorFunction usw.) einen EvalError aus (Standard: true).wasm - Wenn auf false gesetzt, löst jeder Versuch, ein WebAssembly-Modul zu kompilieren, einen WebAssembly.CompileError aus (Standard: true).allowAsync - Wenn auf false gesetzt, löst jeder Versuch, Code mit async auszuführen, einen VMError aus (Standard: true).WICHTIG: Das Timeout ist nur bei synchronem Code wirksam, den Sie über run ausführen. Das Timeout funktioniert NICHT bei Methoden, die von der VM zurückgegeben werden. Es gibt einige Situationen, in denen das Timeout nicht funktioniert – siehe #244.
import { VM } from 'vm2';
const vm = new VM({
timeout: 1000,
allowAsync: false,
sandbox: {},
});
vm.run('process.exit()'); // throws ReferenceError: process is not defined
Du kannst auch Werte aus der VM abrufen.
let number = vm.run('1337'); // returns 1337
TIPP: Weitere Anwendungsbeispiele finden Sie in den Tests.
Im Gegensatz zu VM ermöglicht NodeVM das Einbinden von Modulen auf dieselbe Weise wie im regulären Node-Kontext.
Optionen: