LightOS

本文用于介绍 LightOS 的主要能力、适用场景、安装方式和核心功能说明。
文中的界面、版本和镜像列表可能会随应用更新而变化，请以实际界面显示为准。

LightOS 是懒猫微服自研的一套轻量化容器编排平台，和 LPK 深度集成，提供 WebShell、远程桌面、GUI 应用接入本地等能力。它适合拿来做远程开发环境、轻量桌面系统、局域网服务节点，以及接显示器直接使用的桌面主机。

LightOS 是什么

如果把 LightOS 当成一个“可快速创建的系统容器”，会更容易理解它的定位。

你可以在 LightOS 里：

• 创建一套独立的 Linux 系统环境
• 使用 WebShell 在浏览器里直接操作终端
• 配置 XRDP，通过 RDP 远程访问桌面
• 挂载懒猫网盘，在系统里直接访问数据
• 使用快照快速回退系统状态
• 通过 HDMI 把某个容器当作桌面主机使用

它更像是“带管理界面的 Linux 系统容器”，而不是传统意义上的虚拟机。

适合哪些场景

LightOS 常见的使用方式主要有三类：

• 远程桌面主机：适合需要从 Windows、macOS、Linux 远程接入桌面的用户
• 开发与运维环境：适合需要长期保留终端会话、安装开发工具、跑脚本和调试服务的用户
• 桌面主机：适合通过 HDMI 接显示器、键盘和鼠标，直接把微服当作一台轻量 Linux 电脑来使用

如果你是第一次接触，建议优先按“远程桌面”或“WebShell + 开发环境”这两个场景来理解和配置。

安装入口

应用商店地址：

在商店中下载并打开 LightOS 后，需要创建一个系统实例。创建流程分为三步：

• 基础页面设置
• 网络界面设置
• 身份页面设置

系统安装

按照本文操作一步步执行，即可安装成功。

1. 创建系统

打开 LightOS，新建一个系统实例。

2. 基础页面

• 系统镜像：Debian Stable
• 镜像仓库：registry.lazycat.cloud
• 基础软件包：桌面环境选 XFCE
• 开发者工具: 安装 build-essential 工具包
• Node 与 NPM：前端构建工具
• 常用 CLI 工具：安装 jq、ripgrep、rsync、git、curl、wget、vim 等工具
• codex cli: 终端代码开发工具
• claude cli: 终端代码开发工具
• 国内源：选择 USTC

选完后点击下一步。

3. 网络页面

• 网络模式：选择 Nat
• SSH：保持开启
• 挂载 /lzcsys/data/document：选择开启，挂载后可以获取懒猫网盘的数据。
• /dev：选择开启

选完后点击下一步。

4. 身份页面

• 操作系统名称：debian，自定义即可
• 用户名：一般有默认值，自定义即可 ⚠️不要使用纯数字，会出错⚠️
• 密码：设置一个登录系统的密码
• 语言：建议选择中文（简体）

设置完成后点击创建。

5. 等待构建完成

构建完成后，界面会显示安装完成提示。

点击知道了返回主页面。

如果不需要安装远程桌面，可以跳过下面的远程桌面安装

---

远程桌面 (如果不需要可以不安装）

未安装远程桌面的容器显示是灰色的图标

安装远程桌面

按照下面的流程进行操作

1. 进入设置

2. 安装 Selkies

3. 开启远程桌面

4. 打开远程桌面

提升清晰度

打开了远程桌面，感觉清晰度不是很好，可以设置画面的质量。质量越高对网络的要求也高。大家可以根据实际需求来设置。

文件上传下载

这里下载，打开后看到的是桌面的文件。要把下载的文件放到桌面。

剪切板（可以粘贴图片）

粘贴图片需要开启剪贴板的图形支持功能

---

其他使用场景

把它当作 HDMI 桌面主机

使用 HDMI 线连接微服和显示器，再配合键盘和鼠标，即可把 LightOS 当成一台桌面主机使用。

推荐：

• 桌面环境优先选 KDE
• 自动启动按需开启
• 如果有多个桌面容器，注意它们会竞争 HDMI 接口
• 懒猫智慧屏也会占用同一个 HDMI 接口

如果插上显示器后看到的不是预期桌面，通常要先检查是不是其他容器抢占了 HDMI。

如果不打算当作主机使用，可以关闭 DHMI 对应的服务，在脚本里面关闭
手动关闭命令: sudo systemctl disable --now lightdm.service

---

相关设置参考

这部分放在文章后面，供需要时查阅，不打断前面的安装和远程桌面主流程。

基础页面设置说明

系统镜像怎么选

• 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 这类操作可能直接关闭页面
• 关闭浏览器窗口后，终端会话一般仍然保留，再次进入可以继续使用

终端支持多标签和使用右键分屏操作。

手机与电脑可以共享同一个终端状态：

手机	电脑

如果你有多个容器，也可以在右上角切换当前连接的容器或返回主页，另外可以在设置中修改终端的选项

终端设置

主题设置

手机快捷键设置

PC快捷键设置

发布服务

可以将本地服务转发到微服里直接生成应用。

先进入设置

进入服务转发设置

部署服务

在应用里面搜索创建的服务

打开应用

如果出现下面的图片说明在容器里面没有启动对应的服务

SSH

SSH 适合从本地终端直接连接 LightOS 容器，也适合配合 IDE 和脚本化运维使用。主页面上的复制按钮可以直接生成连接命令。

常见问题

1. 为什么我可以创建系统，但远程桌面连不上

优先排查：

• XRDP 是否已安装并启动
• 容器网络模式是否适合远程接入
• 3389 端口是否被占用
• 连接地址是否填写正确

2. 为什么显示器上不是我想要的桌面

通常是因为多个桌面容器或智慧屏在竞争 HDMI 接口。

3. WebShell 和 SSH 有什么区别

• WebShell：打开即用，适合随时进入
• SSH：更适合本地终端、IDE 和脚本化使用

4. 快照适合什么时候用

建议在安装桌面环境、批量装软件、改系统配置之前先手动创建一个快照。