在服务器本机打开 `http://127.0.0.1:5995/`,再用客户机访问 `http://服务器IP:5995/`。
HQShare 现场排障
按登录、端口、下载、上传和权限逐层排查。先确认服务已监听,再确认浏览器登录态和共享目录边界。
开始排障前先分清三件事
不要把网页登录、服务端口和文件权限混在一起判断。先看服务是否启动,再看账号是否有权限,最后看文件是否在共享根目录内。
能登录但没有按钮时,通常是角色权限不足;下载、上传、删除等操作会按角色显示。
文件必须位于共享根目录内。不要把系统盘、桌面或临时真实客户目录直接作为共享根目录。
浏览器打不开、登录失败或登录后跳回登录页
先区分服务未启动、端口不可达、账号密码错误和浏览器会话异常。
在运行 HQShare 的机器上访问 `http://127.0.0.1:5995/`。本机打不开时,先看服务是否启动和端口是否被占用。
本机能打开但客户机打不开时,检查绑定地址、防火墙、网段隔离和是否使用了正确 IP。
确认账号未被禁用、密码正确、角色仍然有效。正式上线后修改初始管理员口令,避免多人共用一个管理员账号。
检查浏览器会话是否被拦截,或是否跨代理改写了访问地址导致登录状态不稳定。
文件下载失败、上传失败或大文件不稳定
先确认权限和路径,再看文件大小、磁盘空间和浏览器下载行为。
当前用户缺少下载权限。把账号切到只读访客或操作员以上角色,并确认角色允许下载。
文件不存在、文件名不匹配或文件不在共享目录范围内。系统会拒绝越界读取,不会读取共享目录之外的文件。
确认用户具备上传权限、目标目录存在、文件没有超过最大上传限制、共享目录所在磁盘还有空间。
HQShare 会流式传输文件,但网络中断、代理超时或客户端浏览器限制仍会影响体验。大包建议放在稳定内网,避免通过不可靠 Wi-Fi 分发。
服务启动失败、端口被占用或重启后没有自动运行
Windows 桌面版看启动提示和当前用户自启;Linux 部署看 systemd 状态和环境文件。
默认端口是 5995。桌面版会提示建议端口;Linux 服务版修改环境文件中的端口后重启服务。
确认桌面程序正在运行,系统托盘图标可见,当前用户自启设置符合现场要求,共享目录仍然可访问。
执行 `systemctl status hqshare` 和 `journalctl -u hqshare -n 100`,确认环境文件中的共享目录、端口和绑定地址正确。
`127.0.0.1` 只允许本机访问;`0.0.0.0` 允许所有网卡访问。正式现场建议绑定具体内网 IP 并配防火墙。