146 lines
4.6 KiB
Markdown
146 lines
4.6 KiB
Markdown
Misskey構築の手引き
|
||
================================================================
|
||
|
||
Misskeyサーバーの構築にご関心をお寄せいただきありがとうございます！
|
||
このガイドではMisskeyのインストール・セットアップ方法について解説します。
|
||
|
||
- [英語版もあります - English version also available](./setup.en.md)
|
||
- [简体中文版同样可用 - Simplified Chinese version also available](./setup.zh.md)
|
||
|
||
----------------------------------------------------------------
|
||
|
||
*1.* Misskeyユーザーの作成
|
||
----------------------------------------------------------------
|
||
Misskeyはrootユーザーで実行しない方がよいため、代わりにユーザーを作成します。
|
||
Debianの例:
|
||
|
||
```
|
||
adduser --disabled-password --disabled-login misskey
|
||
```
|
||
|
||
*2.* 依存関係をインストールする
|
||
----------------------------------------------------------------
|
||
これらのソフトウェアをインストール・設定してください:
|
||
|
||
#### 依存関係 :package:
|
||
* **[Node.js](https://nodejs.org/en/)** (12.x, 14.x)
|
||
* **[PostgreSQL](https://www.postgresql.org/)** (10以上)
|
||
* **[Redis](https://redis.io/)**
|
||
|
||
##### オプション
|
||
* [Yarn](https://yarnpkg.com/)
|
||
* セキュリティの観点から推奨されます。 yarn をインストールしない方針の場合は、文章中の `yarn` を適宜 `npx yarn` と読み替えてください。
|
||
* [Elasticsearch](https://www.elastic.co/)
|
||
* 検索機能を有効にするためにはインストールが必要です。
|
||
* [FFmpeg](https://www.ffmpeg.org/)
|
||
|
||
*3.* Misskeyのインストール
|
||
----------------------------------------------------------------
|
||
1. misskeyユーザーを使用
|
||
|
||
`su - misskey`
|
||
|
||
2. masterブランチからMisskeyレポジトリをクローン
|
||
|
||
`git clone --recursive -b master git://github.com/misskey-dev/misskey.git`
|
||
|
||
3. misskeyディレクトリに移動
|
||
|
||
`cd misskey`
|
||
|
||
4. [最新のリリース](https://github.com/misskey-dev/misskey/releases/latest)を確認
|
||
|
||
`git checkout master`
|
||
|
||
5. Misskeyの依存パッケージをインストール
|
||
|
||
`yarn install`
|
||
|
||
*4.* 設定ファイルを作成する
|
||
----------------------------------------------------------------
|
||
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`パッケージをインストールする必要があります。
|
||
|
||
何らかのモジュールでエラーが発生する場合はnode-gypを使ってください:
|
||
1. `npx node-gyp configure`
|
||
2. `npx node-gyp build`
|
||
3. `NODE_ENV=production yarn build`
|
||
|
||
*6.* データベースを初期化
|
||
----------------------------------------------------------------
|
||
``` shell
|
||
yarn run init
|
||
```
|
||
|
||
*7.* 以上です！
|
||
----------------------------------------------------------------
|
||
お疲れ様でした。これでMisskeyを動かす準備は整いました。
|
||
|
||
### 通常起動
|
||
`NODE_ENV=production yarn start`するだけです。GLHF!
|
||
|
||
### 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
|
||
```
|
||
|
||
CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。
|
||
|
||
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`
|
||
|
||
なにか問題が発生した場合は、`yarn clean`または`yarn cleanall`すると直る場合があります。
|
||
|
||
----------------------------------------------------------------
|
||
|
||
なにかお困りのことがありましたらお気軽にご連絡ください。
|