troubleshooting
常见问题与排查
排查时先记录发生时间、功能入口、预期结果与实际错误。一次只改变一个设置,并优先用测试文件验证。把日志发到社区前移除账号、密码、令牌、配对码与私人文件内容。
桌面无法打开
先确认 NAS 开机、网线和路由器连接正常,再检查当前局域网地址是否变化。使用 http://NAS-IP:18080 访问实际地址,并区分局域网访问与远程域名。局域网可用而外部不可用时,按 外部访问 检查解析、中继或网络,不要先重建存储。
能登录但文件操作被拒绝
检查当前目录的实际权限、所有者、用户组和 ACL。若通过 SMB 访问,还需检查共享设置与 SMB 凭据。界面管理员能力不等于对所有 Linux 文件自动拥有读写权。不要直接给整盘开放所有权限。
时间相差八小时
进入 区域设置 选择正确时区并点击“保存时区”。时区仅影响时间显示;设备时钟本身错误时还需检查时间同步。记录 NAS 和客户端双方的时区,避免混淆。
同步或上传中断
先确认正在使用文件管理、浏览器文件传输还是 ApuClient。三者容量限制与续传方式不同。ApuClient 当前单文件最多 64 MiB,中断后从头上传;直连网络失败不会自动切云中继。检查目的目录权限、可用空间与页面是否被刷新。
备份已经建立但没有新副本
当前手动备份任务需要实际触发。连接保存或任务创建不等于后台已按时执行。查看最近一次任务结果,并抽查目标文件;需要恢复时使用新恢复目录,见 备份与恢复。
应用或更新失败
应用模板存在不代表镜像已下载,模型已下载不代表运行环境就绪。检查网络、资源、端口与数据目录权限。系统更新签名或哈希失败时不要绕过校验,保留当前版本并记录可公开错误。求助时同时写明设备架构、系统版本和能稳定复现的最短步骤。
troubleshooting.txt · 最后更改: 由 apuos-docs-import
