系统服务

适用版本：DASS5（当前版本）
前提：已登录 DASSConsole

【说明】：系统服务列表展示所有被 magusdog 守护的程序。用户可在此查看所有服务的详细信息，部分服务提供配置修改功能；列表中的服务可以进行启停、守护控制。若缺少所需服务，可获取并上传官方服务包。

【入口】：维护 → 系统服务

功能概述

系统服务列表展示所有被 magusdog 守护的后台程序：可以查看每个服务的详细信息、进行启停与守护控制，部分服务提供配置修改；若缺少所需服务，可获取并上传官方服务包。

核心价值：一个入口看清"设备上到底有哪些服务在跑、谁是守护进程、哪个服务该重启"，是排障时判断"问题在采集侧还是系统侧"的第一站。

使用场景

• 排查后台服务（edge_mqtt_hub、doa、hms-network、dasserver 等）是否在运行；
• 需要重启某个守护服务、或查看/下载其日志；
• 现场缺少某个服务，需要上传官方服务包补齐。

前置条件

• 已登录，且有维护权限；
• 确认重启/停止该服务不会中断业务，或已选好停机窗口；
• 上传服务包时：包与设备平台 / DASS 版本匹配。

常用系统服务

服务名称	说明
dasserver	驱动管理和边缘终端通用管理服务（不可配置）
openplant	负责所有数据点的存储，包括 DASS 初始化测点、采集上传测点、计算点等
watchdog_management	硬件看门狗，负责在硬件因故停止时执行重启
magusdog	服务看门狗。列表内所有服务都在 magusdog 守护进程中，由它负责在服务异常停止时重启
ntp_client	负责盒子本地校时。默认使用阿里云 NTP 服务对时；局域网场景下需自行搭建 NTP 服务器并填写配置信息。（Windows 版无该服务，校时依赖 Windows 系统自带的对时功能）
edge_controlsystem	Box 控制代理。创建采集-控制服务时需开启此服务
gpio_management	用于管理串口工作模式切换
monitor_edge	DASS 性能检测，监测信息存储在 W3.monitor 节点下
network_management	拨号网络管理系统服务。用于管理蜂窝网络拨号功能，使用 4G 上网时必须上传该服务并启用
Proxy	代理服务，允许用户通过该服务对盒子进行非直接的操作
EdgeHms	Magusbox 硬件管理服务。涉及网络安全模块的编辑配置需开启该服务

各服务的职责概述见《系统服务介绍》。

服务操作说明

【说明】：对系统服务可执行的操作包括添加服务、修改配置、删除服务、服务启停、守护启停、下载日志。

启停控制

【说明】：用于控制服务启停。

• 启用：服务启动，正常工作；
• 停止：服务中止。

【操作】：点击【停止】、【启动】按钮即可。

编辑服务

【说明】：用于修改服务配置。

【操作】：点击【编辑】即可修改服务配置。

删除服务

【说明】：删除当前系统服务。

【警告】删除不可恢复，请确认该服务已无其它服务或业务依赖。

【操作】：点击【删除】并二次确认即可。确认框文案为 提示 + 此操作将删除该服务，请谨慎操作！。

下载日志

【说明】：用于获取相应系统服务的日志文件。

【操作】：

步骤1. 点击【下载日志】。

步骤2. 选取所需下载的日志文件，点击【下载】即可。

添加服务

【说明】：系统服务有两种 —— 公司内部服务在【应用管理】中【离线导入】即可；外部服务在【系统服务】中添加。

添加公司内部服务

【操作】：

步骤1. 在应用市场下载系统服务包。

步骤2. 点击【应用管理】，在【离线导入】中上传服务包。

步骤3. 上传完毕后会弹框提示是否启动系统服务：标题 提示、正文 是否需要启动系统服务，点击【确定】。

取证说明：本图仍是旧版截图。重截需要一份系统服务包（.tar.gz，从麦杰应用市场下载，市场下载需登录），本次取证环境未取得该包，故未重拍；界面流程（上传后弹 提示 / 是否需要启动系统服务）已按源码与既有截图核对，未发现变化。

步骤4. 返回【系统服务】即可看见服务添加成功。

添加外部服务

【操作】：

步骤1. 点击【创建服务】。

步骤2. 填写服务信息。

配置项	说明
服务名称	服务的名称
路径名	系统服务所在位置的路径名
描述	对服务的说明
版本号	系统服务的版本号
延时启动时间	单位：s

填写完点击【保存】，在服务列表中看见该服务存在，则添加完成。

【注意】「路径名」必须填写设备上真实存在的文件路径。若填了不存在的路径，保存后会提示
rpc error: code = Unknown desc = Key: 'Req.Path' Error:Field validation for 'Path' failed on the 'file' tag，服务不会添加成功。
例如把路径名填成 /bin/true 可以成功创建（演示用），创建后服务归 magusdog 守护，可正常【停止】【编辑】【删除】。

参数说明

项	说明
服务名称	系统服务标识（如 dasserver、edge_mqtt_hub、doa、hms-network）
守护	由 magusdog 守护；列表展示所有被守护的程序
可配置性	部分服务可修改配置；dasserver 不可配置
状态 / 操作	运行状态、启停、编辑（可配置的）、删除、下载日志、添加服务

各服务具体配置项随服务不同，以页面表单与其说明书为准。

注意事项

✅ 允许：查看服务信息、启停服务、编辑可配置服务、下载日志、上传官方服务包添加服务。

❌ 禁止 / 需谨慎：

• ⚠️ 警告 停止 dasserver 会中断驱动管理与边缘终端管理；停止 hms-network 影响网络配置；停止 doa 影响缓存代理 / 上传链路 —— 操作前确认影响面并选停机窗口；
• ⚠️ 警告 删除服务前确认没有采集/上传链路依赖它；
• ⚠️ 注意 服务操作有耗时（历史上存在"未开启双机热备时接口访问慢"问题，V5.4.0 已优化），操作后稍等状态刷新。

示例

确认缓存代理服务是否在运行，并取回其日志：

1. 「维护 → 系统服务」；
2. 在列表中找到 doa，查看其状态与守护信息；
3. 点击【下载日志】取回日志包；
4. 若需重启：点【停止】→ 确认 → 再【启动】，观察状态恢复为运行中；
5. 验证：「边缘计算 / 上传服务」链路恢复正常，历史数据无长时间空档。

常见问题及解决方法

现象	原因	处置
服务启动失败	依赖服务未起 / 端口被占用 / 配置错误	先看依赖服务状态与日志，再核对配置
导入系统服务时注册失败	历史缺陷（注册 magusdog 失败）	升级到 V5.4.0 及以上（已修复）
服务操作后页面响应慢	未开启双机热备时的历史问题	升级到 V5.4.0 及以上（已优化）
列表里没有需要的服务	服务未安装	获取官方服务包后【添加服务】上传

相关命令/接口

见**《DASS5 接口与二次开发手册》** → 「4. 接口参考」；系统服务自身的运维接口未单独收录（随服务版本变化）。

安全声明

⚠️ 警告 系统服务多为后台关键进程，误停会造成采集中断、网络失联或上传中断；操作前必须确认影响面，优先在停机窗口进行。