Confluence知识库
权限
Confluence权限体系
可用 |
可以登录系统 |
个人空间 |
可以创建个人空间(可以创建空间时,选到"个人空间"选项) |
创建空间 |
可以创建普通空间(可以看到创建空间按钮) |
站点管理 |
除系统备份恢复之外的其它管理功能(有部分管理员菜单) |
系统管理员 |
全部权限(有管理员菜单),对系统管理员组所做的权限限制无效。始终拥有最高权限。但对个人设置为系统管理员,权限有效。 |
全局权限
空间权限
全部 |
查看 |
查看本空间文章的权限 |
|
删除自己的 |
可删除自己创建的内容 |
页面 |
添加 |
可以创建新页面(可以看到创建按钮) |
|
删除 |
可以删除本空间的所有页面 |
博文 |
添加 |
可以创建博文(可以在创建模板中选择"博文"模板) |
|
删除 |
可以删除博文 |
附件 |
添加 |
可以上传附件 |
|
删除 |
可以删除附件 |
评论 |
添加 |
可以评论 |
|
删除 |
可以删除评论,指删除所有评论 |
权限 |
添加/删除 |
打开页面上的权限设置按钮(可以看到权限设置按钮) |
邮件 |
删除 |
删除空间里的邮件内容(未开启此功能) |
空间 |
导出 |
导出空间内容 |
|
管理 |
拥有空间管理的所有权限 |
页面权限
查看 |
可以查看页面及附件 |
修改 |
可以修改页面及附件 |
权限继承
只读权限会继承,编辑权限不继承。
即父页面的编辑权限不影响子页面的编辑权限,而父页面的只读权限会影响子页面。
如果没有父页面的读权限,即使有子页面的读权限,也无法访问。
系统管理员权限
Confluence-Administrators的权限不可更改,对其设置权限无效。
但对于个人设置系统管理员权限是可以被修改的,比如单独设置A为系统管理员,但是空间管理员可以限制A无法访问某个空间,但同样的设置对confluence-administrators组无效。
站点管理员权限
站点管理员比系统管理员缺少的功能:
- 系统备份与恢复,每日备份管理,邮件服务器,外部小工具,用户宏,in-app通知,PDF导出语言,防止垃圾邮件,office连接器,用户目录,版式,样式表,自定义html,移动端应用程序,协同编辑,系统信息,邮件队列,预定作业,缓存管理,日志与性能分析,分析功能,故障排除与技术支持,集群
- 涉及到站点管理以上的权限,站点管理员不能设置。
空间管理员权限
页面权限设置对空间管理员有效,也就是你可以禁止空间管理员访问你的页面。
但空间管理员可以从空间管理中删除个人所设置的所有受限页面权限。
每个空间至少有一个空间管理员,默认是创建者。
用户或组删除
空间设定只有A群可以访问,将A组删除后,将任何人都无法访问(空间管理员及系统管理员除外)。对于页面权限也是一样的。
空间管理员无法被全部删除,即至少保留一个空间管理员。但是,这个是有bug的,而且会在BUG上出题。
假设空间spaceA有一个管理员test1,我们不能在权限中取消test1的空间管理权限,会提示至少需要一个空间管理员。BUT,我们可以直接将test1用户删掉!!这样spaceA就没有任何空间管理员了。
同样的,group1和test1同时是管理员的情况下,group1下面有一个用户test2,这个时间我们可以取消test1的管理员权限,然后不能取消group1的admin权限,BUT我们可以将test2从group1中删掉!!也可以直接将group1删掉,这样就没有管理员了。
其实说没有管理员也不是非常正确,还记得confluence-administrators这个组吗?所有权限设置对它无效。。。也就是这个组的用户仍然是有权限的。
如果删除confluence-users组会怎么样?confluence-administrators组不能被删除。
删除confluence-users组将会导致非管理员都无法使用confluence
关于用户或组删除的题比较坑,一般情况下,应该选nobody(谁都没权限),但要小心,如果有confluence-administrators时,应该选confluence-administrators。
匿名访问
- 在全局权限中开放匿名访问
- 在空间权限中开放匿名访问
满足以上两点方可访问
一般需要开放匿名访问的场景:
- License的用户数不够,但需要将部分资料向公司其它部门或者外部人员开放。这时一般创建一个新空间向匿名用户开放。
- 需要向公众收集意见,开放某个空间的评论功能给匿名用户。
匿名用户的权限限制:
不可向匿名用户授予"空间管理"及"权限管理"这两个权限。
匿名用户权限与组权限、单独用户权限是并集(对于登录用户而言)。
如果group1组用户没有创建页面的权限,而匿名用户有创建页面权限,那么group1组的用户自动获得创建页面的权限。
匿名用户不能搜索全站,不能查看用户设置,空间列表,用户列表,仪表板。
Active Users权限
- 只能从service desk开启,开启后,所有service desk用户可以访问confluence的特定空间,不受license用户的限制。
- Active users权限会覆盖空间原有权限,即任何登录 confluence的用户都能访问这个空间。类似匿名访问,既然匿名都可以访问,那么所有用户都可以访问。
- 可以关掉这个权限,但要重新开启,则只能从service desk上开启。
Like/lable/line comment权限
Like只需要view权限
Label需要edit权限,如没有edit权限,则只能写个人标签(仅个人可见),语法是my:label
内联评论需要添加评论的权限
无论有无评论权限,都可以删除自己原来的评论
但如果有人回复过这个评论,就不能再删除,删除需要有删除评论的权限。
删除评论后,原来的回复内容将自动上移一层。
但内联评论只要有人回复过就不能删除(有删除权限也不行)。但可以将所有回复都删除之后,再删除就行。
用户目录及权限
组与组权限组合取并集
用户test1同时存在于group1,group2两个组里,组1不能访问space2,组2能访问space2,这时test1是可以访问space2的
组与独立用户权限取并集
页面权限会覆盖空间权限(交集)
如果空间权限允许用户test1编辑页面A,但页面A里限制了test1不能编辑,那么test1是不能编辑的。反过来,空间权限里允许用户编辑,但页面不允许用户编辑,他也是不能编辑的。
对于存在于不同用户目录的同名用户,权限也是并集
同名的情况下,所有设置只对当前用户目录下的用户生效。
本地用户目录不可被删除,但可以限制不使用本地用户目录。
权限限制在页面链接中的表现
A页面链接了空间B中的B页面,test1有A页面的读权限,有两种情况: 1、test1没有空间B的读权限,点链接时会显示"page not found",并且链接中不会显示空间key。
2、test1有空间B的读权限,但没有页面B的读权限,点链接时会显示"access deny"。链接会显示空间key。
删除用户后内容怎么办?
用户删除后他所创建或编辑的页面,作者会变成用户编号。
重新创建同名用户,并不会继承。
空间管理
空间归档
归档后随时可以撤销归档
If a space is archived, that space: Won't appear in the Recent spaces section of the search panel. Won't appear in search results, unless you select Search archived spaces. Won't appear in advanced search results unless you select Search archived spaces. Won't appear on the Spaces dropdown menu. Won't appear in the general spaces lists in the Space Directory, but will instead appear under the Archived Spaces list. It will, however, still appear under any categories it was labeled with. Won't show up in activity streams when updated. Won't appear on your dashboard.
正常情况下,归档空间不可见,也搜不到。
但是如果查看了归档空间的页面(从归档空间中点进去),或者编辑了其中一个页面,那么它就会显示在最近查看或最近编辑列表里。
高级搜索中,可以选择搜索归档空间。
Pages within an archived space will appear in a few places. If you view a page within an archived space, that page will appear in: The Recently visited section of the search panel. The Recently viewed pages menu. If you edit a page within an archived space, that page will appear in: Activity streams The Recently updated macro. Pages within an archived space won't appear in search results, unless you select Search archived spaces. These functions remain available for archived spaces: You can view the content as usual, by following a link or typing in a URL belonging to the archived space. You can edit the content as usual, as determined by the space permissions. RSS feeds, watches and notifications remain active.
Google也搜不到归档空间
Archiving a space has no effect on search results of external search engines. For example, a public space will still appear in Google search results.
如果知道空间名称,可以直接输入它的URL进行访问或编辑。
导出word
只能导出单页
只能导出前50个图片,不包括其它附件
导出的文件只支持microsoft office , 不支持open office等
PDF导出
导出支持中文
在管理员菜单PDF导出语言中设置字体。注意这里是字体,不是语言。
导出样式
一共有四种样式可以设置
导出样式设置 |
适用域 |
特殊说明 |
全局PDF layout |
空间导出PDF |
标题页,页头,页尾 |
全局PDF style |
空间导出和页面导出 |
颜色,字体,页码等 |
空间PDF layout |
当前空间导出 |
标题页,页头,页尾 |
空间PDF style |
当前空间和当前空间的页面 |
颜色,字体,页码等 |
特殊说明:
- 空间设置优先于全局设置
- 页码设置对于DC无效,也就是有些选项在datacenter中是无效的
- 设置自定义style的问题,support不解答,但可以找partner咨询。
- 导出多页PDF时layout可用,即导出单页时,layout是不生效的。
空间导出
The following content is included in space exports.
|
PDF export |
XML export |
HTML export |
Pages |
Yes |
Yes |
Yes |
Blogs |
No |
Yes |
No |
Comments |
No |
Optional |
Optional |
Attachments |
Images only |
Yes |
Yes |
Unpublished changes |
No |
Yes |
No |
Page numbers |
Optional |
N/A |
N/A |
注意:xml export是全量导出,即与权限无关,没有权限的页面也会导出。
三种方式都可以选择指定页面导出,正确的导出内容见上表。
注意,插件Team Calendars不能被导出为xml
注意:导入需要从系统管理员菜单进入,导出则只需要空间管理员权限
注意:confluence站点中的描述是不正确的,比如html导出站点中提示不会导出附件,但实际导出中是有附件的!
空间概览
Space key:唯一、只能包含字符和数字,最长255个字符。
分类:即空间label,用于区分空间分类
归档及删除
空间logo
设置默认空间logo时,会全局更改所有使用默认logo的空间
几种空间类型的常用宏
空间类型 |
宏名称 |
宏作用 |
效果 |
文档空间 |
Info, Tip, Note, and Warning Macros |
显示空间是用来干什么的 |
|
|
Content Report Table Macro |
按给定的labels显示页面列表 |
|
|
Labels List Macro |
显示可见的label列表,导航到包含这些label的页面 |
|
|
Livesearch Macro |
在页面中嵌入搜索框。指定搜索空间和labels |
|
|
Rece ntly Updated Macro |
最近更新列表 |
|
团队空间 |
User Profile Macro |
人员信息 |
显示单个用户的头像 |
|
Blog Posts Macro |
博客流 |
显示团队成员的博客更新 |
知识库 |
Widget Connector Macro |
引用一段外网视频,文档等,像youtubi,google docs |
|
|
Multimedia Macro |
引用本地多媒体文件 |
|
|
Page Index Macro |
按字母序统计文章数量及引用链接 |
|
软件项目 |
Task Report Macro |
任务报告 |
|
|
Status Macro |
状态宏 |
|
|
Roadmap Planner Macro |
计划表 |
|
自定义侧边栏
注意:
空间logo的大小是48px x 48px,大的会自动缩小,小的居中显示
个人空间无法自定义logo
通过look and feel自定义其它内容
自定义样式布局
这个和全局设置一样
Layout/stylesheet,pdflayout/pdfstylesheet都是空间优先,也就是如果空间里不自义,默认就用全局设置。一旦空间里有自定义,就使用空间自定义。
内容工具
菜单 |
功能说明 |
模板 |
管理蓝图和模板 |
重排页面 |
|
独立页面 |
显示空间内,不在页面树中的页面 |
未定义页面 |
被本空间的页面链接过,但现在页面被删除了 |
附件 |
显示空间内所有附件,可以添加标签,导航到页面 |
回收站 |
用户删除的页面,可以恢复或者永久删除 |
|
|
集成
这里显示的是集成到本空间的链接,比如和JIRA项目集成了
页面管理
术语与定义
术语 |
对应编辑模式 |
说明 |
draft |
On |
创建未publish的文档 |
|
Limit |
创建未publish的文档 |
|
off |
|
unpublished |
On/limit |
修改未update的文档,参与编辑的人都可以看到这个状态 |
Current |
On/limit/off |
Save or publish后的文档 |
published |
On/limit |
Publish后的文档 |
|
on |
支持最多12人同时编辑 |
|
Limit |
仅支持最多1个人编辑同一份草稿 |
|
off |
从on转off时,会丢失所有草稿 |
Publish |
On/limit |
发布新版本 |
Delete unpublished page |
On/limit |
创建状态下,不保留草稿 |
resume |
On/limit/off |
恢复编辑草稿 |
discard |
On/limit/off |
放弃草稿 |
view |
Off |
从off转on后的草稿不可再编辑 |
Revert to last published version |
On/limit |
在编辑状态(非新建)放弃编辑,回到上一个发布版本。同样的,对于在版本管理中恢复版本的情况,也会丢掉unpublished的内容。 |
preview |
On/limit/off |
在编辑状态预览效果 |
View change |
On/limit |
在编辑状态(非新建)对比版本 |
复制页面
复制单个页面和复制带子页面的页面,操作是不同的
单个页面会直接打开编辑窗口,多个页面会提示写标题前缀或者替换字符。
复制页面需要的权限:
源空间 |
读权限 |
目标空间 |
Add权限,如果要复制权限,还需要" restrictions"权限 |
总体来说,就是只能复制页面,附件,label三种,变成了一个新页面。
Here's some more info on what's included when you copy a page.
|
Single page |
Page and its child pages |
|
Page contents (text, macros) |
Yes |
Yes |
|
Attached files and images |
Yes |
Optional - if you choose not to include attachments, you may see 'unknown-attachment' errors on the copied pages. |
|
Comments |
No |
No |
|
Labels |
Yes |
Optional |
|
Restrictions |
No |
Optional - you may not be able to change this option if you don't have appropriate 'Restrict' space permissions. |
|
Watchers |
No |
No |
|
Saved for later info |
No |
No |
|
History |
No |
No |
Child pages with view restrictions |
Yes - if you have permission to see the child pages. No - if you do not have permission to see the child page |
删除页面
- 删除页面之后再恢复,页面会变成独立页面(在根目录下),不在页面树中。
- 删除页面并且不选择删除子页面,那么子页面会上移一层,保留在页面树中。
移动页面
1、没有页面权限的人,可以看到设置权限的锁按钮,但无法设置权限。
2、移动页面需要的权限:
源空间的权限 |
目标空间的权限 |
删除页面的权限,查看页面的权限 |
要移动的父页面有读权限 |
如没有删除页面权限,只能在本空间移动 |
在目标空间有增加页面的权限 |
不需要删除附件的权限 |
不需要添加附件的权限 |
被移动页面需要编辑权限 |
|
如果父页面有移动权限,而子页面没有移动权限,则父页面移动后,子页面会变成独立页面。这跟删除不同。
没有添加附件权限的用户,可以将已有附件引用到新页面。
没有附件删除权限的用户,同样可以从编辑器中删除附件宏,但不能删除附件本身。
删除附件
删除附件会从链接的页面中消失,可以从回收站中恢复。
恢复后的附件在哪?
会自动链接到原页面上。
协同编辑
On |
多人编辑时会头像会显示在右上角,可以邀请他人编辑 |
Limit |
只允许一个人编辑,看不到邀请按钮。如果A在编辑,B点编辑按钮会提示A正在编辑,请稍后重试 |
disable |
多人编辑时会提示谁在编辑,保存时会合并当前内容,并生成两个版本。其中后保存的那个版本会包含两个人编辑的内容。 |
链接和锚
锚的引用语法:
快捷键
页面管理常用的宏
宏名称 |
作用 |
效果 |
Page Properties |
页面属性 |
|
Page properties Report |
页面属性报告 |
|
Content by user |
列出用户创建的所有内容 |
Content by label包含了这个功能 |
Contributors |
贡献者 |
本页面的创建和编辑人,编辑的次数等 |
Contributors summary |
贡献者统计 |
和contributors类似,只是默认已经有三个字段edit,comment,label,默认显示count了 |
Excerpt |
摘录 |
在页面中插件一段摘录信息 |
Excerpt include |
包含摘录 |
在页面中包含其它页面的摘录信息 |
Global report |
全局报告 |
上次登录后更新或新建的内容,所有未正确链接,或未定义的页面 |
Include page |
包含页面 |
包含另一个页面内容全部,解决复制页面内容不同的问题。 |
Table of contents |
目录 |
按页面中的标题显示目录 |
Table of content zone |
区域目录 |
显示这个区域内的目录 |
Task report |
任务报告 |
类似用户信息中的报告界面 |
View file |
直接在页面中显示word/excel/ppt/pdf文件 |
显示文件内容到页面中 |
页面导入
导入方式 |
使用的方法 |
导入效果 |
全站导入 |
备份与恢复 |
全站覆盖 |
空间导入 |
备份与恢复 |
空间覆盖 |
目录导入 |
空间管理->内容管理->导入 |
导入某个目录下的所有文本文件,其中文件名转换成标题,文件内容转换成页面内容 |
导入word |
页面菜单 |
导入成新页面或替换当前页面 |
导入html(默认是关闭的,需要从插件管理中开启) |
Html macro |
插入链接内容 |
|
Html include macro |
插入链接内容 |
引入视频等多媒体内容 |
Widget connector macro |
插入链接内容 |
创建页面与编辑
创建与编辑的不同
创建 |
指定位置 |
|
编辑 |
标签 |
|
用户管理
- 忘记管理员密码后,如何重置或重设管理员?
场景一、从cloud导入到server之后,原生是没有administrators账号的。
场景二、使用LDAP或JIRA server做用户服务器,但用户服务器本身不可访问的。
场景三、只有一个管理员,且忘记了管理员密码。
解决方案:
场景三的情况下,如果
- 记得邮箱并且可以登录邮箱。
- 有设置邮件SMTP。
可以通过邮箱重设。
其它情况,需要通过恢复模式来做。具体方法是:
- 在<installation-directory>/bin/setenv.sh或 setenv.bat增加配置-Datlassian.recovery.password=<your-password>,注意密码要是唯一的,即不能跟任何已有账号相同。
- 用手动模式重启confluence(windows下用服务模式重启时,不会读setenv.bat),当然也可以用服务模式来设置这个参数,复杂一些。
- 用恢复账号来登录系统:recovery_admin
- 登录后创建一个新的管理员账号,并加到confluence-administrators组里。
- 测试这个账号可以正常登录并且进入管理员菜单。
- 去掉-Datlassian.recovery.password=<your-password>配置并重启。
- 用新创建的管理员账号登录,正常恢复其它账号。
- 以上方法适应用confluence6.5及以上,以下的版本只能修改数据库,参考以下页面:
LABEL
Label属性
不能包含空格,大小写不敏感,不能包含如&*(等特殊字符,但可以包括-和_
Label需要edit权限,如没有edit权限,则只能写个人标签(仅个人可见),语法是my:label
搜索LABEL,语法:labelText:
第二种语法:
http://<your.Confluence.site>/label/foo+bar
标签不能被管理和删除,在它第一次添加时就变成可选标签,而在所有引用这个标签的地方都删除了就消失。如果是删除页面,则要清空回收站才删除。
Label相关的宏
宏名称 |
作用 |
效果 |
Content by Label Macro |
按label显示包含某些labels的页面(可按空间过滤,按时间,创建者等排序) |
|
Navigation Map macro |
导航到包含某个label的页面 |
|
Related Labels macro |
关联的label,显示与给定label相关联的label,并导航到页面 |
|
Labels List macro |
显示可见的label列表,导航到包含这些label的页面 |
|
Content Report Table macro |
根据给定的标签列出包含的页面列表 |
|
Recently Used Labels |
最近使用的标签 |
|
Popular Labels |
使用最多的标签 |
|
插件管理
插件管理的几个功能菜单
菜单 |
功能说明 |
Audit log |
审计日志,插件的安装,更新,删除日志,默认保留90天 |
Confluence update check |
Confluence更新检查 |
Setting |
是否连接插件市场(不能连公网的情况下要禁用) |
Safe mode |
禁用所有用户插件 |
插件搜索
注意几个选项
Staff-picked |
编辑推荐,默认是这个. |
Most request |
最多用户申请。也就是有普通用户申请过这个插件。 |
others |
其它分类看字面意思即可,都点一下 |
注意:输入内容搜索时,和那几个选项没有毛线关系,搜索是全局的。搜不到插件有两种情况:一是插件没放在市场上卖,二是插件不适用于当前confluence版本。
系统管理
安全配置
配置项 |
说明 |
External user management |
开启后无法管理本地用户,即不能新增,编辑用户细节这些 |
Append wildcards to user and group searches |
搜索用户支持通配符 |
CAPTCHA on login |
登录失败3次后出现验证码 |
Secure administrator sessions |
管理员需要二次验证 |
Attachment Download Security Policy |
定义附件打开方式,默认下载还是在线浏览 |
其它系统配置
配置项 |
作用 |
Spam prevention |
注册用户confluence需要验证码,如果被骚扰可开启 |
Compress HTTP Responses |
压缩HTTP响应 |
External connections enabled |
开启外部连接 |
Draft Save Interval |
自动保存草稿的时间间隔 |
|
|
|
|
|
|
注意:一般情况下语言设置跟随当前时区或浏览器语言,但有一个不会跟随,索引语言。
不同版本的区别
Cloud |
按月或年订阅,可以按任意个用户数订阅 |
Server |
永久授权,一年免费服务 |
Data center |
按年授权,一年免费服务 |
注意:server(dc)和cloud之间的迁移,有单独的迁移工具,叫Migration Assistant
模板与蓝图
模板 |
单个模板或属于某个蓝图的模板 |
蓝图 |
一系列模板,只能通过插件开发的方式来做 |
个人设置
个人空间 |
创建个人空间 |
最近浏览 |
|
最的工作 |
|
Profile |
修改个人信息,像名称,邮箱,头像等 |
Task |
分配给我的,或者我创建的。以及完成或未完成。共4种组合 |
Saved for later |
收藏 |
Watch |
我关注的 |
Draft |
我的草稿 |
Network |
谁关注了我,我关注了谁,我关注的人有什么更新 |
Setting |
修改密码 Authorized Applications |