需要安装 Docker Desktop 并配置好 WSL 2
项目地址:https://github.com/xpipe-io/xpipe-webtop
拉取 XPipe Webtop 镜像
docker pull ghcr.io/xpipe-io/xpipe-webtop:latest
创建并运行 XPipe Webtop 容器
在终端或 PowerShell 中运行以下命令:
docker run -d --name=xpipe-webtop -e SUBFOLDER=/ -p 127.0.0.1:3000:3000 -p 127.0.0.1:3001:3001 -v C:\docker\xpipe\data:/config --restart unless-stopped ghcr.io/xpipe-io/xpipe-webtop:latest
参数说明:
--name=xpipe-webtop:容器名称,便于后续管理。-e SUBFOLDER=/:可选,设置 Web 访问的子文件夹路径。-p 127.0.0.1:3000:3000:将主机的 3000 端口映射到容器的 3000 端口。-v C:\docker\xpipe\data:/config:将主机的C:\docker\xpipe\data目录映射到容器的/config目录,用于持久化数据。--restart unless-stopped:容器会在 Docker 重启后自动启动,除非手动停止。
访问 Web 桌面环境
容器启动后,你可以通过浏览器访问 Web 桌面环境:
打开浏览器,访问 http://127.0.0.1:3000

安装中文字体
进入容器
docker exec -it xpipe-webtop /bin/bash
在容器内运行以下命令来安装中文字体包:
apt-get update
apt-get install -y fonts-noto-cjk
这将安装 Noto CJK 字体,这是一个常用的中文字体,可以支持简体和繁体中文。
如果你希望安装其他中文字体包,比如 WenQuanYi 或 Microsoft YaHei,可以根据需要选择安装。
完成以上步骤后,退出容器并重启它:
docker restart xpipe-webtop
然后重新访问 Webtop,检查中文显示是否正常。

在 Ubuntu 上通过 RDP(远程桌面协议)连接到 Windows 电脑,通常需要使用一个支持 RDP 的客户端工具。最常用的客户端工具是 Remmina,它是一个支持多种协议的远程桌面客户端,包括 RDP、VNC、SSH 等。
在 Ubuntu 上安装 Remmina
sudo apt update
sudo apt install remmina
设置时区符号链接
sudo ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime