LightOS 攻略

# LightOS > 本文用于介绍 LightOS 的主要能力、适用场景、安装方式和核心功能说明。 > 文中的界面、版本和镜像列表可能会随应用更新而变化，请以实际界面显示为准。 LightOS 是懒猫微服自研的一套轻量化容器编排平台，和 LPK 深度集成，提供 WebShell、远程桌面、GUI 应用接入本地等能力。它适合拿来做远程开发环境、轻量桌面系统、局域网服务节点，以及接显示器直接使用的桌面主机。 ## LightOS 是什么如果把 LightOS 当成一个“可快速创建的系统容器”，会更容易理解它的定位。你可以在 LightOS 里： - 创建一套独立的 Linux 系统环境 - 使用 WebShell 在浏览器里直接操作终端 - 配置 XRDP，通过 RDP 远程访问桌面 - 挂载懒猫网盘，在系统里直接访问数据 - 使用快照快速回退系统状态 - 通过 HDMI 把某个容器当作桌面主机使用它更像是“带管理界面的 Linux 系统容器”，而不是传统意义上的虚拟机。 ## 适合哪些场景 LightOS 常见的使用方式主要有三类： - 远程桌面主机：适合需要从 Windows、macOS、Linux 远程接入桌面的用户 - 开发与运维环境：适合需要长期保留终端会话、安装开发工具、跑脚本和调试服务的用户 - 桌面主机：适合通过 HDMI 接显示器、键盘和鼠标，直接把微服当作一台轻量 Linux 电脑来使用如果你是第一次接触，建议优先按“远程桌面”或“WebShell + 开发环境”这两个场景来理解和配置。 ## 安装入口应用商店地址： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.lightos.entry 在商店中下载并打开 LightOS 后，需要创建一个系统实例。创建流程分为三步： - 基础页面设置 - 网络界面设置 - 身份页面设置 ## 远程桌面安装使用流程按照本文操作一步步执行，即可安装成功。 > ⚠️注意：如果不需要远程桌面，可以不勾选桌面环境 > ⚠️注意：debian 13 的 node 版本是 18，有些应用需要更高的版本，推荐使用脚本安装 nvm + node lts 这个版本是 node 24 ### 1. 创建系统打开 LightOS，新建一个系统实例。 ### 2. 基础页面 - 系统镜像：`Debian Stable` - 镜像仓库：`registry.lazycat.cloud` - 基础软件包：桌面环境选 `XFCE` - 常用 CLI 工具：勾选 - 国内源：选择 USTC ![基础页面png](https://dl.playground.lazycat.cloud/guidelines/1279/f45fefa3-667b-4588-8819-90b20b6c5a31.png) 选完后点击**下一步**。 ### 3. 网络页面 - 网络模式：选择 `Nat` - SSH：保持开启 - 挂载 `/lzcsys/data/document`：选择开启，挂载后可以获取懒猫网盘的数据。 - `/dev`：选择开启 ![网络页面png](https://dl.playground.lazycat.cloud/guidelines/1279/86d8b879-3dd1-4baa-8ad2-7ea1d17c0645.png) 选完后点击**下一步**。 ### 4. 身份页面 - 操作系统名称：debian，自定义即可 - 用户名：一般有默认值，自定义即可 - 密码：设置一个登录系统的密码 - 语言：建议选择中文（简体） ![身份页面png](https://dl.playground.lazycat.cloud/guidelines/1279/a48eaad3-85c1-41b0-b496-b6655152aeea.png) 设置完成后点击**创建**。 ### 5. 等待构建完成 ![构建页面png](https://dl.playground.lazycat.cloud/guidelines/1279/a29275d7-8992-42de-afb3-7b2b3649b5ea.png) 构建完成后，界面会显示安装完成提示。 ![image20260403232303473](https://dl.playground.lazycat.cloud/guidelines/1128/image-20260403232303473.png?imageSlim) 点击**知道了**返回主页面。 ![imagepng](https://dl.playground.lazycat.cloud/guidelines/1279/69053ea4-adb6-4458-b2c8-4df738291db9.png) ### 6. 安装 XRDP 系统创建完成后，开启 SSH 转发，再进入 WebShell。 ![进入png](https://dl.playground.lazycat.cloud/guidelines/1279/0c9125da-b609-4c86-b47b-649a20564815.png) ![自定义ssh端口.png](https://dl.playground.lazycat.cloud/guidelines/1279/e72e9baa-559f-49d7-ade1-f0ef2a23ba25.png "自定义ssh端口.png") 我们这边提供了快速安装脚本，可以使用脚本来进行下载。执行以下命令： ```bash sudo apt update sudo apt install -y wget wget https://gitee.com/longxiaoyi-00/lzc-scripts/raw/main/fix-lightos.sh chmod +x fix-lightos.sh ./fix-lightos.sh ``` ![脚本菜单png](https://dl.playground.lazycat.cloud/guidelines/1279/7bdfeb34-3b0a-4239-968f-6856c9b13ced.png) 这里输入 3 按下回车安装 xfce 远程桌面的服务端 > 4 是浏览器 > nvm 和 uv 是开发者工具 > 这里根据需求安装 ### 7.SSH转发到本地启动终端，执行以下命令： - 地址填写 `{微服名称}.heiyu.space` - 可以通过 LightOS 主界面直接复制出来 > 该命令是通过 ssh 转发将微服的 3389 端口转发的本地的 13389 > 该命令需要在自己电脑上面执行 > 该命令需要在自己电脑上面执行 > 该命令需要在自己电脑上面执行 ```bash ssh -p 4096 {用户名}@{微服名称}.heiyu.space -L 13389:127.0.0.1:3389 ``` ![imagepng](https://dl.playground.lazycat.cloud/guidelines/1279/e1c87c2f-5ec6-4ebb-a48b-c05732c4d8e6.png) ![转发出来.png](https://dl.playground.lazycat.cloud/guidelines/1279/d5690640-e650-4f81-912f-4bfc2c5ee8c4.png "转发出来.png") ### 8. 连接远程桌面 Windows： - 使用系统自带的“远程桌面连接” - 地址填写 `127.0.0.1:13389` - 用户名和密码使用创建容器时设置的账号信息 ![imagepng](https://dl.playground.lazycat.cloud/guidelines/1128/7dfac91e-1d45-4af9-acdb-8c1d692f1d0d.png) ![imagepng](https://dl.playground.lazycat.cloud/guidelines/1128/3007b6b5-3289-40d4-9e7e-609320209a06.png) macOS： - 使用 `Windows App` - 新建一个 Remote PC 连接 - 地址填写 `127.0.0.1:13389` ![56d093f8fc954185225bbe61a14cc7c9jpg](https://dl.playground.lazycat.cloud/guidelines/1128/2332a0ac-5ad7-4a05-9a90-e97847371c6d.jpg) ![4453347ff094d974ff707c345fe4015ejpg](https://dl.playground.lazycat.cloud/guidelines/1128/aa9dc7a4-890e-47e5-b8b5-01960a8d4536.jpg) ![imagepng](https://dl.playground.lazycat.cloud/guidelines/1128/6baa6b86-9676-4e19-9abd-f5938dfad894.png) --- ## 其他使用场景 ### 把它当作 HDMI 桌面主机使用 HDMI 线连接微服和显示器，再配合键盘和鼠标，即可把 LightOS 当成一台桌面主机使用。推荐： - 桌面环境优先选 KDE - 自动启动按需开启 - 如果有多个桌面容器，注意它们会竞争 HDMI 接口 - 懒猫智慧屏也会占用同一个 HDMI 接口如果插上显示器后看到的不是预期桌面，通常要先检查是不是其他容器抢占了 HDMI。 ![image20260324141340999](https://dl.playground.lazycat.cloud/guidelines/1128/image-20260324141340999.png?imageSlim) --- ## 相关设置参考这部分放在文章后面，供需要时查阅，不打断前面的安装和远程桌面主流程。 ### 基础页面设置说明 #### 系统镜像怎么选 - Arch Linux：滚动更新，适合熟悉 Arch 的用户 - Debian Bookworm：Debian 12 - Debian Bullseye：Debian 11 - Debian Stable：Debian 13 当前稳定版，适合大多数用户 - Debian Testing：测试版，不建议新手使用 - 自定义：适合有明确需求的用户，自行指定 OCI 镜像推荐建议： - 新手优先选 Debian Stable - 需要稳定远程桌面环境，优先选 Debian 系镜像 - 只有在你清楚镜像来源、软件包管理方式和系统初始化方式时，再考虑自定义镜像 #### 镜像仓库怎么选 - `registry.lazycat.cloud`：懒猫微服官方源，推荐 - `docker.1ms.run`：镜像加速源 - `docker.io`：Docker 官方源 - 自定义：使用你自己的镜像仓库 #### 基础软件包怎么选 - 开发者基础工具：基础开发环境 - Golang：Go 开发环境 - Node 与 NPM：前端和部分 AI 工具依赖，推荐 - 常用 CLI 工具：常用命令行工具集，推荐 - hclient-cli：在系统中使用微服客户端 - yay：仅 Arch Linux 相关 - Codex CLI：可选，按需安装 - Claude CLI：可选，按需安装 - KDE / XFCE：桌面环境二选一桌面环境推荐： - 远程桌面优先选 XFCE - HDMI 桌面主机优先选 KDE #### 国内源怎么选 - NPM：选择了 Node 与 NPM 时建议开启 - Golang：选择了 Golang 时建议开启 - 系统包源：USTC 或 TUNA 二选一即可，保持默认也可以 ### 网络页面设置说明 #### 网络模式说明 - `Nat`：默认最稳妥，外部访问内部端口时需要配合端口转发 - `Host`：与微服共享网络，能力更强，但操作不当可能影响主机网络 - `MacVlan`：独立 IP、独立 MAC，但通常不能直接访问主机上的其他服务 - `Ipvlan`：独立 IP、复用主机 MAC，部分路由器不支持 #### SSH - 建议保持默认开启 - 端口一般保持默认即可 - 如果需要修改，请确认界面中显示该端口可用 #### 挂载设备 - `/dev`：桌面环境通常建议添加 - 允许磁盘设备：仅在需要操作外接 U 盘或移动硬盘时开启 - 挂载 `/lzcsys/data/document`：把懒猫网盘挂到容器中，推荐 - 只读：勾选后只能读取，不能写入挂载内容 ### 主页面功能说明 - 启动 / 停止：控制系统运行状态 - 命令行界面：打开 WebShell - 设置界面：修改系统配置 - 菜单：克隆、删除等功能 - SSH 复制：快速复制 SSH 命令 - 自动启动：控制该实例是否随微服启动 ### WebShell 说明 WebShell 适合远程执行命令、手机和电脑协同操作，以及保留长期终端会话。注意事项： - 浏览器环境下，部分快捷键可能和浏览器自身冲突 - 类似 `Ctrl+W` 这类操作可能直接关闭页面 - 关闭浏览器窗口后，终端会话一般仍然保留，再次进入可以继续使用终端支持多标签和使用右键分屏操作。 ![image20260323183843604](https://dl.playground.lazycat.cloud/guidelines/1128/image-20260323183843604.png?imageSlim) 手机与电脑可以共享同一个终端状态： | 手机 | 电脑 | | ------------------------------------------------------------ | ------------------------------------------------------------ | | ![b17fdd494b4ada713224760806d00623.jpg](https://dl.playground.lazycat.cloud/guidelines/1128/3b4b26ab-cc4c-4397-ad3d-91f1623117e0.jpg "b17fdd494b4ada713224760806d00623.jpg") | ![5ea9dbeaaea19c499c5845633c3b77f7.png](https://dl.playground.lazycat.cloud/guidelines/1128/e7c39a8d-8d07-4606-94b2-b872b2faa1e1.png "5ea9dbeaaea19c499c5845633c3b77f7.png")| 如果你有多个容器，也可以在右上角切换当前连接的容器或返回主页，另外可以在设置中修改终端的选项 ![应用设置.png](https://dl.playground.lazycat.cloud/guidelines/1128/1e480d78-a36d-4137-9290-9603fe5d4d26.png "图片.png") 终端设置 ![终端设置.png](https://dl.playground.lazycat.cloud/guidelines/1128/d03b049f-e5ce-462b-87ef-2fac8e73a26f.png "图片.png") 主题设置 ![主题设置.png](https://dl.playground.lazycat.cloud/guidelines/1128/cd27bdfe-e85a-47a5-806f-bfc660cd9468.png "图片.png") 手机快捷键设置 ![手机快捷键设置.png](https://dl.playground.lazycat.cloud/guidelines/1128/b9574329-6e83-483f-9801-15dbe69ab649.png "图片.png") PC快捷键设置 ![图片.png](https://dl.playground.lazycat.cloud/guidelines/1128/c43e1a7c-7aad-441c-978a-781f0d086f78.png "图片.png") ### 发布服务可以将本地服务转发到微服里直接生成应用。先进入设置 ![应用设置.png](https://dl.playground.lazycat.cloud/guidelines/1128/1e480d78-a36d-4137-9290-9603fe5d4d26.png "图片.png") 进入服务转发设置 ![服务转发设置.png](https://dl.playground.lazycat.cloud/guidelines/1128/c7579f36-3380-41a0-a1fe-fa1b902c1412.png "图片.png") 部署服务 ![部署服务.png](https://dl.playground.lazycat.cloud/guidelines/1128/3fb6c493-6478-4736-9472-4bbc7276334b.png "图片.png") 在应用里面搜索创建的服务 ![搜索创建的服务.png](https://dl.playground.lazycat.cloud/guidelines/1128/04a0335c-0d74-4940-888e-587b9a03b06b.png "图片.png") 打开应用 ![打开应用.png](https://dl.playground.lazycat.cloud/guidelines/1128/5b212f3e-c46f-4b65-aeaa-4bdfe7aba7cf.png "图片.png") > 如果出现下面的图片说明在容器里面没有启动对应的服务 > ![启动502.png](https://dl.playground.lazycat.cloud/guidelines/1128/8c51c83c-2ee4-4841-adf5-7787714f66c0.png "图片.png") ### SSH SSH 适合从本地终端直接连接 LightOS 容器，也适合配合 IDE 和脚本化运维使用。主页面上的复制按钮可以直接生成连接命令。 ## 常见问题 ### 1. 为什么我可以创建系统，但远程桌面连不上优先排查： - XRDP 是否已安装并启动 - 容器网络模式是否适合远程接入 - 3389 端口是否被占用 - 连接地址是否填写正确 ### 2. 为什么显示器上不是我想要的桌面通常是因为多个桌面容器或智慧屏在竞争 HDMI 接口。 ### 3. WebShell 和 SSH 有什么区别 - WebShell：打开即用，适合随时进入 - SSH：更适合本地终端、IDE 和脚本化使用 ### 4. 快照适合什么时候用建议在安装桌面环境、批量装软件、改系统配置之前先手动创建一个快照。