Confluence简介
Confluence 作为团队协作与知识管理工具,是澳大利亚Atlassian公司的企业项目管理软件的主打产品之一,主要产品还有有JIRA,Confluence,GreenHopper,Bitbucket,Hipchat,Sourcetree 等。从它的官网介绍,不难看出 Confluece 诞生的主要目的便是对团队开发过程中相关的所有文档、方案等资源进行统一管理。
Confluence 为团队提供一个协作环境。在这里,团队成员齐心协力,各擅其能,协同地编写文档和管理项目。从此打破不同团队、不同部门以及个人之间信息孤岛的僵局,Confluence 真正实现了组织资源共享。
主要特性
文中所使用 Confluence 安装包与破解工具:
下载地址:https://pan.baidu.com/s/1h5xRRgAIhRpe2vs8OxqMNg
提取码:59dv
- 空间
空间是页面的组合,可以创建不限数量的空间。
每个空间都有自己的权限设置, 由空间管理员将权限分配到用户和组。Confluence 提供多种方法将空间内容导出为 HTML、PDF、XML、Word 等格式。Confluence 的每个空间具有属于该空间的博客,博客内容可以是通知、行程、状态报告或任何与时间相关的信息。点击空间中的“查看标签”页面查看空间中的全部标签, 点击任一标签查看具有该标签的页面,并且可以进一步点击标签以得到满意的结果。
- 页面
Confluence 通过历史版本记录每一个页面的编辑过程, 能够很方便的查看版本之间的区别,或恢复到以前的版本。支持页面模板,当在空间中添加一个新页面,不必从头开始,可以在页面模板的基础上添加内容,空间中的页面按照父子关系组织成树状关系,这种页面组织关系虽然简单,但是对内容的分类组织却十分有效。
Confluence 可以导入 Word 文档成为一个页面,并自动根据文档章节,对页面进行拆分和树状组织, 可以在同一空间或不同空间中移动和复制页面,可以以字母顺序排序或手工排序。
支持标签功能,用以标识页面和博客,标签能够对页面进行详细分类,并可跨越多个空间和类型以聚合内容。对页面内容的讨论,可以进行评论,评论是一种有效的社区用户沟通方式。Confluence 自动将已删除页面放置到回收站中,页面能够恢复回来,除非管理员清空了回收站。页面限制可以对单一页面设置谁可以查看、谁可以编辑,子页面继承父页面的“查看”限制设置。
- 编辑器
简单易用的富文本编辑器,用户可以迅速上手。Confluence 的富文本编辑器可以帮助用户很方便快捷的创建具有吸引力的页面。
支持在 Word 中进行编辑,点击页面或博客中的在 Word 中编辑链接,将在 Microsoft Word 中打开页面,可以编辑后将编辑好的内容存回 Confluence 中。Confluence 在用户输入时自动保存草稿,当浏览器在编辑时崩溃你输入的内容也不会丢失。可以以多种方式在页面中显示图片,还可以按照缩略图方式显示,或者显示成画廊以幻灯片方式播放。
可以很容易的在页面中嵌入多媒体, Confluence 支持以下多媒体格式:
Flash (.swf)、Quicktime 影片(.mov)、Windows Media (.wma, .wmv)、Real Media (.rm, .ram)、MP3 文件(.mp3)、AVI 文件(.avi),支持同时编辑,当出现两个以上的人同时编辑同一页面的情况,Confluence 将保证所有人不会丢失任何内容。支持拖放。 通过拖放可将嵌入的图片和Office文档直接输入到富文本编辑器中。通过链接浏览器可以链接到系统的任意对象,如:页面、博客、附件、甚至用户。
- 宏
宏是一种在页面中动态扩展功能的机制, Confluence内置提供了几十种常用的宏供用户使用。
图表宏将表格数据显示成图表,图表类型可选饼图、柱状图、折线图、面积图、散列图等。画廊宏将页面中的图像附件以缩略图画廊方式在页面中显示。
HTML 宏允许用户将 HTML 代码嵌入到页面中,HTML宏默认设置成关闭。热门标签宏将常用标签生成列表或热图。引用宏标记页面中的内容供其他宏使用。社交网络宏显示在你社交网络中的所有用户。用户属性宏显示用户属性详情。代码块宏在页面中以语法高亮方式显示源代码(HTML, Javascript, Java,等)。
- 附件
在Confluence中, 附件不是仅仅上传后就不起作用了,附件是信息共享重要的部分,附件有版本管理、可链接、可搜索、可预览,所有的附件都有版本控制, 另外每个版本都有创建者的备注,说明由谁创建和创建的原因,为了合理利用服务器存储空间, 管理员可设定附件最大尺寸。
如果安装了 Office 软件,可以直接在附件页面中编辑 Office 文件,内置的 WebDAV 插件,使用户能够通过 Windows Explorer 或其他 WebDAV 客户端直接浏览、管理、编辑附件。
Confluence 构建附件索引,以便于搜索以下文件的内容:Microsoft Word 文档、PDF 文件、Microsoft Excel 文件、Microsoft PowerPoint 演示稿、HTML, XML, 源文件和.txt文件、ZIP文件,将附件上传到 Confluence 中就像在桌面系统中一样工作。可以将桌面中的文件直接拖放到 Confluence 页面中。支持批量下载,可以将页面中的附件打包成一个ZIP文件下载。可以使用附件宏在页面中显示附件列表。
- 通知
Confluence 使用邮件通知和 RSS 源使用户能够得到最新变化的通知。可以将一日内的 Confluence 更新情况的邮件通知浓缩成一份每日邮件报告。
用户可以关注空间或其他用户,当空间内的页面或博客有任何改动时,或被关注用户进行了相关操作时,用户将会收到邮件通知。用户可以决定编辑后是否发送通知给关注人。空间管理员能够查看谁在关注页面,并能够添加关注着到任意页面或博客,这样能够使相关人员及时获得重要活动的信息。
- 搜索
Confluence 能够搜索全部空间(全局和个人空间)中的所有内容,包括邮件、个人属性、附件和空间描述。附件内容也能够建立索引,与其他Confluence内容一样供用户搜索。支持快速导航,根据用户的输入信息提供建议的搜索结果,只需要在下拉列表中选择中意的页面即可。
如果要更精准的找到想要的结果,Confluence 能够在以下几个方面设置搜索条件:
- 地方- 特定空间, 收藏空间, 全局空间或个人空间
- 内容 - 特定内容类型(页面、消息条目、邮件等)
- 时间 - 内容在特定时间段内被修改过
- 作者 - 内容最后被特定用户修改
- 邮件搜索,Confluence 支持归档全部邮件及其附件到特定空间,一旦归档后,邮件能够:
- 可搜索 - 包括邮件附件的内容
- 可查阅 - 任何有权限的人
- 可关联 - 能够追踪相关邮件
Confluence 的搜索语法提供更精细的搜索条件,可以搜索短语、指定不包括的词语,并能使用逻辑操作符,如:AND, OR ,以及通配符*,Confluence 支持标签搜索,使用前缀及搜索词,如 labelText:chocolate,用在线搜索宏在页面中添加一个搜索框,当用户输入搜索词语后,将动态显示匹配的结果。
- 定制化
Confluence 能够快速套用用户组织的展现风格并能够扩展用户所需的功能。Confluence 站点和空间的布局能够自定义。定制空间配色方案,体现出个性化或者仅仅是匹配组织的配色标准。定制样式表能够改变空间样式风格,使界面更有个性。定制站点的欢迎信息以显示站点的介绍或者是当天的重要信息。
主题用于个性化设置 Confluence 的展现风格,可以在整个站点或某个空间应用主题。Confluence有上百种插件,用于扩展 Confluence 以适应各种应用场景。Confluence 提供全面的Web Service 接口,使应用程序或脚步能够远程更新内容、管理用户和人空间。提供的API类型包括:SOAP、XML-RPC 和 REST。可访问源代码。所有的授权用户允许访问 Confluence 源代码,用于定制和扩展功能。
- 个性化
Confluence 面板显示站点的概览和最新内容变化情况,用户可以过滤和收藏内容,管理员甚至能够创建定制化的欢迎信息。注册用户能够自定义 Confluence 首页,当成功登录 Confluence 后将跳转到首页,首页可以是面板或者是定制好的一个页面。
收藏功能是快速访问感兴趣的页面或空间的一种方法, 可以从面板或个人属性页面中快速访问个人收藏的信息。私有标签可以标识个人感兴趣的内容,用于后续导航内容时使用。Confluence 记录最近查看的页面,便于后续访问。
状态更新类似微博,限制 140 个字符,能在整个组织中查看到。人员目录提供了Confluence 站点所有人员的列表,从人员目录中搜索人员,点击人名或头像就能查看到该人的详细信息。可以关注用户,了解其他人在 Confluence 中的活动,将其纳入自己的社交网络中。
创建个人空间,用于展现自己、写关于工作的博客或者仅仅是在线保存个人信息。用户可以上传自己的头像或者从系统提供的头像中选择。如果上传了照片,Confluence 允许截取指定区域作为头像。如果想了解用户更多的信息,只需要在用户名字上悬浮鼠标就会弹出浮动消息框,显示用户的概要信息。
每个Confluence都拥有用户信息区域,用于显示用户的如下信息:
- 当前状态
- 最近活动
- 头像
- 社交网络
- 其他属性
- 安全
为了便于管理,用户可以被分配到用户组中,这样在组中的用户就自动具有该组被赋予的权限。支持公开注册,便于创建一个面向公众的站点。
支持验证码。每个空间都能配置权限,权限可以由管理员赋予某个用户或者用户组。页面权限能够控制那些人能够查看或编辑某一个页面,子页面继承父页面的查看权限
支持单点登录。每个 Confluence 站点都允许不限数量的匿名用户访问,使得 Confluence 成为理想的对外服务站点,管理员能够对匿名用户组单独设置权限。
安装 Confluence 需要 Java 的支持,所以需要安装 JDK,同时需要配置数据库,安装自己的 Mysql 数据库,便于管理数据。
本次安装环境:
- Java : jdk-8u172-windows-x64
- Mysql : mysql-5.5.62-winx64
- Server : windows2012 r2
- Mysql驱动包 : mysql-connector-java-5.1.47-bin.jar
- Confluence : atlassian-confluence-6.8.5-x64.exe
JAVA环境配置
- 安装 JDK
首先下载 JDK 进官网下载 JDK
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
本篇文章下载 1.8 的。
选择相应的系统,一键安装即可。安装后会有两个 JRE,一个 JDK 内部的,和 JDK 外部的,关于两套 JRE 的解释,一个 JRE 文件在 JDK 的外部,一个 JRE 文件在 JDK 内部,这就是所谓的专用 JRE 和公用 JRE。
- 专用 JRE
安装 JDK 时,会安装一个专用 JRE,并且您可以选择安装一个公共副本。需要专用 JRE 才能运行 JDK 中包含的工具。专用 JRE 没有注册表设置,并且完全包含在仅对 JDK 已知的 Java 目录位置(通常位于 C:\Program confluence_image\Java\jdk1.8.0_162\jre)中。
- 公共 JRE
可由其他 Java 应用程序使用,并且包含在 JDK 外部(通常位于C:\Program confluence_image\Java\jre1.8.0_162)。公共 JRE 会注册到 Windows 注册表(位于 HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft)中。公共 JRE 可以使用“添加/删除程序”进行删除,并且还会注册到浏览器。
- 配置环境
进入之后选择高级系统设置,然后选择环境变量,在打开的环境变量对话框后,单击下方 【系统变量】 下的 【新建】 按钮。
然后输入 JAVA_HOME,对应的变量值为你 JDK 安装的目录。
点击确定。
然后新建变量名: CLASSPATH 变量值:.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar点确定。
然后在系统变量中找到名为 “Path” 的变量并双击,新建变量为 .;%JAVA_HOME%\bin;
确定以后,分别输入“ Java ”、“ Java -version ”( Java -version 代表你安装的java的版本)和 Javac,若都正常运行则代表 Java已经正确安装。
Mysql 解压版配置
- 下载 & 解压
打开连接 https://downloads.mysql.com/archives/community/ ,下载对应的社区版 ZIP 压缩包。然后解压到任意目录。
- 添加配置文件
在解压目录中的 my.cnf 中编辑为下面配置,如果有多个文件,如:
-
my-small.ini 是为了小型数据库而设计的。不应该把这个模型用于含有一些常用项目的数据库。
-
my-medium.ini 是为中等规模的数据库而设计的。如果你正在企业中使用 RHEL,可能会比这个操作系统的最小 RAM 需求(256MB)明显多得多的物理内存。由此可见,如果有那么多 RAM 内存可以使用,自然可以在同一台机器上运行其它服务。
-
my-large.ini 是为专用于一个 SQL 数据库的计算机而设计的。由于它可以为该数据库使用多达 512MB 的内存,所以在这种类型的系统上将需要至少 1GB 的 RAM,以便它能够同时处理操作系统与数据库应用程序。
-
my-huge.ini 是为企业中的数据库而设计的。这样的数据库要求专用服务器和 1GB 或 1GB 以上的RAM。
-
my-innodb-heavy-4G.ini 服务器内存为 4G 及以上使用,为企业专业版使用。
或者重新新建配置 my.ini 文件,如下:
[mysql]
#设置客户端默认字符集
default-character-set=utf8
[mysqld]
#设置3306端口
port = 3306
#设置mysql的安装目录
basedir=D:\Program confluence_image\mysql-5.7.24-winx64
#允许最大连接数
max_connections=200
#设置服务端默认字符集
character-set-server=utf8
#设置默认存储引擎
default-storage-engine=INNODB
为了接合 Confluence ,需要加入或修改下列配置:
#编码设置为UTF-8
character_set_server=utf8
#max_allowed_packet修改为64M
max_allowed_packet = 64M
#日志大小修改为512M
innodb_log_file_size = 512M
#存储引擎选择InnoDB
default-storage-engine = InnoDB
- 配置环境变量
鼠标右键点击“计算机”->属性->高级系统设置->高级->环境变量->系统变量->Path->新建,填写对应 Mysql 的 bin 路径,例如:D:\Program confluence_image\mysql-5.7.24-winx64\bin。
- 安装&初始化
进入 Mysql 解压目录的 bin 目录下,输入 cmd 进入命令行,如 : C:\mysql\mysql-5.5.62-winx64\bin 。
mysqld --install --defaults-file="D:\mysql-5.5.42-win32\my.ini"
#--defaults-file 指向你所选择的配置文件
#提示 Service successfully installed,然后输入以下命令进行初始化:
mysqld --initialize --console
#最后一行尾处 root@localhost: 之后就是初始密码
- 登陆数据库并修改密码
继续在命令窗口输入:mysql -uroot -p,回车后输入上述密码,进入数据库后修改密码:
set password for root@localhost = password('123456');
设置远程访问
grant all privileges on *.* to 'root'@'%' identified by '123456' with grant option;
flush privileges;
设置事务隔离级别为:读已提交
SET GLOBAL tx_isolation='READ-COMMITTED';
通过连接工具测试下,是否可以连接成功。
新建空数据库,库名为 Confluence,为 Confluence 安装所用,存放数据。
Confluence安装
将文件解压到指定目录,双击打开 atlassian-confluence-6.8.5-x64.exe
出现下列界面,点击 Next 继续。
选择 Custom Install 自定义安装。
选择 Confluence 存放路径。
这步直接 Next 继续。
如果没有其他的端口冲突的话,可直接默认 8090 端口即可,也可以输入其他的端口。
选中安装 Conference 服务,方便启动和关闭,点击安装 Install。
勾选安装后启动,继续安装。
全部安装后,页面会自动打开 Confluence 的配置页面。
这时候我们先关闭服务,现在安装的是没有破解包的,我们需要去破解一下。
找到我们的破解工具 Confluence_keygen.jar,双击运行(需要本地 Java 环境,需要事先配置)。
打开后,界面如下图:
进入到我们 Confluence 的安装目录下,找到 atlassian-extras-decoder-v2-3.3.0.jar 包,根据自身安装路径,如: C:\Program confluence_image\Atlassian\Confluence\confluence\WEB-INF\lib,将其拷贝到空闲目录下。
将其名称修改为 atlassian-extras-2.4.jar,我们的破解工具只会认识这个名称的 jar 包,回到我们破解工具界面点击 .patch,然后选中我们更名后的 jar 包,自动就破解了。
然后将我们更名破解后的 jar 包,名称改为更名前的名称 atlassian-extras-decoder-v2-3.3.0.jar。
将 atlassian-extras-decoder-v2-3.3.0.jar 拷贝到它原来的路径下,替换掉之前没有破解的 jar 包文件。
同时找到我们的 Mysql 数据库连接驱动 jar 包,如下图所示,选择mysql-connector-java-5.1.47-bin.jar这个带 bin 的 jar 包,
将它拷贝到我们的 Conflience 安装目录下,和破解包atlassian-extras-decoder-v2-3.3.0.jar 在同一目录下。
这时打开我们的配置页面,开始配置我们破解后的 Confluence 产品了。
选择语言为中文。
选择产品安装。
选择 Confluence Team Calendars 插件安装。
在下图页面复制我们的服务器 ID 。
打开我们的破解软件,名称、组织、单位可以随便填写,将刚才复制的 Server ID 正确填写,点击 .gen!得到 key,将 key 复制。
将复制的 key 填入 Confluence 文本框中,继续下一步。
选择我自己的数据库。
将我的数据库信息录入,点击测试连接,按本文配置的数据库大多可以直接测试成功,如有提示错误,可自行检查,测试成功后点击下一步继续。
选择站点,刚开始我们选择示范站点,看下别人给出的案例,方便学习。
在 Confluence 中管理用户和组。
配置系统管理员,管理站点及 Confluence 配置。
打开站点管理,看下我们是否破解成功。
注:授权快到期的时侯使用破解工具再次获取 Key,再次进行破解即可。