WSL2 Ubuntu‑24.04 OpenSandbox‑Server 完整部署文档环境Windows10/11Docker‑DesktopE盘存放WSL系统本地开发沙箱服务一、开启WSL2功能Windows操作以管理员身份打开 PowerShell执行开启WSL功能wsl--install如果之前装过旧版发行版可以先查看列表wsl-l-v二、离线导入Ubuntu‑24.04安装到E盘不占用C盘本次下载文件ubuntu-noble-wsl-amd64-wsl.rootfs.tar.gz你下载后放到桌面在E盘新建存放目录mkdir E:\wsl\Ubuntu2404导入Ubuntu发行版管理员PowerShell执行wsl--import Ubuntu-24.04 E:\wsl\Ubuntu2404 C:\Users\LENOVO\Desktop\ubuntu-noble-wsl-amd64-wsl.rootfs.tar.gz--version 2查看导入结果wsl-l-v输出示例NAME STATE VERSION * docker-desktop Stopped 2 Ubuntu-24.04 Stopped 2启动Ubuntuwsl-d Ubuntu-24.04⚠️离线导入默认登录用户为 root。三、基础环境配置‑uv工具安装Python包管理器进入Ubuntu终端root账号# 官方脚本安装uvcurl-LsSfhttps://astral.sh/uv/install.sh|sh# 加载环境变量echoexport PATH$HOME/.local/bin:$PATH~/.bashrcsource~/.bashrc# 验证安装uv--versionuvx--version四、Docker‑Desktop 连通配置Windows DockerWindows端先打开 Docker‑Desktop托盘图标显示运行状态。WSL2中Ubuntu可直接访问Windows Docker的socket。五、OpenSandbox‑Server 部署配置1、编写配置文件 .sandbox.toml关闭API鉴权本地开发专用cat/root/.sandbox.tomlEOF [server] host 127.0.0.1 port 8080 log_level INFO [runtime] type docker execd_image sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/execd:v1.0.6 docker_socket /mnt/wsl/docker-desktop/docker.sock [egress] image sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/egress:v1.0.3 [storage] allowed_host_paths [] [docker] network_mode bridge drop_capabilities [AUDIT_WRITE, MKNOD, NET_ADMIN, NET_RAW, SYS_ADMIN, SYS_MODULE, SYS_PTRACE, SYS_TIME, SYS_TTY_CONFIG] no_new_privileges true apparmor_profile seccomp_profile [ingress] mode direct EOF2、无鉴权启动OpenSandbox‑Server核心环境变量OPENSANDBOX_INSECURE_SERVERYES uvx opensandbox-server环境变量OPENSANDBOX_INSECURE_SERVERYES跳过空密钥安全确认弹窗关闭鉴权。六、服务验证新开一个WSL终端窗口服务窗口保持运行1、健康检查测试curlhttp://127.0.0.1:8080/health成功返回结果{status:healthy}2、创建沙箱测试curl-XPOST http://127.0.0.1:8080/v1/sandboxes\-HContent-Type: application/json\-d{timeout_seconds:300}七、常用管理命令速查Windows PowerShell# 查看所有wsl发行版wsl-l-v# 完全关闭所有WSL实例修改配置后重启生效wsl--shutdown# 启动Ubuntu‑24.04wsl-d Ubuntu-24.04# 将Ubuntu设为默认启动项wsl--set-defaultUbuntu-24.04八、Ubuntu(WSL)内部常用命令# 退出wsl返回Windows终端exit# 查看docker socket是否存在连通性排查ls/mnt/wsl/docker-desktop/# 停止opensandbox服务服务窗口按下 Ctrl C九、故障排查记录踩坑清单uvx: command not found→ uv未安装或者环境变量未生效执行source ~/.bashrcruntime字段报错→ toml配置需要嵌套[runtime]不能直接写runtimedocker401 MISSING_API_KEY→ 配置里写了api_key就强制开启鉴权删掉api_key并带上环境变量OPENSANDBOX_INSECURE_SERVERYES启动即可关闭鉴权Docker连接失败→ Windows上Docker‑Desktop必须先启动运行十、当前最终运行参数汇总WSL发行版Ubuntu‑24.04存放路径E:\wsl\Ubuntu2404Sandbox服务地址http://127.0.0.1:8080鉴权状态关闭本地开发Docker后端Windows Docker‑Desktop
WSL2 + Ubuntu‑24.04 + OpenSandbox‑Server 完整部署文档
WSL2 Ubuntu‑24.04 OpenSandbox‑Server 完整部署文档环境Windows10/11Docker‑DesktopE盘存放WSL系统本地开发沙箱服务一、开启WSL2功能Windows操作以管理员身份打开 PowerShell执行开启WSL功能wsl--install如果之前装过旧版发行版可以先查看列表wsl-l-v二、离线导入Ubuntu‑24.04安装到E盘不占用C盘本次下载文件ubuntu-noble-wsl-amd64-wsl.rootfs.tar.gz你下载后放到桌面在E盘新建存放目录mkdir E:\wsl\Ubuntu2404导入Ubuntu发行版管理员PowerShell执行wsl--import Ubuntu-24.04 E:\wsl\Ubuntu2404 C:\Users\LENOVO\Desktop\ubuntu-noble-wsl-amd64-wsl.rootfs.tar.gz--version 2查看导入结果wsl-l-v输出示例NAME STATE VERSION * docker-desktop Stopped 2 Ubuntu-24.04 Stopped 2启动Ubuntuwsl-d Ubuntu-24.04⚠️离线导入默认登录用户为 root。三、基础环境配置‑uv工具安装Python包管理器进入Ubuntu终端root账号# 官方脚本安装uvcurl-LsSfhttps://astral.sh/uv/install.sh|sh# 加载环境变量echoexport PATH$HOME/.local/bin:$PATH~/.bashrcsource~/.bashrc# 验证安装uv--versionuvx--version四、Docker‑Desktop 连通配置Windows DockerWindows端先打开 Docker‑Desktop托盘图标显示运行状态。WSL2中Ubuntu可直接访问Windows Docker的socket。五、OpenSandbox‑Server 部署配置1、编写配置文件 .sandbox.toml关闭API鉴权本地开发专用cat/root/.sandbox.tomlEOF [server] host 127.0.0.1 port 8080 log_level INFO [runtime] type docker execd_image sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/execd:v1.0.6 docker_socket /mnt/wsl/docker-desktop/docker.sock [egress] image sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/egress:v1.0.3 [storage] allowed_host_paths [] [docker] network_mode bridge drop_capabilities [AUDIT_WRITE, MKNOD, NET_ADMIN, NET_RAW, SYS_ADMIN, SYS_MODULE, SYS_PTRACE, SYS_TIME, SYS_TTY_CONFIG] no_new_privileges true apparmor_profile seccomp_profile [ingress] mode direct EOF2、无鉴权启动OpenSandbox‑Server核心环境变量OPENSANDBOX_INSECURE_SERVERYES uvx opensandbox-server环境变量OPENSANDBOX_INSECURE_SERVERYES跳过空密钥安全确认弹窗关闭鉴权。六、服务验证新开一个WSL终端窗口服务窗口保持运行1、健康检查测试curlhttp://127.0.0.1:8080/health成功返回结果{status:healthy}2、创建沙箱测试curl-XPOST http://127.0.0.1:8080/v1/sandboxes\-HContent-Type: application/json\-d{timeout_seconds:300}七、常用管理命令速查Windows PowerShell# 查看所有wsl发行版wsl-l-v# 完全关闭所有WSL实例修改配置后重启生效wsl--shutdown# 启动Ubuntu‑24.04wsl-d Ubuntu-24.04# 将Ubuntu设为默认启动项wsl--set-defaultUbuntu-24.04八、Ubuntu(WSL)内部常用命令# 退出wsl返回Windows终端exit# 查看docker socket是否存在连通性排查ls/mnt/wsl/docker-desktop/# 停止opensandbox服务服务窗口按下 Ctrl C九、故障排查记录踩坑清单uvx: command not found→ uv未安装或者环境变量未生效执行source ~/.bashrcruntime字段报错→ toml配置需要嵌套[runtime]不能直接写runtimedocker401 MISSING_API_KEY→ 配置里写了api_key就强制开启鉴权删掉api_key并带上环境变量OPENSANDBOX_INSECURE_SERVERYES启动即可关闭鉴权Docker连接失败→ Windows上Docker‑Desktop必须先启动运行十、当前最终运行参数汇总WSL发行版Ubuntu‑24.04存放路径E:\wsl\Ubuntu2404Sandbox服务地址http://127.0.0.1:8080鉴权状态关闭本地开发Docker后端Windows Docker‑Desktop
