Confluence 连接器把一个完整的 space 同步进一个已连接文件夹：其中每个当前页面，再加上挂在它们上的文件。连接方式有两种：

卡片	适用于	以谁的身份登录
Confluence	Confluence Cloud	你本人，经由 Atlassian 登录弹窗
Confluence Keys	Confluence Cloud，或 Server / Data Center	一个 API token（Cloud）或个人访问令牌（Server / Data Center）

Atlassian 的登录方式够不到 Server / Data Center，因此对自建的 Confluence，令牌是唯一选择。

用登录方式连接 Confluence Cloud

1. 在 Files → Connections 上点击 Add connection，选择 Confluence，再点击 Authorize。
2. 在弹窗里登录 Atlassian，选择你的站点并确认。

该连接申请的是对页面、附件与 space 的只读访问，能读取你账号可打开的那些 space。

用 API token 连接 Confluence

连接能看到哪些 space，由令牌自身的权限决定，所以请使用一个能读到你目标 space 的账号来生成令牌。

Confluence Cloud： 在 id.atlassian.com/manage-profile/security/api-tokens 创建 API token。

Server / Data Center： 在你的个人资料页创建个人访问令牌，入口是 Settings → Personal Access Tokens。

然后在 Files → Connections 上点击 Add connection，选择 Confluence Keys，填写：

字段	Cloud	Server / Data Center
Confluence site URL	https://your-team.atlassian.net/wiki，要带上 /wiki	你的基础 URL，例如 https://confluence.example.com
Atlassian 账号邮箱	创建该令牌的账号邮箱	留空
API token	API token	个人访问令牌

连接器正是靠「有没有填邮箱」来区分 Cloud 与 Server / Data Center，所以用个人访问令牌时请把它留空。

点击 Connect。LlamaCloud 会先向站点询问这枚令牌属于谁，再保存。站点 URL 必须以 https://（或 http://）开头且能解析到公网地址，因此只在内网可达的 Server / Data Center 实例无法连接。

从 Confluence 连接创建文件夹

在 Files → New folder → Connected folder 里选择你的 Confluence 连接，并从列表中挑一个 Space。已归档的 space 不在列表里。

如果列表加载不出来，或该账号能看到超过 200 个 space，会出现一个 Space key 输入框代替。key 就在该 space 下任意页面的 URL 里，紧跟在 /spaces/ 之后：…/wiki/spaces/ENG/pages/… 中的它就是 ENG。

一个文件夹总是同步整个 space，不能只挑某些页面或某棵页面树。

Confluence 连接器会往你的文件夹里放什么

• 每个页面变成一个 HTML 文件，其中内嵌的图片也一并内联进去。
• 每个附件会作为独立文件出现在页面旁边。
• 只同步页面，不同步博客文章。

每次同步都会列出整个 space 并与文件夹里现有的做比对。被编辑过的页面与附件会重新下载，被删除的会被移除。因此很大的 space 即使几乎没变，每次同步也更久。

Confluence 连接器的故障排查

提示	该检查什么
”Confluence rejected this token”	令牌有误或已被撤销、邮箱与创建它的账号不符，或者你给 Server / Data Center 令牌填了邮箱。
”No Confluence API answered at …”	站点 URL 指向的是某个页面而不是站点本身。Cloud 应当以 /wiki 结尾。
”Confluence URL must resolve to a public address”	站点在内网。
”confluence space … not found”	space key 写错，或该连接的账号看不到这个 space。