RMinte
全部指南 admin

日常管理

TianshanOS admin 日常使用指南

面向使用 admin 账户管理 TianshanOS 的用户,覆盖系统状态、设备面板、网络、文件与 OTA 更新。

9 个章节 六种语言 TianshanOS
展开本页目录

本指南依据 TianshanOS 0.6.3 编写。使用其他版本时,请结合对应版本的说明核对操作。

本指南面向使用 admin 账户的用户,介绍系统查看、设备控制、网络、文件和固件升级。终端、远程指令与自动化配置由 root 运维指南说明;安全管理请参阅单独的安全指南。

按设备页面显示的功能操作。部分选项需要指定硬件或配置才会出现。电脑上将指针停在图标按钮上,可查看按钮名称。手机表格较宽时,在表格内左右滑动查看其他列。

1. 开始使用

进入 WebUI

  1. 在浏览器中打开管理员提供的设备网页地址(WebUI)。
  2. 点击页面右上角的“登录”。
  3. 用户名保持为 admin,输入设备提供的 admin 密码。
  4. 点击“登录”。登录成功后,右上角会显示当前用户名。

使用默认密码登录后,页面会显示“安全提醒”。输入当前密码,再输入两次新密码,点击“立即修改”。两次新密码必须一致。点击“稍后修改”可关闭提醒。

使用完毕后,点击右上角的“退出登录”。再次操作设备时需要重新登录。

切换语言

点击页面顶部的语言按钮,在菜单中选择中文或 English。页面内容和按钮名称会立即切换到所选语言。

页面导航

admin 日常使用的主要入口如下:

  • “系统”:查看设备状态,控制模组、风扇和 LED,并进入 OTA 升级。
  • “网络”:查看以太网和 DHCP 状态,设置 WiFi 和 NAT 网络转发。
  • “文件”:管理 SD 卡和 SPIFFS 中的文件。
  • “安全”:进入单独的安全管理页面,详细操作请查看安全指南。

2. 系统状态与常用操作

点击顶部导航中的“系统”进入系统页面。

查看资源与服务状态

“带外管理芯片资源监控”显示管理芯片的 CPU、DRAM 和 PSRAM 使用情况。这些读数不代表 AGX 或 LPMU 的资源使用率。

  • 点击“详情”,查看内存总量、已用和空闲空间等信息。
  • “服务”按钮显示运行中的服务数和服务总数。点击后可查看各项服务的状态和启动阶段。
  • 服务状态异常时,先刷新。需要重启的服务按下方“重启单项服务”操作。

查看系统与电源信息

“系统总览”显示芯片、固件版本、ESP-IDF 版本和运行时间。日常使用主要核对固件版本;ESP-IDF 是设备所用系统框架的版本。

卡片右侧显示输入电压、内部电压、电流、功率和保护状态。

网络、风扇、温度和灯光等系统设置保存在设备内部。插入旧 SD 卡不会自动恢复这些设置。自动化配置另行管理,不要把应急副本当作整机备份。

保护状态旁的开关用于启用或停用低电压保护。启用后,设备会按保存的电压和等待时间,在低电压时关机、供电恢复后重新启动。

查看网络与时间

“网络与时间”显示以太网、WiFi、IP 地址、当前时间、同步状态、时间源和时区。

  • 点击“同步时间”,将浏览器当前时间同步到设备。
  • 点击“时区”,选择预设时区或填写页面支持的时区设置,然后保存。
  • 点击“OTA 升级”,进入固件升级页面。

高级操作

重启 TianshanOS

重启会暂时中断 WebUI 和设备管理功能。先完成正在进行的操作,再点击“重启”并确认。等待设备恢复,然后重新打开 WebUI。

重启单项服务

重启服务会暂时中断该服务提供的功能。在“服务状态”中找到异常服务,点击该行的“重启”。操作完成后重新查看服务状态。

调整关机设置

这些设置决定设备在低电压时何时关机,以及供电恢复后何时重新启动。请按设备的供电要求填写电压和等待时间。

点击“关机设置”,可以调整以下内容:

  • “低电压阈值”:低于该电压后开始关机倒计时。
  • “恢复电压阈值”:高于该电压后开始恢复流程。
  • “关机倒计时”:检测到低电压后等待多久执行关机。
  • “恢复保持时间”:电压恢复后等待多久确认供电稳定。
  • “风扇停止延迟”:关机后等待多久关闭风扇。

保存后,页面会应用新的保护设置。

切换顶部 USB 连接目标

设备提供 USB 切换功能时,页面会显示“USB”按钮。每点击一次,顶部 USB 接口按 ESP、AGX、LPMU 的顺序切换到下一个目标。查看按钮上的目标名称和页面提示,确认切换结果。

3. 设备面板

“设备面板”位于“系统”页面,包含模组电源控制、快捷操作和数据组件。

控制 AGX 和 LPMU

  • “AGX 电源”显示电源控制状态。点击按钮可上电或断电;操作后等待页面确认。
  • “LPMU 电源”显示“在线”“离线”或“未知”。在线表示网络能够连通,离线表示网络无法连通。这些状态不能单独证明模组已开机或关机。
  • 点击 LPMU 按钮会触发一次与物理电源按钮相同的操作。随后等待检测和页面提示;结果未知时,先检查模组和网络,不要连续点击。

使用快捷操作

快捷操作卡片由 root 用户配置。显示卡片和允许手动运行是两项设置;看得到卡片,不代表可以启动任务。

  1. 查看卡片名称和说明,确认将要执行的任务。
  2. 点击卡片,阅读结果提示。处理中不要再次启动。
  3. 提示已执行或已排队后,还要确认目标设备或任务的实际结果。需要核验、查看日志或停止后台服务时,请 root 用户处理。

无法启动时,按提示处理,不要连续点击:

  • 规则已停用,或不允许手动触发:请 root 用户检查规则设置。看得到卡片,不代表可以运行。
  • 任务或后台操作正在处理:等待结果,不要重复启动。
  • 同一任务已有后台运行记录:请 root 用户核验原任务,确认结束后再启动。
  • 配置尚未加载、缺少关联项或自动化已暂停:请 root 用户检查配置和启停状态。

完成一次点击后,等待几秒再启动其他操作。关闭页面、删除卡片或重启 TianshanOS,都不会替你停止远程主机上的后台服务。

长按卡片,出现排序提示后拖动,可以调整显示顺序。

没有卡片时,先阅读说明。配置加载中就等待;页面报告无法加载时,保留原因并联系 root 用户。只是没有配置快捷操作时,请 root 用户检查规则的“显示在面板”设置。

规则修改或导入后,当前配置会更新,不需要为了切换规则而重启。卡片任务刚被调整时,先请 root 用户确认任务内容,再执行。

不要为了恢复卡片,自行重启正在提供服务的设备。

管理数据组件

数据组件用于在“设备面板”中持续显示设备数据。

  1. 点击“组件管理”。
  2. 选择刷新间隔,或关闭自动刷新。
  3. 添加预设组件,或选择页面提供的组件样式和数据来源。
  4. 根据需要编辑名称、显示方式和单位,然后保存。

已有组件可以编辑、删除和调整顺序。也可以直接点击组件卡片进入编辑界面。长按组件后拖动,可以改变它在面板中的位置。

4. 风扇管理

“风扇控制”位于“系统”页面。卡片显示设备提供的风扇。设置曲线前,核对风扇编号。

查看风扇状态

顶部显示“有效温度”和“当前输出”。卡片上的大百分比是设备确认已设置的调速值,不是实测转速。RPM 表示测得的每分钟转数,没有有效读数时不显示。大百分比显示 --,表示当前输出尚未确认。

拖动手动滑块时,滑块旁显示准备设置的值,大百分比仍显示当前输出。松开滑块后,查看提示和更新后的读数。“请求设置”与当前输出不同,说明不能只凭请求值判断调速已经生效。

智能模式会显示运行状态,例如“智能模式”“按曲线运行”“保护介入”或“温度失效”。页面还提供“安全参考”“45 秒预测”和“升温速度”。

出现“温度失效”时,检查温度来源是否仍在更新。设备会采用温度失效时的保护调速。点击“TTI”可查看智能热控说明。

点击区域顶部的刷新按钮,重新获取状态。出现“未能完成风扇调节”或输出未确认时,检查设备状态后再决定是否重试。

选择运行模式

模式作用
“关闭”停止风扇。
“手动”用滑块设置固定的调速百分比,范围为 0-100%。
“曲线”按已设置的温度与调速百分比对应关系运行。
“智能”以基础曲线为参考,根据温度趋势和过去的调速情况调整散热;需要保护时采用保护调速。

关闭风扇或设置过低的手动值会降低散热能力。执行前确认设备负载和温度,并持续观察。只有在手动模式且当前输出已确认时,滑块才可调节。

设置风扇曲线

