finalpi/wechat2tg-pad repository overview

⁠wechat2tg-pad

基于 gewechaty⁠ 重构的基于 pad 协议收发微信消息

⁠TG 群组: @Wx2TgUserGroup⁠

⁠主要功能

1. 微信单聊消息、微信群消息、公众号消息的接收、企业微信消息的接收
2. Telegram 向指定的微信用户、微信群、公众号发送消息
3. 屏蔽指定群组的消息

⁠支持的消息类型

⁠微信消息类型支持列表

• 文本消息
• 企业微信消息
• 微信表情包
• 图片消息
• 视频消息（需要登录文件传输助手）
• 音频/视频通话 (仅消息提醒)
• 文件消息（需要登录文件传输助手）
• 链接消息
• 群聊消息
• 群聊@消息（@所有人和@你 会转换成 Telegram @你）
• 公众号消息
• emoji
• 位置消息
• 撤回消息
• 红包消息（提醒，无法获取红包内容）
• 小程序消息
• 语音消息

⁠Telegram 消息类型支持列表

• 文本消息
• 贴纸表情（部分支持，只能发送静态表情）
• 图片消息
• 视频消息
• 文件消息
• 语音消息

⁠注意事项

1. 本项目仅用于技术研究和学习，不得用于非法用途
2. 无论遇到什么问题都欢迎提交 issue

⁠gewechat⁠ 容器的注意事项(原项目 readme 已删除)

⁠注意事项：

• 1、系统环境推荐：Centos7或Ubantu2204
• 2、硬件环境推荐：4核8G
• 3、由于容器需要用到2531和2532端口，要保证服务器这两个端口没有被占用
• 4、容器启动后会访问腾讯服务，因此要保证服务器能够访问外网，并且出网没有被限制，否则会导致容器无法正常启动
• 5、使用者必须搭建服务到同省服务器或者电脑里方可正常使用
• 6、本框架面向个人娱乐使用，请勿用于任何商用场景

⁠部署安装

先复制一份 .env.example 为 .env 文件，然后配置 .env 文件中的环境变量

⁠docker-compose

创建 docker-compose.yml 文件：

version: '3'

services:
  wx2tg-pad:
    image: finalpi/wechat2tg-pad:latest
    container_name: wx2tg-pad
    ports:
      - "3000:3000"
    volumes:
      - ./config:/app/storage
      - ./save-files:/app/save-files # 保存文件夹挂载后贴纸文件不需要重新转换
    # env_file 指定环境变量文件
    env_file: ".env"
    restart: always
  gewechat:
     image: xleat/gewe:latest # 拉取镜像
     container_name: gewechat
     ports:
        - "2531:2531"
        - "2532:2532"
     volumes:
        - ./temp:/root/temp
     restart: always

⁠运行

docker-compose up -d

⁠关闭 bot 隐私模式

关闭掉机器人的隐私模式，打开 BotFather，输入 /mybots，选择你的bot。点击 Bot Settings - Group Privacy - Turn off ，出现 Privacy mode is disabled for xxx 就说明关闭成功了

⁠使用说明

⁠BOT命令

• /login：获取登录二维码；首次部署启动时，最先发送 /login 命令的人将成为 BOT 的所有者

• /flogin：获取文件传输助手登录二维码，支持接收视频和文件

• /update：更新群组头像和昵称信息

• /add：根据手机号添加微信好友，例如 /add 18888888888

• /message：开关群组消息接收

• /forward：开关转发群组内其他人或者 bot 的消息

• /user：获取微信用户列表；点击按钮后可创建新群组或者绑定用户（可通过名称或备注搜索，例如： /user 张 查找包含「张」的微信用户）

• /room：获取微信群列表；点击按钮后可创建新群组或者绑定微信群（可通过名称或备注搜索，例如： /room 外卖 查找含有「外卖」的微信群）

• /settings：程序设置

• /getqr：获取自己的二维码名片

• /unbind：解绑微信群或微信用户（仅支持在群组使用）

⁠环境变量说明

⁠设置项/settings命令说明

1. 文件传输助手接收文件和视频消息：是否使用文件传输助手接收文件和视频消息（上游没办法下载视频和文件，所以需要用文件传输助手接收）

2. 接受公众号消息：是否接受公众号消息

⁠获取API_ID 和 API_HASH

1. 登录 telegram account⁠

2. 然后点击「API development tools」并填写应用程序详细信息（只需应用程序标题和简称）

3. 最后点击「Create application」

⁠自定义消息模板

如果你想修改消息发送者的格式，你可以修改 docker 中的环境变量或者 .env 文件

自定义消息模板占位符:

#[alias]：联系人备注

#[name]：联系人昵称

#[topic]：群聊昵称

#[alias_first]：备注优先，如果没有备注就显示联系人的昵称

#[identity]：身份信息文本

#[body]：消息体文本

#[br]：换行

⁠如何 @所有人

发送以 @all 开头的消息会 @所有人，仅支持文本消息 @所有人

⁠常见问题

⁠重启 gewechat 容器后日志提示：“回调地址设置失败，请确定gewechat能访问到回调地址网络

删掉配置目录内的 ds.json，然后重启 wx2tg 容器即可

⁠参与开发

1. fork 项目，切换到 wx2tg-pad-dev 分支，或者新建一个分支。请不要直接提交代码到主分支
2. 提交 Pull Request 到 wx2tg-pad-dev 分支

⁠License

MIT⁠

⁠Thanks

感谢Jetbrains对本项目的支持