Configuring a WebDAV client for Confluence

中文标题【为 Confluence 配置一个 WebDAV 客户端】

在 Confluence 管理员控制台的 WebDAV 配置（WebDAV Configuration）界面，你可以：

• Deny a WebDAV client write permissions to a Confluence installation 使用正则表达式（regex）
• Disable or enable strict path checking
• Enable or disable access to specific virtual files/folders

备注：

• WebDAV 配置（WebDAV Configuration）页面仅仅在 WebDAV 插件启用后才会看到。这个插件是与 Confluence 安装绑定在一起的。系统管理员可以启用或者禁用这个插件。
• WebDAV 配置（WebDAV Configuration）的配置不能应用到外部附件存储配置。

使用 WebDAV 客户端来对页面进行操作

下面的部分告诉你如何在不同的系统中来设置原生的 WebDAV 客户端，这个客户端通常显示在你操作系统的文件浏览器中，例如，Windows 的 Windows Explorer 或者 Linux 的 Konqueror。

在 Mac OSX Finder 中访问 Confluence

如何使用 Finder 来查看和管理 Confluence 内容：

1. 在 Finder 选择 进入（Go） > 连接到服务器（Connect to Server）

2. 输入下面格式的 URL：

   http://<confluenceURL>/plugins/servlet/confluence/default

   针对上面的示例，你的 Confluence URL 是 http://ourconfluence.atlassian.net/wiki 的话，你需要输入下面的内容：

   http://ourconfluence.atlassian.net/wiki/plugins/servlet/confluence/default

3. 输入你的 Confluence 用户名和密码，然后单击 连接（Connect）

   使用的用户名（jsmith），不要使用你的电子邮件地址，除非你是用电子邮件地址作为你的用户名的。

Confluence 将会显示在 Finder 的分享目录中。你可以使用相同的 URL 来用第三方的客户端来连接 Confluence 实例，例如 CyberDuck。

在 Microsoft Windows 中用 Explorer 访问 Confluence

这部分我们有下面 2 个方法来配置你的 Microsoft Windows 访问 WebDAV 客户端：

• 通过一个网络驱动器
• 通过一个 Web 文件夹

如果可能的话，使用网络驱动的方法对比使用 Web 文件夹的方法来说能够提供更多的功能，也更加全面。然而，你的 Confluence 安装实例必须满足一些特定的要求才能满足使用网络驱动的方法进行访问。如果你配置的 Confluence 安装实例不能满足使用网络驱动器访问 Confluence 内容的要求的时候，你可以使用 web 文件夹的方法或者第三方的 WebDAV 客户端。

如果你使用了 SSL，你需要将 @SSL 参数配置添加到你服务器的 URL 中，例如：

http://<confluence server url>@SSL/confluence/plugins/servlet/confluence/default

如果你在配置的时候遇到了任何问题，请参考 WebDAV Troubleshooting 页面中的内容。

Windows 网络驱动器

为了将 Confluence WebDAV 客户端映射为网络驱动器，你 Confluence 的安装实例必须满足下所有的配置要求：

• 没有上下文的根（context root）
• 如果你在映射为网络驱动的时候，有配置阻止你成功进行配置，你可以配置使用下面的步骤来配置 网络文件夹（Network Folders）。

有这些限制的原因是因为 Microsoft's Mini-Redirector 组件的限制。有关更多的问题，请参考微软的 server discovery issue。

希望在 Microsoft  Window 中映射 WebDAV 客户端网络：

1. 在 Window XP 中，进入My Computer->Tools menu->Map Network Drive
   在 Windows Vista 中，进入 Computer->Map Network Drive
2. 指定下面的 2 个配置参数来映射 WebDAV  客户端：
   
   • Drive:<Any drive letter> （例如，z：）
   • Folder:\\<hostname>\webdav （例如 \\localhost\webdav）
3. 单击完成（Finish）
   
   

当需要你输入 Confluence 的登录信息的时候，输入你 Confluence 的用户名和密码。

Windows Web 文件夹

希望在 Microsoft  Window XP 中映射 WebDAV 客户端为 Web 文件夹：

1. 进入 My Network Places 然后选择 Add a network place 然后单击 Next
2. 请确定  Choose another network location 已被选择了，然后单击 Next 继续
3. 在 'Internet or network address' 字段中，输入 Confluence WebDAV 的 URL 路径（例如，http://<confluence server url>/confluence/plugins/servlet/confluence/default 或 http://<confluence server url>/plugins/servlet/confluence/default）然后单击 Next
4. 如果你的 Confluence 用户名和密码
5. 为你的 Web 文件夹提供一个有意义的名字
6. 单击 完成（Finish）

屏幕截图：一个在 Windows XP 中的 Confluence WebDAV 客户端 Web 文件夹

希望在 Microsoft  Window Vista 中映射 WebDAV 客户端为 Web 文件夹：
在 Vista 映射的过程与 XP 的映射过程非常相似。然后有关的界面与 XP 比起来还是有点不同的：

