web-desktop-environment 的安装和配置教程

2025-05-30 12:44:56作者：卓艾滢Kingsley

1. 项目的基础介绍和主要的编程语言

web-desktop-environment 是一个基于网页的跨平台桌面环境。它设计用来提供一个简单直观的方式来管理你的服务器，拥有类似桌面操作系统的界面。这个项目适用于从微型计算机（如 Raspberry Pi）到远程超级计算机或 Docker 容器等多种环境。它的主要编程语言包括 TypeScript 和 JavaScript。

2. 项目使用的关键技术和框架

该项目使用了以下关键技术和框架：

React.js: 在前端和后端都使用 React.js，通过一个专门为其开发的 React 框架来实现紧密的客户端和服务器端响应式连接。
Node.js: 作为服务器的运行环境。
xpra: 允许在网页上运行 X11 应用程序。
PWA (Progressive Web App): 使得项目可以在移动设备上以应用程序的形式运行。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保你的系统中已经安装了以下软件：

Node.js: 版本 16 或更高。
Yarn: 用于管理项目依赖。
Linux 或 macOS: 或者 Windows 上的 WSL (Windows Subsystem for Linux)。

安装步骤

克隆项目仓库

打开终端或命令提示符，执行以下命令来克隆项目仓库：

git clone https://github.com/shmuelhizmi/web-desktop-environment.git
cd web-desktop-environment

安装依赖

在项目目录中，使用 Yarn 安装所有的依赖：
```
yarn install
```
运行服务器

选择你想要运行的服务器版本（家庭版或开发版）：
- 家庭版（不包含 X11 转发和 VS-Code 集成）：
```
yarn global add @web-desktop-environment/home-edition-server
web-desktop-home
```
- 开发版（包含 X11 转发和 VS-Code 集成）：
```
yarn global add @web-desktop-environment/development-edition-server --unsafe-perm
web-desktop-dev
```
安装完成后，终端会显示服务器的端口和凭据信息。
访问网页界面

在浏览器中输入以下地址来访问你的 Web Desktop Environment：
```
http://localhost:{端口号}
```
其中 {端口号} 是终端中显示的端口号。
使用 HTTPS

如果有安全考虑，可以使用 HTTPS 代理（如 ngrok）来访问你的 Web Desktop Environment：
```
https://web-desktop.run/
```