
Sandbox Node.js para executar JavaScript não confiável no próprio processo, usando Proxies e require controlado para restringir o acesso a módulos internos e externos.
vm2 é um sandbox que pode executar código não confiável com módulos integrados do Node na lista de permissões.
Para uma análise aprofundada do funcionamento interno do vm2, consulte o arquivo CONTRIBUTING.md.
Experimente você mesmo:
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 é uma sandbox simples para executar código não confiável de forma síncrona sem o recurso require. Apenas objetos nativos do JavaScript e o Buffer do Node estão disponíveis. Funções de agendamento (setInterval, setTimeout e setImmediate) não estão disponíveis por padrão.
Opções:
timeout - Tempo limite do script em milissegundos. AVISO: Você pode querer usar esta opção junto com allowAsync=false. Além disso, operar sobre objetos retornados da sandbox pode executar código arbitrário e contornar o tempo limite. Deve-se testar se o objeto retornado é um primitivo com typeof e descartá-lo completamente (fazer logging ou criar mensagens de erro com tal objeto também pode executar código arbitrário novamente) no caso contrário.sandbox - Objeto global da VM.compiler - javascript (padrão), typescript, coffeescript ou função de compilador personalizada. A biblioteca espera que você tenha o compilador pré-instalado se o valor for definido como typescript ou coffeescript.eval - Se definido como false, quaisquer chamadas a eval ou construtores de função (Function, GeneratorFunction, etc.) lançarão um EvalError (padrão: true).wasm - Se definido como false, qualquer tentativa de compilar um módulo WebAssembly lançará um WebAssembly.CompileError (padrão: true).allowAsync - Se definido como false, qualquer tentativa de executar código usando async lançará um VMError (padrão: true).IMPORTANTE: O tempo limite só é efetivo em código síncrono que você executa através de run. O tempo limite NÃO funciona em nenhum método retornado pela VM. Existem algumas situações em que o tempo limite não funciona - veja #244.
import { VM } from 'vm2';
const vm = new VM({
timeout: 1000,
allowAsync: false,
sandbox: {},
});
vm.run('process.exit()'); // throws ReferenceError: process is not defined
Também é possível recuperar valores da VM.
let number = vm.run('1337'); // returns 1337
DICA: Consulte os testes para mais exemplos de uso.
Diferente de VM, o NodeVM permite que você faça require de módulos da mesma forma que faria no contexto normal do Node.
Opções: