用实际绑定的 IP 和端口验证。绑定 `0.0.0.0` 时，本机可用 `127.0.0.1`；绑定特定 IP 时须用该 IP。默认端口为 5995。
文档手册
Mingcedar Share 现场排障
按登录、端口、下载、上传和权限逐层排查。先确认服务已监听，再确认浏览器登录态和共享目录边界。
开始排障前先分清三件事
依次检查服务是否启动、账号权限、文件是否位于共享根目录。
能登录但没有按钮时，通常是角色权限不足；下载、上传、删除等操作会按角色显示。
文件必须位于共享根目录内。不要把系统盘、桌面或临时真实客户目录直接作为共享根目录。
浏览器打不开、登录失败或登录后跳回登录页
先区分服务未启动、端口不可达、账号密码错误和浏览器会话异常。
在主机访问绑定地址和端口：`0.0.0.0` 可用 `127.0.0.1` 验证，特定 IP 须用该 IP。仍打不开时，检查服务和端口占用。
本机能打开但客户机打不开时，检查绑定地址、防火墙、网段隔离和是否使用了正确 IP。
确认账号未被禁用、密码正确、角色仍然有效。正式上线前修改初始管理员口令，避免多人共用一个管理员账号。
会话默认登录 12 小时后过期，重启共享也会清除会话。重新登录后仍跳回时，检查浏览器是否允许站点 Cookie。
文件下载失败、上传失败或大文件不稳定
先确认权限和路径，再看文件大小、磁盘空间和浏览器下载行为。
当前用户缺少下载权限。把账号切到只读访客或操作员以上角色，并确认角色允许下载。
检查文件是否存在、名称是否匹配、是否位于共享目录内；越界读取会被拒绝。
确认用户具备上传权限、目标目录存在、本次全部文件及表单开销没有超过上传限制（默认 512 MiB）、共享目录所在磁盘还有空间。
文件采用流式传输。检查网络中断、代理超时和浏览器限制；大文件使用稳定内网传输。
服务启动失败、端口被占用或重启后没有自动运行
Windows / macOS 登录自启只打开桌面应用，共享仍需启动；Linux 检查 systemd 状态和 config.json。macOS 需确认本地网络与文件夹访问权限。
默认端口是 5995。桌面版会提示建议端口；Linux 服务版通过 `config set --port` 修改配置后重启服务。
确认桌面程序正在运行，系统托盘图标可见，当前用户自启设置符合现场要求，共享目录仍然可访问。
执行 `systemctl status hqshare` 和 `journalctl -u hqshare -n 100`，确认 `/etc/hqshare/config.json` 中的共享目录、端口和绑定地址正确；环境文件仅指定程序与配置路径。
`127.0.0.1` 只允许本机访问；`0.0.0.0` 监听所有 IPv4 接口，能否访问仍取决于网络和防火墙。正式现场可绑定固定内网 IP，并通过防火墙限制来源。