Mojo-Webqq

环境要求

• Perl 5.10.1 及以上，推荐 5.14+（Linux/Mac 多数系统自带，Windows 推荐 StrawberryPerl）
• cpanm 包管理工具（系统已装可跳过）
• Linux 编译环境：openssl-devel（RedHat/CentOS）或 libssl-dev（Ubuntu），用于编译 IO::Socket::SSL
• 建议在 root 用户下安装使用，非 root 安装参考官方 FAQ

安装与启动步骤

1. 1确认 Perl 版本

   先确认系统已安装 Perl，且版本至少 5.10.1、推荐 5.14+。Windows 建议选 StrawberryPerl 等二进制预编译版本，装完即用。

   perl -v

   复制

2. 2安装 cpanm 工具

   系统已有 cpanm 可跳过。方法 a 用 cpan 安装，方法 b 在线安装，两者任选其一执行即可，国内访问慢时用带腾讯云镜像的那条。

   cpan -i App::cpanminus
   curl -kL https://cpanmin.us | perl - App::cpanminus
   curl http://share-10066126.cos.myqcloud.com/cpanm.pl|perl - App::cpanminus

   复制

3. 3安装 Mojo::Webqq

   用 cpanm 在线安装 Mojo::Webqq 模块；若已安装过，执行此命令相当于升级。会自动安装大量依赖模块。

   cpanm Mojo::Webqq

   复制

4. 4换国内镜像重装

   若一直提示下载失败，是访问国外服务器网络较差，可手动指定网易镜像站点重新安装。

   cpanm --mirror http://mirrors.163.com/cpan/ Mojo::Webqq

   复制

5. 5补齐 SSL 编译依赖

   安装失败常见原因是 IO::Socket::SSL 编译出错。按系统二选一安装：RedHat/CentOS 用 yum，Ubuntu 用 apt，装完回到上一步重装。

   yum install -y openssl-devel
   sudo apt-get install libssl-dev

   复制

6. 6编写启动脚本

   新建 UTF-8 编码的 .pl 文件，填入示例代码：加载 ShowMsg 插件和 Openqq 插件，指定监听地址与端口，可选填写消息上报接口。

   #!/usr/bin/env perl
   use Mojo::Webqq;
   my ($host,$port,$post_api);
   
   $host = "0.0.0.0"; #发送消息接口监听地址，没有特殊需要请不要修改
   $port = 5000;      #发送消息接口监听端口，修改为自己希望监听的端口
   #$post_api = 'http://xxxx';  #接收到的消息上报接口，如果不需要接收消息上报，可以删除或注释此行
   
   my $client = Mojo::Webqq->new();
   $client->load("ShowMsg");
   $client->load("Openqq",data=>{listen=>[{host=>$host,port=>$port}], post_api=>$post_api});
   $client->run();

   复制

7. 7运行脚本并登录

   用 perl 解释器运行刚才保存的脚本，程序会完成 QQ 登录，并在本机指定地址端口上产生一个 HTTP server。

   perl xxxx.pl

   复制

8. 8调用接口验证

   脚本运行后，按 API 文档地址调用发送好友消息接口，uid 换成真实 QQ 号。返回 JSON 中 code 为 0 表示调用成功。

   curl 'http://127.0.0.1:5000/openqq/send_friend_message?uid=xxxxx&content=hello'

   复制

关键配置

如何确认成功

脚本运行后访问监听地址的发送好友消息接口，返回 {"status":"发送成功","msg_id":23910327,"code":0} 即表示服务正常。

常见问题

注意事项

• WebQQ 已于 2019 年 1 月 1 日停止服务，项目停止维护，仅供技术学习与参考
• 启动脚本必须保存为 UTF-8 编码的文件，否则可能运行失败
• README 建议尽量在 root 下安装使用，非 root 安装的问题参见官方 FAQ
• README 提到支持 Docker 镜像，具体命令参见项目内 Docker.md，本文未给出 Docker 安装命令