最完整的Winboat安装指南：从0到1搭建跨系统应用环境

你是否还在为Linux系统下无法运行Windows专属软件而困扰？是否尝试过多种虚拟机方案却被复杂的配置和糟糕的性能劝退？Winboat作为一款专为Linux设计的跨系统应用工具，通过容器化技术实现Windows应用的无缝集成。本文将带你从环境准备到应用运行，完成Winboat的全流程安装，让Linux桌面也能流畅运行Windows软件。

环境准备：系统要求与依赖检查

Winboat基于Docker容器和KVM虚拟化技术实现Windows应用运行，在开始安装前需确保系统满足以下条件：

硬件要求

• CPU：至少2核心（推荐4核心及以上），需支持硬件虚拟化技术（Intel VT-x/AMD-V）
• 内存：至少4GB（Windows系统运行建议分配4GB以上）
• 存储：至少32GB空闲空间（推荐64GB以保证应用安装需求）

软件依赖

Winboat运行依赖以下组件，需提前安装并配置：

依赖项	版本要求	作用	安装验证命令
Docker	最新稳定版	容器运行环境	docker --version
Docker Compose	v2+	容器编排工具	docker compose version
KVM模块	系统内置	硬件虚拟化支持	`lsmod
FreeRDP	3.x.x+	远程应用显示	xfreerdp --version

⚠️ 注意：Docker Desktop和Podman目前不被支持，需使用原生Docker引擎。用户必须加入docker用户组以避免权限问题：sudo usermod -aG docker $USER

安装流程：从源码到运行的五步实现

1. 获取Winboat源码

通过Git克隆官方仓库到本地：

git clone https://gitcode.com/GitHub_Trending/wi/winboat
cd winboat

项目结构中，与安装相关的核心文件包括：

• package.json：项目元数据和构建脚本
• guest_server/install.bat：Windows guest环境配置脚本
• src/renderer/lib/install.ts：安装流程控制逻辑

2. 安装构建依赖

Winboat使用Node.js构建前端界面，使用Go语言开发guest server组件。执行以下命令安装依赖：

# 安装Node.js依赖
npm install

# 构建guest server
npm run build-guest-server

构建过程会编译guest_server/main.go中的Go代码，生成Windows环境所需的服务端程序。

3. 配置Docker环境

Winboat通过Docker Compose管理Windows容器，默认配置文件定义了资源分配和端口映射规则。关键配置项位于src/renderer/lib/install.ts中的DefaultCompose对象：

export const DefaultCompose: ComposeConfig = {
  "name": "winboat",
  "services": {
    "windows": {
      "image": "ghcr.io/dockur/windows:5.07",
      "environment": {
        "RAM_SIZE": "4G",       // 默认内存分配
        "CPU_CORES": "4",       // CPU核心数
        "DISK_SIZE": "64G"      // 磁盘大小
      },
      "ports": [
        "8006:8006",            // VNC管理界面
        "7148:7148",            // Guest Server API
        "3389:3389/tcp"         // RDP协议端口
      ]
    }
  }
}

可根据硬件配置修改这些参数，例如增加内存分配或调整CPU核心数。

4. 启动安装向导

执行开发模式命令启动图形化安装向导：

npm run dev

向导界面会引导完成以下配置：

• 资源分配（内存、CPU、磁盘）
• Windows版本选择（支持Windows 10/11）
• 用户账户设置
• 文件共享配置

安装过程中，程序会自动创建Docker容器并执行Windows安装流程。关键步骤包括：

• 创建Docker Compose文件（src/renderer/lib/install.ts#L116-174）
• 生成OEM配置文件（src/renderer/lib/install.ts#L175-240）
• 启动容器并监控安装进度（src/renderer/lib/install.ts#L241-340）

5. 验证安装状态

安装完成后，可通过以下命令检查容器运行状态：

docker ps --filter "name=WinBoat"

正常运行时会显示类似输出：

CONTAINER ID   IMAGE                          COMMAND       STATUS         PORTS                                                                 
abc123         ghcr.io/dockur/windows:5.07   "/init"       Up 5 minutes   0.0.0.0:3389->3389/tcp, 0.0.0.0:8006->8006/tcp, 0.0.0.0:7148->7148/tcp

界面导览：Winboat工作区介绍

安装完成后，Winboat提供直观的图形界面管理Windows应用。主要功能区域包括：

控制面板

主界面左侧为控制面板，显示系统状态和资源使用情况。可通过src/renderer/views/Home.vue查看实现代码，核心监控指标包括CPU使用率、内存占用和磁盘空间。

应用启动器

安装完成后，Windows应用会自动出现在启动器中。应用列表数据来源于：

• src/renderer/data/appgroups.ts：应用分类定义
• src/renderer/data/internalapps.ts：系统工具定义

文件共享

默认配置下，Linux主目录会挂载到Windows系统的/shared路径，实现跨系统文件访问。共享逻辑在Docker卷配置中定义：

volumes:
  - "${HOME}:/shared"  # 主机目录共享

常见问题：安装过程中的疑难解决

KVM权限问题

若启动时报错/dev/kvm permission denied，需将当前用户添加到kvm用户组：

sudo usermod -aG kvm $USER
newgrp kvm  # 立即应用组变更

端口冲突

Docker容器默认使用3389（RDP）、8006（VNC）等端口，若提示端口占用，可通过src/renderer/lib/install.ts中的PortManager类自动分配可用端口。

安装卡在"Starting Container"

此问题通常由于Docker服务未启动或权限不足导致，可通过以下步骤排查：

1. 检查Docker状态：systemctl status docker
2. 查看容器日志：docker logs WinBoat
3. 验证安装日志：cat ~/.winboat/install.log

应用运行：从安装到启动的完整体验

成功安装后，可通过两种方式运行Windows应用：

1. 图形界面启动

在Winboat主界面的"应用"标签页中，点击应用图标即可启动。首次运行会通过FreeRDP建立连接，应用窗口将无缝集成到Linux桌面环境。

2. 命令行启动

通过winboat命令直接启动指定应用：

# 列出可用应用
npm run dev -- --list-apps

# 启动记事本
npm run dev -- --run "Notepad"

总结与展望

Winboat通过容器化技术和RDP协议，实现了Windows应用在Linux系统的接近原生体验。随着项目的持续迭代，未来版本将支持更多高级特性：

• USB设备直通（开发中，见src/renderer/lib/usbmanager.ts）
• 3D加速支持
• 应用性能优化

通过本文的安装指南，你已掌握Winboat的完整部署流程。如需进一步定制或参与开发，可查阅项目源代码或提交Issue反馈使用体验。

项目文档：README.md
开发指南：src/main/main.ts
问题反馈：项目Issues页面