跳到正文
ApuOS产品文档
目录

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

developer:http [2026/10/16 01:56] – ApuOS reviewed user manual import apuos-docs-importdeveloper:http [2026/10/16 02:20] (当前版本) – APP sync prerequisites; reviewed source c8aeac4219db082a75590cf246cfb3d12e8c94a4 apuos-admin
行 1: 行 1:
 ====== NAS 认证、目录和 HTTP 文件接口 ====== ====== NAS 认证、目录和 HTTP 文件接口 ======
 本文描述 NAS 既有 HTTP 接口,可供 APP 局域网接入或经明确配置的 HTTPS 入口使用。所有文件路径通过已有文件身份代理解析,用户选择的是允许的 root 与相对路径,不是向服务器提交任意绝对路径。默认HTTP端口为18080,仅用于可信局域网;远程使用已核验身份的DTLS WebRTC或明确配置且证书可信的HTTPS入口。示例地址是文档占位值,替换为实际NAS,严禁向公网明文HTTP提交密码。 本文描述 NAS 既有 HTTP 接口,可供 APP 局域网接入或经明确配置的 HTTPS 入口使用。所有文件路径通过已有文件身份代理解析,用户选择的是允许的 root 与相对路径,不是向服务器提交任意绝对路径。默认HTTP端口为18080,仅用于可信局域网;远程使用已核验身份的DTLS WebRTC或明确配置且证书可信的HTTPS入口。示例地址是文档占位值,替换为实际NAS,严禁向公网明文HTTP提交密码。
 +
 +===== NAS 必需组件 =====
 +NAS 管理员需先在套件中心正常安装并启用“文件管理”(files)和“文件互传”(transfer)。新版同步门面复用文件互传的原有分块引擎,内部调用继续受官方套件安装、签名和权限门禁约束;只安装“备份中心”并不自动安装可选的文件互传应用。轻量安装或卸载该套件后,原互传接口可能返回 409,新门面可能返回 sync_transfer_rejected。此时先由 NAS 管理员检查套件状态,APP 不应绕过安装确认或构造注册表。
 +
 +capabilities 的 upload.stagingAvailable **只代表缓存数据卷就绪**,不代表所需应用已安装或当前账号拥有写权限;开始备份前还需核对组件状态、transfer.read/write、files.read/write 和目标目录权限。当前生产测试 NAS 数据卷未挂载,create 会先返回 503 transfer_storage_unavailable,即使组件也需要配置,不能把 503 猜成凭据错误。
  
 ===== 登录与响应格式 ===== ===== 登录与响应格式 =====