# LinuxDesktop **Repository Path**: jackletter/linux-desktop ## Basic Information - **Project Name**: LinuxDesktop - **Description**: 开源的linux服务器运维桌面,使用 .net10+纯html+AI 开发 - **Primary Language**: C# - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-08 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Linux Desktop Console 基于 **.NET 10** 的 Linux 远程桌面 Web 控制台。浏览器只与本机网关通信,网关通过 **SSH.NET 2026.0.0** 管理目标 Linux 主机,不在被管主机安装 Agent。 前端为 **纯 HTML + 原生 JavaScript(ES Module)+ CSS**: - 没有 `package.json` - 没有 npm / Vite / Webpack / Rollup - 第三方库放入 `wwwroot/vendor/` 本地托管,不依赖运行时 CDN - Monaco Editor `0.52.2` 位于 `wwwroot/vendor/monaco/vs/`,保留上游 `LICENSE` - xterm.js `5.5.0` 与 `@xterm/addon-fit 0.10.0` 位于 `wwwroot/vendor/xterm/`,保留上游 `LICENSE-xterm` / `LICENSE-addon-fit` --- ## Windows 桌面版 项目现在以 **.NET 10 WinForms + WebView2** 应用启动: - 启动时先在 `127.0.0.1` 上从 **12345** 开始寻找可用端口 - 内置 Kestrel 提供完整 Web 控制台 - 主窗口使用 WebView2 加载本机页面 - **无登录页**:本地桌面直接进入服务器列表,自动使用本机管理员身份 - 已移除账号、登录、注册、账号管理、分组管理和标签功能 - 服务器列表改为桌面软件式工具栏 + 数据表格布局 - 新增/编辑服务器弹框支持保存前测试 SSH 连接 - 服务只监听 `127.0.0.1`,拒绝非本机来源和非法 Host - 服务器列表窗口默认约 1100×720,列表无横向滚动条 - 点击行本身不打开主机,只能点击“进入桌面”或“进入Shell” - 点击进入桌面、进入Shell或批量Shell后:打开新窗口,服务器列表保持显示 - 不使用系统托盘 - 服务器列表、桌面、Shell、批量Shell 全部关闭后,应用进程才退出 - 服务器行支持“进入桌面”“进入Shell” - 支持批量选择服务器和批量 Shell - 支持批量 Shell:多个终端使用绝对定位布局,窗口缩放实时重排,可拖拽分隔条,共用底部命令输入 - 桌面任务栏窗口按钮仅显示图标;只有任务栏空间不足时才合并同应用窗口 - 合并窗口悬浮列表支持逐项红色关闭按钮 - 桌面模块图标采用 Windows 风格彩色图标 - 通用表格插件:固定表头、列宽拖拽/自适应、列头排序、列显示菜单、细滚动条与明暗主题 - 网络、性能、进程、systemd、用户、磁盘、日志、定时任务、内核、容器、证书、Nginx 等表格统一使用该插件 - 桌面 F5 只刷新远程 Desktop 目录;终端/Shell 窗口禁用 F5 和 Ctrl+F5 - WebView2 页面禁用 F12、Ctrl+Shift+I/J/C、Ctrl+F5 等浏览器快捷键,保留页面 F5 与 Ctrl+F12 - Macro 编辑器:标题 `Macro-<路径>`,无顶部工具栏,底部显示大小与快捷键 - `Alt+Shift+S` 格式化 - `Ctrl+S` 保存 - `Ctrl+Shift+S` 另存为 - `F5` 重新加载当前文件 - F5 规则:服务器列表刷新页面、Linux 桌面刷新桌面、Explorer 刷新当前目录、Macro/图片/音视频/PDF 刷新当前数据;不再有全局 F5 确认框 - systemd:详情可关闭;支持新增后台服务;实时日志使用 `journalctl --no-pager -f` 持续滚动 - 目标框架:`net10.0-windows` - 需要安装 **Microsoft Edge WebView2 Runtime** - 全局快捷键(应用运行期间系统级生效): - `Win+D`:显示/恢复 Web 桌面窗口(所有窗口最小化/还原) - `Win+E`:在当前 Web 桌面新开文件系统窗口 - `Ctrl+F12`:打开当前 WebView2 调试窗口 - 支持 `LD_PORT` 环境变量覆盖起始端口 - 支持 `LD_WEBVIEW_DEBUG_PORT` 开启 WebView2 调试端口 - WebView2 配置目录不可写时在创建控制器前自动切换到应用目录下的恢复配置,避免白屏且不再重启进程 - Win+D / Win+E 使用独立 STA 消息循环的低级键盘钩子,页面内同时保留 `Meta+D/E` 兜底 - 应用 Logo:Windows 四色窗口 + Linux 企鹅组合图标,见 `Assets/LinuxDesktop.ico` / `wwwroot/favicon.svg` 构建: ```powershell dotnet build ``` 运行: ```powershell bin\Debug\net10.0-windows\LinuxDesktop.exe ``` 网站地址会显示在启动日志中,默认: ```text http://127.0.0.1:12345/ ``` --- ## 当前进度 **里程碑 A · 第 3 步已完成:主机总览首页 + 单主机远程桌面。** **里程碑 B · 第 4 步已完成:机器信息 + 硬件只读。** **里程碑 B · 第 5 步已完成:网络信息只读。** **里程碑 B · 第 6 步已完成:实时性能。** **里程碑 B · 第 7 步已完成:实时进程。** **里程碑 B · 第 8 步已完成:系统设置。** **里程碑 C · 第 9 步已完成:文件系统浏览。** **里程碑 C · 第 10 步已完成:文件上传/下载。** **里程碑 C · 第 11 步已完成:文件预览/编辑。** **里程碑 C · 第 12 步已完成:文件管理(新建/删除/重命名/复制/移动/压缩/解压)。** **里程碑 C · 第 13 步已完成:Web 终端(xterm.js + WebSocket)。** **里程碑 D · 第 14 步已完成:应用管理只读(包管理器/已安装/可升级/软件源)。** **里程碑 D · 第 15 步已完成:软件包安装/卸载/升级与版本选择。** **里程碑 D · 第 16 步已完成:软件源管理(托管源/启停/索引更新)。** **里程碑 D · 第 17 步已完成:包管理器命令百科。** **里程碑 E · 第 18 步已完成:systemd 服务只读(列表/状态/依赖/日志)。** **里程碑 E · 第 19 步已完成:systemd 启停、重启与开机启用管理。** **里程碑 E · 第 20 步已完成:systemd drop-in 配置编辑(Monaco/校验/回滚)。** **里程碑 E · 第 21 步已完成:用户、用户组与登录会话只读。** **里程碑 E · 第 22 步已完成:用户生命周期管理(创建/密码/锁定/sudo/Shell/删除)。** **里程碑 E · 第 23 步已完成:定时任务只读(用户/系统 cron、systemd timer、目录)。** **里程碑 E · 第 24 步已完成:托管 cron 任务创建/删除/测试运行。** **里程碑 F · 第 25 步已完成:journald/syslog 日志只读查看。** **里程碑 F · 第 26 步已完成:内核、sysctl、模块、limits 与启动项只读。** **里程碑 G · 第 27 步已完成:磁盘、文件系统、块设备与 swap 只读。** **里程碑 H · 第 28 步已完成:容器与虚拟化只读(运行时探测)。** **里程碑 H · 第 29 步已完成:证书扫描与到期检查只读。** **里程碑 H · 第 30 步已完成:Nginx 状态、配置、站点与日志只读。** **里程碑 H · 第 31 步已完成:OpenSSL 自签名证书生成。** **里程碑 H · 第 32 步已完成:Nginx 托管站点配置编辑、校验与 reload。** **第 33 步已完成:全量模块最终验收(API、构建、资源与安全清理)。** 已实现: - .NET 10 Minimal API 项目骨架,按 `Services/`、`Endpoints/`、`Models/` 分层 - 服务只监听本机回环地址,请求自动使用本机管理员身份 - 已移除登录、注册、注销、账号管理页面和前端账号状态 - 操作审计日志(不记录密码、哈希、私钥) - **SSH.NET 2026.0.0 连接池**:每台主机复用 `SshClient` / `SftpClient`,空闲 5 分钟释放 - **主机管理**:新增、编辑、删除;密码认证与私钥认证(含私钥口令) - **连接测试**:真实 SSH 登录,返回服务版本、延迟、SHA256 主机密钥指纹 - **主机密钥校验**:首次连接接受并缓存;后续指纹变化直接拒绝,不自动信任;管理员可显式重置信任 - **凭据加密**:密码、私钥与口令使用 ASP.NET Core Data Protection 加密落盘,API、日志永不返回明文 - **主机总览首页**:登录后展示当前账号可管理的全部主机;不再直接进入远程桌面 - **分组管理**:主机新增时选择已有分组或新建分组;分组按名称排序,“全部”始终排在第一位 - **分组筛选**:点击分组卡片只显示该组主机;分组卡片显示组内主机数量 - **移除了批量操作**:首页不再有批量测试、复选框或批量按钮;同时移除了旧的主机批量测试 API - **移除统计卡片**:主机总数/已信任密钥/已连接过/当前选择区域替换为分组卡片 - **行点击进入远程桌面**:点击主机行(或“进入”)在新浏览器标签页打开 `/desktop.html?hostId=...` - **单主机远程桌面**:新标签页只显示该主机相关应用,不显示主机管理、账号管理、主机切换、批量模式或 Web 用户信息 - **标签页标题**:格式为“主机名 · 用户名@地址 — Linux Desktop” - **连接监控**:桌面加载后建立 SSH 会话并每 10 秒健康检查;意外断开时整页灰色蒙版,中间弹框提供“重新连接”和“关闭” - **窗口动画**:打开淡入、最大化/还原尺寸过渡、关闭缩放淡出 - **网格桌面图标**:图标吸附到 96×104 网格,位置持久化;拖动时显示目标格,落到已占用格会交换位置,不会重叠 - **无开始菜单任务栏**:左侧显示 SSH 用户名、主机名、IP;固定应用区 + 已打开窗口;移除 Windows 风格开始菜单 - **Windows 风格任务栏交互**:窗口按钮悬停显示缩略预览;右键提供最大化/还原窗口大小/最小化/关闭/重新打开新窗口/固定到任务栏 - **默认夜晚主题**:无本地偏好时默认 dark,仍可切换浅色 - **选择策略**:远程桌面全局禁用文本/图片选择;仅输入框、文本域和文件/目录名称放开;文件详情提供“复制路径”按钮 - **窗口右上角控件**:最小化/最大化/关闭按钮贴顶,关闭按钮贴顶部和右侧 - **多文件窗口**:文件系统支持多个独立窗口实例,各自地址栏可输入路径;路径不存在时弹框提示 - **桌面右键菜单**:刷新、排列图标、更换壁纸、在桌面打开终端、重新连接 SSH - **机器信息 + 硬件只读**:远程桌面“硬件”应用展示系统/发行版/内核/架构/运行时间、DMI 主板与 BIOS、CPU、内存、块设备与文件系统、网卡地址与默认路由、GPU、温度/风扇/电压、电源与 Linux 软件 RAID - **固定只读采集**:全部通过一条固定的 SSH 只读脚本采集,命令超时 5 秒,不执行任何修改命令,不使用主机 Agent - **部分信息降级**:缺少 lscpu/lm-sensors/nvidia-smi/mdadm 或非 root 用户时,对应区块为空并显示采集提示,不影响其他信息 - **网络信息只读**:远程桌面“网络”应用展示接口/地址/MAC/MTU/速率/驱动、路由表、DNS、邻居表、监听端口、bond 与 bridge - **网络接口统计**:接收/发送字节、包量、错误与丢弃计数;接口状态和 carrier 标记 - **固定网络采集**:同样使用只读 SSH 脚本,5 秒超时、512 KB 输出上限,不修改接口、路由、DNS 或防火墙 - **实时性能仪表盘**:每 3 秒采样,保留 3 分钟趋势;CPU/每核/负载、内存/Swap、磁盘读写、网络收发、进程数、TCP 状态、监听端口;有 NVIDIA GPU 时显示 GPU 利用率/显存/温度 - **Canvas 趋势图**:零第三方图表库,原生 Canvas 绘制;支持暂停/继续、刷新、曲线自动缩放,关闭窗口立即停止轮询 - **实时进程**:每 3 秒刷新,PID/用户/状态/CPU/内存/RSS/线程/运行时长/命令行;支持搜索、CPU/内存/PID 排序、详情弹框 - **单条结束进程**:管理员可对单个 PID 执行固定 `kill -TERM`,需输入 PID 二次确认,审计记录操作;不提供批量结束 - **系统设置**:读取主机名、时区、NTP、系统语言、X11 键盘布局和机器信息;管理员可修改主机名/时区/NTP/语言/X11 布局 - **设置修改安全**:服务端校验主机名/时区/语言/布局格式,只使用固定 `hostnamectl`、`timedatectl`、`localectl` 命令;执行前输入“确认”,并记录旧值/新值审计 - **文件系统浏览**:SFTP 目录列表、顶部唯一可输入地址栏、前进/后退/上一级、快捷位置、搜索、隐藏文件复选框、预览面板开关、排序、详情面板 - **多选与拖拽**:Ctrl 增减选择、Shift 连续选择、鼠标矩形框选;选中项可拖到文件夹/侧栏目录移动,右键批量复制、剪切、粘贴、删除、压缩 - **最近目录**:左侧保留主目录/根目录/配置/临时/日志,追加“最近”分组记录打开过的文件所在目录 - **Windows 风格右键菜单**:打开、复制、剪切、粘贴、删除、重命名、压缩为 tar.gz、解压到当前目录、属性 - **Web 终端**:本地 xterm.js + WebSocket 接管真实 SSH shell;支持彩色输出、窗口缩放、Ctrl+C、清屏、重新连接和明暗主题 - **终端安全**:仅管理员;每主机最多 4 个、全局最多 12 个终端会话;打开/关闭写审计,不记录命令内容 - **应用管理**:自动识别 APT/dpkg、RPM/DNF、pacman;展示包管理器、发行版、已安装数量、可升级数量、软件源、已安装体积 - **包列表**:已安装包搜索(名称/版本)、版本/架构/大小/状态;可升级包当前版本与目标版本;APT/RPM/Pacman 软件源 - **软件包变更**:管理员可安装(可选版本)、卸载、升级;安装前可查询可用版本;操作前输入包名确认,结果写入审计 - **软件源管理**:系统源只读;托管文件 `/etc/apt/sources.list.d/linuxdesktop.list` 支持添加/删除源、启用/停用、更新 apt 索引;写入前备份为 `.bak`,权限 0644 - **命令百科**:按当前包管理器展示 27+ 条 APT 命令;覆盖更新升级、安装卸载、查询诊断、软件源缓存、清理维护;支持搜索/分类/管理器筛选和复制命令 - **systemd 只读**:服务总数/运行中/失败/开机启用统计;服务列表搜索与状态筛选;服务详情、单元文件状态、主 PID、内存、任务、重启次数、依赖和最近 80 行 journal 日志 - **systemd 服务管理**:管理员可启动、停止、重启服务,启用/禁用开机启动;操作前输入服务名确认,结果写入审计;列表合并已加载单元与单元文件,未加载的禁用服务也可启动 - **drop-in 编辑**:管理员为服务创建/修改/删除 `/etc/systemd/system/.d/*.conf`;Monaco 编辑器、`systemd-analyze verify` 校验、失败自动回滚、`daemon-reload`、删除保留 `.bak`、操作审计 - **用户与组只读**:用户列表(UID/类型/组/密码状态/在线/主目录/Shell)、用户组(GID/成员)、登录会话、sudo/wheel/admin 管理员识别、shadow 状态脱敏 - **用户生命周期**:管理员可创建用户(主目录/Shell/sudo)、重置密码、锁定/解锁、加入/移出 sudo、修改 Shell、删除用户(可选删除主目录);服务名与密码不进入审计明文 - **定时任务只读**:用户 crontab、`/etc/crontab` 与 `/etc/cron.d`、systemd timer、`cron.hourly/daily/weekly/monthly` 目录;计划、用户、命令、来源展示与搜索 - **托管 cron 任务**:管理员在 `/etc/cron.d/linuxdesktop-<名称>` 创建任务,支持立即测试运行、删除并保留 `.bak`;创建前输入任务名确认,权限 0644,命令通过 `runuser` 执行 - **日志只读**:journald JSON 日志与 syslog/messages 快照;服务单元/优先级/行数筛选,消息搜索,严重级别统计,Boot 记录、journal 磁盘占用与单元列表 - **内核只读**:内核 Release/架构/构建版本/命令行/运行时长、默认启动项与 GRUB 环境、`/boot` 内核文件、sysctl 参数搜索、内核模块与引用关系、limits.conf/ulimit - **磁盘只读**:文件系统容量/使用率、总容量/已用/可用、块设备拓扑(磁盘/分区/型号/传输/挂载/文件系统)、swap 与 `/etc/fstab` - **容器与虚拟化只读**:探测 Docker/Podman/nerdctl/ctr/virsh/kubectl;展示容器、镜像、libvirt 虚拟机与运行时版本/状态;无运行时显示明确空态 - **证书只读**:扫描本地/服务证书(跳过系统 CA 根证书库),展示 Subject、Issuer、有效期、剩余天数、SAN、路径、自签名标记;30 天内到期/已过期统计与 OpenSSL 版本 - **Nginx 只读**:检测 nginx 版本/服务状态、`nginx -t`、站点 server 块、配置文件切换、access/error 日志;未安装时显示空态 - **证书生成**:管理员用目标主机 OpenSSL 生成 2048 位自签名证书(CN/SAN/有效天数),写入 `/etc/ssl/localcerts`,证书 0644、私钥 0600;输入名称确认,私钥不通过界面下载 - **Nginx 站点编辑**:管理员以 Monaco 编辑托管 `/etc/nginx/conf.d/linuxdesktop-*.conf`;保存前 `nginx -t`,失败自动回滚;成功 reload;删除保留 `.bak`;系统配置只读 - **包管理器操作安全**:固定包管理器命令、包名/版本/源参数白名单、shell 转义、每主机串行执行、操作超时 5 分钟;不开放自定义命令或任意参数 - **新建文件夹**:工具栏按钮,管理员在当前目录创建;同名目标拒绝覆盖 - **解压**:管理员对 `.tar.gz`/`.tgz`/`.tar`/`.zip` 解压到同名新目录,目标已存在时拒绝覆盖 - **图片查看器**:独立窗口、适应窗口宽高比、分辨率/大小、左右旋转动画、Ctrl+滚轮缩放、当前百分比、1:1 按钮;超过 30 MiB 打开前确认 - **文件元数据**:类型、大小、修改时间、Unix 权限、UID/GID 解析为用户名/组名、符号链接标识 - **文件上传**:管理员上传到当前目录,支持多文件、进度显示、同名 409 后二次确认覆盖;单文件上限 100 MiB(可配置) - **文件下载**:任意已登录用户从详情面板下载普通文件,服务端流式输出,不把文件整体读入内存 - **文本预览**:UTF-8 文本只读预览、行数/大小/编码;不设应用层大小截断;超过 50 MiB 打开前二次确认;二进制文件给出明确提示 - **图片查看器**:PNG/JPEG/GIF/WebP/BMP/AVIF/ICO 独立查看器,不嵌套 Explorer;超过 30 MiB 打开前二次确认;SVG 不按图片内联,避免活动内容 - **Monaco 编辑**:文本文件双击直接打开独立 Monaco 窗口;任何已登录用户可编辑;超过 50 MiB 打开前二次确认;保存前输入文件名确认;SHA-256 乐观并发,文件被外部修改返回 409;保留原 BOM 与原文件权限 - **Monaco 快捷键**:Alt+Shift+F 格式化、Alt+Z 自动换行、Ctrl+S 保存、Ctrl+/ 注释、Ctrl+Shift+[ / ] 折叠/展开;复制、粘贴、撤销、重做使用 Monaco 原生快捷键 - **文件浏览安全**:远程绝对路径归一化,拒绝反斜杠/NUL;上传文件名拒绝路径分隔符/控制字符;按主机串行化 SFTP 操作;编辑成功写入审计 - **Linux 桌面目录**:远程桌面读取 `~/Desktop` 并显示文件/文件夹图标;支持从本机拖拽文件或文件夹上传到桌面和 Explorer 当前目录 - **Explorer 快捷操作**:Ctrl+A 全选可见项、F5 刷新、Backspace 返回上级目录、右键“下载”单文件 - **缩放策略**:全局禁用 Ctrl+滚轮缩放;图片查看器直接滚轮缩放,不再需要 Ctrl - **字号提升**:窗口内容统一至少 14px,窗口/面板标题 16px;Monaco、终端同步放大 - **全部应用已接入**:文件、终端、硬件、网络、性能、进程、设置、应用管理、systemd、用户、定时任务、日志、内核、磁盘、容器、证书、Nginx - Fluent/Win11 风格,默认夜晚深色主题 - 基础安全响应头:CSP、X-Frame-Options、nosniff、Referrer-Policy 等 **全部 33 步已完成。** ### 增量优化(进行中) - 第 1 步:全局 F5/Ctrl+F5 拦截并确认刷新;桌面外壳统一处理 - 第 1 步:除 Explorer/回收站/剪贴板外,所有应用窗口禁用浏览器默认右键菜单 - Explorer 原有 F5 列表刷新已移除以避免与全局刷新确认冲突 - 第 2 步:Explorer 移除预览/详情窗格,增加空白处与选中项右键菜单 - 第 2 步:删除默认进入回收站(无确认),硬删除需确认;支持回收站恢复撤销 - 第 2 步:Explorer 快捷键 Ctrl+N / Ctrl+Shift+N / F2 / Delete / Shift+Delete / Ctrl+C/X/V/Z / 方向键 / Home / End - 第 2 步:复制文件名/全路径、批量改名、粘贴同名自动重命名、选中行高亮增强 - 第 3 步:压缩/解压支持 tar、tar.gz、tar.bz2、tar.xz、zip、rar、7z、tar.zst、tar.lz4、gz、bz2、xz、zst、lz4 - 第 3 步:压缩菜单二级格式、自动检测命令并置灰缺失工具;zip/7z/rar 支持可选密码(不写日志) - 第 3 步:解压按后缀自动选择工具,用户主动压缩/解压不设内部强制超时 - 第 4 步:双击按类型打开;无后缀文件提供 Monaco/图片/PDF/压缩包/执行选择;视频、音频、PDF 直接预览 - 第 4 步:图片查看器居中、左键拖动、角度持续累加、四种背景、顶部居中工具栏、路径显示在标题栏 - 第 4 步:Monaco 记录版本并在冲突时提供放弃/覆盖/另存副本;未保存关闭提供保存/放弃/取消 - 第 5 步:完整 freedesktop 回收站:Home Trash + 卷级 `.Trash/$uid` / `.Trash-$uid`,元数据独占创建,跨分区回退 - 第 5 步:回收站聚合列表、缺失元数据警告、恢复(取消/自动重命名/二次确认覆盖)、逐项流式清空可停止 - 第 6 步:应用管理新增应用分类:Web/数据库、运行时、版本控制/CI、容器、终端/系统工具、压缩与解压缩、网络服务、其他 - 第 6 步:分类目录支持包名/命令/描述搜索、安装状态、包版本、命令路径、安装/卸载;压缩分类展示用途与示例 - 第 6 步:新增 `/packages/probe` 命令位置探测接口,用于安装位置和命令可用性检测 - 第 7 步:实时进程改为右键操作(详情/Kill/复制命令),移除点击行详情;新增 PPID、进程名、启动时间、GPU、网络速率列 - 第 7 步:进程列宽自适应并支持拖拽调整;刷新间隔 1/2/5 秒、暂停、搜索、排序保留;默认 CPU 降序 - 第 7 步:Kill 前确认;非当前用户进程使用 `sudo -n kill`,不支持批量 Kill - 第 8 步:实时性能重构为左侧导航(概览/CPU/内存/磁盘 IO/网络);概览仅保留四项统计,不显示进程数/TCP - 第 8 步:CPU 总体图表 + 每核心 + 负载;内存图表与明细;磁盘速率/IOPS/利用率;网络图表与 TCP/UDP 连接表 - 第 8 步:2 秒采样、60 个历史采样点;标签页隐藏或窗口最小化时暂停采集 - 第 9 步:网络接口改为行式布局,展示状态/MAC/IPv4/IPv6/速率统计;关键信息支持一键复制 - 第 9 步:网络表格自适应并支持拖拽列宽;新增 Ping(30 次)、高级(hosts/防火墙/tc)、设置(nmcli/netplan)只读视图 - 第 10 步:终端支持多窗口实例,每个窗口独立 WebSocket/SSH;窗口标题“终端 — 主机名”,任务栏独立缩略 - 第 10 步:终端右键选中文本自动复制;无选中时读取剪贴板文本并输入(不自动回车),支持 bracketed paste - 第 10 步补充:任务栏窗口缩略图右上角新增 × 关闭按钮;点击缩略图恢复/置顶窗口 - 剪贴板:浏览器 sessionStorage 按主机隔离,不跨主机;Explorer 文件、Monaco 文本、终端文本、图片查看器图片共用 - 剪贴板:任务栏指示器显示类型/内容,可查看和清空;浏览器 Clipboard API 权限策略已开启 - 剪贴板:Explorer 粘贴仍走 SFTP 复制/移动并自动重命名;终端文件剪贴板以路径文本插入,不自动回车 ### 问题修复批次 - Explorer:F5 恢复刷新当前目录(桌面全局 F5 仍确认);Ctrl+N/Ctrl+Shift+N 改为窗口内快捷键;弹框回车提交;列宽拖拽;同目录复制自动生成 `- 副本`;空白右键刷新;Ctrl+拖拽复制 - Explorer:上传改为内存缓冲,修复 Windows 临时文件 `UnauthorizedAccessException` - 实时进程:列头排序 + 固定列宽拖拽;移除工具栏排序按钮 - 实时性能:网络连接表固定列宽、列头排序箭头、列宽拖拽 - 终端:增加配色主题、字体大小调整、Ctrl+滚轮字号;关闭半透明背景消除白底黑边 - 任务栏:显示桌面按钮、Win+D、Alt+Tab、预览可悬停/点击/关闭、缩小预览;回收站/网络/硬件/日志/定时任务支持多开 - 窗口默认宽度整体加宽 12%,减少列表横向滚动条 - F5:连接断开、页面离线或桌面连接覆盖层显示时不再拦截,直接浏览器刷新;连接正常时才确认刷新 - 回收站:禁用右键、列宽拖拽、列头排序 - 通用表格:其他应用列表统一固定列宽 + 拖拽 + 列头排序 + 粘性表头 - systemd:日志区提供实时日志/独立日志窗口,可过滤、选中复制;依赖移至底部 - 应用管理:安装/升级进度条,完成后显示命令输出(最多 8000 字符) - 保留 Nginx 托管配置 Monaco 编辑 - 用户与权限:新增用户组、用户/用户组映射管理;登录会话标记当前会话并支持踢出其他 pts 会话 - 登录会话解析支持 `who` 的 `pts/N`、`ttyN`、`seatN` 等终端列格式 - 已实测创建用户组、加入成员、创建真实 `pts` 会话并成功踢出 - Nginx:托管配置与 `/etc/nginx` 下系统 `.conf` 均可使用 Monaco 编辑;保存前 `nginx -t`,失败自动恢复 - 通用表格增强覆盖用户、用户组、登录会话、文件系统、块设备、日志、定时任务等列表 ### 增量 12 步验收 - 18 个桌面应用逐窗口打开/关闭通过,无前端运行时异常 - 全局 F5 拦截、确认文案与取消刷新通过 - 浏览器本地剪贴板:Explorer 文件复制/粘贴、终端文本粘贴通过 - 终端多窗口、独立任务栏缩略、右键粘贴通过 - 实时性能概览/CPU/内存/磁盘/网络视图通过 - 网络接口行、复制、列宽拖拽、Ping、高级/设置视图通过 - 回收站、应用分类、进程右键、图片查看器、Monaco 冲突保存通过 - 构建 0 警告 0 错误 - 已知未覆盖:SignalR 推送(当前 2 秒轮询)、OSC 52、终端批处理网格、跨分区回收站、zip/7z/rar 密码真实环境、音视频播放 ### 最终验收 - 全量 API 冒烟:17 个入口全部返回成功,覆盖主机、硬件、网络、性能、进程、设置、文件、应用管理、systemd、用户、定时任务、日志、内核、磁盘、容器、证书、Nginx - 所有模块页面均可从桌面打开;只读模块与管理员模块权限分离 - 前端无 npm/Vite 构建,Monaco/xterm 均为本地资源 - `dotnet build`:0 警告,0 错误 - JS 语法检查:通过 - 测试主机未安装 Docker/Podman/libvirt;容器页面以明确空态展示 - Nginx 验证使用临时安装的 1.26.3,验证完成后已卸载并清理托管配置 - 测试证书、用户、cron、systemd 临时单元、托管源和测试数据均已清理;`Data/` 真实数据保留 > `index.html` 现在是主机总览;`desktop.html` 是单主机远程桌面;`hosts.html` 仅保留为旧链接的兼容重定向。 --- ## 快速开始 ### 环境要求 - .NET 10 SDK(LTS) - 可访问 NuGet 源以还原 `SSH.NET 2026.0.0` 与 `BouncyCastle.Cryptography 2.7.0` - Linux 部署时无需安装 Node.js / npm ```bash cd LinuxDesktop dotnet restore dotnet run ``` 默认监听 `http://localhost:5080`(见 `Properties/launchSettings.json`)。 打开 ,使用初始管理员登录: ```text 用户名:admin 密码:admin ``` 登录后请立即修改默认密码。首次启动会在 `Data/` 下生成 `web-users.json` 与审计日志;添加主机后生成加密的 `hosts.json`。 ### 其他启动方式 ```bash # 指定监听地址 dotnet run --urls http://0.0.0.0:5080 # 发布后运行 dotnet publish -c Release -o publish cd publish ASPNETCORE_URLS=http://127.0.0.1:5080 \ Storage__DataDirectory=/var/lib/linuxdesktop \ dotnet LinuxDesktop.dll ``` ### 主机总览与远程桌面 - 登录后进入 **主机总览**,显示当前账号可管理的全部主机。 - 分组卡片按名称排序;“全部”固定在第一位。 - 点击分组卡片会过滤下方主机列表;搜索框会叠加当前分组过滤。 - 点击主机行或“进入”按钮,会打开一个新的浏览器标签页进入该主机的远程桌面。 - 主机的新增、编辑、删除、连接测试、主机密钥重置仍在行尾按钮中;新增主机时可选择或新建分组。 - **分组管理**支持重命名和删除分组;删除分组只把主机移动到“未分组”,不删除主机。 - 远程桌面标签页只包含该主机相关应用;没有主机管理、账号管理、主机切换和批量模式。 ### 远程桌面操作 - **双击图标**打开应用;拖动图标只能落到网格,已占用格会交换位置,不会重叠;位置保存在 localStorage。 - **右键桌面**:刷新、排列图标、更换壁纸、在桌面打开终端、重新连接 SSH。 - **任务栏左侧**:SSH 用户名/主机名/IP、固定应用、已打开窗口按钮;没有开始菜单。 - **任务栏窗口按钮**:悬停显示缩略预览;右键可最大化、还原窗口大小、最小化、关闭、重新打开新窗口、固定/取消固定。 - **任务栏右侧**:当前主机/连接状态、主题切换、每秒时钟。 - **窗口**:标题栏拖动;右下角/右边缘/下边缘缩放;最小化到任务栏;双击标题栏最大化/还原;关闭带缩放淡出动画;右上角控件贴顶/贴右。 - **文件窗口**:可同时打开多个;地址栏输入路径回车跳转,不存在时弹框;文件列表与详情字体已放大。 - **连接中断**:整页灰色蒙版不可操作,中间弹框显示失败原因,提供“重新连接”和“关闭”。关闭会尝试关闭当前标签页,失败时返回主机总览。 - **硬件**:双击“硬件”打开只读硬件窗口;左侧分区导航,右侧只显示当前分区;默认“概览”,包含系统、CPU、内存、磁盘、网络、GPU、传感器/电源、RAID。 - **网络**:双击“网络”打开只读网络窗口;左侧分区导航,右侧只显示当前分区;默认“概览”,包含接口、路由、DNS、邻居、监听端口、bond/bridge。 - **实时性能**:双击“实时性能”打开仪表盘;每 3 秒采样并绘制 CPU、内存、磁盘、网络、GPU 趋势,支持暂停/继续和刷新。 - **实时进程**:双击“实时进程”打开列表;支持搜索、CPU/内存/PID 排序、详情和单条结束。管理员结束进程需输入 PID 确认。 - **系统设置**:双击“系统设置”查看主机名、时区、NTP、系统语言、X11 键盘布局和机器信息;管理员修改需输入“确认”。 - **文件系统**:双击“文件系统”打开 Explorer,可打开多个独立窗口;顶部唯一地址栏可直接输入路径,前进/后退/上一级、快捷位置、搜索、隐藏文件复选框;右侧预览面板默认关闭,通过“开启预览”复选框显示。双击文本直接打开 Monaco,双击图片打开独立查看器;右键提供打开/复制/剪切/粘贴/删除/重命名/压缩/属性;Ctrl/Shift/矩形框选和拖拽移动已接入;任意登录用户可编辑和下载,破坏性文件操作仅管理员。 --- ## 配置 `appsettings.json`: ```json { "Storage": { "DataDirectory": "Data" }, "ReverseProxy": { "Enabled": false }, "Auth": { "AllowSelfRegistration": true, "SessionHours": 8, "RememberMeDays": 7, "MaxLoginFailures": 5, "LoginFailureWindowMinutes": 5, "Pbkdf2Iterations": 210000 }, "Ssh": { "ConnectTimeoutSeconds": 15, "InternalCommandTimeoutSeconds": 5, "IdleTimeoutMinutes": 5 }, "Batch": { "MaxConcurrency": 0 } } ``` | 配置项 | 默认值 | 说明 | | --- | --- | --- | | `Storage:DataDirectory` | `Data` | 数据目录,可使用绝对路径 | | `Auth:AllowSelfRegistration` | `true` | 是否允许自助注册 | | `Auth:SessionHours` | `8` | 普通会话有效期 | | `Auth:RememberMeDays` | `7` | “记住我”有效期 | | `Auth:MaxLoginFailures` | `5` | 限流窗口内最大失败次数 | | `Auth:LoginFailureWindowMinutes` | `5` | 限流窗口 | | `Auth:Pbkdf2Iterations` | `210000` | PBKDF2 迭代次数,最低强制 100,000 | | `Ssh:ConnectTimeoutSeconds` | `15` | SSH 连接建立超时;超时快速失败 | | `Ssh:InternalCommandTimeoutSeconds` | `5` | 内部采集命令短超时(后续模块使用) | | `Ssh:IdleTimeoutMinutes` | `5` | 连接池空闲释放时间 | | `Batch:MaxConcurrency` | `0` | 为后续批量模块保留的并发上限;当前主机首页不提供批量操作 | | `Files:MaxUploadBytes` | `104857600` | 单文件上传上限(100 MiB),同时限制 Kestrel/表单请求体 | | `ReverseProxy:Enabled` | `false` | 是否信任本机反向代理的 `X-Forwarded-*` | 环境变量使用双下划线覆盖,例如: ```bash export Storage__DataDirectory=/var/lib/linuxdesktop export Auth__AllowSelfRegistration=false export Batch__MaxConcurrency=20 export ReverseProxy__Enabled=true ``` --- ## 数据与安全 ### 数据文件 | 路径 | 内容 | | --- | --- | | `Data/web-users.json` | Web 账号与 PBKDF2 密码哈希 | | `Data/web-users.json.bak` | 上一次写入前的备份 | | `Data/hosts.json` | SSH 主机配置;密码、私钥、口令字段为 Data Protection 密文 | | `Data/hosts.json.bak` | 主机配置的上一次写入备份 | | `Data/audit.log.jsonl` | 追加式操作审计日志 | | `Data/dp-keys/` | Data Protection 密钥环(Cookie 与 SSH 凭据加密) | Linux 上数据目录会尝试收紧为 `0700`,数据文件为 `0600`。**不要把这些文件提交到 Git 或放入公开备份。** > Data Protection 密钥环在 Linux 上默认不额外加密,依赖 `Data/dp-keys/` 的目录权限保护。如果威胁模型要求更高,请把数据目录放到加密卷,或后续改用证书保护密钥。 ### 认证设计 - Web 登录账号与目标 Linux 系统用户完全独立。 - 密码只保存 PBKDF2-SHA256 哈希,API 永不返回哈希或明文。 - 登录失败统一返回“用户名或密码错误”,不泄露账号是否存在。 - 账号不存在时也执行一次等价 PBKDF2 计算,降低响应时间侧信道。 - 禁用账号、重置密码、修改角色会轮换安全戳;每次请求都会重新校验账号状态与安全戳。 - 管理员接口通过 `RequireAuthorization("Administrator")` 强制角色校验。 - 不允许删除自己、禁用自己、删除最后一个启用管理员、把最后一个管理员降级。 - 审计日志只记录操作者、动作、目标和脱敏摘要。 ### SSH 与主机密钥 - SSH 密码、私钥与私钥口令使用独立的 Data Protection purpose 加密,`hosts.json` 中只保存密文。 - 主机 DTO 只返回 `hasPassword` / `hasPrivateKey` 等标志,绝不返回密文以外的凭据内容,更不返回明文。 - 首次连接某台主机时接受并缓存其 SHA256 主机密钥指纹(TOFU 模型)。 - 后续连接会重新计算指纹:与缓存不一致时直接拒绝连接,并在结果中返回旧/新指纹;不会自动信任新密钥。 - 管理员确认主机重装或密钥轮换可信后,可在主机详情中显式“重置主机密钥”,下次连接才会重新信任。 - SSH 连接建立超时默认 15 秒;超时只影响当前主机,不阻塞其他主机。 - 连接池按主机复用 `SshClient` / `SftpClient`,空闲 5 分钟后释放。 - 单主机远程桌面每 10 秒检查连接池中的 SSH 会话;断开时显示整页灰色蒙版和重新连接入口。 - 硬件与网络采集使用固定只读 SSH 脚本,不接受用户命令;内部命令超时 5 秒,输出限制 512 KB。 - 采集不调用 `sudo`;DMI、传感器、RAID、监听端口进程名等需要额外权限或工具时降级为空并显示提示。 - 网络页只读取接口、路由、DNS、邻居和监听端口,不修改网络配置,也不主动发起 ping/扫描。 - 实时性能默认每 3 秒采样一次,CPU/磁盘/网络速率由服务端基于前后两次计数器差分计算。 - 实时性能只读取 `/proc`、`ss` 与 `nvidia-smi` 聚合信息,不采集进程参数;关闭窗口会停止轮询。 - 结束进程仅限管理员,固定 `kill -TERM `,不接受自定义信号;执行前输入 PID 二次确认,服务端拒绝 PID ≤ 1,并记录审计。 - 进程列表最多展示 CPU 占用最高的 500 条,避免一次拉取过多数据。 - 系统设置修改仅限管理员,服务端拒绝非法主机名/时区/语言/布局,只调用固定 systemd 命令;执行前需输入“确认”,并审计旧值/新值。 - 文件浏览使用 SFTP 而非 shell;远程路径归一化并拒绝反斜杠/NUL,按主机串行化 SFTP 操作。 - 文件上传仅限管理员,文件名拒绝路径分隔符/控制字符;服务端限制单文件大小并返回 409 供前端二次确认覆盖;上传成功写入审计。 - 文件下载流式输出,设置 `Content-Disposition: attachment` 与 `nosniff`,不把大文件读入内存。 - 文件预览只读取严格 UTF-8 文本或安全图片扩展名;二进制不返回内容;图片内联只允许白名单 MIME,SVG 不作为图片内联。 - 文件编辑对任意已登录用户开放;保存要求 SHA-256 版本校验并二次输入文件名;符号链接不可直接编辑;审计记录旧/新哈希与大小,不记录文件内容。 - 预览/编辑不设应用层大小上限,但大文件打开前由前端二次确认;Monaco 资源本地化,不依赖外部 CDN。 - 删除/重命名/复制/移动/压缩/新建/解压仍仅管理员可执行;路径归一化,拒绝根目录和把目录复制/移动到自身内部;删除通过 SFTP 递归处理,复制使用固定 `cp -a` 命令并做 shell 转义,压缩使用固定 `tar -czf`,解压使用固定 `tar`/`unzip` 命令并拒绝覆盖已有目标。 - Web 终端仅管理员可用;每个 WebSocket 使用独立 SSH 连接和 shell,限制会话数;只审计打开/关闭,不记录命令内容;终端输入输出不写入磁盘。 - 包列表使用固定 SSH 脚本读取 dpkg/rpm/pacman 与 APT/RPM/Pacman 软件源;输出上限 8 MB、采集超时 30 秒。 - 安装/卸载/升级仅管理员;包名与版本经过白名单和 shell 转义,固定包管理器命令,每主机串行执行,操作超时 5 分钟;执行前输入包名确认,结果写入审计。 - 软件源管理仅管理员;系统源只读,托管源文件写入前备份为 `.bak`,URI/Suite/Components 白名单校验,启用/停用通过重命名 `.disabled`,`apt-get update` 超时 5 分钟并审计。 - systemd 列表/详情读取使用固定 `systemctl`/`journalctl` 命令;服务名经过白名单校验;依赖和日志输出有上限。 - systemd 启停/重启/开机启用仅管理员;动作白名单,服务名确认后执行,每主机串行,超时 5 分钟,结果写入 `systemd.start/stop/restart/enable/disable` 审计。 - drop-in 编辑仅管理员;服务名与文件名白名单,内容上限 64 KiB;写入前保存原内容、写入后执行 `systemd-analyze verify`,失败自动回滚;成功后 `daemon-reload`;删除保留 `.bak`;操作写入 `systemd.dropin.save/delete` 审计。 - 用户与组读取通过固定 `getent passwd/group/shadow`、`who` 采集,shadow 只输出密码状态,不返回哈希;登录来源仅在会话页显示,不写入日志或截图。 - 用户变更仅管理员;用户名/Shell 白名单,密码通过 SSH shell 的 `chpasswd` 标准输入设置,不出现在命令行或审计;root 与当前 SSH 用户受保护;每主机串行,操作写入 `user.*` 审计(不记录密码)。 - 定时任务读取使用固定脚本,不执行 cron 命令、不修改系统已有任务;输出上限 4 MB。 - 托管 cron 任务仅管理员;文件名/计划/用户/命令白名单,写入 `/etc/cron.d/linuxdesktop-*` 并强制 0644;测试运行通过 `runuser` 执行,30 秒超时;删除保留 `.bak`;操作写入 `cron.create/delete/test` 审计(不记录命令输出到审计)。 - 日志页面只读;固定 `journalctl`/`tail` 命令,unit/priority/lines 白名单,不执行日志管理或修改;输出上限 8 MB。日志可能包含登录来源等敏感信息,不写入审计。 - 内核页面完全只读;固定 `uname`/`sysctl`/`lsmod`/`/proc`/limits 命令,不修改 sysctl、模块或启动项;sysctl 上限 4000 条,模块 1000 条。 - 磁盘页面完全只读;固定 `df`/`lsblk`/`/proc/swaps`/`fstab` 读取,不格式化、不挂载、不修改分区或 fstab;块设备/文件系统有数量上限。 - 容器页面完全只读;仅调用 `docker/podman/nerdctl ps/images` 与 `virsh list` 查询,不启动/停止容器或虚拟机;无运行时不会报错,只显示警告和空态。 - 证书扫描使用固定 `openssl x509` 解析本地/服务证书,跳过系统 CA 根证书库,不读取私钥;输出上限 4 MB、最多 80 个证书。 - 证书生成仅管理员;CN/SAN/名称/天数白名单校验,固定 `openssl req -x509` 参数,不覆盖同名文件;证书 0644、私钥 0600,不通过界面下载私钥,操作写入 `certificate.generate` 审计。 - Nginx 站点编辑仅管理员;只允许 `/etc/nginx/conf.d/linuxdesktop-*.conf`,名称/内容白名单,写入前执行 `nginx -t`,失败自动恢复;成功后 `systemctl reload nginx`;删除保留 `.bak`,操作写入 `nginx.config.*` 审计。 - 系统 nginx 配置和日志只读;日志可能包含访问来源等敏感信息,不写入审计。 - 普通用户可查看主机列表并执行连接测试;新增、修改、删除、重置主机密钥仅管理员可操作。 > TOFU 首次信任无法替代带外指纹核验。对高安全环境,建议在首次连接后通过可信渠道核对页面展示的 SHA256 指纹。 ### 安全响应头 - `Content-Security-Policy`:脚本仅同源;iframe 仅同源 - `X-Frame-Options: SAMEORIGIN` - `X-Content-Type-Options: nosniff` - `Referrer-Policy: no-referrer` - HTTPS 下自动添加 HSTS ### 反向代理 若通过 Nginx / Caddy 暴露服务,建议: 1. 应用只监听 `127.0.0.1`。 2. 设置 `ReverseProxy__Enabled=true`,让应用读取本机代理的 `X-Forwarded-Proto`(Cookie 才会标记 `Secure`)。 3. 代理必须传递 `X-Forwarded-For` 与 `X-Forwarded-Proto`。 `ForwardedHeaders` 默认只信任回环地址上的代理。如果代理不在本机,请勿直接清空已知代理列表,应按部署环境显式配置可信代理。 --- ## API 摘要 | 方法 | 路径 | 权限 | 说明 | | --- | --- | --- | --- | | POST | `/api/auth/login` | 匿名 | 登录 | | POST | `/api/auth/register` | 匿名 | 自助注册(受配置控制) | | POST | `/api/auth/logout` | 登录 | 注销 | | GET | `/api/auth/me` | 登录 | 当前用户 | | POST | `/api/auth/change-password` | 登录 | 修改自己的密码(成功后要求重新登录) | | GET | `/api/admin/users` | 管理员 | 账号列表,支持 `?q=` | | POST | `/api/admin/users` | 管理员 | 新增账号 | | PATCH | `/api/admin/users/{id}` | 管理员 | 修改角色 / 启用状态 | | POST | `/api/admin/users/{id}/reset-password` | 管理员 | 重置密码 | | DELETE | `/api/admin/users/{id}` | 管理员 | 删除账号 | | GET | `/api/admin/audit?limit=50` | 管理员 | 最近审计日志 | | GET | `/api/hosts` | 登录 | 主机列表(不含凭据) | | GET | `/api/hosts/groups` | 登录 | 分组列表与组内主机数(按名称排序) | | GET | `/api/hosts/{id}` | 登录 | 主机详情(不含凭据) | | POST | `/api/hosts` | 管理员 | 新增主机;可指定或创建分组 | | PUT | `/api/hosts/{id}` | 管理员 | 更新主机;地址/端口变化会清除主机密钥信任 | | DELETE | `/api/hosts/{id}` | 管理员 | 删除主机并释放连接池 | | POST | `/api/hosts/{id}/test` | 登录 | 单台真实 SSH 连接测试并预热连接池 | | GET | `/api/hosts/{id}/health` | 登录 | 检查连接池中的 SSH 会话是否仍然可用 | | GET | `/api/hosts/{id}/hardware` | 登录 | 机器与硬件只读快照;固定脚本、5 秒超时 | | GET | `/api/hosts/{id}/network` | 登录 | 网络接口/路由/DNS/邻居/端口只读快照 | | GET | `/api/hosts/{id}/metrics` | 登录 | 实时性能快照;服务端计算 CPU/磁盘/网络差分速率 | | GET | `/api/hosts/{id}/processes` | 登录 | 进程列表;最多返回 CPU 占用最高的 500 条 | | POST | `/api/hosts/{id}/processes/{pid}/terminate` | 管理员 | 对单个进程发送固定 SIGTERM | | GET | `/api/hosts/{id}/settings` | 登录 | 主机名/时区/NTP/语言/键盘布局与机器信息 | | GET | `/api/hosts/{id}/packages` | 登录 | 包管理器、已安装/可升级包、软件源只读快照 | | GET | `/api/hosts/{id}/packages/versions?name=...` | 登录 | 查询可用软件包版本 | | GET | `/api/hosts/{id}/packages/search?q=...` | 登录 | 搜索软件源中的软件包 | | POST | `/api/hosts/{id}/packages/install` | 管理员 | 安装软件包,可选版本 | | POST | `/api/hosts/{id}/packages/remove` | 管理员 | 卸载软件包 | | POST | `/api/hosts/{id}/packages/upgrade` | 管理员 | 升级指定软件包 | | POST | `/api/hosts/{id}/packages/sources` | 管理员 | 添加托管软件源 | | POST | `/api/hosts/{id}/packages/sources/remove` | 管理员 | 删除托管软件源 | | POST | `/api/hosts/{id}/packages/sources/toggle` | 管理员 | 启用/停用托管源文件 | | POST | `/api/hosts/{id}/packages/sources/update` | 管理员 | 执行 apt-get update | | GET | `/api/hosts/{id}/systemd` | 登录 | systemd 服务列表、状态统计 | | GET | `/api/hosts/{id}/systemd/unit?unit=...` | 登录 | 单个服务属性、依赖与最近日志 | | POST | `/api/hosts/{id}/systemd/action` | 管理员 | 启动/停止/重启/启用/禁用服务 | | GET | `/api/hosts/{id}/systemd/dropins?unit=...` | 登录 | 读取服务的 drop-in 文件 | | POST | `/api/hosts/{id}/systemd/dropins` | 管理员 | 保存 drop-in(校验/回滚/daemon-reload) | | POST | `/api/hosts/{id}/systemd/dropins/delete` | 管理员 | 删除 drop-in,保留 .bak | | GET | `/api/hosts/{id}/users` | 登录 | 用户、用户组、密码状态与登录会话只读快照 | | POST | `/api/hosts/{id}/users/create` | 管理员 | 创建用户(主目录/Shell/sudo) | | POST | `/api/hosts/{id}/users/password` | 管理员 | 重置用户密码 | | POST | `/api/hosts/{id}/users/lock` | 管理员 | 锁定/解锁用户 | | POST | `/api/hosts/{id}/users/sudo` | 管理员 | 加入/移出 sudo | | POST | `/api/hosts/{id}/users/shell` | 管理员 | 修改登录 Shell | | POST | `/api/hosts/{id}/users/delete` | 管理员 | 删除用户,可选删除主目录 | | GET | `/api/hosts/{id}/cron` | 登录 | 用户/系统 cron、systemd timer 与 cron 目录只读快照 | | POST | `/api/hosts/{id}/cron/jobs` | 管理员 | 创建托管 cron 任务 | | POST | `/api/hosts/{id}/cron/jobs/delete` | 管理员 | 删除托管任务,保留 .bak | | POST | `/api/hosts/{id}/cron/jobs/test` | 管理员 | 立即以任务用户运行命令 | | GET | `/api/hosts/{id}/logs?source=journal&unit=...&priority=...&lines=...` | 登录 | journald/syslog 日志快照 | | GET | `/api/hosts/{id}/kernel` | 登录 | 内核、sysctl、模块、limits 与启动项只读快照 | | GET | `/api/hosts/{id}/disks` | 登录 | 文件系统、块设备、swap 与 fstab 只读快照 | | GET | `/api/hosts/{id}/containers` | 登录 | 容器、镜像、libvirt VM 与运行时只读快照 | | GET | `/api/hosts/{id}/certificates` | 登录 | 本地/服务证书扫描与到期信息 | | POST | `/api/hosts/{id}/certificates/generate` | 管理员 | 生成 OpenSSL 自签名证书 | | GET | `/api/hosts/{id}/nginx` | 登录 | nginx 版本/状态/配置/站点/日志只读快照 | | POST | `/api/hosts/{id}/nginx/config` | 管理员 | 保存托管站点配置,校验后 reload | | POST | `/api/hosts/{id}/nginx/config/delete` | 管理员 | 删除托管站点,保留 .bak | | POST | `/api/hosts/{id}/nginx/test` | 管理员 | 执行 nginx -t | | PUT | `/api/hosts/{id}/settings/hostname` | 管理员 | 修改主机名 | | PUT | `/api/hosts/{id}/settings/timezone` | 管理员 | 修改时区 | | PUT | `/api/hosts/{id}/settings/ntp` | 管理员 | 启用/停用 NTP | | PUT | `/api/hosts/{id}/settings/locale` | 管理员 | 修改系统语言 | | PUT | `/api/hosts/{id}/settings/keymap` | 管理员 | 修改 X11 键盘布局 | | GET | `/api/hosts/{id}/files?path=...` | 登录 | SFTP 目录列表与文件元数据 | | GET | `/api/hosts/{id}/files/preview?path=...` | 登录 | 文本/图片/二进制预览元数据与文本内容 | | GET | `/api/hosts/{id}/files/download?path=...&inline=true` | 登录 | 流式下载;`inline` 仅允许安全图片类型 | | POST | `/api/hosts/{id}/files/upload?path=...&overwrite=...` | 管理员 | 上传单个文件到目标目录 | | PUT | `/api/hosts/{id}/files/content` | 登录 | 保存文本,要求 `expectedSha256` | | POST | `/api/hosts/{id}/files/delete` | 管理员 | 批量删除文件/目录(递归) | | POST | `/api/hosts/{id}/files/rename` | 管理员 | 重命名单个对象 | | POST | `/api/hosts/{id}/files/copy` | 管理员 | 批量复制到目标目录 | | POST | `/api/hosts/{id}/files/move` | 管理员 | 批量移动/拖拽到目标目录 | | POST | `/api/hosts/{id}/files/compress` | 管理员 | 当前目录批量压缩为 `.tar.gz` | | POST | `/api/hosts/{id}/files/mkdir` | 管理员 | 新建文件夹 | | POST | `/api/hosts/{id}/files/extract` | 管理员 | 解压 tar.gz/tgz/tar/zip 到同名目录 | | WebSocket | `/api/hosts/{id}/terminal` | 管理员 | 交互式 SSH shell;二进制输出、JSON resize/ping | | PUT | `/api/hosts/groups/{name}` | 管理员 | 重命名分组 | | DELETE | `/api/hosts/groups/{name}` | 管理员 | 删除分组,组内主机移动到“未分组” | | POST | `/api/hosts/{id}/reset-host-key` | 管理员 | 显式重置主机密钥信任 | 除登录、注册外,所有 `/api` 请求未认证时返回 `401`;页面未登录时重定向到 `/login.html`。 --- ## 测试 启动服务后,在 Windows PowerShell 中运行: ```powershell powershell -ExecutionPolicy Bypass -File .\scripts\smoke-auth.ps1 -BaseUrl http://127.0.0.1:5081 ``` 脚本覆盖: - 未登录 401 / 页面重定向 / 安全响应头 - 默认管理员登录、Cookie 属性 - 创建账号、重复用户名 409、账号搜索 - 普通用户访问管理员接口与账号管理页被拒绝 - 登录失败 5 次后返回 429 与 `Retry-After` - 禁用后旧会话立即失效、禁用账号无法登录 - 角色变更、重置密码、自行改密后的会话失效 - 自助注册、注销 - 管理员不能删除/禁用自己 - 审计日志存在且不包含密码/哈希 > 冒烟脚本使用临时数据目录时,请通过 `Storage__DataDirectory` 指向测试目录,避免污染正式账号。 ### SSH 主机测试 准备一台可用 SSH 登录的测试主机后运行: ```powershell powershell -ExecutionPolicy Bypass -File .\scripts\smoke-hosts.ps1 ` -BaseUrl http://127.0.0.1:5081 ` -PrivateKeyPath C:\path\to\test_key ` -SshHost 127.0.0.1 -SshPort 2222 -SshUser testuser ` -DataDirectory E:\path\to\test-data ``` 脚本覆盖: - 主机创建、输入校验、密码/私钥凭据加密落盘 - 首次连接信任主机密钥、第二次连接指纹复用 - 连接池健康检查 - 不可达主机失败隔离 - 分组列表、按名称排序、重命名、删除后移动主机 - 普通用户只读/测试,写操作 403 - 修改端点清除主机密钥信任、重置信任 - 删除主机与审计日志脱敏 主机密钥变化拒绝流程需要重启测试 SSH 服务并更换主机密钥后再次测试;已验证会返回 `host_key_mismatch`,且不会自动更新缓存指纹。 ### 主页与远程桌面验收 `scripts/qa-home-remote.mjs` 通过 Chrome DevTools Protocol 验证: - 主页分组卡片顺序(全部在第一位、其余按名称排序) - 分组过滤、无“控制台”入口、无旧统计卡片、无批量操作和复选框 - 添加主机时新建分组 - 分组管理对话框 - 点击主机行在新标签页打开远程桌面 - 浏览器标签页标题包含主机名/用户名/地址 - 远程桌面只显示 17 个主机相关图标,无主机管理/账号管理/批量/Web 用户信息 - 窗口打开、最大化、还原、关闭动画 - 连接异常时整页灰色蒙版、失败信息、“重新连接”和“关闭” - 重新连接成功 `scripts/qa-app-nav.mjs` 验证真实 Linux 主机的硬件/网络分区布局: - 硬件左侧 9 个分区、网络左侧 7 个分区 - 默认“概览”显示 6 个摘要卡片 - 点击 CPU/路由表后右侧只保留一个对应分区 - 侧边栏宽度、激活状态、分区计数 - 只读标识、无输入表单 - 无前端运行时错误 `scripts/qa-monitor.mjs` 验证实时性能: - 6 个摘要卡片、5 个趋势图、CPU 核心条、监听端口与连接状态 - 至少两次 3 秒采样后出现真实 CPU/内存/网络数据和曲线 - 暂停后时间戳保持不变,继续后恢复采样 - 无前端运行时错误 `scripts/qa-process.mjs` 验证实时进程: - 摘要卡片、进程表格、管理员结束按钮 - 搜索目标 `sleep` 进程并打开详情 - 输入 PID 二次确认后执行 `kill -TERM` - 目标进程从刷新后的列表消失,toast 提示成功 - 无前端运行时错误 `scripts/qa-files.mjs` 验证文件系统浏览: - 默认进入 SSH 用户主目录 `/root`,隐藏文件默认不显示 - 显示隐藏文件后条目从 1 增加到 15 - 快捷位置进入 `/etc`,渲染 149 项 - `/etc/passwd` 详情显示大小、修改时间、`-rw-r--r--`、`root:root` - 顶部地址栏、后退回到 `/root` - 管理员可见上传按钮,选中文件详情显示下载按钮 - 无前端运行时错误 `scripts/qa-transfer-ui.mjs` 验证上传/下载界面: - 管理员上传按钮、单文件上限提示 - 通过文件选择上传到 `/root`,文件出现在刷新后的列表 - 详情面板显示下载按钮 - 同名再次上传弹出覆盖确认,取消后不执行 - 无未预期前端运行时错误 `scripts/qa-desktop-ux.mjs` 验证桌面 UX: - 默认 dark、无开始菜单/搜索、任务栏显示用户名/主机/IP - 17 个图标全部在唯一网格位置,拖动后仍吸附且不重叠 - 文件系统可打开多个窗口(任务栏按钮同步增加) - 悬停任务栏窗口显示缩略预览 - 右键菜单包含最大化/还原/最小化/关闭/重开/固定 - 最大化后“还原窗口大小”恢复初始尺寸;固定应用成功 - 文件窗口地址栏输入 `/etc` 正常;不存在路径弹出提示 - 关闭按钮贴顶/贴右,文件表字体 12.5px,文件名可选择 - 无未预期前端运行时错误 `scripts/qa-desktop-shots.mjs` 生成 `desktop-ux.png` 与 `desktop-file.png` 两张深色桌面验收截图。 `scripts/qa-monaco.mjs` 验证 Explorer、Monaco 与大文件确认: - 顶部唯一地址栏;无重复地址输入框和旧面包屑 - 隐藏文件/开启预览均为复选框;预览面板默认关闭 - 窗口控制按钮 cursor 为 default;任务栏右键不弹出浏览器菜单 - 双击文本直接打开独立 Monaco 编辑器,不再先打开预览 - 关闭 Explorer 后 Monaco 编辑器仍保留 - Monaco 加载本地资源、显示文本、格式化、自动换行、修改并二次确认保存 - 超过 50 MiB 的文本/编辑器打开前二次确认 - 超过 30 MiB 的图片查看器打开前二次确认 - 无未预期前端运行时错误 ![Monaco 编辑器](obj/qa-shots/files-monaco.png) `scripts/qa-ops.mjs` 验证 Explorer 操作、图片查看器与 Monaco 快捷键: - 最近目录分组、Ctrl 多选和右键菜单 - 重命名、删除、压缩、复制/粘贴、拖拽移动 - 文本双击直达 Monaco;Alt+Shift+F 格式化,Alt+Z 自动换行 - 图片查看器独立于 Explorer,显示分辨率/大小、旋转、Ctrl+滚轮缩放、1:1 - 无未预期前端运行时错误 ![图片查看器](obj/qa-shots/files-image-viewer.png) `scripts/qa-terminal.mjs` 验证 Web 终端: - xterm.js 本地资源加载,无 AMD 冲突 - WebSocket 连接真实 SSH shell,状态变为“已连接” - 输入 `echo TERMINAL_READY`,终端回显命令与结果 - 支持窗口缩放、清屏、重新连接 - 浏览器运行时错误为 0 ![Web 终端](obj/qa-shots/terminal.png) `scripts/qa-packages.mjs` 验证应用管理页(只读列表 + 管理员操作): - 概览卡片:包管理器、发行版、已安装、可升级、软件源、体积 - 已安装列表可搜索(Debian 13 实测 389 个包) - 可升级列表与软件源列表 - 管理员安装按钮、版本查询、卸载/升级操作入口 - 安装 cowsay → 升级 → 卸载完整 API 验证;审计记录 package.install/upgrade/remove - 软件源添加/删除/停用/启用/更新索引 API 验证 - 命令百科按当前 APT/dpkg 展示 27 条,5 个分类,搜索“版本”返回 7 条 - 只读/管理员标识、刷新、加载/错误状态 - 无未预期浏览器运行时错误 ![应用管理](obj/qa-shots/packages.png) ![软件源管理](obj/qa-shots/packages-sources.png) ![命令百科](obj/qa-shots/packages-commands.png) `scripts/qa-svc.mjs` 验证 systemd 只读页: - 服务总数 102、运行中 32、失败 0、开机启用 14 - 搜索/状态筛选 - 选择 ssh.service 后显示 49 个依赖与 80 行 journal 日志 - 服务总数合并已加载单元与单元文件后为 177,开机启用 15 - 临时 linuxdesktop-qa.service:启动 → 运行 → 停止 → inactive;启用/禁用开机启动成功 - UI 启动、停止按钮与输入服务名确认流程 - drop-in:空目录读取、保存 `override.conf`、读取内容、非法配置 422 并回滚、删除并保留 `.bak` - drop-in 弹窗使用 Monaco 编辑器,`systemd-analyze verify` 通过后写入 - 只读标识、刷新、错误状态 - 无未预期浏览器运行时错误 ![systemd drop-in](obj/qa-shots/systemd-dropin.png) `scripts/qa-users.mjs` 验证用户与组只读页: - 用户总数 25、人类用户 3、管理员 1、已锁定 1、登录中 1、用户组 52 - 搜索 `root` 精确收敛到 1 行 - 用户组 52 行、登录会话 4 行 - 密码状态只显示已设置/已锁定,不显示 shadow 哈希 - 只读标识、刷新、加载/错误状态 - 用户生命周期 API:创建 ldqa → 锁定/解锁 → 重置密码 → sudo 加入/移出 → Shell 改为 /bin/sh → 删除并删除主目录 - root 删除返回 403;用户与主目录确认已清理 - UI:新建用户弹窗字段、用户管理操作列表、管理员标识 - 审计:user.create/lock/unlock/password/sudo.add/sudo.remove/shell/delete - 无未预期浏览器运行时错误 ![用户与组](obj/qa-shots/users.png) `scripts/qa-cron.mjs` 验证定时任务只读页: - 任务总数 7、用户 crontab 0、系统 cron 7、systemd timer 8 - 系统任务 7 行;搜索 `linuxdesktop-qa` 收敛到 1 行 - systemd timer 8 行、cron 目录 4 个 - 只读标识、刷新、加载/错误状态 - 无未预期浏览器运行时错误 ![定时任务](obj/qa-shots/cron.png) `scripts/qa-cron-editing.mjs` 验证托管 cron: - 管理员“添加任务”按钮与表单 - 创建 `linuxdesktop-ldqa-cron`,来源/计划/命令解析正确,文件权限 0644 - 测试运行输出 `cron-test-ok` - 非法计划返回 400 - 删除保留 `.bak`,测试文件已清理 - 管理列对托管任务显示测试/删除,系统原有任务只读 - 无未预期浏览器运行时错误 `scripts/qa-kernel.mjs` 验证内核只读页: - 内核 6.12.111+deb13-amd64、x86_64、运行 6 小时 19 分 - 内核模块 97、sysctl 1032、启动项 2 - sysctl 搜索 `fips` 返回 3 条 - 内核模块与引用关系、启动内核文件、limits/ulimit 展示 - 只读标识、刷新、加载/错误状态 - 无未预期浏览器运行时错误 ![内核](obj/qa-shots/kernel.png) `scripts/qa-disks.mjs` 验证磁盘只读页: - 文件系统 9、块设备 5、swap 1、fstab 3 - 总容量 21.6 GiB、已用 4.18 GiB、可用 16.5 GiB、使用率 19% - `/` 文件系统 24% 使用率 - 文件系统/块设备/swap/fstab 切换与展示 - 只读标识、刷新、加载/错误状态 - 无未预期浏览器运行时错误 ![磁盘与文件系统](obj/qa-shots/disks.png) 容器与虚拟化页面在测试主机上未安装 Docker/Podman/nerdctl/libvirt: - 运行时 0、容器 0、镜像 0、虚拟机 0 - 正确显示“未检测到容器运行时”警告与空态 - 容器/镜像/虚拟机/运行时四个标签页可切换 - 真实容器运行时环境尚未接入,解析逻辑保留 `scripts/qa-certificates.mjs` 验证证书只读页: - 生成临时自签名证书 `CN=linuxdesktop-qa.local`,剩余 6 天 - 证书总数 1、30 天内到期 1、已过期 0 - OpenSSL 3.5.7 版本展示 - Subject/Issuer、到期时间、路径、自签名标记 - 搜索过滤正常 - 测试证书与私钥已清理 - 无未预期浏览器运行时错误 ![证书与加密](obj/qa-shots/certificates.png) `scripts/qa-nginx-edit.mjs` 验证 Nginx 站点编辑: - 临时安装 nginx 1.26.3,`nginx -t` 通过、active - 3 个配置文件、2 个站点解析 - 创建托管 `linuxdesktop-ldqa.conf`,权限 644 - 保存后 `nginx -t` 通过并 reload - 删除托管站点成功,保留 `.bak` - 测试后 nginx 包与配置已清理 - UI:添加站点按钮、Monaco 编辑弹窗、配置切换 - 无未预期浏览器运行时错误 `scripts/qa-nginx.mjs` 验证 Nginx 只读页: - 测试主机未安装 nginx - 状态“未安装”、版本/配置测试为空 - 站点 0、配置文件 0 - 正确显示空态,不误报命令错误 - 概览/站点/配置/日志标签页结构正常 - 无未预期浏览器运行时错误 ![Nginx 配置](obj/qa-shots/nginx.png) `scripts/qa-certificates-generate.mjs` 验证证书生成: - 生成 `ldqa-self`,CN=ldqa.local,SAN=DNS:ldqa.local,IP:192.0.2.10,30 天 - 证书与私钥路径正确 - 证书权限 644、私钥权限 600 - 扫描结果:自签名、剩余 29 天、SAN 正确 - UI:管理员“生成证书”按钮与表单字段正常 - 测试证书与私钥已清理 - 无未预期浏览器运行时错误 `scripts/qa-logs.mjs` 验证日志只读页: - journald 400 条、Boot 记录 6、单元 150、日志占用约 23.3 MB - 服务单元 `ssh.service` 筛选、级别筛选、行数切换 - 消息搜索、严重级别统计 - syslog 不可用时显示空态与警告 - 无未预期浏览器运行时错误 `scripts/qa-settings.mjs` 验证系统设置: - 4 个摘要卡片、6 个设置/信息卡片 - 主机名、时区、NTP、语言、X11 布局、Machine ID 渲染 - 时区/语言/X11 布局候选列表加载 - 管理员修改确认框显示固定命令、旧值和新值;取消后不执行 - 服务端验证:同值主机名修改成功并审计,非法时区返回 400 - 普通用户 `canModify=false`,修改接口返回 403 需要先启动应用、一个无头 Chrome(`--remote-debugging-port=9222`)和至少两台测试主机。 > 本次实际使用两台真实 Linux 主机完成了密码认证、分组、远程桌面和断线蒙版验证;硬件、网络、实时性能、实时进程、系统设置、文件浏览、上传下载、文件预览与编辑使用其中一台 Debian 13 主机完成验证,传感器、NVIDIA GPU 和 RAID 在当前虚机上不可用,页面正确降级显示。 --- ## 项目结构(当前) ```text LinuxDesktop/ ├── Program.cs ├── appsettings.json ├── global.json ├── Data/ ├── Models/ │ ├── WebUser.cs │ ├── AuthDtos.cs │ ├── HostModels.cs │ ├── HardwareModels.cs │ ├── NetworkModels.cs │ ├── MetricsModels.cs │ ├── ProcessModels.cs │ ├── SettingsModels.cs │ ├── PackageModels.cs │ ├── SystemdModels.cs │ ├── UsersModels.cs │ ├── CronModels.cs │ ├── LogsModels.cs │ ├── KernelModels.cs │ ├── DiskModels.cs │ ├── ContainerModels.cs │ ├── CertificateModels.cs │ ├── NginxModels.cs │ └── FileModels.cs ├── Services/ │ ├── AuthOptions.cs │ ├── AuthService.cs │ ├── PasswordHasher.cs │ ├── WebUserStore.cs │ ├── AuditLogService.cs │ ├── LoginThrottle.cs │ ├── StoragePaths.cs │ ├── HostStore.cs │ ├── HostService.cs │ ├── HardwareService.cs │ ├── NetworkService.cs │ ├── MetricsService.cs │ ├── ProcessService.cs │ ├── SettingsService.cs │ ├── FileService.cs │ ├── PackageService.cs │ ├── SystemdService.cs │ ├── UsersService.cs │ ├── CronService.cs │ ├── LogsService.cs │ ├── KernelService.cs │ ├── DisksService.cs │ ├── ContainersService.cs │ ├── CertificatesService.cs │ ├── NginxService.cs │ ├── TerminalSessionRegistry.cs │ ├── SshConnectionFactory.cs │ └── HostConnectionPool.cs ├── Endpoints/ │ ├── AuthEndpoints.cs │ ├── WebUserEndpoints.cs │ ├── TerminalEndpoints.cs │ └── HostEndpoints.cs ├── scripts/ │ ├── smoke-auth.ps1 │ ├── smoke-hosts.ps1 │ ├── qa-home-remote.mjs │ ├── qa-app-nav.mjs │ ├── qa-monitor.mjs │ ├── qa-process.mjs │ ├── qa-settings.mjs │ ├── qa-files.mjs │ ├── qa-transfer-ui.mjs │ ├── qa-desktop-ux.mjs │ ├── qa-desktop-shots.mjs │ ├── qa-monaco.mjs │ ├── qa-ops.mjs │ ├── qa-terminal.mjs │ ├── qa-packages.mjs │ ├── qa-svc.mjs │ ├── qa-svc-dropin.mjs │ ├── qa-users.mjs │ ├── qa-users-lifecycle.mjs │ ├── qa-cron.mjs │ ├── qa-cron-editing.mjs │ ├── qa-logs.mjs │ ├── qa-kernel.mjs │ ├── qa-disks.mjs │ ├── qa-certificates.mjs │ ├── qa-certificates-generate.mjs │ └── qa-nginx.mjs └── wwwroot/ ├── index.html ├── desktop.html ├── login.html ├── register.html ├── accounts.html ├── hosts.html # 旧链接兼容重定向到 index.html ├── forbidden.html ├── favicon.svg ├── css/ │ ├── app.css │ ├── desktop.css │ ├── hardware.css │ ├── network.css │ ├── monitor.css │ ├── process.css │ ├── settings.css │ ├── files.css │ ├── editor.css │ ├── image-viewer.css │ ├── terminal.css │ ├── packages.css │ ├── systemd.css │ ├── users.css │ ├── cron.css │ ├── logs.css │ ├── kernel.css │ ├── disks.css │ ├── containers.css │ ├── certificates.css │ └── nginx.css ├── vendor/ │ ├── monaco/ # Monaco 0.52.2 本地资源与 LICENSE │ └── xterm/ # xterm.js 5.5.0 + addon-fit 本地资源 └── js/ ├── theme-boot.js ├── api.js ├── util.js ├── icons.js ├── ui.js ├── shell.js ├── login.js ├── register.js ├── home.js ├── desktop.js ├── hardware.js ├── network.js ├── monitor.js ├── process.js ├── settings.js ├── files.js ├── editor.js ├── image-viewer.js ├── terminal.js ├── packages.js ├── package-commands.js ├── systemd.js ├── users.js ├── cron.js ├── logs.js ├── kernel.js ├── disks.js ├── containers.js ├── certificates.js ├── nginx.js ├── window.js └── accounts.js ``` --- ## 部署提示(Linux systemd 示例) ```ini [Unit] Description=Linux Desktop Console After=network.target [Service] Type=simple User=linuxdesktop Group=linuxdesktop WorkingDirectory=/opt/linuxdesktop Environment=ASPNETCORE_URLS=http://127.0.0.1:5080 Environment=Storage__DataDirectory=/var/lib/linuxdesktop Environment=ReverseProxy__Enabled=true ExecStart=/usr/bin/dotnet /opt/linuxdesktop/LinuxDesktop.dll Restart=always RestartSec=3 [Install] WantedBy=multi-user.target ``` ```bash sudo mkdir -p /var/lib/linuxdesktop sudo chown linuxdesktop:linuxdesktop /var/lib/linuxdesktop sudo chmod 700 /var/lib/linuxdesktop ``` 首次启动后从本机访问并修改默认管理员密码,再把服务暴露给受信网络。生产环境务必配置 HTTPS。 网关需要能访问目标主机的 SSH 端口(默认 22)。如果目标在 NAT、跳板机或安全组后,请提前打通网络;当前版本不支持 SSH 跳板链。`dotnet restore` 需要能获取 `SSH.NET` 与 `BouncyCastle.Cryptography` 包。 --- ## 约束提醒 - 本项目坚持零 npm 构建。 - 所有修改类操作后续必须遵循“备份 → 展示命令/diff → 确认 → 执行 → 摘要”。 - 用户主动执行的长任务不设置强制超时;内部采集使用 3~5 秒短超时。 - 后续批量模块必须并发执行、单台失败隔离;当前主机首页不提供批量操作。 - SSH 主机密钥变化必须报错,不自动接受;首次信任需知晓 TOFU 风险。