You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows 11系统下安装配置Docksal的权威推荐方案是什么?

Docksal Win11 安装使用官方方案及问题解答

首先明确:Docksal官方针对Windows 11的优先推荐运行方案为WSL2原生方案,以下是你提到的几个问题的明确答复:

核心问题确认

1. 是否可以仅使用搭载Ubuntu 20.04发行版的WSL2环境运行?

  • 完全可以,这也是当前官方首推的Win11运行方案。仅需要确保你的Windows 11已经开启WSL2嵌套虚拟化,Ubuntu 20.04运行在WSL2模式下即可,不需要依赖Windows侧的额外运行环境。
  • 注意项目文件不要存放在Windows侧的/mnt/c挂载路径下,直接放在WSL2内的Ubuntu文件系统中,可避免IO性能下降和权限异常问题。

2. 是否需要安装Docker Desktop / Docker for Windows?

  • 不需要强制安装,分两种场景可选:
    • 纯WSL2方案无需安装Docker Desktop,直接在WSL2内的Ubuntu 20.04中按照Linux版Docksal安装流程执行即可,所有组件都运行在WSL2内部。
    • 如果你需要在Windows侧的工具直接调用容器命令,也可以安装Docker Desktop并开启WSL2集成,Docksal同样兼容该模式,但属于可选项而非必选项。

3. 能否使用VirtualBox方案运行?

  • Win11下可运行VirtualBox方案,但属于官方不再推荐的legacy方案,当前WSL2的性能、兼容性都远优于VirtualBox方案,除非有特殊虚拟化需求否则不建议选择。如果要使用该方案需要先关闭WSL2的相关虚拟化功能,避免和VirtualBox的监控程序冲突。

IDE及Xdebug配置说明

PhpStorm配置

  • 纯WSL2方案下,直接在PhpStorm中打开WSL2内的项目路径,在设置中将PHP CLI解释器指定为WSL2内Docksal对应的PHP CLI即可,Xdebug默认监听9003端口,在PhpStorm调试设置中开启对应端口监听,配置好服务器路径映射(本地路径和容器内项目路径对应)就能正常进行断点调试。
  • 如果使用Docker Desktop集成方案,配置逻辑一致,仅需要将CLI解释器指定为Docker Desktop集成的对应容器即可。

VSCode配置

  • 安装WSL扩展后直接通过WSL2远程入口打开项目目录,安装PHP Debug扩展,在launch.json中添加9003端口监听配置,启动监听后即可正常触发Xdebug断点,无需额外修改Docksal默认配置。
  • 如使用Docker Desktop集成方案,安装Dev Containers扩展后直接连接对应容器,调试配置逻辑和WSL2方案完全一致。

内容的提问来源于stack exchange,提问作者Tim C

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.24 01:06:07