HQShare 现场排障

按登录、端口、下载、上传和权限逐层排查。先确认服务已监听,再确认浏览器登录态和共享目录边界。

网页登录端口检测下载上传权限边界
基础核查

开始排障前先分清三件事

不要把网页登录、服务端口和文件权限混在一起判断。先看服务是否启动,再看账号是否有权限,最后看文件是否在共享根目录内。

CHECK 1. 先看服务地址

在服务器本机打开 `http://127.0.0.1:5995/`,再用客户机访问 `http://服务器IP:5995/`。

CHECK 2. 再看账号权限

能登录但没有按钮时,通常是角色权限不足;下载、上传、删除等操作会按角色显示。

CHECK 3. 最后看共享目录

文件必须位于共享根目录内。不要把系统盘、桌面或临时真实客户目录直接作为共享根目录。

Case 1

浏览器打不开、登录失败或登录后跳回登录页

先区分服务未启动、端口不可达、账号密码错误和浏览器会话异常。

本机先测

在运行 HQShare 的机器上访问 `http://127.0.0.1:5995/`。本机打不开时,先看服务是否启动和端口是否被占用。

客户机再测

本机能打开但客户机打不开时,检查绑定地址、防火墙、网段隔离和是否使用了正确 IP。

登录失败

确认账号未被禁用、密码正确、角色仍然有效。正式上线后修改初始管理员口令,避免多人共用一个管理员账号。

登录后跳回登录页

检查浏览器会话是否被拦截,或是否跨代理改写了访问地址导致登录状态不稳定。

Case 2

文件下载失败、上传失败或大文件不稳定

先确认权限和路径,再看文件大小、磁盘空间和浏览器下载行为。

下载 403

当前用户缺少下载权限。把账号切到只读访客或操作员以上角色,并确认角色允许下载。

下载 404

文件不存在、文件名不匹配或文件不在共享目录范围内。系统会拒绝越界读取,不会读取共享目录之外的文件。

上传失败

确认用户具备上传权限、目标目录存在、文件没有超过最大上传限制、共享目录所在磁盘还有空间。

大文件下载

HQShare 会流式传输文件,但网络中断、代理超时或客户端浏览器限制仍会影响体验。大包建议放在稳定内网,避免通过不可靠 Wi-Fi 分发。

Case 3

服务启动失败、端口被占用或重启后没有自动运行

Windows 桌面版看启动提示和当前用户自启;Linux 部署看 systemd 状态和环境文件。

端口被占用

默认端口是 5995。桌面版会提示建议端口;Linux 服务版修改环境文件中的端口后重启服务。

Windows 桌面运行

确认桌面程序正在运行,系统托盘图标可见,当前用户自启设置符合现场要求,共享目录仍然可访问。

Linux systemd

执行 `systemctl status hqshare` 和 `journalctl -u hqshare -n 100`,确认环境文件中的共享目录、端口和绑定地址正确。

绑定地址

`127.0.0.1` 只允许本机访问;`0.0.0.0` 允许所有网卡访问。正式现场建议绑定具体内网 IP 并配防火墙。