cherrypick/docs/setup.ja.md
syuilo 0769566408 ✌️
2017-12-17 01:41:22 +09:00

3.2 KiB
Raw Blame History

Misskey構築の手引き

Misskeyサーバーの構築にご関心をお寄せいただきありがとうございます このガイドではMisskeyのインストール・セットアップ方法について解説します。

英語版もあります - English version also available


Dockerを利用してMisskeyを構築することもできます: Setup with Docker。 その場合、3番目以降の手順はスキップできます。

1. ドメインの用意

Misskeyはプライマリ ドメインとセカンダリ ドメインを必要とします。

  • プライマリ ドメインはMisskeyの主要な部分を提供するために使われます。
  • セカンダリ ドメインはXSSといった脆弱性の対策に使われます。

セカンダリ ドメインがプライマリ ドメインのサブドメインであってはなりません。

サブドメイン

Misskeyは以下のサブドメインを使います:

  • api.{primary domain}
  • auth.{primary domain}
  • docs.{primary domain}
  • ch.{primary domain}
  • stats.{primary domain}
  • status.{primary domain}
  • dev.{primary domain}
  • file.{secondary domain}

2. reCAPTCHAトークンの用意

MisskeyはreCAPTCHAトークンを必要とします。 https://www.google.com/recaptcha/intro/ にアクセスしてトークンを生成してください。

(オプション) VAPIDキーペアの生成

ServiceWorkerを有効にする場合、VAPIDキーペアを生成する必要があります:

npm install web-push -g
web-push generate-vapid-keys

3. 依存関係をインストールする

これらのソフトウェアをインストール・設定してください:

依存関係 📦

オプション
  • Elasticsearch - 検索機能を向上させるために用います。

4. Misskeyのインストール

  1. git clone -b master git://github.com/syuilo/misskey.git
  2. cd misskey
  3. npm install
  4. npm run build

アップデートするには:

  1. git pull origin master
  2. npm install
  3. npm run build

5. 以上です!

お疲れ様でした。これでMisskeyを動かす準備は整いました。

起動

sudo npm startするだけです。GLHF!

テスト

(ビルドされている状態で)npm test

デバッグ 🐛

デバッグメッセージを表示するようにする

Misskeyはdebugモジュールを利用しており、ネームスペースはmisskey:*となっています。