系统基础配置

文档版本：v1.0
最后更新：2026-06-11
适用范围：平台初始化、系统参数维护、OSS/S3 存储配置

配置入口

服务部署并能正常登录后台后，先完成系统基础配置。常用菜单路径：

配置项	菜单路径	用途
系统参数	系统管理 -> 参数管理	维护 ASR、MQTT、白名单、设备 JWT、测试打印等全局参数
在线存储	系统管理 -> 在线存储配置	维护 OSS/S3 文件存储，用于打印文件、语音记录、文生图图片等对象保存

涉及密钥、Token、AccessKey、设备密钥的截图和文档示例必须脱敏。

系统参数

进入 系统管理 -> 参数管理 后，按参数键搜索并逐项维护。

建议先确认以下参数：

参数键	示例值	说明
network.asr_address	https://asr.example.com	ASR 网关 HTTPS 服务入口；设备最终使用的 WebSocket 连接地址以 Bootstrap / 协议返回的 asrAddress 为准
network.asr_api_key	***已脱敏***	ASR 网关 API Key，用于生成或校验识别访问凭据
api.whitelist_ips	127.0.0.1 10.0.0.25	重要 API 访问 IP 白名单，多个 IP 按页面规则换行维护
device.test_print_file_id	demo_test_print_file	设备测试打印时使用的文件 ID
device.jwt_expire_seconds	86400	设备 Token 有效期，单位秒
mqtt.host	mqtt.example.com	设备接入 MQTT 服务地址
mqtt.port	1883	设备接入 MQTT 服务端口

在线存储配置

进入 系统管理 -> 在线存储配置，选择当前生效的存储类型，并填写 OSS/S3 连接信息。

字段	说明
存储类型	选择 oss 或 s3，决定后续文件上传、下载与签名实现
Endpoint	对象存储服务地址，通常与地域相关
Region	对象存储区域
Bucket	文件保存的 Bucket 名称
Access Key ID	对象存储访问标识，文档与截图必须脱敏
Access Key Secret	对象存储访问密钥，文档与截图必须脱敏
Base Path	平台对象键前缀，用于区分环境或业务目录
下载签名配置	控制私有文件临时访问 URL 的有效期与签名方式

在线存储会影响：

• 打印任务资源文件保存与下载。
• 设备上传的打印文件保存。
• ASR 录音记录保存。
• 文生图结果图片保存。
• 图片下发打印前的压缩、转换与临时访问。

配置顺序

1. 先配置在线存储，确保平台能保存和读取业务文件。
2. 再配置 ASR 地址与 API Key，确保语音记录和热词识别链路可用。
3. 配置 MQTT host/port，保证设备 Bootstrap 后能获得正确连接参数。
4. 配置白名单，避免回调、联调或管理接口被误拦截。
5. 配置设备 JWT 有效期和测试打印文件 ID，便于后续设备维护与调试。

验证方式

验证项	检查方式
OSS/S3 可用	上传一条打印资源或触发文生图，确认对象可保存并生成访问链接
ASR 地址可用	在 ASR 记录或设备语音链路中确认连接没有鉴权错误
MQTT 参数正确	设备 Bootstrap 后返回的 MQTT 地址、端口符合预期
白名单正确	受控 API 调用来源 IP 不被误拒绝

完成系统基础配置后，继续维护 设备维护。