点击“风扇控制”区域顶部的“曲线”,打开“风扇曲线管理”。卡片内的“曲线”只切换运行模式。

  1. 在“风扇”中选择要调整的编号,并与系统页卡片核对。
  2. 在“温度变量绑定”中点击“添加变量”,选择温度来源并填写权重。
  3. 点击“绑定”。绑定的温度来源由曲线、智能模式的风扇共用,修改会影响使用该来源的风扇。
  4. 在“曲线节点”中添加或编辑节点。每条曲线至少需要 2 个节点,最多支持 10 个。
  5. 设置“最小转速”和“最大转速”。这里填写的是调速百分比,最小值不能高于最大值。
  6. 设置“温度回差”和“最小调节间隔”。回差范围为 0-20°C,可减少温度小幅波动造成的频繁调速。间隔范围为 500-30000 ms,1000 ms 等于 1 秒。
  7. 点击“保存曲线”。成功后,设置被保存,所选风扇切换到曲线模式。若希望继续使用智能热控,返回风扇卡片点击“智能”。

保存失败时,先查看具体提示并检查当前状态,再决定是否重试。解除温度绑定后,也应检查有效温度和风扇状态。

导入和导出曲线

  • 点击“导入配置”,选择曲线 JSON 文件。JSON 是保存曲线数据的文件格式。检查载入的节点、限制和风扇编号,再点击“保存曲线”使其生效。
  • 点击“导出配置”,浏览器会下载当前曲线,并尝试将副本保存到 SD 卡的 /sdcard/config 目录。分别检查浏览器下载结果和页面提示的 SD 卡保存结果。

使用测试温度

测试温度会临时替代正常温度来源,并影响曲线或智能调速。测试期间持续观察风扇和设备状态。

  1. 在“测试温度”中输入 0-100°C。
  2. 点击“测试”,观察当前输出、状态和风扇响应。
  3. 测试结束后点击“清除测试”,恢复正常温度来源,并确认有效温度已恢复。

5. LED 管理

“LED 控制”位于“系统”页面,只显示设备提供的 LED。不同 LED 可用的功能不同。

常用控制

  • 使用卡片底部的灯泡按钮开启或关闭 LED。
  • 拖动“亮度”滑块调整亮度,或选择颜色和预设色。
  • 点击动画按钮进入“LED 设置”,在“程序动画”中选择动画并使用对应的播放或停止按钮。
  • 点击卡片右下角的保存图标,保存当前 LED 配置。
  • 点击“全部关闭”关闭所有 LED,并查看页面报告的结果。部分关闭失败时,检查对应设备。

LED 矩阵高级功能

矩阵设备的卡片提供相应功能图标,打开后可在“LED 设置”中切换分组:

  • “程序动画”:选择和运行动画。
  • “图像/QR码”:从 SD 卡选择图像,或输入内容生成 QR 码。
  • “文本显示”:填写文字,并设置字体、对齐、滚动、前景色和背景。
  • “后处理滤镜”:选择滤镜及参数,再应用或停止。
  • “色彩校正”:调整显示效果,并按页面按钮重置、导入或导出设置。

操作后检查灯光或矩阵画面。只使用页面提供的功能。设置失败时,按提示检查文件、输入和设备状态。

6. 网络管理

查看网络状态

页面顶部显示以太网、WiFi 客户端和 WiFi 热点的连接状态。进入对应面板,可以查看 IP 地址、子网掩码、网关、DNS、MAC 地址、SSID、信号和接入设备数量等信息。

以太网面板用于查看当前链路和地址信息,不提供地址修改入口。

选择 WiFi 模式

模式作用
“关闭”关闭 WiFi。
“站点 (STA)”让设备连接现有 WiFi 网络。
“热点 (AP)”让设备提供 WiFi 热点。
“STA+AP”同时连接现有 WiFi,并保留设备热点。

连接 WiFi

  1. 将 WiFi 模式设置为“站点 (STA)”或“STA+AP”。
  2. 在“站点连接”中点击“扫描”。
  3. 从列表中选择网络。列表会显示 SSID、信号强度、信道和认证方式。
  4. 输入密码并确认。开放网络可以将密码留空。
  5. 等待状态变为“已连接”,并确认页面显示新的 IP 地址。

点击“断开”可以结束当前 WiFi 客户端连接。

配置 WiFi 热点

  1. 将 WiFi 模式设置为“热点 (AP)”或“STA+AP”。
  2. 在“热点”区域点击“配置”。
  3. 填写 SSID。密码留空会创建开放热点;设置密码时至少输入 8 位字符。
  4. 选择信道,并根据需要启用“隐藏 SSID”。
  5. 点击“应用”,等待热点状态更新。

点击“设备”可以查看当前连接到热点的设备。

