docs: 记录玩过的 docker 项目（searxng/paopao-ce/misskey）

misskey.md

@@ -0,0 +1,50 @@
+# Misskey — 开源社交平台
+
+> 部署于 2026-08-04，运行中 🟢
+
+## 简介
+
+[misskey-dev/misskey](https://github.com/misskey-dev/misskey)：日系开源社交平台（类微博/推特），界面颜值天花板，支持联邦宇宙（ActivityPub）。玩法丰富：笔记（嘟文）、反应表情、画板、主题帖等。
+
+## 技术栈
+
+- 后端：Node.js（NestJS）+ TypeScript
+- 数据库：PostgreSQL（默认）/ 其他可选
+- 缓存/队列：Redis
+- 搜索：SQL Like（默认）/ Meilisearch 可选
+
+## 部署记录（Docker Compose）
+
+服务组成：`misskey/misskey:latest` + `postgres:18-alpine` + `redis:7-alpine`
+
+```yaml
+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/），容器删了数据还在