Struct HostSandbox 

pub struct HostSandbox { /* private fields */ }

直接在宿主机上执行命令、读写真实文件系统的 sandbox。

这是默认实现,行为等价于“不沙箱“,不提供任何隔离。

Implementations

impl HostSandbox

pub fn new() -> Self

pub fn with_root(root: impl Into<PathBuf>) -> Self

把命令限定在 root 目录下执行(以它为工作目录)。

注意:这是工作目录级别的限定——相对路径会落在 root 内,但不阻止绝对路径 (如 /etc/...)或 cd .. 逃逸,因此不是安全沙箱,只是“默认在这个目录里干活“。

Trait Implementations

impl Default for HostSandbox

fn default() -> HostSandbox

Returns the “default value” for a type.

impl Sandbox for HostSandbox

fn open<'life0, 'async_trait>( self: Arc<Self>, _session_id: &'life0 str, ) -> Pin<Box<dyn Future<Output = Result<Arc<dyn Sandbox>, SandboxError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

打开或恢复某个 session 对应的 sandbox。实现应保持幂等:同一 session 多次 open 应恢复到同一份状态,并且 bootstrap 逻辑不应重复破坏环境。

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, command: &'life1 str, on_output: Option<OutputCallback>, ) -> Pin<Box<dyn Future<Output = Result<ExecOutput, SandboxError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

执行一条命令并返回结果。

fn save<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), SandboxError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

持久化自身当前状态。实例自己知道 session_id 和存到哪里,故无参。 默认不做事(真机文件系统本来就持久)。

fn fork<'life0, 'life1, 'async_trait>( &'life0 self, _to_session: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), SandboxError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

把自身当前状态复制给另一个会话 to_session。默认不支持。