设置主机名

在“网络服务”的“主机名”区域输入新名称,然后点击“设置”。主机名更新后,页面会显示当前名称。

查看 DHCP 客户端

DHCP 会自动为接入设备分配网络地址。点击“客户端”,选择“WiFi AP”或“Ethernet”,查看当前分配记录。点击刷新按钮可以重新加载列表。

高级网络操作

设置 NAT 网关

NAT 用于在设备的网络接口之间转发网络流量。启用或停用 NAT 后,点击“保存”保留当前设置。操作完成后检查 WiFi 和 Ethernet 状态。

通过 LPMU 接入上层网络

此操作通过已配置的 LPMU 主机接入网络。先确认能连接 LPMU、网络线缆已接好,再准备该主机 SSH 账号的 sudo 密码。这个密码用于允许账号修改系统设置,可能与 WebUI 登录密码不同。

  1. 在“接入上层网络”区域点击“通过 LPMU 接入”。
  2. 在弹窗中输入“LPMU sudo 密码”,再点击接入按钮。密码仅用于本次操作,不保存;下次执行需要重新输入。
  3. 等待处理结束,不要重复启动。
  4. 结果窗口显示互联网连接正常和网络配置已完成时,才表示接入成功。
  5. 失败或结果未确认时,先阅读具体原因;需要更多信息时展开“执行日志”。密码错误时核对密码,找不到互联网连接时检查网络接线与上层网络。

状态获取失败不等于脚本已经停止。先点击页面提供的“刷新状态”确认当前执行情况,再决定是否重新接入。

7. 文件管理

点击顶部导航中的“文件”进入“文件管理”。

SD 卡是可插拔存储,SPIFFS 是设备内部文件存储。点击“SD 卡”或“SPIFFS”切换位置。页面上方显示当前文件夹路径;点击路径中的文件夹名称,可以返回上一级或更早的目录。

浏览和管理文件

  • 点击文件夹名称进入该目录。
  • 点击文件右侧的下载按钮,将文件保存到浏览器的下载位置。
  • 点击重命名按钮,输入新名称并确认。
  • 点击“新建文件夹”,输入文件夹名称并创建。
  • 点击刷新按钮重新加载当前目录和存储状态。

上传文件

文件只能上传到 SD 卡,不能上传到 SPIFFS。先确认 SD 卡已挂载。

  1. 点击“SD 卡”,进入要上传文件的目录。
  2. 点击“上传文件”。
  3. 点击上传区域选择一个或多个文件,或将文件拖入该区域。
  4. 检查上传列表,移除不需要的文件。
  5. 点击“上传”,等待每个文件显示完成状态。

上传 .tscfg 配置包后,页面会显示配置包的验证和应用步骤。但当前文件上传入口不会应用包中的设置;上传或验证成功,不代表设置已经生效。

规则配置包请交给 root 用户,从“自动化”页面导入。不要用普通文件上传代替规则导入。其他配置包的来源和签名说明见安全指南。

批量操作

勾选文件或文件夹后,页面会显示批量工具栏。

  • “批量下载”下载选中的文件。文件夹不会加入下载内容。
  • “批量删除”删除选中的文件和文件夹。
  • “取消选择”清除当前选择。

删除文件或文件夹

删除操作无法从 WebUI 撤销。删除文件夹时,其中的全部内容也会被删除。确认名称和路径后,再点击“删除”或“批量删除”并确认。

自动化管理的文件受到保护。向 /sdcard/config/automation 上传或覆盖文件,以及删除、重命名这个目录或包含它的父目录,可能被拒绝。看到“这是自动化使用的配置文件”时,请 root 用户从配置页面处理,不要改用终端绕过限制。

挂载和卸载 SD 卡

卸载后,SD 卡中的文件会暂时无法访问。先确认上传、下载等文件操作已结束,再点击“卸载 SD”。

卸载或换卡可能让自动化改用内部应急配置。这份配置可能较旧,已启用的自动规则仍可能运行;没有可用副本时,自动化可能无法运行。先请 root 用户确认可以卸载。卡上的图片、字体和日志会暂时无法访问。

SD 卡未挂载时,页面会显示“挂载 SD”。点击该按钮,等待存储状态变为“已挂载”,随后重新进入 SD 卡目录。

挂载成功不等于已改用卡内自动化配置。重新插卡后,需要 root 用户选择使用哪份配置,不会自动覆盖或合并。

8. OTA 更新

在“系统”页面的“网络与时间”区域点击“OTA 升级”,进入“固件升级”。

