docker-playground/misskey.md

Misskey — 开源社交平台

部署于 2026-08-04，运行中 🟢

简介

misskey-dev/misskey：日系开源社交平台（类微博/推特），界面颜值天花板，支持联邦宇宙（ActivityPub）。玩法丰富：笔记（嘟文）、反应表情、画板、主题帖等。

技术栈

• 后端：Node.js（NestJS）+ TypeScript
• 数据库：PostgreSQL（默认）/ 其他可选
• 缓存/队列：Redis
• 搜索：SQL Like（默认）/ Meilisearch 可选

部署记录（Docker Compose）

服务组成：misskey/misskey:latest + postgres:18-alpine + redis:7-alpine

services:
  web:
    image: misskey/misskey:latest
    ports: ["3000:3000"]
    volumes: ["./files:/misskey/files", "./.config:/misskey/.config:ro"]
    depends_on: { db: {condition: service_healthy}, redis: {condition: service_healthy} }
  db:
    image: postgres:18-alpine
    env_file: .config/docker.env   # POSTGRES_USER/PASSWORD/DB
  redis:
    image: redis:7-alpine

networks:
  internal_network: { internal: true }  # db/redis 只走内网
  external_network: {}

关键配置：.config/default.yml（复制自 docker_example.yml）中 url 必须设为对外访问地址，启动后不可更改；首次启动自动跑数据库迁移。

🕳️ 踩坑记录

1. 数据库认证失败（auth_failed）：官方 docker_example.yml 里 db 账号是占位符 example-misskey-user/example-misskey-pass，复制后忘记改，与 docker.env 里生成的随机账号不一致，web 启动时 PG 认证失败。修复：把 default.yml 的 db.user/pass 改成与 docker.env 一致，docker compose restart web
2. 首启动迁移耗时：web 容器启动要跑 pnpm migrate && pnpm start，健康检查从 starting 到 healthy 需要约 1 分钟，别急着判失败

备注

• 端口策略：3000 对外，PostgreSQL/Redis 全走 internal_network，外部不可达
• 第一个注册的账号自动成为管理员，后台可管理站点
• 若只想自己玩，可关闭开放注册或改邀请制
• 数据在 /tmp/misskey/（files/、db/、redis/、.config/），容器删了数据还在

清理记录

• 2026-08-04 17:22 体验完毕，按 xf 要求删除：3 容器 + 3 镜像（misskey:latest 2.5G / postgres:18-alpine / redis:7-alpine）+ 数据目录 /tmp/misskey，共释放约 3G 磁盘