PyWinSandbox是一个强大的Python库，用于在Windows Sandbox中创建和控制沙盒环境。它提供了一个简单的RPyC接口，允许你安全地运行潜在危险的代码，而无需担心对你的系统造成损害。本文将深入探讨PyWinSandbox的用法，并通过具体的示例展示其强大的功能。
一、快速上手：安装与配置
PyWinSandbox的安装非常简单，可以使用pip进行安装：
pip3 install -U pywinsandbox如果你想使用最新的代码，可以从GitHub仓库直接安装：
pip3 install -U git+git://github.com/karkason/pywinsandbox.git重要提示: 在使用PyWinSandbox之前，请确保你的系统已启用Windows Sandbox功能。你可以参考微软官方文档了解如何启用Windows Sandbox。
二、核心功能：创建和控制沙盒
PyWinSandbox的核心功能是创建和控制Windows Sandbox实例。通过winsandbox.new_sandbox()函数，你可以创建一个新的沙盒，并通过RPyC接口与之交互。
三、高级用法：定制沙盒环境
PyWinSandbox提供了丰富的选项，允许你根据需要定制沙盒环境。例如，你可以使用folder_mappers参数映射本地目录到沙盒中的桌面，方便数据交换：
import winsandbox
# 创建一个沙盒，并将C:\users\public目录映射到沙盒的桌面
sandbox = winsandbox.new_sandbox(folder_mappers=[winsandbox.FolderMapper(r'C:\users\public')])
# 在沙盒中运行命令，查看映射目录下的文件结构
tree = sandbox.rpyc.modules.subprocess.check_output(r'cmd /c tree %userprofile%\Desktop\public')
print(tree.decode())你还可以通过networking参数控制沙盒的网络连接，并使用logon_script参数指定登录脚本：
# 创建一个离线沙盒，并运行explorer.exe
sandbox = winsandbox.new_sandbox(networking=False, logon_script="explorer .")四、命令行工具：便捷操作
PyWinSandbox还提供了一个命令行工具wsb (或winsandbox)，方便你快速创建和管理沙盒。例如，wsb -i可以创建一个交互式沙盒会话，启动IPython shell：
wsb -i而wsb -s "explorer C:\windows\system32"则可以创建一个离线沙盒，并运行指定的命令：
wsb -s "explorer C:\windows\system32"此外，wsb -r和wsb -u分别用于注册和注销shell扩展，方便你通过右键菜单直接沙盒化可执行文件。(需要管理员权限)
五、Shell扩展：右键菜单集成
PyWinSandbox提供了一个Shell扩展，允许你直接通过右键菜单将可执行文件运行在沙盒中。这极大地简化了沙盒化的流程。记住，你需要以管理员权限运行注册和注销命令：
# 注册shell扩展 (需要管理员权限)
wsb -r
# 注销shell扩展 (需要管理员权限)
wsb -u六、总结
PyWinSandbox是一个功能强大且易于使用的Python库，它简化了在Windows Sandbox中创建和管理沙盒环境的过程。通过其提供的丰富的功能和便捷的命令行工具，你可以轻松地进行安全测试、代码隔离和恶意软件分析等工作，显著提高工作效率和安全性。其Shell扩展更进一步提升了用户体验，让沙盒化操作触手可及。
项目地址：https://github.com/karkason/pywinsandbox