更新过程中设备会重启,WebUI 会暂时断开。开始前应保存正在进行的工作,并保持设备供电稳定。升级进度尚未完成时不要关闭设备。

首次从旧版本升级到 0.6.3

首次从 0.6.2 等旧存储布局升级时,需要发行方确认的配套 USB/串口升级包。只上传主固件或 WebUI,不能完成这次升级。请设备管理员或提供方按包内说明操作,不要自行全片擦除或使用旧分区表。

升级前保存重要文件,保留原 SD 卡。首次启动会迁移原配置,期间不要断电。完成后,检查登录、网络、风扇、灯光、SSH 主机和自动化规则。不要在尚未确认规则内容时测试带有断电、重启或远程命令的任务。

该配套包会更新两个应用槽,不能假定另一个槽仍保留旧版本。忘记 root 密码时,只使用提供方确认与 0.6.3 布局匹配的恢复方案,不要刷入旧版密码重置固件。

下面的网页更新方法用于发行方确认可通过 OTA 安装的版本,不能代替首次布局升级。

从 OTA 服务器检查更新

  1. 查看页面显示的“当前版本”。
  2. 在“OTA 服务器”中输入管理员或发行方提供的服务器地址。
  3. 点击“保存”,随后点击“检查更新”。
  4. 页面会显示“发现新版本”“已是最新版本”“服务器版本较旧”或错误信息。
  5. 确认目标版本后,点击“立即升级”或页面显示的升级按钮。
  6. 等待下载、安装和重启完成。需要中止时,使用页面显示的中止按钮;只在按钮可用的阶段操作。
  7. 等待页面确认升级后的固件,再重新连接 WebUI,核对“当前版本”和设备状态。

“升级进度”单独显示当前阶段。进度达到 100% 或显示文件已写入,不代表重启和版本核对已完成。出现“升级结果未确认”或“启动的固件与升级目标不符”时,保留提示,检查设备当前版本;不要直接重复升级。无法确认时,请 root 用户或设备提供方检查。

升级同时包含 WebUI 时,固件和 WebUI 会依次更新。请使用同一发布版本的配套主固件和 WebUI 资源。升级后仍显示旧界面时,尝试强制刷新浏览器,再核对版本和页面。

手动升级

展开“手动升级”后,可以选择以下方式:

  • “从 URL 升级”:填写固件 URL,根据发布说明勾选“同时升级 www”,然后点击“升级”。www 指设备网页界面的资源文件。
  • “从 SD 卡升级”:填写固件文件路径,例如 /sdcard/firmware.bin。勾选“同时升级 www”时,确保同目录中也有该版本的 www.bin。

从 URL 升级时,“跳过证书校验”用于跳过 HTTPS 服务器证书验证。勾选后,设备无法通过该证书确认下载服务器的身份。日常升级请保持未勾选;遇到证书错误时,请先联系管理员检查服务器地址和证书。

分区管理与回滚

“分区管理”显示当前运行分区和其他可用分区。

  • “标记有效”会确认当前运行版本,并取消该版本的自动回滚保护。确认当前版本运行正常后再执行。
  • “回滚到此版本”会选择另一可启动版本,并通过重启切换。回滚会中断当前服务,执行前应确认目标版本和相关数据兼容。

操作完成并重启后,重新打开 WebUI,核对当前版本和设备状态。

0.6.3 改变了配置保存方式和设备分区布局。不要直接回退到不兼容的旧固件。确需降级时,请设备提供方确认完整的固件、布局和配置恢复方案。

回滚不会恢复旧配置格式,也不保证旧规则可用。

9. 安全管理入口

点击顶部导航中的“安全”进入安全管理页面。SSH 密钥、远程主机、主机指纹、HTTPS 证书、配置包和账户管理的操作请查看《TianshanOS 安全指南》。本指南不重复这些内容。

遇到失败或结果未确认

字段旁出现红色错误说明时,按提示修正后再保存。标记消失不代表已经保存成功;还要检查保存提示和列表。

先看哪项操作失败,再阅读原因和下一步。提示没有说明原因时,不要猜测。

有“详情”时,点击查看。点击“收起”可隐藏详情。页面提供 × 时,可点击它关闭提示。需要求助时,保留提示和详情,交给 root 用户检查。

出现“结果未确认”时,先刷新并检查设备、文件或任务状态。超时或断开连接不代表操作没有执行;不要立即重复断电、删除、启动任务或升级。仍无法确认时,请 root 用户检查。

批量操作后,分别核对成功、失败和未确认的项目。下载文件后,检查浏览器下载列表。

下一步 继续阅读 root 指南