Mojo-Weixin

环境要求

• Perl 5.10.1 以上版本（推荐 5.14+），Windows 之外多数系统自带
• 系统需已安装或可安装 cpanm 模块安装工具
• 能访问 CPAN 源（国内网络建议使用 163 镜像）
• Linux 下需具备编译环境，RedHat/CentOS 装 openssl-devel，Ubuntu 装 libssl-dev
• 建议在 root 用户下安装使用，非 root 需参考官方 FAQ

安装与启动步骤

1. 1检查 Perl 版本

   安装前先确认系统已安装 Perl，且版本不低于 5.10.1，推荐 5.14 以上。Windows 推荐用 StrawberryPerl。

   perl -v

   复制

2. 2安装 cpanm 工具

   系统已有 cpanm 可跳过。root 用户可用 cpan 安装，或用官方在线脚本安装。

   curl -kL http://cpanmin.us | perl - App::cpanminus

   复制

3. 3国内网络装 cpanm

   官方脚本在国外访问不畅时，改用腾讯云镜像脚本安装 cpanm，效果相同。

   curl http://share-10066126.cos.myqcloud.com/cpanm.pl|perl - App::cpanminus

   复制

4. 4安装 SSL 编译依赖

   IO::Socket::SSL 是安装中最易失败的依赖，Linux 需先装 SSL 开发库再继续。按系统二选一执行。

   yum install -y openssl-devel
   # Ubuntu 系统改用：sudo apt-get install libssl-dev

   复制

5. 5安装 Mojo::Weixin

   用 cpanm 在线安装模块，会自动拉取大量依赖模块，耗时较长请耐心等待。

   cpanm Mojo::Weixin

   复制

6. 6改用国内镜像安装

   若安装中一直提示下载失败，多为国外源网络差，手动指定 163 CPAN 镜像站点重试。

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

   复制

7. 7检查依赖是否齐全

   若安装仍失败，可运行官方依赖检查脚本，定位缺失的依赖模块后再重新安装。

   curl -ks "https://raw.githubusercontent.com/sjdy521/Mojo-Weixin/master/script/check_dependencies.pl"|perl -

   复制

8. 8编写并运行启动脚本

   把示例代码存成 UTF8 编码的 pl 文件，用 perl 运行后会扫码登录并在本机开启 HTTP 服务。

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

   复制

关键配置

如何确认成功

运行 perl xxxx.pl 完成扫码登录后，本机 3000 端口出现 HTTP 服务；调用 /openwx/send_friend_message 返回 {"status":"发送成功","code":0} 即成功。

常见问题

注意事项

• 本项目仅用于技术交流学习，禁止任何对国家、企业、个人构成危害的非法用途。
• 项目仅实现微信网页版自身功能范围，不支持网页版之外的能力。
• 请尽量在 root 用户下安装使用，非 root 用户可能安装成功但无法正常运行。
• IRC 命令行使用方式请阅读 IRCShell 插件的 IRC.md 文档，更多 HTTP 接口参数见 API.md。