Ubuntu 搭建Confluence企业wiki系统

3,798 阅读5分钟

Confluence介绍:

Confluence是一个专业的企业知识管理与协同软件,也可以用于构建企业wiki。使用简单,但它强大的编辑和站点管理特征能够帮助团队成员之间共享信息、文档协作、集体讨论,信息推送 -- from 百度百科

其他的团队协作软件还有国内的 蓝湖 等...

环境准备:

  1. 服务器 我这里使用的是ubunru14.04
  2. JDK 因为Confluence是基于Java的,因此Java环境是必须的
  3. DB 我这里使用Mysql5.7

JDK环境准备:

可参考这篇博客中的JDK部署: www.yangxiao2.xyz/?p=136

Mysql安装:

sudo apt-get install mysql-server
sudo apt-get install mysql-client
sudo apt-get install libmysqlclient-dev
# 安装的过程中会输入root用户的密码, 要记住

Confluence的安装、破解与初始化:

下载

wget https://downloads.atlassian.com/software/confluence/downloads/atlassian-confluence-6.7.1-x64.bin -P /opt/

安装:

chmod +x atlassian-confluence-6.7.1-x64.bin    #加执行权限
./atlassian-confluence-6.7.1-x64.bin 

安装过程中会有交互信息

confluence 安装交互信息

到这里confluence就已经安装好了,我们接下来下载破解软件进行破解:files.cnblogs.com/files/Javam…

破解步骤:

  1. 先把confluence安装目录下的jar包传回本地:

cp /opt/atlassian/confluence/confluence/WEB-INF/lib/atlassian-extras-decoder-v2-3.3.0.jar /home/live/  #备份一份
# 备注 从服务器传文件到本地的话可以用 xftp 或者 winscp等工具
# 服务端的jar包传回到本地之后  重命名为: atlassian-extras-2.4.jar
  • 打开破解软件包中的 confluence_keygen.jar, 在图形化界面 点击 ' .patch ' 选择你从服务器传回来的jar包, jar包就破解成功
  • 将破解之后的jar传回服务端原目录下,并重命名为 atlassian-extras-decoder-v2-3.3.0.jar
  • 将 破解包里的 mysql-connector-java-5.1.44-bin.jar 传至服务器confluence安装目录下 /opt/atlassian/confluence/confluence/WEB-INF/lib
  • 重启 Confluence
sh /opt/atlassian/confluence/bin/stop-confluence.sh

sh /opt/atlassian/confluence/bin/start-confluence.sh

访问服务器IP:8090 端口:

选择语言和选择安装方法,选择 Prodution Installation 安装

这里可以直接点Nest 下一步

到这里是最关键的,打开破解软件 Name: 输入英文 Server ID:将confluence页面上的Confluence的Server ID 输入进去之后 点 .gen 按钮,就会生成一个key, 复制key 填写到 confluence的页面中进入下一步:

企业的话建议购买, 个人使用可以破解

配置数据库:

选择我自己的数据库

配置数据库之前需要在mysql中新建用户和新建confluence数据库,并分配权限:

CREATE USER 'confluence'@'localhost' IDENTIFIED BY 'password';    # 新建confluence用户
CREATE DATABASE 'confluence' DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;    # 新建数据库
GRANT ALL PRIVILEGES ON confluence.* TO "confluence"@"%" IDENTIFIED BY "password";   # 分配权限     

# 数据库的my.cnf配置文件新增以下配置:
init_connect='SET collation_connection = utf8_unicode_ci'
init_connect='SET NAMES utf8'
character-set-server=utf8
collation-server=utf8_unicode_ci
skip-character-set-client-handshake
transaction-isolation=READ-COMMITTED

# 重启mysql

数据库配置好了之后就可以在页面上填入数据库信息了, 数据库类型选择 MySQL,安装类型选择 通过连接字符串 数据库URL jdbc:mysql://localhost/confluence 再输入数据库用户名和密码

这里注意数据库URL后还要加一个字符串,指定隔离级别,不加的话可能会报错,所有完整的数据库URL为:

jdbc:mysql://localhost/confluence?sessionVariables=tx_isolation='READ-COMMITTED'

配置好之后点测试连接, 如果测试成功,点下一步继续安装,这里等几分钟数据库设置好之后就可以进入confluence配置admin账户信息, 配置好后就可以开始使用啦。

Confluence 使用中常见踩坑总结:

  • 如果使用了nginx代理, 可能会一直报一个 BASE_URL error 的错误

解决办法:

第一步: 用管理员账户登录之后修改服务器主页URL

第二步: 在插件管理界面 禁用 Confluence Base URL Plugin 这个插件

  • 不能上传大文件

解决办法:

原因1: 可能是附件大小限制, 可联系管理员 在 一般配置里更改附件大小限制

原因2: 如果更改了附件大小限制后还是不能上传,可能是用了nginx代理, 代理限制了大小, 需要在nginx配置文件中加入下边这行配置:

    client_max_body_size 1024M;  #大小按需更改
  • 预览附件时 附件内的中文显示乱码

原因: 服务器上没有Microsoft字体

解决办法:

- 创建字体文件夹

mkdir -p /usr/share/fonts/msttcore

- 把window系统下 C:\Windows\Fonts\ 下的所有字体全部上传到上面新建的字体文件夹

- 修改confluence的配置文件:

修改前先把原配置文件copy一份

cp  /opt/atlassian/confluence/bin/setenv.sh  ~/setenv.sh    # 这里的目录根据实际安装目录修改
vim /opt/atlassian/confluence/bin/setenv.sh

# 搜索`CATALINA_OPTS`, 在最后一个匹配行后,追加如下行:

CATALINA_OPTS="-Dconfluence.document.conversion.fontpath=/usr/share/fonts/msttcore ${CATALINA_OPTS}"    #指定字体目录

- 备份缓存后删除 (不清缓存只有新上传的附件才会显示正常)

#备份
cp -r /var/atlassian/application-data/confluence/viewfile/ /root/viewfile_20180114
cp -r /var/atlassian/application-data/confluence/shared-home/ /root/shared-home_20180114
cp -r /var/atlassian/application-data/confluence/thumbnails/ /root/thumbnails_20180114
 
#清空缓存
rm -rf /var/atlassian/application-data/confluence/viewfile/*
rm -rf /var/atlassian/application-data/confluence/thumbnails/*
rm -rf /var/atlassian/application-data/confluence/shared-home/dcl-document/*
rm -rf /var/atlassian/application-data/confluence/shared-home/dcl-document_hd/*
rm -rf /var/atlassian/application-data/confluence/shared-home/dcl-thumbnail/*

- 重启confluence

sh /opt/atlassian/confluence/bin/stop-confluence.sh
sh /opt/atlassian/confluence/bin/start-confluence.sh

重启之后再次预览附件, 附件中的中文就显示正常啦

最后附一个官网的解决方法,可以尝试下: The Text in a PowerPoint, Excel or Word Document is Missing or Looks Different when Using the Viewfile Macro

~over~