请协助我们进行翻译

本文档为社区翻译,您可以通过 Crowdin 翻译该文档。我们需要您的帮助🙏

手动搭建 Misskey

本指南介绍如何安裝和配置 Misskey。

警告

请勿使用已启动的服务器的域主机名重新创建数据库!

前提条件

必须安装并配置以下软件:

如果您使用 Debian/Ubuntu,最好安装 build-essential 软件包。

必须启用 corepack

sudo corepack enable

创建用户

Misskey 不能以 root 身份执行,因此建议创建一个用户。 Debian:

adduser --disabled-password --disabled-login misskey

安装 Misskey

sudo -iu misskey
git clone --recursive https://github.com/misskey-dev/misskey.git
cd misskey
git checkout master
git submodule update --init
NODE_ENV=production pnpm install --frozen-lockfile

设置

请复制范例中的 .config/example.yml,并重命名为 default.yml

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

请根据文件中的提示编辑 default.yml

构建镜像与初始化数据库

使用以下命令进行 Misskey 的构建和数据库初始化。这可能需要一些时间。

NODE_ENV=production pnpm run build
pnpm run init

运行

您做到了!您可以使用以下命令启动 Misskey。

NODE_ENV=production pnpm run start

大功告成,祝武运昌盛! GLHF✨

使用 systemd 进行管理

创建 systemd 配置文件

/etc/systemd/system/misskey.service

在编辑器中打开它,粘贴以下代码并保存:

[Unit]
Description=Misskey daemon

[Service]
Type=simple
User=misskey
ExecStart=/usr/bin/npm start
WorkingDirectory=/home/misskey/misskey
Environment="NODE_ENV=production"
TimeoutSec=60
StandardOutput=journal
StandardError=journal
SyslogIdentifier=misskey
Restart=always

[Install]
WantedBy=multi-user.target
注意

如果需要在 CentOS 中使用低于 1024 的端口号使用 Misskey, 必须修改成 ExecStart=/usr/bin/sudo /usr/bin/npm start

systemdを再読み込みしmisskeyサービスを有効化

sudo systemctl daemon-reload
sudo systemctl enable misskey

搭建 Misskey 服务器

sudo systemctl start misskey
提示

systemctl status misskeyと入力すると、サービスの状態を調べることができます。

更新Misskey的方法

注意

在更新时,请务必确认Misskey更新通知,以提前了解变更内容以及可能需要进行的额外工作(通常情况下并不需要)。

拉取 master,安裝、构建和迁移数据库:

git checkout master
git pull
git submodule update --init
NODE_ENV=production pnpm install --frozen-lockfile
NODE_ENV=production pnpm run build
pnpm run migrate

由于更新内容和数据库规模的不同,处理时间可能会有所不同。

更新完成后,請重启 Misskey 服务。

sudo systemctl restart misskey
提示

如果您在构建或启动过程中遇到错误,请尝试以下命令:

  • pnpm run cleanpnpm run clean-all
  • pnpm rebuild