开发者社区> QianChia> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

iOS - XMPP Openfire 服务器的搭建

简介: 前言 提前下载好相关软件,且安装目录最好安装在全英文路径下。如果路径有中文名,那么可能会出现一些莫名其妙的问题。 提前准备好的软件: jdk-8u91-macosx-x64.dmg mysql-5.7.17-macos10.12-x86_64.dmg mysql-workbench-community-6.3.9-osx-x86_64.dmg openfire_4_1_1.dmg Openfire 官网 MySQL 官网 JDK 官网 在安装配置 Openfire 或其他 xmpp 服务器前,需要先安装 MySQL 数据库。
+关注继续查看

前言

1、下载安装 Openfire

  • Openfire 官网下载最新的 Mac 版本 Openfire 安装包。

    Openfire1

  • 下载完后双击安装包,点击 pkg 文件,在安装引导下进行傻瓜式安装。安装完成后,进入系统偏好设置,点击 Openfire 图标。

    Openfire2

  • 进入 Openfire 偏好设置界面。点击 Start Openfire,让 OpenFire 服务开始启动(默认是启动的),启动完毕后,我们就可以点击 Administration 下的按钮,进入服务器后台,然后会要求输入管理员账号密码。

    Openfire3

  • Openfire 服务启动不了问题解决

    • 安装好之后,第一次是可以启动 openfire 服务器的,但是电脑重启后,就再也不能启动服务器了,每次一点击 “Start Openfire”,然后加载一下,状态还是 “Start Openfire” 没变化,有时甚至还会跳出错误提示框,提示 “Could not start the Openfire server”。

    • 解决方案如下:

      • 1)首先需要确认是否已经安装了 Java 的运行环境,以及 JAVA jdk 是否与当前 OS 系统版本,Openfire 版本成对应,如果不是,就请先安装相匹配对应的软件。

        • 在终端中输入 java -version,就可以查看电脑有没有安装 JAVA 运行环境。
      • 2)如果软件,环境对应的,最终的解决办法是

        • 打开终端,输入以下命令:

              // 获取 Openfire 目录的访问权限  
              sudo chmod -R 777 /usr/local/openfire/bin
          
              // 以超级管理员的权限运行脚本  
              sudo su
              cd /usr/local/openfire/bin
          
              // 设置 Java 的环境变量  
              export JAVA_HOME=`/usr/libexec/java_home`
          
              // 输出检验环境变量的值
              echo $JAVA_HOME
          • 输入上面的命令后回车,就会出现后面的这些语句

                /Library/Java/JavaVirtualMachines/jdk1.8.0_51.jdk/Contents/Home
        • 接着在终端,输入以下命令:

              cd /usr/local/openfire/bin  
          
              // 运行 Openfire shell 脚本  
              ./openfire.sh
          • 输入上面的命令后回车,就会出现后面的这些语句

                Openfire 4.1.2 [2016-2-21 2:47:51]
                管理平台开始监听:
                  http://jhq0228-macbookair.local:9090
                  https://jhq0228-macbookair.local:9091
                Successfully loaded plugin 'admin'.
        • 执行完这些命令之后,服务器就可以启动了,每次开机后,都启动不了的话,都试下这个方法。

2、配置 Openfire

  • 在 Openfire 偏好设置界面中,点击 Open Admin Console,进入 web 配置页面,开始配置 Openfire 服务器。

2.1 选择语言

  • 简体中文

    Openfire4

2.2 服务器设置

  • 域:如果只是本地机器上登录,可以设置为本地的域 127.0.0.1。需要远端登录的话,设置为相应的 IP 地址或域名即可。此处设置为 Mac 的机器名。

  • Server Host Name (FQDN):服务器名,不能为 IP 地址。

    Openfire5

