1 基础知识

1.1 WinBoat的特点

– WinBoat提供简介直观的界面，可将Windows无缝继承到你的Linux桌面环境，让你感觉就像在原生系统一样。
– WinBoat安装Windows系统非常简单，所有操作均可通过界面完成。
– WinBoat上的程序能在Windows上运行，就能在WinBoat上运行而且像使用原生操作系统级别的窗口一样。
– WinBoat从Windows中访问Linux文件系统非常便捷，主目录已挂在到Windows系统中，因此可轻松在两个系统之间共享文件。
– WinBoat后续会添加例如智能卡直通和资源监控。

1.2 硬件要求

– 内存，至少4GB的内存
– CPU,至少2个CPU线程
– 存储，安装文件夹对应的驱动器至少32GB的可用空间
– 虚拟化，在BIOS/UEFI中启用KVM

1.3 容器化

1.3.1 Docker使用范例

– Docker的使用方法？
– Docker Compose v2如何使用？
– 用户已经添加到docker群组如何操作？
– Docker守护进程正在运行（开机启动时也已启动），如何实现？

1.3.2 Podman使用范例

– Podman如何使用？
– Podman如何创建？

1.4 FreeRDP

请确保版本为3.x.x并且包括声音支持，如何操作？

2 最佳实践

2.1 环境信息

2.1.1 系统环境

OS = Ubuntu 24.04.4 LTS
Host Name = any
IP Address = any

2.1.2 安装Podman

如何Apt部署Ubuntu 24.04.4 LTS podman？

执行“2.2.1章节”完成基本安装即可

2.1.3 安装Podman Compose

如何安装部署podman-compose？

2.1.4 安装FreeRDP

apt install -y freerdp3-x11

2.1.5 创建WinBoat容器安装目录（可选）

sudo sudo mkdir -p /home/podman
sudo chown $(id -u):$(id -g) /home/podman
sudo chmod 770 /home/podman

2.2 部署软件包

2.2.1 下载软件包

cd ~/Downloads/
wget -O winboat-0.9.0-amd64.deb https://release-assets.githubusercontent.com/github-production-release-asset/960420129/3ab478be-ff75-4bd7-a9da-20b1a56cf770?sp=r&sv=2018-11-09&sr=b&spr=https&se=2026-04-07T01%3A28%3A17Z&rscd=attachment%3B+filename%3Dwinboat-0.9.0-amd64.deb&rsct=application%2Foctet-stream&skoid=96c2d410-5711-43a1-aedd-ab1947aa7ab0&sktid=398a6654-997b-47e9-b12b-9515b896b4de&skt=2026-04-07T00%3A27%3A49Z&ske=2026-04-07T01%3A28%3A17Z&sks=b&skv=2018-11-09&sig=B3vzsStIE3yUbVZiBQmuNn%2B4aQaeRj%2F4maLWD1vxOuk%3D&jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmVsZWFzZS1hc3NldHMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwia2V5Ijoia2V5MSIsImV4cCI6MTc3NTUyNDk4NCwibmJmIjoxNzc1NTIzMTg0LCJwYXRoIjoicmVsZWFzZWFzc2V0cHJvZHVjdGlvbi5ibG9iLmNvcmUud2luZG93cy5uZXQifQ._kLex_gZsDVvtSvWQEFA6U3JwTd3UOmBvms-m6r-Qak&response-content-disposition=attachment%3B%20filename%3Dwinboat-0.9.0-amd64.deb&response-content-type=application%2Foctet-stream

以上只是命令行演示，如果异常或需要其他版本，请从官方连接下载，
https://winboat.app/

2.2.2 安装软件包

cd ~/Downloads/
sudo apt install ./winboat-0.9.0-amd64.deb

2.3 配置WinBoat

如上图所示，
单击【Next】
窗口显示如下，

如上图所示，
单击【I Agree】
窗口显示如下，

如上图所示，
选择【Podman】作为容器
单击【Next】
窗口显示如下，

如上图所示，
选择安装目录，本范例选择之前预选创建的“/home/podman”目录作为WinBoat容器安装目录
单击【Next】
窗口显示如下，

如上图所示，
本范例使用默认选项
单击【Next】
窗口显示如下，

如上图所示，
选项“Username”填写你系统的用户名，当前范例为“will”
选项“Password”填写你系统的密码，当前范例为“********”
选项“Confirm Password”填写你系统的密码，当前范例为“********”
单击【Next】
窗口显示如下，

如上图所示，
调整容器的硬件配置，本范例使用默认配置（支持安装完成后调整）
单击【Next】
窗口显示如下，

如上图所示，
勾选选项“Enable home folder sharing”
单击【Next】
窗口显示如下，

如上图所示，
核对之前的选择，如果符合你的预期
单击【Next】
窗口显示如下，

如果遇到以上错误，可以使用如下命令检查日志，

cat ~/.winboat/install.log
cat ~/.winboat/container.log

如果遇到如下错误，

Error: initializing source docker://ghcr.io/dockur/windows:5.14: pinging container registry ghcr.io: Get "https://ghcr.io/v2/": tls: failed to verify certificate: x509: certificate signed by unknown authority
exit code: 125
podman start WinBoat
Error: no container with name or ID "WinBoat" found: no such container
exit code: 125

你需要使用如下命令修复错误，

sudo apt update && sudo apt install -y ca-certificates
sudo update-ca-certificates
systemctl --user restart podman

然后，执行以下命令后并重试安装，

podman stop WinBoat 2>/dev/null
podman rm WinBoat 2>/dev/null
rm -rf /home/podman/winboat
rm -rf ~/.winboat

如果仍然无法解决，可尝试使用如下命令手动获取镜像，

sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 $USER
podman system migrate
podman system prune -a -f
podman pull --tls-verify=false ghcr.io/dockur/windows:5.14

然后，使用如下命令检查，

podman images

正常可见如下显示，

REPOSITORY              TAG         IMAGE ID      CREATED       SIZE
ghcr.io/dockur/windows  5.14        1d1c11048017  4 months ago  387 MB

修正以上错误后，请重试并知道安装完毕。

参阅文档
===============
官方首页
————
https://winboat.app/

官方github
————–
https://github.com/TibixDev/winboat

github错误
————
https://github.com/TibixDev/winboat/issues/262