1. 打开 'Map Network Drive' 对话框（请参考上面的映射网络驱动器的步骤）然后选择 'Connect to a Web site that you can use to store your documents and pictures'
2. 单击 'Next'
3. 输入选择的 Choose a custom network location ，然后单击 Next 继续
4. 在 'Internet or network address' 字段中，输入 Confluence WebDAV 的 URL 路径（例如，http://<confluence server url>/confluence/plugins/servlet/confluence/default 或 http://<confluence server url>/plugins/servlet/confluence/default）然后单击 Next
5. 输入你的 Confluence 用户名和密码
6. 为你的 Web 文件夹提供一个有意义的名字
7. 单击 完成（Finish）

在 Linux 或 Solaris 中设置 WebDAV 客户端

在这 2 个操作系统中有很多工具可以被用来配置 WebDAV 客户端。因此，我们使用 Konqueror 来管理，这个是 K Desktop Environment 的一部分。

希望在 Konqueror 中设置 Confluence WebDAV  客户端：

1. 打开 Konqueror
2. 在 'Location' 字段，输入 Confluence  WebDAV 的位置，使用 'protocol' 为 webdavs （例如，http://<confluence server url>/confluence/plugins/servlet/confluence/default 或 http://<confluence server url>/plugins/servlet/confluence/default）然后单击 回车（Enter）。
3. 如果弹出对话框，输入你的 Confluence 用户名和密码
   
   

你应该可以单击来载入很多文件，但是并不会载入所有的文件。在通常情况下，你应该保存修改了的文件夹在本地，然后拖到 Konqueror 窗口中上传到 Confluence。

限制 Confluence WebDAV 客户端的写入权限

在早期的 WebDAV 插件中分离了 WebDAV 客户端的写入权限（不能使用，创建/修改，编辑和删除操作）是分开配置的。但是在新版版本的插件中，我们将这些权限合并到了一起。

WebDAV 客户端现在被显示了写入权限通过设置正则表达式来匹配你 WebDAV 客户的用户的头。通过设置正则表达式，我们将会把一系列的限制列表限制到 WebDAV 的客户端中。任何用户如果满足了匹配的头部，将会被限制写入权限。

示例：一个 PROPFIND 方法的头部，这个是由 Microsoft Web Folder WebDAV 客户端创建，显示在 user agent 头部的字段中：

PROPFIND /plugins/servlet/confluence/default HTTP/1.1
Content-Language: en-us
Accept-Language: en-us
Content-Type: text/xml
Translate: f
Depth: 1
Content-Length: 489
User-Agent: Microsoft Data Access Internet Publishing Provider DAV
Host: 127.0.0.1:8082
Connection: Keep-Alive

限制 WebDAV 客户端向你安装的 Confluence 的写入权限：

1. 在屏幕的右上角单击 控制台按钮 ，然后选择 基本配置（General Configuration） 链接。
2. 在左侧边栏中选择 WebDav 配置（WebDav Configuration'）。
3. 输入正则表达式来满足你 user agent 的头部，这个是由你期望限制的 WebDAV 客户端发送的。
4. 单击 添加新正则表达式（Add new regex）按钮。
   重复上面的第三和第四步，对你期望进行限制的其他 WebDAV 客户端。
5. 单击 保存（Save）。

在你 Confluence 的安装实例中，恢复一个或者多个限制的 WebDAV 客户端：

1. 在屏幕的右上角单击 控制台按钮 ，然后选择 基本配置（General Configuration） 链接。
2. 在左侧边栏中选择 WebDav 配置（WebDav Configuration'）。
3. 在正则表达式列表中，选择你希望恢复的 WebDAV 客户端。
4. 单击 删除选择的正则表达式（Remove selected regexes）按钮。
5. 单击 保存（Save）。

屏幕截图：WebDAV 配置
 

禁用严格路径检查

如果你在你的 WebDAV 客户端发现了一些不正常的现象，例如文件夹在 Confluence 中是存在的，但是在你客户端下载的文件中就不存在了。你可以禁用  WebDAV 插件中的严格路径检查选项，这个选项能够帮你缩小你遇到的问题。

希望禁用 WebDAV 插件中的严格路径检查选项：

1. 在屏幕的右上角单击 控制台按钮 ，然后选择 基本配置（General Configuration） 链接。
2. 在左侧边栏中选择 WebDav 配置（WebDav Configuration'）。
3. 取消选择 'Disable strict path check' 选择对话框。
4. 单击 保存（Save）。

虚拟文件和文件夹

在取消点赞事件中，你可能会遇到 WebDAV  客户端的问题或者不稳定的情况，你可以启用访问自动创建（虚拟）文件和文件夹。

备注：

在默认情况下，这个选项隐藏在 'WebDAV Configuration' 页面中。为了让这个可见，添加参数 ?hiddenOptionsEnabled=true 到你的 URL 的结尾，然后重新载入页面。例如：

<Confluence base URL>/admin/plugins/webdav/config.action?hiddenOptionsEnabled=true

屏幕截图：隐藏虚拟文件和文件夹选项
 

希望启用或者禁用虚拟文件夹选项：

1. 在屏幕的右上角单击 控制台按钮 ，然后选择 基本配置（General Configuration） 链接。
2. 在左侧边栏中选择 WebDav 配置（WebDav Configuration'）。
3. 添加你的 URL 按照上面提示的说明，然后重新载入 'WebDav Configuration' 页面。
4. 选择你希望取消的虚拟文件夹选项 'Virtual Files and Folders' ，将选择对话框取消选择就可以了。
5. 单击 保存（Save）。