WinBoat 上手指南4GB 内存起把 Windows 应用跑成 Linux 原生窗口【免费下载链接】winboatRun Windows apps on Linux with ✨ seamless integration项目地址: https://gitcode.com/GitHub_Trending/wi/winboatWinBoat 用容器化方式在 Linux 里跑起一个 Windows 虚拟机再把其中的 Windows 应用通过 FreeRDP 的 RemoteApp 协议合成成系统级窗口直接嵌进你的 Linux 桌面。这篇按我实际跑通的流程写从环境自检、源码构建到首次启动一个 Windows 应用并打通文件共享全程只依赖仓库里现成的命令和配置项。 环境自检跑之前先确认底线不达标后面全白搭内存 ≥4GB分配给 Windows 虚拟机的建议 ≥4GBCPU ≥2 线程且 BIOS/UEFI 已开启 KVM 虚拟化目标磁盘 ≥32GB 可用空间容器运行时DockerCompose v2或 Podman4.x 及以上Compose 同理FreeRDP 3.x需带声音支持两条命令自检都有输出才算过grep -E (vmx|svm) /proc/cpuinfo ls /dev/kvm docker version --format {{.Client.Version}} || podman --version️ 部署流程先装 Bun 和 Goguest server 是 Go 写的构建要它然后在仓库根目录克隆并装前端依赖git clone https://gitcode.com/GitHub_Trending/wi/winboat cd winboat bun i接着跑bun run build:gs编译 guest server——它会被打包成 Windows 开机时自动安装的服务缺了这步装机会卡死。收尾用bun run dev启动 Electron Vite窗口里先走安装向导勾选 Windows 版本Win10 / Win11 Pro、LTSC、Enterprise 等、内存、CPU 核心数、磁盘大小填好用户名和密码。确认后会看到状态从 Creating Compose File 依次走到 Starting Container容器起来并开始轮询 preinstall。当向导状态停在Completed、且仪表盘能拉回 CPU / 内存指标时说明初始化完成。想省掉源码构建的话官方 Releases 里还有 AppImage / .deb / .rpm 预编译包解压或安装后直接运行即可。️ 首次运行体验用 RemoteApp 拉起单个 Windows 应用装好后应用面板里既有 Windows Desktop、Explorer 这类内置项也会列出 guest 里已安装的 Windows 应用。点任意一个它不是弹出一个完整桌面窗口而是以系统级窗口直接落到 Linux 桌面上能像本地程序一样最小化、贴边。办公与开发时的跨系统交互文档、IDE 这类场景最实用的是剪贴板和文件互通RDP 默认带了clipboard以及声音、麦克风参数文字能直接跨系统复制粘贴。文件侧把 Linux 主目录映射进 Windows在 Windows 资源管理器里通过Network\host.lan就能读写本地文件比走剪贴板传大文件省事得多。需要整屏时切完整桌面遇到必须整屏操作的应用面板里的 Windows Desktop 或 Browser Display 能直接开一个完整 Windows 桌面配合多显示器选项MultiMon / Span铺到副屏适合长时间开发。 资源分配与调优档位CPU 核心内存磁盘基础2 核4GB32GB推荐4 核8GB64GB高性能6 核及以上16GB 及以上128GB 及以上改法走图形界面进 Config 页用 RAM Allocation 和 CPU Cores 两个卡片调值点 Save 会写回docker-compose.yml里的RAM_SIZE/CPU_CORES环境变量下次启动容器生效。文件共享和网络也在这页一起管打开 Shared Folder 把主目录挂进 Windows对应Network\host.lan并可用 Auto Start Container 让 Windows 随系统自启WinBoat 会在127.0.0.1的 47270–47274 端口段起 RDP、Guest API 等服务一般不用动。 踩坑速查容器起来了但界面卡在 Installing Windows现象是向导停在 Installing Windows 不动——多半是 guest 的 health API 还没就绪先docker ps找到 WinBoat 容器再docker logs 容器名看它是否还在跑 Windows 首启。资源面板的 Save 按钮点不动保存被禁或下方飘红几乎都是分配值踩了校验线CPU 低于 2 核、或内存低于最低值都会被拦。把 CPU 调到 ≥2、内存提到建议的 4GB 以上Save 就会点亮。Podman 下 USB 直通不可用或安装失败用 Podman 当运行时USB passthrough 目前不受支持且apt装的 Podman 可能低于 4.x 导致安装流程失败。要么升级到 Podman 4.x 以上要么换 Docker 运行时再走 experimental 特性里的 USB 直通。 后续方向与延伸阅读项目仍在 beta官方口径属于 Work in Progress近期在补的方向包括把 USB passthrough 从 experimental 转正、完善多显示器与资源监控以及补齐 Podman 侧的 USB 直通目前 Docker Desktop 与 Podman 直通仍有已知限制。想看 guest 与宿主怎么通信可以从 guest_server 模块 入手端口映射、KVM / 内存这些硬约束都集中在 src/renderer/lib/constants.ts。下一步建议你先在 Config 页点一次 Save把 RAM 和 CPU 固定成推荐档再回头对照Network\host.lan验证共享目录确实能读写——这一步通了后面加应用就只是点点图标的事。【免费下载链接】winboatRun Windows apps on Linux with ✨ seamless integration项目地址: https://gitcode.com/GitHub_Trending/wi/winboat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 WinBoat 上手指南：4GB 内存起，把 Windows 应用跑成 Linux 原生窗口
WinBoat 上手指南4GB 内存起把 Windows 应用跑成 Linux 原生窗口【免费下载链接】winboatRun Windows apps on Linux with ✨ seamless integration项目地址: https://gitcode.com/GitHub_Trending/wi/winboatWinBoat 用容器化方式在 Linux 里跑起一个 Windows 虚拟机再把其中的 Windows 应用通过 FreeRDP 的 RemoteApp 协议合成成系统级窗口直接嵌进你的 Linux 桌面。这篇按我实际跑通的流程写从环境自检、源码构建到首次启动一个 Windows 应用并打通文件共享全程只依赖仓库里现成的命令和配置项。 环境自检跑之前先确认底线不达标后面全白搭内存 ≥4GB分配给 Windows 虚拟机的建议 ≥4GBCPU ≥2 线程且 BIOS/UEFI 已开启 KVM 虚拟化目标磁盘 ≥32GB 可用空间容器运行时DockerCompose v2或 Podman4.x 及以上Compose 同理FreeRDP 3.x需带声音支持两条命令自检都有输出才算过grep -E (vmx|svm) /proc/cpuinfo ls /dev/kvm docker version --format {{.Client.Version}} || podman --version️ 部署流程先装 Bun 和 Goguest server 是 Go 写的构建要它然后在仓库根目录克隆并装前端依赖git clone https://gitcode.com/GitHub_Trending/wi/winboat cd winboat bun i接着跑bun run build:gs编译 guest server——它会被打包成 Windows 开机时自动安装的服务缺了这步装机会卡死。收尾用bun run dev启动 Electron Vite窗口里先走安装向导勾选 Windows 版本Win10 / Win11 Pro、LTSC、Enterprise 等、内存、CPU 核心数、磁盘大小填好用户名和密码。确认后会看到状态从 Creating Compose File 依次走到 Starting Container容器起来并开始轮询 preinstall。当向导状态停在Completed、且仪表盘能拉回 CPU / 内存指标时说明初始化完成。想省掉源码构建的话官方 Releases 里还有 AppImage / .deb / .rpm 预编译包解压或安装后直接运行即可。️ 首次运行体验用 RemoteApp 拉起单个 Windows 应用装好后应用面板里既有 Windows Desktop、Explorer 这类内置项也会列出 guest 里已安装的 Windows 应用。点任意一个它不是弹出一个完整桌面窗口而是以系统级窗口直接落到 Linux 桌面上能像本地程序一样最小化、贴边。办公与开发时的跨系统交互文档、IDE 这类场景最实用的是剪贴板和文件互通RDP 默认带了clipboard以及声音、麦克风参数文字能直接跨系统复制粘贴。文件侧把 Linux 主目录映射进 Windows在 Windows 资源管理器里通过Network\host.lan就能读写本地文件比走剪贴板传大文件省事得多。需要整屏时切完整桌面遇到必须整屏操作的应用面板里的 Windows Desktop 或 Browser Display 能直接开一个完整 Windows 桌面配合多显示器选项MultiMon / Span铺到副屏适合长时间开发。 资源分配与调优档位CPU 核心内存磁盘基础2 核4GB32GB推荐4 核8GB64GB高性能6 核及以上16GB 及以上128GB 及以上改法走图形界面进 Config 页用 RAM Allocation 和 CPU Cores 两个卡片调值点 Save 会写回docker-compose.yml里的RAM_SIZE/CPU_CORES环境变量下次启动容器生效。文件共享和网络也在这页一起管打开 Shared Folder 把主目录挂进 Windows对应Network\host.lan并可用 Auto Start Container 让 Windows 随系统自启WinBoat 会在127.0.0.1的 47270–47274 端口段起 RDP、Guest API 等服务一般不用动。 踩坑速查容器起来了但界面卡在 Installing Windows现象是向导停在 Installing Windows 不动——多半是 guest 的 health API 还没就绪先docker ps找到 WinBoat 容器再docker logs 容器名看它是否还在跑 Windows 首启。资源面板的 Save 按钮点不动保存被禁或下方飘红几乎都是分配值踩了校验线CPU 低于 2 核、或内存低于最低值都会被拦。把 CPU 调到 ≥2、内存提到建议的 4GB 以上Save 就会点亮。Podman 下 USB 直通不可用或安装失败用 Podman 当运行时USB passthrough 目前不受支持且apt装的 Podman 可能低于 4.x 导致安装流程失败。要么升级到 Podman 4.x 以上要么换 Docker 运行时再走 experimental 特性里的 USB 直通。 后续方向与延伸阅读项目仍在 beta官方口径属于 Work in Progress近期在补的方向包括把 USB passthrough 从 experimental 转正、完善多显示器与资源监控以及补齐 Podman 侧的 USB 直通目前 Docker Desktop 与 Podman 直通仍有已知限制。想看 guest 与宿主怎么通信可以从 guest_server 模块 入手端口映射、KVM / 内存这些硬约束都集中在 src/renderer/lib/constants.ts。下一步建议你先在 Config 页点一次 Save把 RAM 和 CPU 固定成推荐档再回头对照Network\host.lan验证共享目录确实能读写——这一步通了后面加应用就只是点点图标的事。【免费下载链接】winboatRun Windows apps on Linux with ✨ seamless integration项目地址: https://gitcode.com/GitHub_Trending/wi/winboat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考