系统设置只维护 HQControl 宿主机运行参数，不修改画面内容。它决定数据库连接、对外访问地址、采集节奏等运行行为。入口是在 HQControl 地址后追加 /settings（本机 http://127.0.0.1:8080/settings）。进入后先查看顶部状态，确认本次改动写入的 hqcontrol.env、配置文件状态和当前平台。权限：本机可直接进入；远程访问需要最高管理员；只读账号只能查看不能保存。保存后必须重启 HQControl 才会生效。
系统设置只维护 HQControl 宿主机运行参数，不修改画面内容。它决定数据库连接、对外访问地址、采集节奏等运行行为。入口是在 HQControl 地址后追加 /settings（本机 http://127.0.0.1:8080/settings）。进入后先查看顶部状态，确认本次改动写入的 hqcontrol.env、配置文件状态和当前平台。权限：本机可直接进入；远程访问需要最高管理员；只读账号只能查看不能保存。保存后必须重启 HQControl 才会生效。
http://127.0.0.1:8080/settings。http://服务器IP:8080/settings，需要已登录最高管理员。左侧 8 个分组分别维护基础访问、数据库、Redis、模块端口、设备连接、采集与消费、联邦和脚本。修改字段前先确认它所属的配置分组。系统设置维护宿主机运行配置，不是内容编辑区；端口、数据库和脚本运行时应留在系统设置里，不应写入菜单、弹窗模板或画面文件。
基础访问（5 项）：服务监听地址和访问名。端口变化会影响后台、运行画面和授权页入口。数据库（8 项）：PostgreSQL 连接参数。正式现场建议保持数据库必须可用，避免无历史、无报警地启动。Redis（8 项）：Redis 用于缓存、跨实例消息和实时分发。Windows 安装态默认使用 HQControlRedis 服务。模块端口（4 项）：外部模块只监听本机回环地址。端口修改后需要重启 HQControl，启动日志中的模块地址会随配置变化。设备连接（3 项）：新建设备的连接和请求默认值。单个设备仍可在设备配置中覆盖。采集与消费（12 项）：IO Worker 采集 PLC/OPC 后写入 tag_latest；页面、趋势、报警都消费这份最新值，不重复直连 PLC。联邦（5 项）：远端站点共享密钥、心跳、路由刷新和 HTTP 超时。参与联邦的节点必须使用同一个联邦共享密钥。脚本（1 项）：集成脚本运行时路径。脚本内容和触发器文件仍按配置文件说明直接迁移。基础访问决定浏览器从哪里进入 HQControl，也决定后台、运行画面和授权页是否指向同一个宿主机。监听地址 是服务实际绑定的地址和端口；站点访问名、公开主机名、统一入口地址 和 所属冗余组 用于识别本地站点、反向代理、VIP 或联邦中的访问入口。单机调试通常保持默认值；现场使用域名、固定 IP、VIP 或反向代理时，再填写真实访问地址。
站点访问名：浏览器访问和本地站点显示使用这个名称；只允许小写字母、数字和 -。监听地址：使用 :8080 或 0.0.0.0:8080 可被其他电脑访问；127.0.0.1:8080 仅本机访问。公开主机名：用于显示和识别站点，可填域名、主机名或固定访问地址。统一入口地址：客户端连接的门户/VIP/反代地址；为空时使用公开主机名。所属冗余组：填写冗余组对应的站点编码或 ID；为空时按本地节点所属站点推导。数据库分组只维护 PostgreSQL 连接。使用安装包自带数据库时，默认值通常是相对稳妥的选择；切换到现场已有数据库时，再填写 数据库主机、数据库端口、数据库名、数据库账号、数据库密码、SSL 模式、数据库必须可用 和 数据库等待秒数。正式现场建议把 数据库必须可用 保持为 true：如果数据库未就绪，应让 HQControl 启动失败，而不是在无历史、无报警的状态下运行。
数据库等待秒数 用于启动阶段等待 PostgreSQL 就绪；内置数据库或慢启动机器不要随意调小。SSL 模式 按现场数据库要求选择，内置数据库通常保持默认。Redis 这一组不要再按“普通缓存”理解：它同时负责缓存、跨实例消息和实时分发。Windows 安装态默认使用 HQControlRedis 服务，单机项目保持默认就好；只有 Redis 换成远端、做了哨兵高可用，或现场给 Redis/哨兵设了密码时，才需要填写这 8 个字段。超时值不要凭感觉放大，调得太长只会让故障发现更慢、页面等待更久。
Redis 地址 是普通单实例连接；不使用哨兵时，只填这一项即可。Redis 密码 已配置时，留空保存不会修改；未设密码留空即可。Redis 哨兵地址 多个用英文逗号分隔；留空表示使用上面的单个 Redis 地址。Redis 主库名称 需与哨兵配置中的名称一致；不使用哨兵时忽略。Redis 哨兵密码 只在哨兵本身设置了密码时填写。Redis 读超时(ms)、Redis 写超时(ms)、Redis 连接池等待(ms) 一般保持默认，只有跨机器 Redis 或网络较慢时才调大。模块端口分组维护 IO Engine、Trend Service、Integration Script 和 Alarm Service 的本机回环监听地址。HQControl 主进程通过这些地址与本机外部模块通信；这些地址不是浏览器、客户机或公网访问入口。端口修改后需要重启 HQControl，并在启动日志中确认模块监听地址已经生效。
IO Engine 端口：外部 IO Engine 模块监听地址；必须使用 127.0.0.1 或 localhost。Trend Service 端口：外部趋势模块监听地址；保存后重启 HQControl 生效。Integration Script 端口：外部脚本模块监听地址；必须保持本机回环地址，避免脚本服务暴露到网络。Alarm Service 端口：外部报警模块监听地址；保存后重启 HQControl 生效。设备连接分组只有 3 项，管的是新建设备和连接检测的默认 TCP/会话行为。已有设备的单独配置不会被全局默认值硬覆盖；如果只是某台 PLC 反应慢，先在那台设备的配置里处理，不要为了一个异常点把全站默认超时和重连节奏一起放大。
设备连接超时(ms)：新建设备和连接检测使用的默认 TCP/会话连接超时；局域网 PLC 一般保持 2000。设备请求超时(ms)：新建设备读取、写入和协议请求的默认超时；设备较慢时再调大。重连间隔(ms)：一般保持默认。调小会更快重试，但可能增加故障期间的连接压力。这 12 项直接影响采集、分发和客户端消费压力，调整前应先确认数据链路：IO Worker 从 PLC/OPC 采集数据，写入 tag_latest 最新值；运行画面、趋势和报警读取最新值与可靠日志，不再分别直接连接 PLC。页面实时限速、IO State WebSocket 轮询边界和 HTTP 观测日志用于控制消费侧压力，不等同于直接改变 PLC 采集节奏。
设备采集周期(ms) 是 IO Worker 写入最新值的默认周期；大量 Tag 项目先优化分组和批量读取，再考虑调周期。单设备并发请求数 保持 1，避免同一 PLC 被并发请求压垮；除非设备厂商明确支持并发读取。默认批量读取 保持 true，批量读取能减少请求次数，是默认推荐方式。页面实时请求限速(RPS) 与 页面实时突发容量 只保护多客户端连接压力，不改变 IO Worker 采集周期。IO State WebSocket 最小/默认/最大轮询间隔(ms) 用于第三方 IO State WebSocket 的 pollIntervalMs 边界。HTTP 观测日志 默认关闭；开启后只记录慢请求、大响应、错误或采样请求，用于长测定位页面重复拉取和大数据响应。联邦分组管理远端站点共享密钥、心跳、路由刷新和 HTTP 超时。单机项目通常无需修改；进入多站点、冗余或跨网段部署时，应先确认所有参与联邦的节点使用同一个 联邦共享密钥。共享密钥不一致时，心跳、路由和 Owner 信息都无法稳定同步；密钥确认后，再按真实网络延迟调整同步和超时。
联邦共享密钥：所有参与联邦的节点必须使用同一个值；已配置时，留空保存不会修改。联邦同步周期(ms)：一般保持默认，用于秒级同步远端运行状态。联邦健康检查周期(ms)：一般保持默认，可在 2-3 秒内反映远端健康变化。联邦路由刷新周期(ms)：一般保持默认，用于快速刷新远端路由和 Owner 信息。联邦 HTTP 超时(ms)：一般保持默认。跨网段或 VPN 较慢时再调大。脚本分组只有 Python 路径，它是 Integration Script 的运行时入口，不是脚本编辑器。现场没有用 Integration Script 时保持默认；用到脚本且换了 Python 时，填可执行文件本身，例如 Windows 的 C:\Python311\python.exe 或 Linux 的 /usr/bin/python3。脚本内容、触发器文件和依赖目录仍按集成脚本章节迁移，不在系统设置里改业务逻辑。
页面底部和右下角的按钮是维护入口，不是第 9 个分组。导入配置 会读取 .env 风格文本，把能识别的配置项填入表单，并提示“导入配置已填充，请确认后保存。”；一键还原 会把运行配置拉回默认值，仍然要重启 HQControl 才生效。Hosts 文件 可以像普通 hosts 文件一样直接编辑文本；保存时只写入 HQControl 托管块，文件里其他手工内容不会被覆盖。这些入口可用于排障；操作前应确认已有备份，并完成参数核对。
导入配置 支持普通 KEY=value 和 export KEY=value 行；导入后先核对字段，再保存配置。一键还原 会弹出确认，适合排障后回到默认运行配置；不要在没有备份现场参数时随手点击。插入本地条目 会按当前 站点访问名 插入类似 127.0.0.1 f01-station 的本地 hosts 条目。保存 Hosts 只更新 HQControl 托管块，不覆盖 hosts 文件中用户维护的其它行。后续手册章节应先说明修改场景与禁止修改边界，再按真实 UI 顺序解释字段，最后落实到交付和排障注意点。配图也保持同一标准：每张图都使用当前界面的高清截图，图片标题对应界面对象，说明文字讲清该图的判断依据。文字避免空泛，图片不作装饰用途，读者阅读后应明确下一步操作和限制边界。
src 完全一致。alt 描述画面，title 写对象，caption 写用途或风险；不要用装饰图替代真实界面。
总览图同时呈现配置文件状态、8 个设置分组、导入配置、一键还原、保存配置和 Hosts 文件编辑器，是本节配图标准的基准图。
基础访问决定站点访问名、监听地址、公开主机名、统一入口地址和所属冗余组。
数据库分组用于维护 PostgreSQL 连接、SSL 模式、数据库必须可用和启动等待时间。
Redis 是独立分组，覆盖单实例地址、密码、哨兵高可用和读写超时。
模块端口只应监听本机回环地址，端口变化要在重启后的启动日志里复核。
设备连接分组只影响新建设备和连接检测的默认超时、请求超时和重连间隔。
采集与消费分组说明 IO Worker、页面实时、趋势、报警和 HTTP 观测之间的边界。
联邦设置覆盖共享密钥、同步、健康检查、路由刷新和跨站点 HTTP 超时。
脚本分组只指定 Integration Script 的 Python 路径，脚本内容仍在脚本页面或项目文件中维护。