2.3 数据库设置

  • 1、选择数据库

    • 如果要设置外部数据库(推荐,比如:MySQL),选择标准数据库连接。

      Openfire6

    • 前期 MySQL 数据库准备工作

      • MySQL 安装具体讲解见 iOS - MySQL 的安装配置

      • 1)设置 /usr/local/openfire 文件夹的访问权限为可读写

        Openfire7

        • 方法1:在 finder 中前往文件夹 /usr/local/,右键 openfire 文件夹,显示简介,点击如图右下角中的锁图标解锁,并设置权限为可以读写。

        • 方法2:打开终端,输入如下命令

              $ sudo chmod 777 /usr/local/openfire
          • 其中 777 表示授权可读写权限,000 表示无访问权限。
      • 2)在终端中登陆 MySQL,输入以下命令,然后输入数据库的 root 密码登录

            $ mysql -u root -p
        • 回车后,终端输出

              Welcome to the MySQL monitor.  Commands end with ; or \g.
              Your MySQL connection id is 946
              Server version: 5.7.17 MySQL Community Server (GPL)
          
              Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.
          
              Oracle is a registered trademark of Oracle Corporation and/or its
              affiliates. Other names may be trademarks of their respective
              owners.
          
              Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
      • 3)在终端输入以下命令,创建数据库 openfire

            create database openfire;
        • 回车后,终端输出

              Query OK, 1 row affected (0.03 sec)
      • 4)在终端输入以下命令,导入 openfire 资源文件夹 resources/database 下的数据表

            use openfire;
        
            source /usr/local/openfire/resources/database/openfire_mysql.sql
        • 在终端出现一排导入过程

          Openfire8

      • 5)在终端输入以下命令,刷新权限

            flush privileges;
        • 回车后,终端输出

              Query OK, 0 rows affected (0.07 sec)
      • 6)在终端输入以下命令,退出 MySQL

            exit
  • 2、设置数据库连接

    • 设置标准数据库连接

      Openfire9

    • 1)数据库驱动选项

      • 选择 MySQL,前提是已安装 MySQL。
    • 2)JDBC 驱动程序类

      • 默认不变,默认为:

            com.mysql.jdbc.Driver
    • 3)数据库 URL

      • 形式如下:

            jdbc:mysql://你的主机名:端口号/数据库名称
        
            jdbc:mysql://[host-name]:3306/[database-name]?rewriteBatchedStatements=true
        • [host-name] :主机名
        • [database-name]:数据库名称
      • 这里设置为:

            jdbc:mysql://localhost:3306/openfire
        • 其中主机名 [host-name] 改为 localhost。
        • 其中数据库名称 [database-name] 改为 openfire。
      • 解决数据库字符编码问题,可以在后面加

            ?useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8
      • 最终的 url 形式是

            jdbc:mysql://localhost:3306/openfire?useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8
      • 注意:前提是已存在一个名为 openfire 的数据库,否则会报如下错误,连接配置不成功。openfire 数据库的创建具体见前面所讲的 “前期 MySQL 数据库准备工作”。

        • The Openfire database schema does not appear to be installed. Follow the installation guide to fix this error.
    • 4)用户名和密码

      • 这里的用户名密码,是访问 MySQL 数据库时使用的帐号:root,和安装 MySQL 设置的 root 密码。

2.4 特性设置

  • 如果不打算使用 LDAP,则保持默认设置即可。

    Openfire10

  • 特性设置时出错问题解决

    Openfire11

    • 解决方法

      • 在 OpenFire 偏好设置中重启 OpenFire,然后重新进入 OpenFire web 配置页面,重新开始配置 Openfire 服务器即可。

2.5 管理员账户设置

  • 可以随便填写一个管理员邮箱,输入要设置的密码即可。管理员账号默认为 "admin",如果不设置密码,则默认密码为 "admin"。

    Openfire12

  • 自定义管理员账户名方法

    • 在终端输入以下命令,输入数据库的 root 密码,登陆具体的数据库(openfire)

          mysql -u root -p openfire
    • 删除表 “ofUser” 中的 admin 帐户

          delete from ofUser where username = 'admin';  
    • 创建自定义管理员(用户名:qianchia,密码:123456)

          insert into ofUser (username, plainPassword, encryptedPassword, name, email, creationDate, modificationDate) values('qianchia','123456','123456','Administrator','qianchia@icloud.com','0','0');
    • 查看用户

          select * from ofUser;
      • 如果可以往数据库里插入用户但是在用户摘要却没有数据,这是因为 openfire 的数据库驱动包太旧了,而安装的数据库太新了,把 openfire 里的驱动包换成新的就行了,路径:/usr/local/openfire/lib。

        Openfire13

