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~~
🎉 debian 13 现在的 node 版本是 20.19.2

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：选择开启

网络页面png

选完后点击下一步。

4. 身份页面

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

身份页面png

设置完成后点击创建。

5. 等待构建完成

构建页面png

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

点击知道了返回主页面。

imagepng

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

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

6. 安装 XRDP

提供了快速安装脚本，可以使用脚本来进行下载。

点击终端按钮，进入 webshell 页面

复制命令到终端执行：

curl -O https://raw.giteeusercontent.com/longtaipeng/lazycat-script/raw/master/script/lightos-debian-utils.sh && chmod +x lightos-debian-utils.sh && ./lightos-debian-utils.sh

脚本只支持 debian。

执行脚本

脚本执行成功后，会是下面的输出

脚本菜单

输入 4 进入远程桌面的分类菜单

安装菜单

这里输入 1 2 (中间有空格) 开始安装远程桌面服务

安装进程

进入设置界面

打开设置

添加转发服务

部署完成后，打开转发应用

远程桌面

其他使用场景

把它当作 HDMI 桌面主机

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

相关设置参考

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

基础页面设置说明

系统镜像怎么选

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

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

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

手机	电脑

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

应用设置.png

终端设置

终端设置.png

主题设置

主题设置.png

手机快捷键设置

手机快捷键设置.png

PC快捷键设置

图片.png

发布服务

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

先进入设置

应用设置.png

进入服务转发设置

服务转发设置.png

部署服务

部署服务.png

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

搜索创建的服务.png

打开应用

打开应用.png

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

SSH

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

常见问题

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

优先排查：

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

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

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

3. WebShell 和 SSH 有什么区别

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

4. 快照适合什么时候用

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

LightOS 攻略