Misskey 设置和安装指南

非常感谢您对构建 Misskey 服务器的关注!
这份指南描述了 Misskey 的安装与设置流程。


1. 创建 Misskey 用户

直接使用 root 用户来运行 misskey 也许并不是一个好主意,因此我们有必要创建一个专用的用户。
以 Debian 为例:

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

2. 安装依赖

请安装并设置如下这些软件:

Dependencies 📦

Optional
  • Yarn 可选,但出于安全因素考虑还是推荐安装。如果您没有安装, 您需要使用 npx yarn 来代替 yarn.
  • Elasticsearch - 为了启用搜索功能,这个搜索引擎是有必要的。
  • FFmpeg

3. 安装 Misskey

  1. 连接至 misskey 用户.

    su - misskey

  2. 克隆 Misskey 项目的 master 分支。

    git clone -b master git://github.com/misskey-dev/misskey.git

  3. 进入 misskey 文件夹。

    cd misskey

  4. 检查 最新发布版 标签。

    git checkout master

  5. 安装 Misskey 的依赖。

    yarn

4. 配置 Misskey

  1. 复制 .config/example.yml 并重命名为 default.yml

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

  2. 编辑 default.yml

5. 构建 Misskey

使用如下的指令构建 Misskey :

NODE_ENV=production yarn build

如果您使用的是 Debian , 您需要安装 build-essential, python 环境包。

如果您仍然遇到有关某些模块的错误,您可以使用 node-gyp:

  1. npx node-gyp configure
  2. npx node-gyp build
  3. NODE_ENV=production yarn build

6. 初始化数据库

yarn run init

7. 完成了!

干得不错!现在您拥有了一个可以运行Misskey的环境啦。

正常启动

只需要 NODE_ENV=production npm start 即可。玩得愉快!

使用 systemd 来启动

  1. 在此处创建一个 systemd 服务:

    /etc/systemd/system/misskey.service

  2. 编辑它,粘贴如下内容并保存:

    	[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=syslog
    	StandardError=syslog
    	SyslogIdentifier=misskey
    	Restart=always
    
    	[Install]
    	WantedBy=multi-user.target
    
  3. 重启 systemd 并设置 misskey 服务自动启动:

    systemctl daemon-reload ; systemctl enable misskey

  4. 启动 misskey 服务:

    systemctl start misskey

您可以使用 systemctl status misskey 来检查服务是否正在运行。

如何将您的 Misskey 服务器升级至最新版本

  1. git checkout master
  2. git pull
  3. yarn install
  4. NODE_ENV=production yarn build
  5. yarn migrate
  6. 重启您的 Misskey 进程来应用改变。
  7. 尽情享受吧!

如果您在更新时遇到任何问题,请尝试以下操作:

  1. yarn clean 或是 yarn cleanall
  2. 重试升级 (请不要忘记 yarn install

如果您有任何疑问或是困惑,欢迎与我们联系!

本文搬运自github
https://github.com/misskey-dev/misskey/blob/develop/docs/setup.zh.md
防止github断连造成无法访问。

Q.E.D.


悲喜自渡,他人难悟