Lua Academy · Lezione

Sandbox per l'esecuzione dei plugin

Esegua i plugin in ambienti limitati usando setfenv/load con un _ENV personalizzato.

Sandbox per l'esecuzione dei plugin è una lezione Lua Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Lua Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Lua Academy include 4 lezioni in totale.

Perché eseguire i plugin in sandbox?

Il codice di un plugin non attendibile può chiamare funzioni pericolose (os.execute, io.open, load) o accedere allo stato privato dell'applicazione. Una sandbox limita le operazioni che il codice può eseguire.

_ENV personalizzato in Lua 5.2+

In Lua 5.2+, l'ambiente globale di ogni chunk è _ENV. Carichi un chunk con un _ENV limitato per restringerne l'accesso.

local function sandbox(code, env)
  local chunk, err = load(code, "sandbox", "t", env)
  if not chunk then return nil, err end
  return pcall(chunk)
end

Creazione di un ambiente sicuro

Crei un ambiente con whitelist che includa solo le funzioni sicure della libreria standard.

local safeEnv = {
  print  = print,
  type   = type,
  pairs  = pairs,
  ipairs = ipairs,
  tostring = tostring,
  tonumber = tonumber,
  table  = {insert=table.insert, concat=table.concat, sort=table.sort},
  string = {format=string.format, find=string.find, match=string.match},
  math   = math,
}

Blocco delle funzioni pericolose

Escluda esplicitamente: os, io, load, loadfile, dofile, require, debug. Non le copi in safeEnv.

Caricamento dei file nella sandbox

Carichi un file di plugin ed esegua il codice nell'ambiente sandbox.

local function sandboxFile(path, env)
  local chunk, err = loadfile(path, "t", env)
  if not chunk then return nil, err end
  local ok, result = pcall(chunk)
  if not ok then return nil, result end
  return result
end

Fornitura dell'accesso all'API

Conceda ai plugin in sandbox l'accesso a un'API app limitata, includendo nell'ambiente solo i metodi sicuri.

local pluginEnv = setmetatable({
  app = {
    on       = function(e,f) app:on(e,f) end,
    emit     = function(e,...) app:emit(e,...) end,
    log      = function(msg) app:log(msg) end,
  },
}, {__index = safeEnv})

Prevenzione dell'accesso a _ENV

Non includa _G, _ENV o load nella sandbox. Questi elementi consentono di evadere dall'ambiente limitato.

Conteggio delle istruzioni con debug.sethook

Prevenga i cicli infiniti contando le istruzioni eseguite e interrompendo l'esecuzione dopo un limite.

local function withLimit(fn, maxInstructions)
  local count = 0
  debug.sethook(function()
    count = count + 1
    if count > maxInstructions then
      error("Instruction limit exceeded")
    end
  end, "", 100)
  local ok, err = pcall(fn)
  debug.sethook()
  return ok, err
end

Limite di memoria

Combini il conteggio delle istruzioni con controlli periodici di collectgarbage("count") per interrompere l'esecuzione se l'utilizzo della memoria supera una soglia.

Cattura dell'output

Sostituisca print nell'ambiente sandbox con una funzione personalizzata che catturi l'output in un buffer invece di scriverlo su stdout.

Evasioni dalla sandbox da evitare

Vettori di evasione noti: debug.getupvalue, getmetatable sugli oggetti standard, coroutine.wrap con codice pericoloso. Esamini attentamente tutte le voci dell'ambiente.

Domanda sulla sandbox

Come si impedisce al codice in sandbox di chiamare os.execute?

Riepilogo: sandbox dei plugin

Crei un _ENV con whitelist che includa solo API sicure. Carichi il codice del plugin con load(code, name, "t", safeEnv). Utilizzi il conteggio delle istruzioni per prevenire i cicli infiniti. Non includa mai load, debug o _G nella sandbox.

Domande Frequenti

La lezione «Sandbox per l'esecuzione dei plugin» è gratuita?

Sì — il testo completo di «Sandbox per l'esecuzione dei plugin» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Lua Academy, passa a CoddyKit PRO. Il corso Lua Academy include 4 lezioni in totale.

Cosa imparerò in «Sandbox per l'esecuzione dei plugin»?

Esegua i plugin in ambienti limitati usando setfenv/load con un _ENV personalizzato. Eserciti Lua Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Lua Academy?

Non è richiesta alcuna esperienza precedente. Lua Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «Sandbox per l'esecuzione dei plugin»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Lua Academy?

Sì. Ogni lezione Lua Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

Individuazione e caricamento dei plugin
API dei plugin e sistema degli hook
Sandbox per l'esecuzione dei plugin
Versionamento e gestione delle dipendenze

← Torna a Lua Academy