Misskey · 永远免费开源的联邦社交媒体平台 · 自托管实例部署与使用全指南

项目仓库： https://github.com/misskey-dev/misskey

定位：开源联邦社交媒体平台 · 官方站点：misskey-hub.net · 安装指南：misskey-hub.net/docs/for-admin/install · 容器：Docker Hub 官方支持

1 项目简介

Misskey 是一个开源、联邦、永远免费的社交媒体平台。它与 Mastodon 等同属联邦宇宙，用户可在不同实例间互相关注与互动。官方提供了实例目录、创建实例指南与社区（Discord），并由 Sentry、Chromatic、Codecov、Crowdin、Docker 等提供开源支持。

1.1 核心信息一览

1.2 适用场景

• 自建一个联邦社交实例，与其他 ActivityPub 实例互联。
• 喜欢 Misskey 独特的时间线、自定义表情与动画体验。

1.3 能力边界（官方口径）

• Misskey 是开源、永久免费的项目，欢迎通过 Patreon 等方式赞助。
• 错误跟踪由 Sentry、视觉回归由 Chromatic、测试覆盖率由 Codecov、翻译由 Crowdin、生产容器由 Docker 提供支持。

2 功能特性

• 联邦社交媒体：与联邦宇宙其他实例互通。
• 丰富的 UI：动画、自定义表情、时间线等特色交互。
• 可自托管：官方提供从安装指南到 Docker 生产容器的完整链路。
• 国际化：通过 Crowdin 社区翻译为多语言。
• 可视化质量保障：CI 集成 Chromatic、Codecov。

3 官方界面预览

Misskey 前台为带时间线、笔记、自定义表情的现代社交界面，支持亮色 / 暗色与动画效果。

4 官方跳转链接汇总

5 前置要求与服务器配置

5.1 软件前提

• 按官方安装指南准备 Node.js、数据库（PostgreSQL）、Redis 等依赖，或使用官方 Docker 容器。
• 一个域名并解析到本机。

5.2 硬件建议

• 普通 VPS 即可起步；实例规模增大后扩容。

5.3 端口与资源

• Web 服务 80/443；按官方安装指南配置反代。

6 方式一：官方安装指南 / Docker（推荐）

按官方 安装指南 逐步部署；生产环境使用官方 Docker 容器。

7 方式二：从源码开发运行

参考 CONTRIBUTING.md 搭建开发环境。

8 配置项说明

• 实例配置（域名、SMTP、对象存储等）按官方文档设置。

9 常用运维命令

• 启动 / 停止：按官方部署方式（docker compose / systemd）操作。
• 升级：按官方文档升级实例版本。

10 常见故障排查

• 按官方安装指南核对依赖版本与反代配置；加入 Discord 社区求助。

11 风险与合规说明

• 许可证：开源免费软件，使用须遵守仓库 LICENSE。
• 运营责任：自建实例需自行承担内容审核与合规责任。
• 本文整理自官方 README，命令与配置以官方文档最新说明为准；不包含 star 数等动态数据。