noridev/cherrypick

CherryPick Docker镜像文档

镜像概述和主要用途

CherryPick是一款开源、去中心化的社交媒体平台，基于ActivityPub协议构建，支持跨实例和跨网络通信。作为永久免费的联邦式社交解决方案，它允许用户搭建自主可控的社交实例，并与***、Pixelfed等其他联邦社交网络互联互通，适用于注重数据主权和隐私保护的个人或组织。

核心功能和特性

ActivityPub协议支持

• 实现跨平台联邦通信，不仅CherryPick实例间可互操作，还能与***、Misskey、Pixelfed等ActivityPub兼容网络的用户互动，打破平台壁垒。

丰富的内容互动方式

• 表情反应功能：支持对任意帖子添加自定义表情反应，替代传统单一点赞，更精准表达情感。

内置云存储Drive

• 集成文件管理系统，可上传各类文件、创建文件夹，自动关联帖子中的媒体内容，实现社交与存储一体化。

高度可定制的Web界面

• 提供直观易用的Web UI，支持布局调整、小部件添加及主题自定义。
• 通过原创编程语言AiScript开发插件，扩展功能边界，满足个性化需求。

开源与去中心化架构

• 完全开源代码，社区驱动开发，确保透明性与可扩展性。
• 去中心化部署模式，避免单一平台垄断，数据存储在自有实例中。

使用场景和适用范围

个人用户

• 搭建个人私有或公开社交实例，掌控个人数据与社交关系。

社区与组织

• 构建专属社交网络，促进成员间高效互动，支持自定义规则与功能。

联邦社交网络需求场景

• 需要与现有联邦社交生态（如***社区）互联互通的场景，实现跨平台用户资源整合。

隐私敏感场景

• 对数据隐私有较高要求的用户或组织，通过自建实例避免第三方平台数据收集。

使用方法和配置说明

前提条件

• 已安装Docker及Docker Compose
• 准备MySQL或PostgreSQL数据库实例
• 配置域名（推荐搭配SSL证书以确保安全通信）

基本部署步骤

1. 拉取镜像

bash
docker pull kokonect-link/cherrypick:latest

2. 快速启动容器

bash
docker run -d \
  --name cherrypick \
  -p 3000:3000 \
  -e DATABASE_URL=mysql://user:password@db-host:3306/cherrypick \
  -e DOMAIN=your-instance-domain.com \
  -e SECRET_KEY=your-secure-random-key \
  -v ./cherrypick-data:/app/data \
  kokonect-link/cherrypick:latest

3. Docker Compose部署（推荐）

yaml
version: '3.8'
services:
  app:
    image: kokonect-link/cherrypick:latest
    restart: always
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://user:password@db:5432/cherrypick
      - DOMAIN=social.example.com
      - SECRET_KEY=${SECRET_KEY}
      - NODE_ENV=production
      - PORT=3000
    volumes:
      - ./data:/app/data
    depends_on:
      - db

  db:
    image: postgres:14-alpine
    restart: always
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=cherrypick
    volumes:
      - ./postgres-data:/var/lib/postgresql/data

核心配置参数说明

数据持久化

通过挂载/app/data目录实现数据持久化，包含用户上传文件、配置文件及缓存数据：

bash
-v ./cherrypick-data:/app/data  # 本地目录映射，确保容器重启后数据不丢失

文档与社区支持

官方文档

完整安装与配置指南请参考 Misskey Hub（CherryPick官方文档平台）。

社区资源

• 实例查找：通过Misskey Hub实例列表探索公共CherryPick实例
• 开发者贡献：参考https://github.com/kokonect-link/cherrypick/blob/develop/CONTRIBUTING.md%E5%8F%82%E4%B8%8E%E5%BC%80%E5%8F%91
• 社区交流：加入社区 [] 获取支持

致谢

CherryPick的开发与维护得益于以下平台支持：

• Docker：提供容器化部署支持
• Chromatic：UI视觉测试平台
• Codecov：代码覆盖率分析工具
• Crowdin：多语言本地化平台
• RSS3：主要赞助商