安全加固

默认不鉴权

未设 EDGE_AUTH_TOKEN 时所有接口对可达网络开放，其中写属性的接口会直接向 PLC 写寄存器。这个默认值是为带屏网关「插上电就能用」的本机操作场景选的——生产部署必须按本页配置令牌，或确保网关仅在隔离网段 / 反向代理之后可达。

访问令牌

EDGE_AUTH_TOKEN=<强随机串> ./edge

• 令牌以 Bearer / 请求头方式携带；界面登录框输入一次即可
• 生产建议配合 systemd 的 EnvironmentFile 或 Docker secrets 注入，令牌不进命令行历史
• 启动日志会明确提示当前鉴权状态

分享令牌

大屏分享链接使用独立的只读分享 token：

• 与管理员令牌完全独立，可随时吊销
• 权限仅限查看与实时数据推送；写控制、配置、对话、管理接口一律拒绝
• 链接外发前先自己点开验证可见内容

CORS

默认仅同源。确需跨源访问（如自有前端直连网关 API）时，用 EDGE_CORS_ORIGINS 显式列出允许的来源，不要用通配符放开。

网络位置建议

场景	建议
带屏网关、本机操作	保持默认 + 令牌可选
车间局域网	令牌必配；仅放行需要的端口
接入企业网 / 互联网	反向代理（TLS + 认证）之后；或仅暴露分享链接所需路径
北向自签证书内网	EDGE_MQTT_CA_FILE 指定 CA，不要用 INSECURE

exec 命令白名单

规则链里的命令执行节点默认白名单模式、fail-closed：白名单外的命令一律拒绝。需要启用时在配置里显式列出命令，黑名单模式可叠加禁止参数。

OEM 白牌

品牌定制（名称 / Logo / 预装岗位包）随商业授权提供，详见版本与授权。