在服务器上部署 Misskey（保姆级）#

前言#

看到这种自托管论坛的时候，我也去研究了一下，发现了 Misskey 这个去中心化的自建社区平台，感觉挺有意思的。研究都研究了，那就出个教程吧。

前置准备：买一台服务器#

推荐买小兔互联，便宜够用：

打开 https://moebun.com/aff/CCTAJESP ，注册账号
进控制台，点「云服务器」→「购买」这个试用活动价格非常低，购买时选择“试用”，就可以看到下面这个更便宜的，综合下来二核2G的话，7块钱一个月
购买时选择“试用”
买好后会给你一个 IP 地址、root 密码，记下来

然后用终端连接服务器：

1
ssh root@你的服务器IP

输入密码（不会显示，直接粘贴再回车就行），就连上了。

第一步：安装 Docker#

Docker 是一个让应用在「容器」里运行的工具，不用手动装一堆依赖。

1
curl -fsSL https://get.docker.com | sh

第二步：创建文件夹#

1
mkdir -p ~/misskey && cd ~/misskey

第三步：创建配置文件#

这条命令会在当前目录生成一个 docker-compose.yml，告诉 Docker 要运行哪些服务：

1
cat > docker-compose.yml << 'EOF'
2
services:
3
  misskey:
4
    image: misskey/misskey:latest
5
    container_name: misskey
6
    restart: unless-stopped
7
    ports:
8
      - "3000:3000"
9
    volumes:
10
      - ./data:/misskey/files
11
      - ./config:/misskey/.config
12
    depends_on:
13
      - db
14
      - redis
15

16
  db:
17
    image: postgres:15-alpine
18
    container_name: misskey-db
19
    restart: unless-stopped
20
    volumes:
21
      - ./db:/var/lib/postgresql/data
22
    environment:
23
      POSTGRES_USER: misskey
24
      POSTGRES_PASSWORD: 改成你的密码
25
      POSTGRES_DB: misskey
26

27
  redis:
28
    image: redis:7-alpine
29
    container_name: misskey-redis
30
    restart: unless-stopped
31
    volumes:
32
      - ./redis:/data
33
EOF

把「改成你的密码」换成一个你自己设的密码，比如 mypassword123。

第四步：创建 Misskey 配置#

告诉 Misskey 你的域名是什么、怎么连数据库：

1
mkdir -p config
2
cat > config/default.yml << 'EOF'
3
url: https://你的域名/
4
port: 3000
5
db:
6
  host: db
7
  port: 5432
8
  user: misskey
9
  pass: 上一步你设的密码
10
  database: misskey
11
redis:
12
  host: redis
13
  port: 6379
14
id: aid
15
drive:
16
  storage: ./files
17
logLevel: warning
18
EOF

⚠️ 重要：域名一旦填好就不能改了！ 想清楚再填。

把「你的域名」换成你实际的域名，比如 social.example.com。密码要和上一步一致。

第五步：启动#

1
docker compose pull

下载镜像，需要等几分钟。

1
docker compose up -d

启动服务。

1
docker logs -f misskey

查看日志，看到 listening on port 3000 就是成功了，按 Ctrl+C 退出日志。

第六步：域名和 HTTPS#

你需要做两件事：

1. 买域名

去域名注册商注册以cloudfare为例，添加一个域名（免费的也行）。

2. 设置 DNS 和 SSL

在 Cloudflare 的 DNS 设置里：

添加一条 A 记录，名字填你的子域名（比如 social），内容填服务器 IP
开启橙色云朵（Proxied）
SSL 模式选 Flexible

这样访问你的域名就会自动走 HTTPS 了。

第七步：打开网页#

浏览器访问 https://你的域名，按提示创建管理员账号就行了！

常用命令#

操作	命令
重启	`docker compose restart`
更新	`docker compose pull && docker compose up -d`
看日志	`docker logs -f misskey`
备份数据库	`docker exec misskey-db pg_dump -U misskey misskey > backup.sql`