misskey/docs/setup.zh.md

4.0 KiB
Raw Blame History

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 --recursive -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. git submodule update --init
  4. yarn install
  5. NODE_ENV=production yarn build
  6. yarn migrate
  7. 重启您的 Misskey 进程来应用改变。
  8. 尽情享受吧!

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

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

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