WinBoat 上手手册4 个场景在 Linux 桌面运行 Windows 应用【免费下载链接】winboatRun Windows apps on Linux with ✨ seamless integration项目地址: https://gitcode.com/GitHub_Trending/wi/winboatWinBoat 是一款处于 beta 阶段的开源工具能把 Windows 应用以原生窗口的形式跑在 Linux 桌面上。它基于 Docker 容器 KVM FreeRDP 的技术路线适合偶尔需要 Windows 办公软件的桌面用户以及需要 Windows 测试环境的开发者。项目定位3 句话看懂技术路线这一节帮你判断它适不适合你的使用习惯。WinBoat 本体是一个 Electron 桌面程序核心思路是容器化虚拟化Windows 作为 KVM 虚拟机运行在 Docker 或 Podman 容器里而不是直接开一台传统虚拟机。一个用 Go 编写的 Guest Server 常驻 Windows 内部通过 HTTP 接口向外提供应用列表和资源指标实现见 guest_server/cmd/server/main.go。至于原生窗口效果它靠 FreeRDP 配合 Windows 的 RemoteApp 协议把应用界面直接合成到你的 Linux 桌面上你的主目录同时会被自动挂载进 Windows跨系统传文件不需要额外配置。30 秒检查环境并完成安装这一节带你走最短路径完成首次部署。官方提供 AppImage、.deb、.rpm 和 Unpacked 四种 Linux 安装包按你的发行版选一个即可如果你想自己编译需要装好 Bun 和 Gogit clone https://gitcode.com/GitHub_Trending/wi/winboat cd winboat bun i bun run build:linux-gs产物会输出到dist目录打包配置见 electron-builder.json。启动前先用下面几条命令确认硬件达标官方最低要求为 4 GB 内存、2 个 CPU 线程、32 GB 可用磁盘并在 BIOS/UEFI 中开启 KVMgrep -c ^processor /proc/cpuinfo # CPU 线程数 grep -E vmx|svm /proc/cpuinfo # KVM 支持 docker --version docker compose version xfreerdp3 --version # 需 3.x 且带声音支持两点注意Docker Desktop 不被支持选 Podman 的话版本需 4.x 以上。首次打开 WinBoat 会进入向导只需选定 Windows 版本和语言镜像下载与虚拟机配置全部自动完成安装过程日志会写入install.log流程逻辑在 src/renderer/lib/install.ts。场景一启动办公应用这一节解决最高频的需求——打开某个 Windows 软件。装完后进 Apps 页面Windows 里已装的应用都会列出来图标由 Guest Server 端脚本抓取点一下就会以独立窗口出现在你的 Linux 桌面。如果列表为空或刷新失败多半是容器没起来docker ps # 确认 windows 容器在运行 docker compose restart windows场景二Linux 与 Windows 共享文件这一节解决文档互拷的问题。你的主目录会被自动挂载进 Windows在 Windows 资源管理器里直接就能看到 Linux 的文件反过来走网络共享host.lan也能访问宿主机目录不需要手工建共享。想核对挂载是否正确在宿主机执行docker ps docker inspect $(docker ps -q --filter namewindows) --format {{json .Mounts}}场景三USB 与打印机直通这一节解决接打印机、加密狗等硬件的需求。在 Configuration 页面可以查看当前接入的 USB 设备并开关直通设备识别依赖 Linux 的usb.ids数据库仓库内副本见 data/usb.ids。插设备前先记录厂商 IDlsusb需要知道USB 直通目前仅支持 Docker 运行时Podman 用户暂不可用。场景四批量部署与二次开发这一节面向要标准化一套 Windows 环境的团队或想魔改源码的开发者。整个构建是脚本驱动的Go 写的 Guest Server 和 Vue Vite 前端一起编译入口脚本在 scripts/ 下。构建出的 AppImage 分发到各台机器每台再按前面的向导完成各自的容器化 Windowsbun run build:gs # 仅构建 Guest Server开发模式用 bun run dev # 开发模式运行进阶监控、调优与排错对照这一节把资源监控、性能调优和故障排查合并成现象 → 排查命令的对照表出问题时直接对号入座应用窗口打不开或连接中断→ 先docker ps看容器状态再xfreerdp3 --version确认 FreeRDP 是 3.x资源占用高→ Home 页有 CPU/内存/磁盘三个实时仪表盘Guest Server 用 gopsutil 采集见 guest_server/宿主机侧配合docker stats交叉验证网络偏慢→ 加载 iptables/nftables 内核模块可改善性能详见 README.mdUSB 设备不出现→ 用lsusb核对 ID并确认运行的是 Docker 而非 PodmanWinBoat 目前仍在快速迭代当前 0.9.0使用中偶有小 bug 属正常现象。想继续深入建议按这个顺序看环境要求与构建流程 README.md#prerequisites、贡献指南 CONTRIBUTING.md、安全策略 SECURITY.md、许可证 LICENSE。【免费下载链接】winboatRun Windows apps on Linux with ✨ seamless integration项目地址: https://gitcode.com/GitHub_Trending/wi/winboat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
WinBoat 上手手册：4 个场景在 Linux 桌面运行 Windows 应用
WinBoat 上手手册4 个场景在 Linux 桌面运行 Windows 应用【免费下载链接】winboatRun Windows apps on Linux with ✨ seamless integration项目地址: https://gitcode.com/GitHub_Trending/wi/winboatWinBoat 是一款处于 beta 阶段的开源工具能把 Windows 应用以原生窗口的形式跑在 Linux 桌面上。它基于 Docker 容器 KVM FreeRDP 的技术路线适合偶尔需要 Windows 办公软件的桌面用户以及需要 Windows 测试环境的开发者。项目定位3 句话看懂技术路线这一节帮你判断它适不适合你的使用习惯。WinBoat 本体是一个 Electron 桌面程序核心思路是容器化虚拟化Windows 作为 KVM 虚拟机运行在 Docker 或 Podman 容器里而不是直接开一台传统虚拟机。一个用 Go 编写的 Guest Server 常驻 Windows 内部通过 HTTP 接口向外提供应用列表和资源指标实现见 guest_server/cmd/server/main.go。至于原生窗口效果它靠 FreeRDP 配合 Windows 的 RemoteApp 协议把应用界面直接合成到你的 Linux 桌面上你的主目录同时会被自动挂载进 Windows跨系统传文件不需要额外配置。30 秒检查环境并完成安装这一节带你走最短路径完成首次部署。官方提供 AppImage、.deb、.rpm 和 Unpacked 四种 Linux 安装包按你的发行版选一个即可如果你想自己编译需要装好 Bun 和 Gogit clone https://gitcode.com/GitHub_Trending/wi/winboat cd winboat bun i bun run build:linux-gs产物会输出到dist目录打包配置见 electron-builder.json。启动前先用下面几条命令确认硬件达标官方最低要求为 4 GB 内存、2 个 CPU 线程、32 GB 可用磁盘并在 BIOS/UEFI 中开启 KVMgrep -c ^processor /proc/cpuinfo # CPU 线程数 grep -E vmx|svm /proc/cpuinfo # KVM 支持 docker --version docker compose version xfreerdp3 --version # 需 3.x 且带声音支持两点注意Docker Desktop 不被支持选 Podman 的话版本需 4.x 以上。首次打开 WinBoat 会进入向导只需选定 Windows 版本和语言镜像下载与虚拟机配置全部自动完成安装过程日志会写入install.log流程逻辑在 src/renderer/lib/install.ts。场景一启动办公应用这一节解决最高频的需求——打开某个 Windows 软件。装完后进 Apps 页面Windows 里已装的应用都会列出来图标由 Guest Server 端脚本抓取点一下就会以独立窗口出现在你的 Linux 桌面。如果列表为空或刷新失败多半是容器没起来docker ps # 确认 windows 容器在运行 docker compose restart windows场景二Linux 与 Windows 共享文件这一节解决文档互拷的问题。你的主目录会被自动挂载进 Windows在 Windows 资源管理器里直接就能看到 Linux 的文件反过来走网络共享host.lan也能访问宿主机目录不需要手工建共享。想核对挂载是否正确在宿主机执行docker ps docker inspect $(docker ps -q --filter namewindows) --format {{json .Mounts}}场景三USB 与打印机直通这一节解决接打印机、加密狗等硬件的需求。在 Configuration 页面可以查看当前接入的 USB 设备并开关直通设备识别依赖 Linux 的usb.ids数据库仓库内副本见 data/usb.ids。插设备前先记录厂商 IDlsusb需要知道USB 直通目前仅支持 Docker 运行时Podman 用户暂不可用。场景四批量部署与二次开发这一节面向要标准化一套 Windows 环境的团队或想魔改源码的开发者。整个构建是脚本驱动的Go 写的 Guest Server 和 Vue Vite 前端一起编译入口脚本在 scripts/ 下。构建出的 AppImage 分发到各台机器每台再按前面的向导完成各自的容器化 Windowsbun run build:gs # 仅构建 Guest Server开发模式用 bun run dev # 开发模式运行进阶监控、调优与排错对照这一节把资源监控、性能调优和故障排查合并成现象 → 排查命令的对照表出问题时直接对号入座应用窗口打不开或连接中断→ 先docker ps看容器状态再xfreerdp3 --version确认 FreeRDP 是 3.x资源占用高→ Home 页有 CPU/内存/磁盘三个实时仪表盘Guest Server 用 gopsutil 采集见 guest_server/宿主机侧配合docker stats交叉验证网络偏慢→ 加载 iptables/nftables 内核模块可改善性能详见 README.mdUSB 设备不出现→ 用lsusb核对 ID并确认运行的是 Docker 而非 PodmanWinBoat 目前仍在快速迭代当前 0.9.0使用中偶有小 bug 属正常现象。想继续深入建议按这个顺序看环境要求与构建流程 README.md#prerequisites、贡献指南 CONTRIBUTING.md、安全策略 SECURITY.md、许可证 LICENSE。【免费下载链接】winboatRun Windows apps on Linux with ✨ seamless integration项目地址: https://gitcode.com/GitHub_Trending/wi/winboat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
