icewind1991/matrix-puppet-signal-docker

matrix-puppet-signal-docker镜像说明

镜像概述

本Docker镜像封装了matrix-puppet-signal工具，用于搭建Matrix与Signal之间的通讯桥接服务，实现两个平台间的消息双向同步与互通，支持数据持久化存储。

核心功能

1. Matrix与Signal协议桥接，支持消息、附件等内容的双向同步
2. 通过QR码完成Signal账号关联注册
3. 配置文件与会话数据持久化存储
4. 提供灵活的部署命令，支持快速启动与配置

使用场景

• 个人用户需要在Matrix客户端中接收和发送Signal消息
• 团队协作场景下，整合Matrix与Signal平台的通讯内容
• 需要跨平台消息统一管理的场景

配置说明

步骤1：获取并配置文件

下载示例配置文件：https://github.com/matrix-hacks/matrix-puppet-signal/blob/master/config.sample.json%EF%BC%8C%E5%A1%AB%E5%86%99%E5%BF%85%E8%A6%81%E5%8F%82%E6%95%B0%E5%90%8E%E9%87%8D%E5%91%BD%E5%90%8D%E4%B8%BA%60config.json%60%E3%80%82

步骤2：关联Signal账号

运行以下命令启动关联流程，使用Signal手机端扫描生成的QR码完成注册：

bash
docker run -it --rm -v $(pwd)/config.json:/conf/config.json -v $(pwd)/data:/data icewind1991/matrix-puppet-signal link

步骤3：生成注册文件

替换示例中的桥接服务地址，生成signal-registration.yaml文件：

bash
docker run -it --rm -v $(pwd)/config.json:/conf/config.json icewind1991/matrix-puppet-signal registration "http://signal-bridge.example.com"

步骤4：启动桥接服务

运行以下命令启动Matrix与Signal的桥接服务：

bash
docker run -it --rm -v $(pwd)/config.json:/conf/config.json -v $(pwd)/signal-registration.json:/conf/signal-registration.json -v $(pwd)/data:/data icewind1991/matrix-puppet-signal

数据持久化说明

• 配置文件存储路径：/conf/config.json、/conf/signal-registration.json
• 会话数据持久化路径：/data