2023-07-08 10:36:02 +02:00
# 문제가 발생했다면
2023-07-10 17:44:03 +02:00
:::warning
2023-07-08 10:36:02 +02:00
이 문서는 아직 국문/영문으로 번역되지 않았으며, 일문으로 제공되고 있습니다.
번역이 완료되기 전까지는 본 문서를 기계 번역하여 읽어주시면 감사하겠습니다.
:::
< small > 2018年10月07日 / 2021年12月20日 最終更新 / 文責 aqz/tamaina< / small >
MisskeyInstallBattle参加者が増えましたが、それに伴い時期を追うごとに重軽傷者が増加しています。\
この記事ではそのような負傷者を減らすため、過去に事故が起きてしまった個所の傾向と対策をわかりやすく解説します。
**まず最初に、[構築の手引き](/docs/install/manual.html)を熟読してください。**
また、拙著の[Ubuntu向けsystemd版解説](https://hide.ac/articles/iFwm5HDvH)、[Oracle Cloud版詳細解説](https://hide.ac/articles/csERs-7SU)も参考までにお読みいただけると幸いです。
# Ubuntu向けシェルスクリプトのお知らせ
Ubuntu向け解説はコピペばかりでつまらない！ ！ ！
……あれ、コピペだけでできるなら、つまり完全自動化できるのでは？
というわけで、**シェルスクリプトでほぼ全部やってくれるやつを作ってみました！**
[**詳細と使用方法はこちらから！** https://github.com/joinmisskey/bash-install#readme ](https://github.com/joinmisskey/bash-install#readme )
ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。
シェルスクリプトに不具合があれば[製作者(aqz)](https://p1.a9z.dev/@aqz)にお知らせいただければと思います。
# インストールとビルド
[構築の手引き ](/docs/install/manual.html )をよく読みましょう。
## ImageMagick関連
***ImageMagickは不要です！
## ビルドが失敗する
Misskeyのビルドには、経験則上、最低でも2GBのメモリが必要となっています。\
サーバーをスケールアップする手もありますが、お使いのPCでビルドしてサーバーにデプロイするという手もあります。
## なんだかうまくいかない
- [構築の手引き ](/docs/install/manual.html )をよく読みましょう。
- node.jsのバージョンが古いかも？
* 新しめのバージョンにしましょう。
- インストールやビルドの際にErrorとかWARNとかが出てくることがありますが、問題ない場合もあります。とりあえず`npm start`して動作確認しちゃいましょう。
- node-gypがインストールされていないかも？
* `apt install build-essential` を試す。
* Windowsは[この記事](https://qiita.com/AkihiroTakamura/items/25ba516f8ec624e66ee7)も参考にしてみる。
- これでもだめそうだったら、最初から[構築の手引き](/docs/install/manual.html)の手順に従ってやり直してみてください。
## バージョンアップ後に不具合が発生した
- [構築の手引き ](/docs/install/manual.html )およびリリースノートをよく読みましょう。
- Misskeyのバージョンアップ時にはしっかり`pnpm install`や`pnpm run migrate`してください。それでも直らない場合、`pnpm run clean-all && pnpm install`を試し、`pnpm run build && pnpm run migrate && pnpm start`してみてください。
- これでもだめそうだったら、最初から[構築の手引き](/docs/install/manual.html)の手順に従ってやり直してみてください。
---
# 設定
[構築の手引き ](/docs/install/manual.html )をよく読みましょう。
`.config/default.yml` で設定を行います。
[`.config/example.yml` ](https://github.com/misskey-dev/misskey/blob/develop/.config/example.yml )をコピーし、コメントに従って記述します。
（
## URLとポート番号
URLとポート番号のしくみは、少し分かりにくいと思います。
### URL, ポートとTLS証明書の設定（ ）
リビジョン番号[85a0f69](https://github.com/misskey-dev/misskey/blob/85a0f696bcea779b02749dae596fff94a1df2467/.config/example.yml)時点での[.config/example.yml](https://github.com/misskey-dev/misskey/blob/develop/.config/example.yml)に、「Port and TLS settings」として説明図付きで順に書かれていますので、それに沿って設定をしていきましょう。
本文の解説を日本語訳しながらやっていきます。
#### URLの設定
```yml
# Final accessible URL seen by a user.
# 最終的にユーザーがアクセスするURL
url: https://example.tld/
```
**`url: `には、サーバーにブラウザでアクセスしたときアドレスバーに表示される**(したい)**URLを書きます。**
#### ポートと証明書の設定
```yml
# ┌───────────────────────┐
#───┘ Port and TLS settings └───────────────────────────────────
#### ポートと証明書の設定 ####################################
#
# Misskey supports two deployment options for public.
# Misskeyは2つのサーバー開設方法をサポートしています。
#
# Option 1: With Reverse Proxy
# 方法その1 リバースプロキシを挟む
#
# +----- https://example.tld/ ------------+
# +------+ |+-------------+ +----------------+|
# | User | ---> || Proxy (443) | ---> | Misskey (3000) ||
# +------+ |+-------------+ +----------------+|
# +---------------------------------------+
#
# You need to setup reverse proxy. (eg. Nginx)
# この方法では、リバースプロキシ（例: Nginx）
# You do not define 'https' section.
# 'https'セクション（後述）は設定せず、コメントアウトしたままにします。
# Option 2: Standalone
# 方法その2 スタンドアロン
# (リバースプロキシを挟まず、nodeのプロセスで直接ユーザーからのアクセスを受ける)
#
# +- https://example.tld/ -+
# +------+ | +---------------+ |
# | User | ---> | | Misskey (443) | |
# +------+ | +---------------+ |
# +------------------------+
#
# You need to run Misskey as root.
# この方法では、Misskeyをルート(の権限をもたせた状態)で実行する必要があります。
# You need to set Certificate in 'https' section.
# 'https'セクション(後述)で証明書の設定を行う必要があります。
```
##### 方法1 リバースプロキシを挟むとき
```yml
# To use option 1, uncomment below line.
# オプション1で設定する場合、以下の行をコメントアウトします
port: 3000 # A port that your Misskey server should listen.
```
以上の3行は、リバースプロキシを挟むときの話です。
この例では、Misskeyはポート3000で通信します。
リバースプロキシでは、ローカル側の宛先にこのポート番号を指定します。
##### 方法2 リバースプロキシを挟まないとき
```yml
# To use option 2, uncomment below lines.
# オプション2で設定する場合は、以下の6行をコメントアウトします
port: 443
https:
# path for certification
key: /etc/letsencrypt/live/example.tld/privkey.pem
cert: /etc/letsencrypt/live/example.tld/fullchain.pem
```
以上の8行は、リバースプロキシを挟まないときの話です。
ポート443(https)で直接ユーザーと通信します（ ）
TLS証明書を別途取得し、取得した証明書のディレクトリを`https:`で設定します。
ここ書かれているのは、Let's Encryptで`example.tld`に対する証明書を発行したときの例です。
---
### URL, ポートとTLS証明書の設定（ ）
example.ymlの解説文を省くと、default.ymlにおけるポートとTLS証明書の設定は以下のようになります。
#### 方法1 リバースプロキシを挟むとき
```yml
url: https://example.tld/
port: 3000
# https:
# # path for certification
# key: /etc/letsencrypt/live/example.tld/privkey.pem
# cert: /etc/letsencrypt/live/example.tld/fullchain.pem
```
#### 方法2 リバースプロキシを挟まず直接通信するとき
```yml
url: https://example.tld/
# port: 3000
https:
# path for certification
key: /etc/letsencrypt/live/example.tld/privkey.pem
cert: /etc/letsencrypt/live/example.tld/fullchain.pem
```
----
# `npm start`やアクセス時によく遭遇するエラー
`npm start` でサーバーを立てられたものの、その後不具合に遭遇してしまう場合もあります。
まず、[構築の手引き](/docs/install/manual.html)をよく読みましょう。
## YAMLのエラーが出る
`default.yml` の構文にミスがある可能性があります。
行頭に余分なスペースはありませんか？
## redisに接続できない
redis-serverは起動していますか？
何らかの接続数の上限に達していませんか？
11.20.2より前のバージョンのMisskeyはredisのパスワードを解くことができません。以下の2点を確認してください。
- redisにパスワードを設定しない。
- `default.yml` の`redis:`の`pass:`の行をコメントアウトする。
## 上部に「開発ビルドです」と書かれた赤いバーが表示される
サーバーを公開する場合は必ずproductionビルドを使いましょう。
製品ビルドにするには、環境変数が`NODE_ENV=production`になるように設定し`npm run build & & npm start`します。
## 新規登録できない
APIに接続できないようです。
`default.yml` の冒頭の`url:`が正しく設定されているか確認しましょう。
Node.jsのバージョンや、インストールの設定ももう一度よく確認しましょう。
また、正しく`default.yml`が書かれていますか？
## タイムラインの表示に問題が発生する、リアルタイムでTLが更新されない
タイムラインの読み込みに失敗する場合、mongoDBやPostgreSQLのバージョンが古い可能性があります。
PostgreSQLはなるべくv13にしてください。
redisの接続も確認した方がよいでしょう。 [→ redisに接続できない？ ](#redisに接続できない？ )
## 永遠に「再接続中」と右下に表示される、リアルタイムでTLが更新されない
プロキシを利用している場合、それがWebSocket通信を阻害している可能性が考えられます。
## オブジェクトストレージ使用時、不具合が出る
オブジェクトストレージの権限の設定が厳しくなっている可能性があります。「ファイル（オブジェクト）が誰でも取得可能」なように権限を設定してみてください。
また、`default.yml`をもう一度確認してみてください。
### S3 example (with CDN, custom domain)
S3 example (with CDN, custom domain)は、AWSのデフォルトのドメインではなく独自ドメインでストレージを公開したい場合の設定です。
endpointと公開ドメインが同じサービスの場合はS3 exampleのように`baseUrl`は明記しなくてよく、さらにregionの概念がないサービスの場合はregionの行は必要ありません。
### S3互換サービスでの設定
Misskeyではオブジェクトストレージの接続に[aws-sdk](https://www.npmjs.com/package/aws-sdk)を利用しています。
Amazon S3に互換性のあるオブジェクトストレージであれば利用できる可能性があります。
各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。
---
# まったく解決しなかった場合
以下の順序を試してみてください。
1. Misskeyのドキュメントをよく読む。
2. Googleで検索してみる。
3. [MisskeyリポジトリのIssues ](https://github.com/misskey-dev/misskey/issues )を検索してみる（ ）
4. [Misskey Forum ](https://forum.misskey.io/ )を検索してみる。
5. 検索してどうしても見つからなかったら、専門家に質問してみてください。
1. Forumや[MisskeyのDiscordサーバー](https://discord.gg/P4yYqYBjEp)もしくは[「鯖缶工場」](https://discord.gg/mJJGAHv)で聞いてみる
2. 開発者（[aqz]](https://p1.a9z.dev/@aqz)やしゅいろ）にリプライやダイレクト投稿を送信して聞いてみる
