QQ2TG For Mirai

一个帮助 QQ 与 Telegram 互联的小程序（Mirai 版本）

由 Hans362 基于小霖大佬的酷Q版本修改而成

演示

简述

程序主体使用PHP编写, 依赖于拓展swoole, 配合 Mirai-console 的 cqhttp-mirai 插件使用

目前还不是十分完善, 可能存在各种奇怪的问题, 还请各位 dalao 指点一二

Feature

• 使用 Swoole 的异步 HTTP Client 请求 Telegram Bot API 服务器
• 将QQ图片缓存为 Telegram File ID , 提高效率
• 拓展性较高, 可轻松支持一个新的 CQ 码或 Telegram 消息格式
• 支持双向发起私聊消息
• 支持 QQ 自带的 Emoji
• 支持 Telegram 端撤回 QQ 消息
• 支持私聊 QQ 黑名单
• 支持 Sticker 无损转发 (可以当 Sticker 转移机器人啦233
• 附带 Web 端消息查看
• 支持位置信息发送与接收
• 机器人在线时手机电脑可同时在线
• 采用世界上最好的语言编写 ((日常拉仇恨

实在编不出来了... /滑稽

环境要求

• 适用于 PHP 7.2（感谢 @ojhdt 帮助测试）
• 需要 MySQL 数据库
• 需要 HTTPS 支持

使用

关于该项目更为详细的使用说明，可以参考 https://blog.ojhdt.com/20200829/qq2tg/

1. 将代码拖到本地: git clone https://github.com/hans362/QQ2TG.git
2. 根据提示及示例填写完整config\.env，不要改动config\.env.example
3. 安装 Mirai-console 以及 cqhttp-mirai 插件，并对插件添加配置以下参数:

# Debug日志输出选项
debug: false
# 要进行配置的QQ号 (Mirai支持多帐号登录, 故需要对每个帐号进行单独设置)
'1234567890':
  # HTTP 相关配置
  http:
    enable: true
    # 可选，HTTP API服务器监听地址, 默认为0.0.0.0
    host: 0.0.0.0
    # 可选，HTTP API服务器监听端口, 5700
    port: 5700
    accessToken: ""
    postUrl: ""
    postMessageFormat: string
    secret: ""
  ws_reverse:
    - enable: true
      postMessageFormat: string
      # 反向Websocket主机
      reverseHost: 127.0.0.1
      # 反向Websocket端口
      reversePort: 9501
      accessToken: ""
      reversePath: /
      useUniversal: true
      reconnectInterval: 3000

4. 确保您本地可访问 Telegram Bot API 服务器或在config\.env中填写好了proxy -> host/port(若不需要请留空)
5. 确保您的PHP已安装了swoole扩展
6. 进入目录, 输入composer update
7. 在网站环境中设置public/为运行目录并确保其中的images目录可写
8. 访问https://api.telegram.org/bot<bot_token>/setWebHook?url=https://<Your_URL>/webhook.php设置WebHook, 若认为不安全, 可自行改变文件名（注意：Telegram WebHook 需要 HTTPS 协议，请解析好域名并部署好证书）
9. 配置进程守护程序:

# /usr/lib/systemd/system/QQ2TG.service
[Unit]
Description=QQ2TG
Documentation=https://github.com/XiaoLin0815/QQ2TG
After=network.target
[Service]
ExecStart=/path/to/your/php /path/to/QQ2TG/run.php
Restart=always
[Install]
WantedBy=multi-user.target

10. 终端输入 service QQ2TG start
11. enjoy it

• TG端发送消息:

  1. 私聊机器人并发送 /new_chat
  2. 选择要私聊的用户
  3. 回复机器人发出的消息开始私聊

• Web 消息查看:

  1. 在 config\.env 中设置好 program -> password 权限密钥
  2. 打开 http(s)://<Your URL>/admin/message.html 并将权限密钥填写完整
  3. enjoy it

配置安全 (极为重要!)

• Nginx:

  location ~ (^\.|/\.) {
      return 403;
  }

• Apache:

  RewriteEngine On
  RewriteRule (^\.|/\.) - [F]
  

• IIS:

  <configuration>
    <system.webServer>
      <rewrite>
        <rules>
          <rule name="Block access to dotfiles">
            <match url="(^\.|/\.)" ignoreCase="false" />
            <action type="CustomResponse" statusCode="403" statusReason="Forbidden" />
          </rule>
        </rules>
      </rewrite>
    </system.webServer>
  </configuration>

问题

日志等级建议调至 2 或以上，否则可能会造成严重的消息延误

由于 Telegram 的特殊性，所有由 QQ 转发至 Telegram 的 GIF 图像都会以链接的方式发送，至于客户端能不能自动解析显示就要看运气了 /滑稽

TODO

• 异步消息发送
• 图片信息缓存
• 用户群名片缓存
• 支持私聊消息
• 支持消息撤回
• 更新时自动更新配置
• 解决文档中提到的问题
  • 从 Telegram 端发起私聊
• 更多CQ码兼容

dalao 们如果有任何问题或者建议请在issue中提出或直接提交PR，感谢万分

更新日志

2021/06/13 修复多行文本无法正常转发的问题（感谢 @coderykw 指出并帮助测试）

2020/08/13 完成对 Mirai 的兼容 By Hans362

以下是小霖大佬的更新日志：

2018/08/11 完全重构配置调用方式

2018/08/10 支持位置信息发送与接收

2018/08/09 新增 Web 端消息查看

2018/08/08 新增 rich/sign CQ 码兼容

2018/07/27 新增日志记录

2018/07/26 支持 Sticker 本地处理转发

2018/07/22 支持 Telegram 端先发起私聊

2018/07/20 支持消息撤回

2018/07/18 回复消息提醒对方

2018/07/12 支持双向私聊消息

2018/07/11 更新名片获取机制, 添加伪消息回复支持

2018/07/05 添加图片信息缓存、消息异步发送、群名片缓存, 支持保存消息

2018/07/02 第一版，支持 QQ 与 Telegram 消息双向互通，支持图片、sticker 发送