Misskey 使用及搭建

共计 3348 个字符，预计需要花费 9 分钟才能阅读完成。

最近我在折腾去中心化社交网络（Fediverse）的时候，发现了一个特别有意思的项目——[[Misskey]]。起初我一直在用 [[Mastodon]]，也就是长毛象，它确实很稳定，也很标准。但用久了总觉得稍微有点"严肃"，或者说功能上偏向于传统的推特体验。直到有一天，我在时间线上看到有人发了一些排版非常花哨、带着各种动态特效的嘟文，底下还有五花八门的 Emoji 贴贴（Reaction），我一下子就被吸引住了。顺藤摸瓜，我发现了 Misskey 这个宝藏。

经过一番研究和搭建，我发现它不仅仅是"另一个 Mastodon"，它在用户体验和可玩性上完全走了另一条路。今天就来聊聊 Misskey 的使用体验，以及如何自己动手搭建一个实例。

背景介绍

Misskey 是一个诞生于 2014 年的开源去中心化社交媒体平台。虽然它和 Mastodon 一样都使用 [[ActivityPub]] 协议，意味着你可以用 Misskey 账号和 Mastodon、[[Pleroma]] 等其他平台的互通，但它的出身和设计理念完全不同。

它起源于日本，开发者是 syuilo。这一背景赋予了 Misskey 浓厚的"二次元"和"极客"基因。相比于 Mastodon 追求的克制和公共讨论氛围，Misskey 更强调个人表达、高度自定义和社区互动的趣味性。

在目前的 Fediverse 版图中，Misskey 已经成为了仅次于 Mastodon 的重要力量，特别是在亚洲地区和对 UI/UX 有较高要求的用户群体中非常受欢迎。

深度分析

在使用了一段时间后，Misskey 有几个特性让我印象深刻，也是我认为它区别于其他竞品的核心优势。

高自由度的 UI

这是 Misskey 最直观的特点。Mastodon 的界面通常是固定的三栏或四栏布局，而 Misskey 允许你像搭积木一样定制自己的仪表盘（Dashboard）。你可以随意添加、删除、拖拽各种小组件（Widgets），比如时钟、日历、RSS 阅读器、系统监控，甚至是你的相册展示。如果你懂 CSS，甚至可以把界面魔改成完全认不出来的样子。

丰富的互动反馈

在 Mastodon 上，你对他人的互动通常只有"收藏"（Like）和"转发"（Boost）。但在 Misskey 上，你可以使用任意 Emoji 进行表态（Reaction）。这种机制大大降低了互动的门槛，有时候一个简单的滑稽表情或者爱心，比干巴巴的文字回复更能传达情绪。这种"贴贴"文化让社区氛围显得更加活泼和亲切。

Misskey Flavored Markdown (MFM)

这是我最喜欢的功能之一。Misskey 支持一种扩展的 Markdown 语法，叫 MFM。它不仅支持基础的加粗斜体，还支持文字滚动、抖动、旋转、彩虹色渐变等特效。虽然听起来有点"杀马特"，但在表达某些强烈情绪或者搞怪时，这些特效简直是神来之笔。

Drive 云盘功能

Misskey 内置了一个叫 Drive 的文件管理系统。你在发帖时上传的图片、视频都会保存在这里，而且你可以像管理网盘一样对它们进行文件夹分类、重命名等操作。这对于经常发图的用户来说非常友好。

实践经验

既然 Misskey 这么好玩，那么如何拥有一个属于自己的 Misskey 实例呢？虽然现在有很多公开的实例（比如 misskey.io），但自建实例能让你拥有数据的完全掌控权，也不用担心大实例的卡顿问题。

下面分享一下我使用 Docker Compose 搭建 Misskey 的全过程。

准备工作

你需要一台安装了 Linux 的服务器（VPS），建议配置至少 2GB 内存，因为构建过程和运行数据库都比较吃资源。另外你需要一个域名，并将其解析到服务器 IP。

环境方面，请确保安装了 Docker 和 Docker Compose。

获取代码

首先，我们需要从 GitHub 上拉取 Misskey 的官方代码库。建议直接使用 master 分支以保持更新，或者 checkout 到最新的 release tag。

git clone -b master https://github.com/misskey-dev/misskey.git
cd misskey

配置文件

Misskey 的配置主要涉及三个文件，官方提供了示例，我们需要复制一份出来修改。

# 复制配置文件示例
cp .config/docker_example.yml .config/default.yml
cp .config/docker_example.env .config/docker.env
cp ./compose_example.yml ./compose.yml

编辑 default.yml

这是最核心的配置文件。你需要修改其中的 url 为你的域名。

url: https://your-domain.com
# ... 其他配置保持默认，或者根据需求修改端口
# 注意：在 docker 环境下，数据库 host 通常是 db，redis host 是 redis，不要填 localhost
db:
  host: db
  port: 5432
  # ...
redis:
  host: redis
  port: 6379

编辑 docker.env

这里配置数据库的用户名和密码。请务必修改默认密码，保证安全。

POSTGRES_PASSWORD=your_strong_password
POSTGRES_USER=misskey
POSTGRES_DB=misskey

编辑 compose.yml

官方的 compose.yml 基本可以直接用，但如果你想修改映射端口或者挂载路径，可以在这里调整。

初始化和启动

配置完成后，我们需要构建镜像并初始化数据库。这一步会比较慢，耐心等待。

# 构建镜像
sudo docker compose build

# 初始化数据库
sudo docker compose run --rm web pnpm run init

如果看到类似 "Migration finished" 的提示，说明初始化成功了。

最后，启动服务：

sudo docker compose up -d

反向代理

虽然 Misskey 跑起来了，但通常我们还需要配置 Nginx 作为反向代理来处理 HTTPS。

在你的 Nginx 配置文件中加入类似以下的配置：

server {
    listen 80;
    listen 443 ssl http2;
    server_name your-domain.com;

    # SSL 配置略...

    location / {
        proxy_pass http://127.0.0.1:3000; # 假设 Misskey 运行在 3000 端口
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

配置好 Nginx 并重启后，直接访问你的域名，应该就能看到 Misskey 的欢迎界面了。

遇到的坑

在搭建过程中我也遇到过几个小问题，提醒大家注意：

一个是内存问题。构建（Build）阶段非常吃内存，如果你的 VPS 内存较小（比如 1G），大概率会因为 OOM 失败。建议开启 Swap 交换分区，或者在本地构建好镜像再推送到服务器。

另一个是Elasticsearch。Misskey 支持用 ES 做全文搜索，这会极大地提升搜索体验，但 ES 也是个内存黑洞。如果是个人小实例，初期可以先不配置 ES，等数据量大了再加也不迟。

最后

搭建 Misskey 给我最大的感受是，技术不仅仅是冷冰冰的代码，它也能承载非常丰富的情感和个性。相比于商业社交平台千篇一律的算法推荐和广告，Misskey 这种由社区驱动、高度可定制的平台，找回了互联网早期那种"我的地盘我做主"的乐趣。你可以在这里建立一个只属于你的小圈子，或者通过联邦宇宙连接全世界有趣的人。

如果你也对现有的社交网络感到厌倦，或者想尝试一下不一样的信息获取方式，强烈建议你试一试 Misskey。无论是加入一个现有的实例，还是自己动手搭建一个，相信你都能找到属于自己的那份快乐。