yukimochi/activity-relay

Activity Relay Server

概述

Activity Relay Server是一个基于Go语言开发的强大可定制ActivityPub中继服务器，旨在为ActivityPub协议支持的联邦社交网络（如***等）提供活动转发服务，增强网络连接性与信息传播效率。

核心功能与特性

• 基于Go语言开发：具备高性能与跨平台特性
• 支持ActivityPub协议：兼容联邦社交网络标准，实现活动中继功能
• 可定制配置：通过YAML文件或环境变量灵活配置服务参数
• 多组件架构：包含API服务器、Job Worker和CLI管理工具，分工明确
• 依赖Redis存储：使用Redis进行数据存储与状态管理

系统要求

• https://github.com/antirez/redis%EF%BC%9A%E7%94%A8%E4%BA%8E%E6%95%B0%E6%8D%AE%E5%AD%98%E5%82%A8

核心组件

项目包含以下主要包：

• github.com/yukimochi/Activity-Relay
• github.com/yukimochi/Activity-Relay/api（API服务组件）
• github.com/yukimochi/Activity-Relay/deliver（投递组件）
• github.com/yukimochi/Activity-Relay/control（控制组件）
• github.com/yukimochi/Activity-Relay/models（数据模型）

使用方法

API服务器

启动API服务器以处理中继请求：

bash
relay --config /path/to/config.yml server

任务工作器

启动任务工作器以处理投递任务：

bash
relay --config /path/to/config.yml worker

CLI管理工具

使用命令行工具进行中继服务管理：

bash
relay --config /path/to/config.yml control

配置说明

YAML配置文件

创建YAML格式的配置文件（如config.yml），示例如下：

yaml
# 用于签名活动的PEM证书路径
ACTOR_PEM: /var/lib/relay/actor.pem
# Redis连接URL
REDIS_URL: redis://redis:6379

# 中继服务绑定地址与端口
RELAY_BIND: 0.0.0.0:8080
# 中继服务域名
RELAY_DOMAIN: relay.toot.yukimochi.jp
# 中继服务名称
RELAY_SERVICENAME: YUKIMOCHI Toot Relay Service
# 任务并发数
JOB_CONCURRENCY: 50
# 中继服务描述（可选，多行文本）
# RELAY_SUMMARY: |
#
# 中继服务图标URL（可选）
# RELAY_ICON: https://
# 中继服务图片URL（可选）
# RELAY_IMAGE: https://

环境变量配置

当未提供配置文件时，可通过环境变量进行配置（均为可选）：

• ACTOR_PEM: PEM证书路径
• REDIS_URL: Redis连接URL
• RELAY_BIND: 服务绑定地址与端口
• RELAY_DOMAIN: 中继服务域名
• RELAY_SERVICENAME: 中继服务名称
• JOB_CONCURRENCY: 任务并发数
• RELAY_SUMMARY: 中继服务描述
• RELAY_ICON: 图标URL
• RELAY_IMAGE: 图片URL

相关文档

详细的构建、安装与控制指南，请参考https://github.com/yukimochi/Activity-Relay/wiki%E3%80%82

许可证

https://app.fossa.io/api/projects/git%2Bgithub.com%2Fyukimochi%2FActivity-Relay.svg?type=large](https://app.fossa.io/projects/git%2Bgithub.com%2Fyukimochi%2FActivity-Relay?ref=badge_large)

项目赞助

感谢您的支持。

月度***

***者列表

***平台

• Patreon
• pixiv fanbox
• fantia