147 lines
4 KiB
Markdown
147 lines
4 KiB
Markdown
|
Misskey 设置和安装指南
|
|||
|
|
================================================================
|
|||
|
|
|
|||
|
|
非常感谢您对构建 Misskey 服务器的关注！
|
|||
|
|
这份指南描述了 Misskey 的安装与设置流程。
|
|||
|
|
|
|||
|
|
- [日本語版もあります - Japanese version also available](./setup.ja.md)
|
|||
|
|
- [英語版もあります - English version also available](./setup.en.md)
|
|||
|
|
|
|||
|
|
----------------------------------------------------------------
|
|||
|
|
|
|||
|
|
*1.* 创建 Misskey 用户
|
|||
|
|
----------------------------------------------------------------
|
|||
|
|
直接使用 root 用户来运行 misskey 也许并不是一个好主意，因此我们有必要创建一个专用的用户。
|
|||
|
|
以 Debian 为例：
|
|||
|
|
|
|||
|
|
``` bash
|
|||
|
|
adduser --disabled-password --disabled-login misskey
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
*2.* 安装依赖
|
|||
|
|
----------------------------------------------------------------
|
|||
|
|
请安装并设置如下这些软件：
|
|||
|
|
|
|||
|
|
#### Dependencies :package:
|
|||
|
|
* **[Node.js](https://nodejs.org/en/)** (12.x, 14.x)
|
|||
|
|
* **[PostgreSQL](https://www.postgresql.org/)** (>= 10)
|
|||
|
|
* **[Redis](https://redis.io/)**
|
|||
|
|
|
|||
|
|
##### Optional
|
|||
|
|
* [Yarn](https://yarnpkg.com/) *可选，但出于安全因素考虑还是推荐安装。如果您没有安装, 您需要使用 `npx yarn` 来代替 `yarn`.*
|
|||
|
|
* [Elasticsearch](https://www.elastic.co/) - 为了启用搜索功能，这个搜索引擎是有必要的。
|
|||
|
|
* [FFmpeg](https://www.ffmpeg.org/)
|
|||
|
|
|
|||
|
|
*3.* 安装 Misskey
|
|||
|
|
----------------------------------------------------------------
|
|||
|
|
1. 连接至 misskey 用户.
|
|||
|
|
|
|||
|
|
`su - misskey`
|
|||
|
|
|
|||
|
|
2. 克隆 Misskey 项目的 master 分支。
|
|||
|
|
|
|||
|
|
`git clone -b master git://github.com/syuilo/misskey.git`
|
|||
|
|
|
|||
|
|
3. 进入 misskey 文件夹。
|
|||
|
|
|
|||
|
|
`cd misskey`
|
|||
|
|
|
|||
|
|
4. 检查 [最新发布版](https://github.com/syuilo/misskey/releases/latest) 标签。
|
|||
|
|
|
|||
|
|
`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.* 初始化数据库
|
|||
|
|
----------------------------------------------------------------
|
|||
|
|
``` bash
|
|||
|
|
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` ）
|
|||
|
|
|
|||
|
|
----------------------------------------------------------------
|
|||
|
|
|
|||
|
|
如果您有任何疑问或是困惑，欢迎与我们联系！
|