# 书屿连接 WebDAV：从私人书库下载一本书

语言：zh-CN
原文：[书屿连接 WebDAV：从私人书库下载一本书](<https://allluckly.cn/guides/nasbook-webdav-library/>)
中文：[中文 HTML](<https://allluckly.cn/guides/nasbook-webdav-library/>)
English: [English HTML](<https://allluckly.cn/en/guides/nasbook-webdav-library/>)
发布于: 2026-10-23T00:00:00+08:00
内容更新于: 2026-10-23T00:00:00+08:00
署名：Bison

配置书屿 WebDAV 私人书库，核对地址、路径与权限，下载单本电子书并完成离线检查，区分书库访问和阅读数据同步。

WebDAV 适合把 NAS 或自有服务器上的电子书提供给手机和平板。书屿连接后可以浏览远程目录，再选择需要的书下载到本机。第一次配置的目标应当很小：连上一处正确目录，下载一本 EPUB，确认断网后也能打开。

## 在服务器准备一个阅读目录

先确认你的服务器已经启用 WebDAV，知道服务地址、端口、用户名、密码和书籍目录。建议在一个专用目录中放一本小型 EPUB 作检查，目录名可以是 `Books/Test`。这些值由服务器配置决定，不能照抄别人的端口，也不要把 NAS 管理后台的网址直接当作 WebDAV 服务地址。

手机与服务器需要互相可达。第一次可在家中同一网络完成，远程访问再按现有部署方式处理。书屿的 NAS 浏览、下载及远程阅读属于藏书家 Pro 范围；本地文件阅读可以先完成，不必为了验证基础阅读就配置全部远程功能。会员状态和服务器权限是两项独立前提。

## 在书屿添加 WebDAV 连接

进入「设置」中的「NAS 连接」，通过添加按钮打开连接表单。给连接取一个能够区分用途的名称，例如“家中书库”，协议选择 WebDAV。按照表单分别填写地址、端口、路径和凭据；如果地址栏已经包含协议或路径，避免又在其他字段重复拼接同一段内容。

例如服务器实际开放的是 `https://books.example.com/dav/`，就要依照当前表单的拆分方式填写主机与路径。这里的域名只是说明结构，不能直接使用。用户名和密码填专用字段，不要夹进地址文本；否则复制连接信息或截屏求助时，容易把本不该公开的凭据带出去。

## 先测试，再保存并浏览

使用「测试连接」，查看结果。成功后保存，再打开连接浏览目录。测试通过只说明当前连接检查成功，还需要实际进入目标文件夹，看到练习书并下载一次，才能确认书籍路径与读取权限也正确。若提示失败但允许仍然保存，应把它当作保存配置，不能当作连通证明。

浏览时先按层级找到 `Books/Test`，比较服务器端与 App 中的文件名。看到空目录，先核对账户是否有目录读取权限，以及路径是不是多了一层或少了一层。不要立刻扫描整个 NAS；从已知小目录开始，可以把地址、权限和文件格式问题拆开判断。

## 下载到书架并检查本地结果

选择练习书，在可用操作中使用「下载到书架」。若随后出现导入预览，核对标题与格式，再完成导入。等待下载与导入都结束，回书架打开正文。远程目录里看到封面、文件名或大小，都不能代替这一步；本地阅读需要实际保存可用内容。

打开后读到第二章，返回书架，再临时关闭网络重新打开。如果能够读到后面的章节，说明这一本已具备本地阅读条件。对行程准备而言，下载一册验证后再安排其他书，比一次排入几十本却不核对结果更可靠。每一本是否完成，仍应以实际结果为准。

## 区分书库连接和阅读数据同步

本篇连接的是书籍存放位置。书屿另有「全量同步」用于把阅读进度、笔记、标签等数据写入你选择的 WebDAV 目录，两者用途不同。能下载电子书，不等于已经启用阅读记录同步；同步成功，也不等于整套书籍文件已自动复制到另一台设备。

如果之后要开启同步，可以准备独立的同步目录，避免把阅读数据库文件与原书混在一起。服务器账户也需要相应写入权限，而单纯下载书籍可能只需要读取。不要为了排查下载问题就开启大范围写权限，先按本次用途确认具体缺少什么。

## 按错误现象检查连接

出现认证失败时，检查账号、密码以及该账号是否允许 WebDAV 访问；后台网页登录成功，不一定说明同一权限已经开放给文件协议。出现路径不存在时，核对大小写、空格和反向代理前缀。出现超时时，先确认服务器在线、网络可达，以及地址指向的端口确实提供 WebDAV。

HTTPS 证书错误应在服务器端修正证书、域名或证书链，不要通过关闭校验来让教程“继续”。下载结果如果其实是登录网页，也不能当作 EPUB 使用。保留错误类型与时间，能够帮助管理员查日志；求助时只分享必要信息，遮住密码与私有地址中的敏感部分。

## 常见问题

**同一 Wi-Fi 下为什么仍连不上？** 设备可能位于访客网络、隔离网段，或服务器防火墙没有允许相应访问。先确认网络路线和服务端设置，再反复测试 App；更换文件名通常解决不了连通性问题。

**下载过的书会在会员到期后不能打开吗？** 公开说明区分远程会员功能与本地使用：已经下载的本地书籍和本地阅读仍可继续。到期后不要把远程目录可访问性与本地文件可读性混为一谈，出门前仍应实际做离线检查。

**能直接把 WebDAV 地址发给别人共享书吗？** 地址本身不代表授权，也不应连同个人账号一起分享。共享需要依据你拥有的内容权利与服务器管理方式单独安排；本篇只建立自己的私人访问。

## 后续路线

家庭局域网已有 SMB 共享时，可对比[SMB 连接方式](<https://allluckly.cn/guides/nasbook-smb-library/>)；需要两台设备延续笔记和进度，继续[WebDAV 阅读数据同步](<https://allluckly.cn/guides/nasbook-webdav-sync/>)。

## 资料与版本

资料核对于 2026 年 10 月 23 日。公开版本为书屿 1.1.3，最低要求 iOS / iPadOS 15.6。本文按公开功能说明与相应功能入口整理，界面名称可能随版本调整。参考[App Store 官方说明](<https://apps.apple.com/cn/app/id6766198898>)与[Apple 版本信息](<https://itunes.apple.com/lookup?id=6766198898&country=cn>)。