
Песочница Node.js для запуска недоверенного JavaScript в том же процессе с использованием Proxy и контролируемого require для ограничения доступа к встроенным и внешним модулям.
vm2 — это песочница, которая может запускать недоверенный код с разрешёнными встроенными модулями Node.
Для углублённого изучения внутреннего устройства vm2 см. файл CONTRIBUTING.md.
Попробуйте сами:
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 — это простая песочница для синхронного выполнения недоверенного кода без возможности require. Доступны только встроенные объекты JavaScript и Buffer из Node. Функции планирования (setInterval, setTimeout и setImmediate) по умолчанию недоступны.
Опции:
timeout — тайм-аут скрипта в миллисекундах. ВНИМАНИЕ: возможно, эту опцию стоит использовать вместе с allowAsync=false. Кроме того, операции с возвращёнными из песочницы объектами могут выполнять произвольный код и обходить тайм-аут. Следует проверить с помощью typeof, является ли возвращённый объект примитивом, и в противном случае полностью отбросить его (логирование или создание сообщений об ошибках с таким объектом также может снова выполнить произвольный код).sandbox — глобальный объект VM.compiler — javascript (по умолчанию), typescript, coffeescript или пользовательская функция компилятора. Библиотека предполагает, что компилятор предварительно установлен, если значение равно typescript или coffeescript.eval — если установлено в false, любые вызовы eval или конструкторов функций (Function, GeneratorFunction и т. д.) будут выбрасывать EvalError (по умолчанию: true).wasm — если установлено в false, любая попытка скомпилировать модуль WebAssembly будет выбрасывать WebAssembly.CompileError (по умолчанию: true).allowAsync — если установлено в false, любая попытка выполнить код с использованием async будет выбрасывать VMError (по умолчанию: true).ВАЖНО: тайм-аут действует только на синхронный код, который вы запускаете через run. Тайм-аут НЕ работает ни для одного метода, возвращаемого VM. Есть некоторые ситуации, когда тайм-аут не работает — см. #244.
import { VM } from 'vm2';
const vm = new VM({
timeout: 1000,
allowAsync: false,
sandbox: {},
});
vm.run('process.exit()'); // throws ReferenceError: process is not defined
Вы также можете получать значения из VM.
let number = vm.run('1337'); // returns 1337
СОВЕТ: Дополнительные примеры использования см. в тестах.
В отличие от VM, NodeVM позволяет подключать модули так же, как вы делали бы это в обычном контексте Node.
Опции: