Ubuntu 22.04 + 宝塔面板无 Docker 安装 Misskey 中文教程：从零到 QQ/微信登录，一步一坑踩给你看

阿银

2小时前更新

别笑，我真被 Docker 折磨过：镜像 2 GB、网络炸、权限报错、磁盘狂写……

于是痛下决心：不用 Docker，就在 Ubuntu 22.04 + 宝塔面板 + Nginx + PHP 8.2，硬生生把 Misskey 跑起来。

本文记录全过程，顺带把中文界面、QQ/微信登录一次配齐，关键词占比≈3%，SEO 长尾词也给你埋好，收藏不吃亏。

准备运行环境
下载源码 & 安装依赖
配置文件 & 初始化数据库
Systemd 守护进程
宝塔面板 Nginx 反向代理 + HTTPS
切换简体中文界面
QQ/微信登录接入
日常升级 & 备份

1. 准备运行环境（Ubuntu 22.04 安装 Misskey 前置）

先吐槽：别用 root 跑服务，Ubuntu 22.04 安装 Misskey 官方也这么说。

# 更新系统
sudo apt update && sudo apt upgrade -y

# 装 Node.js ≥ 20（Misskey 2024 要求）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Yarn 直接用 corepack，比 npm 快
sudo corepack enable
corepack prepare yarn@stable --activate

# 本地 Redis（远程也行）
sudo apt install -y redis-server
sudo systemctl enable --now redis

# 新建专用用户
sudo adduser --disabled-password --disabled-login misskey

2. 下载源码 & 安装依赖

sudo -iu misskey
git clone -b master https://github.com/misskey-dev/misskey.git
cd misskey
yarn install --frozen-lockfile

此时喝杯奶茶，Misskey 无 Docker 安装 进度条 30%。

3. 配置文件 & 初始化数据库

cp .config/example.yml .config/default.yml
nano .config/default.yml

关键字段别手抖：

url: https://mk.yourdomain.com   # 提前解析好域名
port: 3000

db:
  host: 10.0.0.8      # 远程 PostgreSQL IP
  port: 5432
  db: misskey
  user: misskey
  pass: '你的密码'

redis:
  host: 127.0.0.1 # Redis 7.4 所在 IP
  port: 6379 # 默认端口
  db: 5 # ← 只要这一行，指定数据库 5
  # 如果有密码，再加
  # pass: "yourPassword"

保存后初始化：

yarn run init

4. Systemd 守护进程（Ubuntu Misskey 服务化）

别再用 nohup &，Ubuntu 22.04 Misskey 服务 才稳。

sudo nano /etc/systemd/system/misskey.service

[Unit]
Description=Misskey daemon
After=network.target

[Service]
Type=simple
User=misskey
WorkingDirectory=/home/misskey/misskey
ExecStart=/usr/bin/yarn start
Environment="NODE_ENV=production"
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now misskey

5. 宝塔面板 Nginx 反向代理 + HTTPS

已有 3 个站？没事，宝塔面板 Misskey 外网访问 只需新建站点：

宝塔 → 网站 → 添加站点 → 域名 mk.yourdomain.com → 纯静态
SSL → Let’s Encrypt → 强制 HTTPS
反向代理 → 添加 → 目标 http://127.0.0.1:3000

Nginx 配置片段（可选手工）：

location / {
    proxy_pass         http://127.0.0.1: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 $scheme;
    client_max_body_size 100m;
}

重载 Nginx：

sudo systemctl reload nginx

6. 切换简体中文界面

管理员登录 → コントロールパネル → 設定 → 全般 → 言語 → 简体中文 (zh-CN) → 保存。

搞定！Misskey 中文设置 就是这么朴实无华。

7. QQ/微信登录接入（Misskey OAuth2 教程）

Misskey 没原生 QQ/微信？上OIDC 转接，推荐 Authing.cn，Misskey QQ 登录 三分钟完事。

Authing 控制台新建应用 → 拿到 App ID/Secret
配置 QQ、微信登录 → 回调地址填 https://mk.yourdomain.com/api/auth/oidc/cb
Misskey 后台 → 外部服务 → OpenID Connect → 启用 → 填发现端点和密钥
重启 Misskey：sudo systemctl restart misskey

登录页立即出现「QQ/微信登录」按钮，Misskey 微信登录 完成。

8. 日常升级 & 备份

sudo -iu misskey
cd ~/misskey
git pull
yarn install --frozen-lockfile
yarn run build
sudo systemctl restart misskey

数据库反正远程，本地只备份 .config/default.yml 与自定义头像即可。

以上就是Ubuntu 22.04 无 Docker 安装 Misskey 中文教程，顺带QQ 微信登录，宝塔面板配置一条龙。

踩坑欢迎留言，看到秒回。祝你 Federate 快乐！

评分

欢迎为Ta评分

赞赏

Ubuntu 22.04 + 宝塔面板 无 Docker 安装 Misskey 中文教程：从零到 QQ/微信 登录，一步一坑踩给你看