开始前先确认
- 您拥有或已获授权管理目标设备和服务。
- 目标服务在局域网中已经可以稳定访问。
- 客户端为 7.5 或以上版本，用户中心显示连接在线。
- 记录目标设备的固定局域网 IP、真实服务端口和登录方式。
本站配置步骤
- 1
准备目标服务
确认 openHAB 内网端口与认证，配置用户中心域名穿透。
- 2
填写内网目标
登录本站后进入“用户中心 → 域名配置”。示例填写
192.168.1.93:8080。网页服务设置子域名；TCP 服务使用系统分配的公网端口。 - 3
保存并等待下发
保存后保持客户端运行。不要反复修改同一配置；等待页面提示的生效时间后再测试。
- 4
切换到真正外网验证
外网查看仪表盘和事件，不先修改自动化规则。
安全设置
公网可达不等于可以忽略认证
开启认证，升级插件，不把管理 API 匿名暴露。
- 使用独立强密码或密钥，不使用设备默认账号。
- 能开启二次认证、TLS、登录锁定的服务都应开启。
- 只开放必需端口，完成临时维护后可停止映射。
- 禁止发布盗版、违法内容或连接无权管理的设备。
访问失败怎样排查
局域网先测
在客户端所在设备直接访问 192.168.1.93:8080。如果这里失败，先修目标服务。
确认入口类型
网页使用 HTTP/HTTPS 地址；SSH、RDP、数据库使用公网域名加系统分配端口。
记录具体时间
把失败时间、客户端状态、外网错误和目标服务日志一起保存，便于查节点会话。
本场景常见问题：页面空白常与前端缓存或 WebSocket 有关，先从内网交叉验证。
常见问题
应该选择域名穿透还是端口映射？
本场景主要是网页或解析功能，按文中标注使用用户中心域名穿透或对应的 DDNS/IPv6 栏目。
客户端在线但访问失败怎么办？
先在运行客户端的设备上访问内网目标，再检查域名解析和公网入口。在线只说明通道存在，不能代替目标服务、账号权限和防火墙检查。
多久生效？
保存后以页面显示的生效提示为准。首次测试请等待片刻，并在真正外网环境验证，避免本地 DNS 缓存或智能路由影响判断。