2.6 登陆管理控制台

  • 完成安装后可以输入用户名和密码登陆管理控制台

    Openfire14

  • 默认的管理员帐号是 “admin”,默认管理员密码 “admin”,如果上面设置了新密码,则管理员密码是新密码。如果重设了用户名,必须重启 openfire 服务器。

    Openfire15

    Openfire16

  • 无法登录管理控制平台问题解决

    • 安装 Openfire 后 admin 无法登录管理控制平台。登录时提示:Login failed:make sure your username and password are correct and that you’re an admin or moderator。

    • 解决方案如下:

      • 1)使用 MySQL 查看工具进入数据库,进入表 “ofuser”,将该表清空,然后执行该 SQL

            INSERT INTO ofUser (username, plainPassword, name, email, creationDate, modificationDate) VALUES ('admin', 'admin', 'Administrator', 'admin@example.com', '0', '0'); 
      • 2)关闭 Openfire 服务,就是从其控制台 stop 然后再 start,再用用户名:admin,密码:admin 登录即可。

  • 每次重启 Mac 电脑都需要重新配置 Openfire 问题解决

    • 解决方法:

      • 打开 /usr/local/openfire/conf/ 文件夹。

      • 将 openfire.xml 和 security.xml 两个文件的权限设置为读与写。

      • 重新完成 Openfire 配置。

3、卸载 Openfire 方法

  • 1、卸载之前首先要停止 Openfire 服务。

    • 系统偏好中点击 Openfire 图标,如下图

      Openfire17

    • 在 Openfire 偏好设置界面中,点击 Stop Openfire。

      Openfire18

  • 2、删除 Openfire 文件。

    • 在终端里,输入以下三条命令执行即可。

          sudo rm -rf /Library/PreferencePanes/Openfire.prefPane
    • 以上执行后需要输入管理员密码。

          sudo rm -rf /usr/local/openfire
      
          sudo rm /Library/LaunchDaemons/org.jivesoftware.openfire.plist

4、测试服务器

4.1 添加测试账户

  • 服务器配置完成之后,我们可以创建几个用户,然后客户端可以使用这些用户信息登录,互相传输消息。

    Openfire19

    Openfire20

4.2 XMPP 客户端设置与使用

  • 有许多通信聊天客户端可以支持 XMPP 协议,比如,Mac 电脑就自带了一个 “信息” app,“信息” app 就支持 jabber 通信协议(XMPP 的别名)。

  • 打开 Mac 的 “信息” app,点击菜单 信息 -> 添加账户,选择其他 “信息” 账户...

    Openfire21

  • 选择 jabber 账户类型,填写相关信息

    Openfire22

    • 账户类型:Jabber
    • 用户名:上边添加的测试账户名,格式必须为:名称@openfire服务器名称
    • 密码:用户名对应的密码
    • 服务器:openfire 服务器地址,可以使用自动查找服务器和端口
    • 端口:openfire 服务器客户端端口
  • 然后,提示验证证书,选择继续。

    Openfire23

  • 登录成功。

    Openfire24

  • 登录成功后在 openfire 服务器端可以看到用户的登录状态。

    Openfire25

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
+关注
QianChia
树的芳香由风决定,人生的芳香由自己决定!
文章
问答
文章排行榜
最热
最新
相关电子书
更多
移动 App 性能监测实践(iOS篇)
立即下载
深入剖析 iOS 性能优化
立即下载
React-Native 在iOS上的性能优化方案
立即下载