> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.alephant.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server. # 坚果云与 WebDAV > 配置坚果云或企业私有 WebDAV 连接器，只读索引指定根路径下的文件。 坚果云与 WebDAV 连接器用于从官方坚果云 WebDAV 服务或企业私有 WebDAV 部署读取文件。连接器为只读模式：AIvis 会索引匹配文件，但不会上传、修改、移动或删除源文件。 当团队已经把共享文件放在坚果云或兼容 WebDAV 服务器中，并希望这些文件可被智能体和知识库搜索引用时，使用此连接器。 ## 需要准备什么 | 项目 | 坚果云 | 自定义 WebDAV | | --------- | ---------------------------------------- | ----------------------------- | | WebDAV 服务 | 选择 `坚果云`。 | 选择 `自定义 WebDAV`。 | | 基础 URL | 使用默认值 `https://dav.jianguoyun.com/dav/`。 | 输入管理员批准的 WebDAV 端点。 | | 用户名 | 使用坚果云账号邮箱。 | 使用目标服务器的 WebDAV 账号名。 | | 密码 | 使用“第三方应用管理”生成的坚果云应用密码。不要使用坚果云登录密码。 | 使用 WebDAV 账号对应的密码或令牌。 | | 根路径 | 使用一个或多个绝对目录，例如 `/` 或 `/Team/Handbook`。 | 使用 WebDAV 服务器上存在的绝对 POSIX 路径。 | 坚果云官方 WebDAV 帮助文档也按服务器地址、账号和应用密码三项说明连接方式。官方服务的服务器地址是 `https://dav.jianguoyun.com/dav/`；账号是坚果云登录邮箱；密码是生成的第三方应用密码。 ## 生成坚果云应用密码 使用官方坚果云服务时，请先创建专用应用密码，再在 AIvis 中创建凭据。 1. 登录坚果云网页端。 2. 打开账号菜单，进入**账户信息**和**安全选项**。 3. 在**第三方应用管理**中选择**添加应用密码**。 4. 输入应用名称，例如 `AIvis`，然后生成密码。 5. 复制生成的应用密码，粘贴到 AIvis 凭据表单的**密码或应用密码**字段。 坚果云移动端也可以从设置进入第三方应用管理。建议每个集成使用独立应用密码，这样撤销 AIvis 访问时不会影响其他 WebDAV 客户端。 ![坚果云设置页面，展示第三方应用管理入口](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/706f033f45675365d4664a68b81c2ebb6c4b6032e9429215d8fcc48a8a95a256/assets/aivis/nutstore/nutstore-third-party-settings.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T120254Z&X-Amz-Expires=604800&X-Amz-Signature=859c4932f133b029503e865e9890329659f0fe15dcba10435f67ddb72677b16b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ![坚果云第三方应用管理页面，展示 WebDAV 服务器地址和已遮挡的应用密码](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/170156b7b598f5b4e02a8d105859ecb53a5c3dbc79729a87df405ab6f6927972/assets/aivis/nutstore/nutstore-application-password.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T120254Z&X-Amz-Expires=604800&X-Amz-Signature=12973f22d57ff018b7eaf26b40ffc7f21fc69219bd83eb4db4ee4075ab31bbec&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## 创建凭据 | AIvis 字段 | 推荐填写 | 说明 | | ------------- | ---------------------------------- | ------------------------------------------------ | | 名称 | 描述性名称，例如 `坚果云 - 知识库`。 | 仅在 AIvis 内展示。 | | WebDAV 服务 | `坚果云`。 | 会固定使用官方基础 URL：`https://dav.jianguoyun.com/dav/`。 | | WebDAV 基础 URL | `https://dav.jianguoyun.com/dav/`。 | 选择坚果云后会自动填入默认值。 | | 用户名 | 坚果云账号邮箱。 | 使用能够读取计划索引文件夹的账号。 | | 密码或应用密码 | 坚果云应用密码。 | 这是在第三方应用管理中生成的值。 | | 允许访问私有网络 | 官方坚果云保持关闭。 | 仅对已批准的私有 WebDAV 端点启用。 | | 允许不安全的 HTTP | 官方坚果云保持关闭。 | 只有明确批准私网 HTTP 时才启用。 | | 自定义 CA 证书 | 官方坚果云留空。 | 仅在私有 WebDAV 使用内部证书链时填写 PEM 证书。 | 保存凭据后，先使用**测试连接**，再创建或启用连接器。 ![AIvis 坚果云凭据表单，展示官方 WebDAV 基础 URL、用户名和应用密码字段](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/252da3e9265a9847625018b28f9b1fcd994cb22f2596cfb46e0350fb8387c454/assets/aivis/nutstore/nutstore-credential-form.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T120254Z&X-Amz-Expires=604800&X-Amz-Signature=dffbc91fb17ba878dc704deff32abeade920cc08447a02a9e6523d4ac757f582&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## 配置连接器 | AIvis 字段 | 要求 | 示例 | | ------------- | -------------------------------------------------- | -------------------------------------- | | 连接器名称 | 易识别的连接器名称。 | `坚果云团队文档` | | 根路径 | 一个或多个要索引的 WebDAV 目录。路径必须以 `/` 开头，使用正斜杠，且不能包含 `..`。 | `/`、`/Team/Handbook`、`/Projects/2026/` | | 我已了解对象 ACL 限制 | 必须勾选。 | WebDAV 文件级 ACL 不会同步。 | | 文档访问权限 | 选择谁可以搜索此连接器索引的文档。 | 非公开内容应使用`私有`或按群组限制访问。 | | 最大文件大小 | 单个文件可被索引的最大字节数。 | 除非部署已批准更大文档，否则保持默认值。 | 尽量使用更窄的根路径。`/` 是有效路径，但它会包含该 WebDAV 账号可读取的所有目录，容易索引超出预期的内容。 ![AIvis 坚果云连接器表单，展示根路径、ACL 限制确认和文档访问权限](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/f223e519f3d3c6f010a77110ce37bd20e7c97a9ee16b6131d88fc0b6529945b7/assets/aivis/nutstore/nutstore-connector-form.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T120254Z&X-Amz-Expires=604800&X-Amz-Signature=e2af8b187c4bfbd5ac5ea2dd6215fabe084c55d5c198a2bbcc128a12d801b7c2&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ![AIvis 连接器列表，展示已安排同步的坚果云连接器和已索引文档数量](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/1e791cb507c46b507114956ce12d49c027fb5ba55e31e04347577b0a55711b35/assets/aivis/nutstore/nutstore-connector-list.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T120254Z&X-Amz-Expires=604800&X-Amz-Signature=cb4c78321d01a4a26367255a2da7634693367be38064ff5fc5505b03e78d96f1&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## 权限与 ACL 边界 WebDAV 账号决定 AIvis 在索引时能读取哪些文件。AIvis 不会把坚果云或 WebDAV 的文件级 ACL 导入为文档权限。 这意味着： * 选中根路径下的文档会继承此连接器的 AIvis 访问设置。 * 如果不同团队应看到不同文件夹，请按根路径和访问群组拆分为多个连接器。 * 只有当每个被索引文件都适合组织内所有目标用户查看时，才把连接器设为组织公开。 * 如果 WebDAV 账号失去某个根路径的访问权限，后续同步可能失败或停止索引该路径。 ## 坚果云服务限制 坚果云会对 WebDAV 使用施加限制。具体限制可能随套餐或部署变化，但官方帮助当前说明了访问频率限制和单次目录项数量限制。大目录、高频同步或多个连接器并发使用同一账号时，可能触发这些限制。 实践建议： * 只需要少数文件夹时，优先配置多个明确根路径，而不是直接索引一个很大的根目录。 * 避免让多个坚果云连接器使用同一账号在同一时间同步。 * 如果某个文件夹文件很多且索引不完整，请拆分文件夹或收窄根路径。 * 如果多次测试或同步后连接开始失败，等待 WebDAV 频率窗口重置后再重试。 ## 验证 创建凭据和连接器后： 1. 测试凭据连接。 2. 保存连接器，并确认已勾选 ACL 限制确认项。 3. 运行首次同步。 4. 确认每个根路径下的代表性文件已被索引。 5. 确认根路径之外的文件不会被索引。 6. 使用有权限用户搜索，确认能看到预期结果。 7. 使用连接器受众之外的用户搜索，确认受限文件不会出现。 8. 在维护窗口轮换坚果云应用密码，并重新测试连接。 ## 常见问题排查 | 现象 | 可能原因 | 处理方式 | | ------------- | -------------------------------- | ---------------------------------------------------- | | 认证失败 | 用户名不是坚果云邮箱，或密码填成了登录密码而不是应用密码。 | 在坚果云第三方应用管理中生成新的应用密码，并更新 AIvis 凭据。 | | 根路径不存在 | 路径不存在、未以 `/` 开头、包含 `..`，或账号无权读取。 | 在坚果云或 WebDAV 中核对文件夹路径，并使用类似 `/Team/Handbook/` 的绝对路径。 | | 权限被拒绝 | WebDAV 账号无权读取选中的文件夹。 | 在坚果云中授予该账号访问权限，或为它可读取的文件夹创建连接器。 | | TLS 或证书失败 | 自定义 WebDAV 端点使用了不受信任证书。 | 使用可信 HTTPS 证书，或为私有 WebDAV 提供已批准的自定义 CA PEM。 | | 请求被网络策略阻断 | 配置了私有地址或不安全 HTTP，但没有明确批准。 | 使用官方坚果云 URL；只有已批准的内部端点才启用私网和 HTTP 选项。 | | 目录列表失败或看起来不完整 | 可能触发坚果云 WebDAV 限制，或目录过大。 | 收窄根路径、按连接器拆分文件夹、降低同步并发，并在频率窗口重置后重试。 | | 文件被跳过 | 文件超过连接器大小阈值，或无法抽取正文。 | 先确认部署限制和索引成本，再调整最大文件大小。 | ## 相关坚果云文档 * [坚果云第三方应用授权 WebDAV 开启方法](https://help.jianguoyun.com/?p=2064) * [坚果云 WebDAV 在 WPS 中的配置示例](https://help.jianguoyun.com/?page_id=290\&paged=9)