4.0 KiB
Misskey 设置和安装指南
非常感谢您对构建 Misskey 服务器的关注! 这份指南描述了 Misskey 的安装与设置流程。
1. 创建 Misskey 用户
直接使用 root 用户来运行 misskey 也许并不是一个好主意,因此我们有必要创建一个专用的用户。 以 Debian 为例:
adduser --disabled-password --disabled-login misskey
2. 安装依赖
请安装并设置如下这些软件:
Dependencies 📦
- Node.js (12.x, 14.x)
- PostgreSQL (>= 10)
- Redis
Optional
- Yarn 可选,但出于安全因素考虑还是推荐安装。如果您没有安装, 您需要使用
npx yarn
来代替yarn
. - Elasticsearch - 为了启用搜索功能,这个搜索引擎是有必要的。
- FFmpeg
3. 安装 Misskey
-
连接至 misskey 用户.
su - misskey
-
克隆 Misskey 项目的 master 分支。
git clone --recursive -b master git://github.com/misskey-dev/misskey.git
-
进入 misskey 文件夹。
cd misskey
-
检查 最新发布版 标签。
git checkout master
-
安装 Misskey 的依赖。
yarn
4. 配置 Misskey
-
复制
.config/example.yml
并重命名为default.yml
。cp .config/example.yml .config/default.yml
-
编辑
default.yml
5. 构建 Misskey
使用如下的指令构建 Misskey :
NODE_ENV=production yarn build
如果您使用的是 Debian , 您需要安装 build-essential
, python
环境包。
如果您仍然遇到有关某些模块的错误,您可以使用 node-gyp:
npx node-gyp configure
npx node-gyp build
NODE_ENV=production yarn build
6. 初始化数据库
yarn run init
7. 完成了!
干得不错!现在您拥有了一个可以运行Misskey的环境啦。
正常启动
只需要 NODE_ENV=production npm start
即可。玩得愉快!
使用 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=syslog StandardError=syslog SyslogIdentifier=misskey Restart=always [Install] WantedBy=multi-user.target
-
重启 systemd 并设置 misskey 服务自动启动:
systemctl daemon-reload ; systemctl enable misskey
-
启动 misskey 服务:
systemctl start misskey
您可以使用 systemctl status misskey
来检查服务是否正在运行。
如何将您的 Misskey 服务器升级至最新版本
git checkout master
git pull
git submodule update --init
yarn install
NODE_ENV=production yarn build
yarn migrate
- 重启您的 Misskey 进程来应用改变。
- 尽情享受吧!
如果您在更新时遇到任何问题,请尝试以下操作:
yarn clean
或是yarn cleanall
- 重试升级 (请不要忘记
yarn install
)
如果您有任何疑问或是困惑,欢迎与我们联系!