mirror of
https://iceshrimp.dev/Crimekillz/jointrashposs.git
synced 2024-11-24 09:49:06 +01:00
New Crowdin updates (#98)
* New translations thread-mute.md (Chinese Simplified) * New translations webhook.md (Chinese Simplified) * New translations 1.troubleshooting.md (Chinese Simplified) * New translations donate.md (Chinese Simplified) * New translations misskey-hub.md (Chinese Simplified) * New translations announcement.md (Chinese Simplified) * New translations role.md (Chinese Simplified) * New translations 1.index.md (Chinese Simplified) * New translations bash.md (Chinese Simplified) * New translations docker.md (Chinese Simplified) * New translations kubernetes.md (Chinese Simplified) * New translations manual.md (Chinese Simplified) * New translations ubuntu-manual.md (Chinese Simplified) * New translations cdn.md (Chinese Simplified) * New translations disable-timelines.md (Chinese Simplified) * New translations 1.index.md (Chinese Simplified) * New translations permission.md (Chinese Simplified) * New translations 1.index.md (Chinese Simplified) * New translations 2.miauth.md (Chinese Simplified) * New translations 5.releases.md (Chinese Simplified) * New translations 1.index.md (Chinese Simplified) * New translations 3.oauth.md (Chinese Simplified) * New translations ja-jp.yml (Chinese Traditional) * New translations 1.about-misskey.md (Chinese Traditional) * New translations 2.get-started.md (Chinese Traditional) * New translations 3.join-server.md (Chinese Traditional) * New translations 4.things-to-know.md (Chinese Traditional) * New translations ads.md (Chinese Traditional) * New translations drive.md (Chinese Traditional) * New translations mfm.md (Chinese Traditional) * New translations mute-and-block.md (Chinese Traditional) * New translations pages.md (Chinese Traditional) * New translations poll.md (Chinese Traditional) * New translations share-form.md (Chinese Traditional) * New translations thread-mute.md (Chinese Traditional) * New translations webhook.md (Chinese Traditional) * New translations 1.troubleshooting.md (Chinese Traditional) * New translations donate.md (Chinese Traditional) * New translations misskey-hub.md (Chinese Traditional) * New translations announcement.md (Chinese Traditional) * New translations role.md (Chinese Traditional) * New translations 1.index.md (Chinese Traditional) * New translations bash.md (Chinese Traditional) * New translations docker.md (Chinese Traditional) * New translations kubernetes.md (Chinese Traditional) * New translations manual.md (Chinese Traditional) * New translations ubuntu-manual.md (Chinese Traditional) * New translations cdn.md (Chinese Traditional) * New translations disable-timelines.md (Chinese Traditional) * New translations 1.index.md (Chinese Traditional) * New translations permission.md (Chinese Traditional) * New translations 1.index.md (Chinese Traditional) * New translations 2.miauth.md (Chinese Traditional) * New translations publish-on-your-website.md (Chinese Traditional) * New translations 5.releases.md (Chinese Traditional) * New translations 1.index.md (Chinese Traditional) * New translations 3.oauth.md (Chinese Traditional) * New translations 1.about-misskey.md (English) * New translations 2.get-started.md (English) * New translations 3.join-server.md (English) * New translations 4.things-to-know.md (English) * New translations ads.md (English) * New translations drive.md (English) * New translations mfm.md (English) * New translations mute-and-block.md (English) * New translations pages.md (English) * New translations poll.md (English) * New translations share-form.md (English) * New translations thread-mute.md (English) * New translations webhook.md (English) * New translations 1.troubleshooting.md (English) * New translations donate.md (English) * New translations misskey-hub.md (English) * New translations announcement.md (English) * New translations role.md (English) * New translations 1.index.md (English) * New translations bash.md (English) * New translations docker.md (English) * New translations kubernetes.md (English) * New translations manual.md (English) * New translations ubuntu-manual.md (English) * New translations cdn.md (English) * New translations disable-timelines.md (English) * New translations 1.index.md (English) * New translations permission.md (English) * New translations 1.index.md (English) * New translations 2.miauth.md (English) * New translations 5.releases.md (English) * New translations 1.index.md (English) * New translations 3.oauth.md (English) * New translations 1.about-misskey.md (Indonesian) * New translations 2.get-started.md (Indonesian) * New translations 3.join-server.md (Indonesian) * New translations 4.things-to-know.md (Indonesian) * New translations ads.md (Indonesian) * New translations drive.md (Indonesian) * New translations mfm.md (Indonesian) * New translations mute-and-block.md (Indonesian) * New translations pages.md (Indonesian) * New translations poll.md (Indonesian) * New translations share-form.md (Indonesian) * New translations thread-mute.md (Indonesian) * New translations webhook.md (Indonesian) * New translations 1.troubleshooting.md (Indonesian) * New translations donate.md (Indonesian) * New translations misskey-hub.md (Indonesian) * New translations announcement.md (Indonesian) * New translations role.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations bash.md (Indonesian) * New translations docker.md (Indonesian) * New translations kubernetes.md (Indonesian) * New translations manual.md (Indonesian) * New translations ubuntu-manual.md (Indonesian) * New translations cdn.md (Indonesian) * New translations disable-timelines.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations permission.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations 2.miauth.md (Indonesian) * New translations 5.releases.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations 3.oauth.md (Indonesian) * New translations 5.releases.md (Korean) * New translations ja-jp.yml (English) * New translations docker.md (English) * New translations ja-jp.yml (Indonesian) * New translations 5.releases.md (Korean) * New translations ja-jp.yml (Indonesian) * New translations 1.about-misskey.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations ads.md (Indonesian) * New translations antenna.md (Indonesian) * New translations charts.md (Indonesian) * New translations clip.md (Indonesian) * New translations custom-emoji.md (Indonesian) * New translations deck.md (Indonesian) * New translations drive.md (Indonesian) * New translations favorite.md (Indonesian) * New translations follow.md (Indonesian) * New translations hashtag.md (Indonesian) * New translations mention.md (Indonesian) * New translations mfm.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations announcement.md (Indonesian) * New translations bash.md (Indonesian) * New translations ja-jp.yml (Indonesian) * New translations mute-and-block.md (Indonesian) * New translations pages.md (Indonesian) * New translations apps.md (Indonesian) * New translations donate.md (Indonesian) * New translations bash.md (Indonesian) * New translations docker.md (Indonesian) * New translations manual.md (Indonesian) * New translations 1.about-misskey.md (Chinese Traditional) * New translations 1.about-misskey.md (Chinese Traditional) * New translations create-plugin.md (French) * New translations create-plugin.md (Italian) * New translations create-plugin.md (Polish) * New translations create-plugin.md (Chinese Simplified) * New translations create-plugin.md (Chinese Traditional) * New translations create-plugin.md (Indonesian) * New translations aiscript.md (French) * New translations aiscript.md (Italian) * New translations aiscript.md (Korean) * New translations aiscript.md (Polish) * New translations aiscript.md (Chinese Simplified) * New translations aiscript.md (Chinese Traditional) * New translations aiscript.md (English) * New translations aiscript.md (Indonesian) * New translations ja-jp.yml (Chinese Traditional) * New translations ja-jp.yml (Chinese Traditional) * New translations troubleshooting.md (French) * New translations libraries.md (French) * New translations troubleshooting.md (Italian) * New translations libraries.md (Italian) * New translations troubleshooting.md (Korean) * New translations libraries.md (Korean) * New translations troubleshooting.md (Polish) * New translations libraries.md (Polish) * New translations troubleshooting.md (Chinese Simplified) * New translations libraries.md (Chinese Simplified) * New translations troubleshooting.md (Chinese Traditional) * New translations libraries.md (Chinese Traditional) * New translations troubleshooting.md (English) * New translations libraries.md (English) * New translations troubleshooting.md (Indonesian) * New translations libraries.md (Indonesian) * New translations ja-jp.yml (Chinese Traditional) * New translations ja-jp.yml (French) * New translations 2.miauth.md (French) * New translations ja-jp.yml (Italian) * New translations 2.miauth.md (Italian) * New translations ja-jp.yml (Korean) * New translations ja-jp.yml (Polish) * New translations 2.miauth.md (Polish) * New translations ja-jp.yml (Chinese Simplified) * New translations 2.miauth.md (Chinese Simplified) * New translations 2.miauth.md (Chinese Traditional) * New translations ja-jp.yml (English) * New translations 2.miauth.md (English) * New translations ja-jp.yml (Indonesian) * New translations 2.miauth.md (Indonesian) * Revert "New translations 1.about-misskey.md (English)" This reverts commit2b9572c2cf. * Revert "New translations 2.get-started.md (English)" This reverts commit2fa05a5aee. * Revert "New translations 4.things-to-know.md (English)" This reverts commit698c5e980d. * Revert "New translations ads.md (English)" This reverts commitf0e1cd2965. * Revert "New translations mfm.md (English)" This reverts commit51dcc0fc10. * Revert "New translations webhook.md (English)" This reverts commitcfbebc5783. * Revert "New translations 1.index.md (English)" This reverts commit67d2bec45c. * Revert "New translations disable-timelines.md (English)" This reverts commit19ead90df6. * Revert "New translations webhook.md (French)" This reverts commit52e6a8429a. * Revert "New translations webhook.md (Chinese Traditional)" This reverts commit395f0fbc4a. * Revert "New translations webhook.md (Polish)" This reverts commitac4e2c534e. * Revert "New translations webhook.md (Korean)" This reverts commit14853e1eab. * Revert "New translations pages.md (Korean)" This reverts commitf88e73d1ce. * Revert "New translations bash.md (Korean)" This reverts commit60c9fae6a8. * Revert "New translations kubernetes.md (Korean)" This reverts commit2239e8fd23. * Revert "New translations ubuntu-manual.md (Korean)" This reverts commit3aab982625. * Revert "New translations 1.about-misskey.md (Chinese Traditional)" This reverts commit5ac92102db. * Revert "New translations 2.get-started.md (Chinese Traditional)" This reverts commitd090253e34. * Revert "New translations 3.join-server.md (Chinese Traditional)" This reverts commit634db4d49b. * Revert "New translations 4.things-to-know.md (Chinese Traditional)" This reverts commit383ee08013. * Revert "New translations ads.md (Chinese Traditional)" This reverts commit6ed3b6885f. * Revert "New translations drive.md (Chinese Traditional)" This reverts commit988cacb17e. * Revert "New translations mfm.md (Chinese Traditional)" This reverts commit6b53e36fc4. * Revert "New translations mute-and-block.md (Chinese Traditional)" This reverts commit44b1b3c723. * Revert "New translations pages.md (Chinese Traditional)" This reverts commit4e60747a55. * Revert "New translations poll.md (Chinese Traditional)" This reverts commit00385dc6a1. * Revert "New translations share-form.md (Chinese Traditional)" This reverts commit8858eaf2f7. * Revert "New translations thread-mute.md (Chinese Traditional)" This reverts commitd07bd70000. * Revert "New translations 1.troubleshooting.md (Chinese Traditional)" This reverts commit7405a91ff9. * fix * New translations aiscript.md (Korean) * New translations ja-jp.yml (Chinese Traditional) * New translations troubleshooting.md (Korean) * New translations ja-jp.yml (French) * New translations ja-jp.yml (Italian) * New translations ja-jp.yml (Korean) * New translations ja-jp.yml (Polish) * New translations ja-jp.yml (Chinese Simplified) * New translations ja-jp.yml (English) * New translations ja-jp.yml (Indonesian) * New translations 5.releases.md (Korean) * fix * fix * fix * fix
This commit is contained in:
かっこかり
GitHub
parent
574ab894b8
commit
811461f235
@ -6,7 +6,9 @@ description: 'Misskey Advent Calendar 2021 1日目の記事です。Misskey Hub
|
||||
# インサイド Misskey Hub
|
||||
|
||||
:::tip
|
||||
|
||||
この記事は、[Misskey Advent Calendar 2021](https://adventar.org/calendars/6273) 1日目の記事です。
|
||||
|
||||
:::
|
||||
|
||||
こんにちはsyuiloです。いつもMisskeyを利用してくださってありがとうございます。開発の励みになります！
|
||||
@ -29,7 +31,9 @@ Misskey Hubの実装について理解するためには、いくつかの前提
|
||||
|
||||
## 静的サイト is 何
|
||||
:::warning
|
||||
|
||||
**性的サイト**と誤変換しやすいので注意
|
||||
|
||||
:::
|
||||
|
||||
こういった記事がメインのWebサイトは、一般的にはWordpressなどのソフトウェアを使って管理することが多いですが、Misskey Hubはそうではありません。\
|
||||
@ -42,9 +46,11 @@ Misskey Hubは、Misskey Hub内のMisskey Hub説明ページにもあるよう
|
||||
静的なサイトは逆に、そういったリッチなことは行わず、**予め用意したコンテンツをどのユーザーに対しても同じように表示するだけのサイト**です。Misskey Hubは(サイト更新を除けば)誰がいつ見ても同じ内容なので、静的サイトです。
|
||||
|
||||
:::tip
|
||||
|
||||
技術的な話になりますが、静的と言っても、静的なのは「サーバーから」送られてくる内容だけであって、JavaScriptを使ってブラウザ上で動的にページの内容を変えることは可能です。
|
||||
例えばMisskey Hubでは、サイドバーに表示されるMisskeyや藍ちゃんの広告はページを訪れるたびにランダムで変わるようになっています。\
|
||||
さらに言うと、静的サイト内に別の動的サイトを埋め込んで表示することも可能です。これを利用して、将来的にはそのページに対するMisskeyのコメントタイムラインをページに表示する、といったことも実装されるかもしれません。
|
||||
|
||||
:::
|
||||
|
||||
### 静的サイトだと何が嬉しいのか
|
||||
@ -64,6 +70,7 @@ Misskey Hubは、Misskey Hub内のMisskey Hub説明ページにもあるよう
|
||||
動的サイトを運営する際に発生するそのような諸々の心配から解放されるというのは非常に大きなメリットです。つまり、金銭面においても精神面においても、**ゼロコスト**でMisskey Hubを運用できます。
|
||||
|
||||
:::g-details{summary="さらに技術的な話(危険)"}
|
||||
|
||||
ここまで言っておいてなんですが、先ほど言った
|
||||
|
||||
> もちろんMisskeyは動的サイトということになります。
|
||||
@ -80,6 +87,7 @@ MisskeyのWebサーバーは、その不変なJavaScriptを送り返すだけで
|
||||
実際、インスタンスサーバーがトラブルなどで落ちていても、クライアントにはアクセスすることができますし、テーマの設定などサーバーに依存しない操作は普通に行うことができます。
|
||||
|
||||
ちなみに、こういう構成のことをIT界では**サーバーレス**と呼んだりするっぽいです。知らんけど。
|
||||
|
||||
:::
|
||||
|
||||
## SSG is 何
|
||||
@ -122,7 +130,9 @@ Misskey Hubもプラグイン機能を使っていて、「関連するページ
|
||||
さらに、MFMを実際に書いて試せるプレイグラウンド機能や、APIリファレンスにおけるAPIコンソールなども今後実装予定です。
|
||||
|
||||
:::tip
|
||||
|
||||
「関連するページ」「最近更新されたページ」は我ながら便利機能だと思っているので、Misskey Hub以外のvuepressを採用したサイトでも使えるようにnpmで一般公開しようかとも考えています。
|
||||
|
||||
:::
|
||||
|
||||
### 多言語対応(i18n)
|
||||
@ -150,15 +160,21 @@ vuepress標準の機能で、右上にあるやつです。各ページの見出
|
||||
各ページはMarkdown(MFMみたいなもの(いや本来はMFMが「Markdownのようなもの」という立ち位置だけれども))というマークアップ言語で書かれています。Markdownを使うことで、簡単に見出し、リンク、画像、表といった要素を表現できるほか、
|
||||
|
||||
:::tip
|
||||
|
||||
こんな
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
感じの
|
||||
|
||||
:::
|
||||
|
||||
:::danger
|
||||
|
||||
メッセージ
|
||||
|
||||
:::
|
||||
|
||||
を表示したりできます。(厳密にはMarkdownの拡張構文)
|
||||
@ -187,7 +203,9 @@ Misskey Hub内のMisskey Hub説明ページにもあるように、Misskey Hub
|
||||
各インスタンス紹介は、インスタンス側で用意されたプロフィールレンダリングページをiframeというHTMLの機能で埋め込んで表示するようになっています。したがって、一度Misskey Hubにインスタンスを登録してしまえば、インスタンスの名前、説明、バナー画像といった情報を更新した場合でもリアルタイムでインスタンス一覧に反映されます。
|
||||
|
||||
:::tip
|
||||
|
||||
インスタンス一覧へ掲載するインスタンスを募集しています。お気軽にご連絡ください🤗
|
||||
|
||||
:::
|
||||
|
||||
## 管理
|
||||
@ -207,7 +225,9 @@ Misskey Hubにおいては、GitHub ActionsというGitHubの機能を利用し
|
||||
GitHub Pagesは前述した「静的サイトを提供してくれる機能」です。GitHubのインフラストラクチャ上で動くため、いちどデプロイしてしまえば、あとは何の心配もなくMisskey Hubが提供され続けます。
|
||||
|
||||
:::warning
|
||||
|
||||
「何の心配もなく」はちょっと言い過ぎたかもしれません。というのも、(強いていうと)ひとつだけ心配があって、それはドメインです。Misskey Hubはmisskey-hub.netというドメインで提供されていますが、これは私が用意したものです。そのため、もし万が一私がドメインの更新を忘れるとMisskey Hubに繋がらなくなりますが、そこは𝑇𝑟𝑢𝑠𝑡 𝑚𝑒
|
||||
|
||||
:::
|
||||
|
||||
通常のWebサイトであれば、サーバーにFTPでファイルをアップロードしたり、サーバーにSSHで繋いでファイルをダウンロードしてきたりといった作業が必要になりますが、GitHub Pagesではそのような手間すら要りません。
|
||||
@ -230,7 +250,9 @@ SSGはMisskey Hubのようなドキュメントサイトだけでなく、ブロ
|
||||
静的サイトはいいぞ。vuepressはいいぞ。Misskey Hubに幸あれ🙏
|
||||
|
||||
:::g-details{summary="Webで記事を公開する際に必ず記述しなければならないと法令で定められている言葉"}
|
||||
|
||||
> いかがでしたか？
|
||||
|
||||
:::
|
||||
|
||||
---
|
||||
@ -248,5 +270,7 @@ SSGはMisskey Hubのようなドキュメントサイトだけでなく、ブロ
|
||||
栄養があるし、加熱不要で調理も楽(ハサミで切って味噌に突っ込んでチンするだけで味噌汁できる)
|
||||
|
||||
:::danger
|
||||
|
||||
ただし加熱しないと風味が強すぎ、ちょっとしたワサビ食べてるみたいになるので多少訓練が必要
|
||||
|
||||
:::
|
||||
|
||||
@ -10,18 +10,22 @@ We offer campaigns you to recieve rewards for contributing to the development of
|
||||
<https://misskey.io/notes/9auj9aj1ww>
|
||||
|
||||
:::tip
|
||||
|
||||
条件や報奨金の額は、予告なく変更になる場合があります。
|
||||
Conditions and reward amounts are subject to change without notice.
|
||||
|
||||
これ以外にも貢献に応じて不定期に給付金を支給中
|
||||
In addition to those, benefits are being paid at irregular intervals based on contributions.
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
報奨金の原資はパトロンの皆様からの寄付で成り立っています。
|
||||
Rewards come from donations from patrons.
|
||||
|
||||
[**→ 寄付について / About Donations**](../docs/donate.html)
|
||||
|
||||
:::
|
||||
|
||||
## カバレッジ上げ / Increase Coverage
|
||||
|
||||
@ -6,7 +6,9 @@ date: 2023-12-01
|
||||
# Misskey 2023 recap
|
||||
|
||||
:::tip
|
||||
|
||||
これは[Misskey Advent Calendar 2023](https://adventar.org/calendars/8742)一日目の記事です。
|
||||
|
||||
:::
|
||||
|
||||
こんにちは、しゅいろです。2023年も残すところあと1ヶ月となりました。
|
||||
@ -329,7 +331,9 @@ https://xn--931a.moe/
|
||||
そして来年もMisskeyを発展させていきますので何卒よろしくお願いいたします！！
|
||||
|
||||
:::tip
|
||||
|
||||
Misskeyの今のコードネーム(v13~)は「nasubi」です。今年の初め、コードネームは今後野菜で統一していこうと思い、一番手は「一富士二鷹三茄子」とも言われ縁起の良い🍆を選びました。そして言葉通り縁起の良い年になりました。
|
||||
|
||||
:::
|
||||
|
||||
それでは(ちょっと早いですが)、Merry Christmas and Happy New Year!
|
||||
|
||||
@ -6,7 +6,9 @@ date: 2023-12-03
|
||||
# インサイド Misskey Hub Next
|
||||
|
||||
:::tip
|
||||
|
||||
この記事は、[Misskey Alt Advent Calendar 2023](https://adventar.org/calendars/8658) 3日目の記事です。
|
||||
|
||||
:::
|
||||
|
||||
|
||||
@ -22,7 +24,9 @@ date: 2023-12-03
|
||||
しかし、もともとのMisskey Hubの計画上、ドキュメント以外のページもかなり必要になるということで、ドキュメント生成に特化したフレームワークではなく、より拡張性が高く、汎用的な[Nuxt](https://nuxt.com/)をフレームワークとして採用しました。
|
||||
|
||||
:::warning
|
||||
|
||||
VuePressよりは、今はどちらかというと[VitePress](https://vitepress.dev/)のほうがメジャーな感じがします。
|
||||
|
||||
:::
|
||||
|
||||
:::g-details{summary="詳しい技術スタックはこちら"}
|
||||
@ -60,7 +64,9 @@ VuePressよりは、今はどちらかというと[VitePress](https://vitepress.
|
||||
そして、今回のMisskey Hub Nextでは、ドキュメントページとブログページに**ISR**を、それ以外のページに**SSG**を適用しています。略称多くてこんがらがりそう。
|
||||
|
||||
:::tip
|
||||
|
||||
プロジェクト名に`Next`と入っているのでReactフレームワークの[Next.js](https://nextjs.org/)のほうを思い浮かべたかもしれませんが、**罠です。** Nuxtで作ってあります。
|
||||
|
||||
:::
|
||||
|
||||
## ISRとは？
|
||||
@ -127,6 +133,7 @@ Misskeyをより多くの人に広めるために、ぜひご協力お願いし
|
||||
:::
|
||||
|
||||
:::g-details{summary="【マニアック】フォントのはなし"}
|
||||
|
||||
Misskey Hub Nextでは、フォントの改善も行いました。
|
||||
|
||||
現行のMisskey Hubで使われているフォント（Kosugi Maru）は、英字が歪で、英単語や英文になると読みにくくなっていました。また、日本語の漢字部分が中国語とバッティングして不自然に見えてしまうという問題もありました。
|
||||
@ -168,7 +175,9 @@ Misskeyの[サーバー一覧](/servers/)を、[Misskeyをはじめよう(joinmi
|
||||
これにより、基本的には**サーバーを追加するのに特別な作業や申請は必要なくなり、新しく見つかったサーバーは自動的に追加されるようになりました！**
|
||||
|
||||
:::tip
|
||||
|
||||
なので近日中にjoinmisskeyはMisskey Hubに統合されるかも…？
|
||||
|
||||
:::
|
||||
|
||||
### 【新機能】ツール集
|
||||
@ -185,7 +194,9 @@ Misskey関連のさまざまな便利ツールを提供するページ「[ツー
|
||||
をご利用いただけますが、今後も随時拡充していく予定です💪
|
||||
|
||||
:::tip
|
||||
|
||||
[MFMお試しコーナー](/tools/mfm-playground/)の再現精度は割と高いのでMFMアートづくりにもおすすめです
|
||||
|
||||
:::
|
||||
|
||||
### 【新機能】AiScriptに対応
|
||||
@ -205,12 +216,14 @@ for (let i, 100) {
|
||||
|
||||
|
||||
:::fukidashi{chara="doya_ai" charaName="藍"}
|
||||
|
||||
Misskey Hub Nextでは、わたし・藍も色々なところにいます！
|
||||
ほら、こんなところにも！
|
||||
|
||||
|
||||
|
||||
ほかにも色々なところに隠れているので、ぜひ探してみてくださいね♪
|
||||
|
||||
:::
|
||||
|
||||
さらに、<ruby>古<rt>いにしえ</rt></ruby>のミスキストや、現行Misskey Hubのヘビーユーザーしか知らないであろう、知る人ぞ知る機能・**藍モード**も移植しました！
|
||||
@ -231,7 +244,9 @@ Misskey Hub Nextでは、わたし・藍も色々なところにいます！
|
||||
こちらは、現在[株式会社MisskeyHQ (村上さん)](https://misskey.io/notes/9l0i92bvr1)と連携しながら、ドキュメントの拡充に取り組んでいます。もう少しお待ち下さい🙏
|
||||
|
||||
:::tip
|
||||
|
||||
ドキュメントの拡充にご協力いただける方は、[こちら](https://misskey.io/notes/9l0i92bvr1)をご覧のうえ、ぜひご参加ください！
|
||||
|
||||
:::
|
||||
|
||||
### シェアボタン中継機能
|
||||
|
||||
@ -5,7 +5,9 @@ date: 2023-12-19
|
||||
# Deep dive on the linkage between Misskey and Vue.js
|
||||
|
||||
:::tip
|
||||
|
||||
これは [Misskey Advent Calendar 2023](https://adventar.org/calendars/8742) 19 日目の記事です.
|
||||
|
||||
:::
|
||||
|
||||
こんにちは, コアチームメンバーの [acid-chicken](https://github.com/acid-chicken) です. Misskey の開発には nighthike v4 あたりから参加しており, 現在は本業の傍ら, 余暇にリファクタリングやコードレビューなどをやっていることが多いです.
|
||||
@ -13,7 +15,9 @@ date: 2023-12-19
|
||||
Misskey では [2018 年からフロントエンドの UI フレームワークに Vue.js を採用し](https://github.com/misskey-dev/misskey/pull/1116)ており, メジャーアップデートのマイグレーションなどを経て, 現在も継続して使用しています. 今回は, Misskey のフロントエンド構造について, Vue.js の機能との接点を中心に深掘りしていきます.
|
||||
|
||||
:::tip
|
||||
|
||||
大まかな解説は既に syuilo 連載[「Misskey & Webテクノロジー最前線」9月](/blog/2023-09-11-gihyo)などで触れられています. 一方で, 本記事では連載で触れないような, 細かい部分に焦点を絞った話題を扱うため, もしかすると読んでいてつまらない内容になっているかもしれません. 予めご了承ください.
|
||||
|
||||
:::
|
||||
|
||||
## Misskey のフロントエンド構造
|
||||
@ -112,9 +116,11 @@ Misskey と Vue.js に話を戻すと, SFC に
|
||||
Misskey が CSS モジュールを使うようになった後のある日, syuilo は言いました.
|
||||
|
||||
:::fukidashi{chara="syuilo" charaName="しゅいろ"}
|
||||
|
||||
えー、CSS Modulesってminifyしてくれにゃいんだ
|
||||
|
||||
|
||||
|
||||
:::
|
||||
|
||||
— https://misskey.io/notes/9fd9w06qah
|
||||
@ -199,7 +205,9 @@ HelloWorld.__cssModules = {
|
||||
このようなことになってしまうのは, バインドの参照を常に静的に置換できるとは限らないためです. 例えば, <code>$style.redColoredText</code> のような参照は静的に置換できても, <code>$style\[color + "ColoredText"\]</code> のような参照はビルド時に <code>color</code> の値が定まるとは保証できないので, 静的に置換できません. また, Vue.js の Composition API では, <code>useCssModule()</code> を呼び出すことで, バインド用のマップ全体を取得することを許容しています. このような経緯で, 成果物にマップがそのまま含まれているのです. 逆に, それらの機能を一切使わないのであれば, 完全にそれらは無駄になっているといえます. 完全に無駄なものは安全に除去できるはずです. そこで, Misskey では, <code>$style</code> 配下を識別子のメンバーアクセスによる参照のみを認めるルールで運用することを前提に, 静的置換を行う Rollup プラグインを開発および使用することで, 成果物からマップを除去するようにしました. これにより, バンドルサイズの 3% 程度の削減につながりました.
|
||||
|
||||
:::tip
|
||||
|
||||
詳細は [#10923](https://github.com/misskey-dev/misskey/issues/10923) を参照してください.
|
||||
|
||||
:::
|
||||
|
||||
## 今後の展望
|
||||
|
||||
@ -15,7 +15,9 @@ Misskeyはオープンソースの分散型マイクロブログプラットフ
|
||||
当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。
|
||||
|
||||
:::tip
|
||||
|
||||
Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。
|
||||
|
||||
:::
|
||||
|
||||
誰でも開発に参加することができ、現在でも活発に開発が続いています。
|
||||
@ -35,7 +37,9 @@ Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev
|
||||
再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。
|
||||
|
||||
:::tip
|
||||
|
||||
技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev)
|
||||
|
||||
:::
|
||||
|
||||
## 開発に参加する、プロジェクトを支援する
|
||||
@ -143,8 +147,11 @@ Misskeyは開発が進むにつれ使用する技術も大きく変わってき
|
||||
:::fukidashi{chara="doya_ai" charaName="藍"}
|
||||
|
||||
わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！
|
||||
|
||||
:::
|
||||
|
||||
:::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"}
|
||||
|
||||
Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ!
|
||||
|
||||
:::
|
||||
|
||||
@ -11,14 +11,17 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作
|
||||
[サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。
|
||||
|
||||
:::tip
|
||||
|
||||
どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。
|
||||
|
||||
:::g-details{summary='詳細'}
|
||||
|
||||
Misskeyには連合機能が備わっています。
|
||||
|
||||
連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。
|
||||
|
||||
Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。
|
||||
|
||||
:::
|
||||
|
||||
:::
|
||||
@ -31,5 +34,7 @@ Misskeyが搭載している連合機能はActivityPubというオープンな
|
||||
自分にあったテーマのサーバーを探すのもおすすめです。
|
||||
|
||||
:::tip
|
||||
|
||||
サーバーの一覧は[こちら](/servers/)からご覧いただけます。
|
||||
|
||||
:::
|
||||
|
||||
@ -3,9 +3,11 @@
|
||||
登録するサーバーが決まったら、さっそくアカウントを作成しましょう。
|
||||
|
||||
:::tip
|
||||
|
||||
ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。
|
||||
|
||||
ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。
|
||||
|
||||
:::
|
||||
|
||||
## 登録する
|
||||
|
||||
@ -7,7 +7,9 @@
|
||||
Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！
|
||||
|
||||
:::tip
|
||||
|
||||
詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。
|
||||
|
||||
:::
|
||||
|
||||
## タイムライン
|
||||
@ -15,7 +17,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一
|
||||
Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。
|
||||
|
||||
:::tip
|
||||
|
||||
詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。
|
||||
|
||||
:::
|
||||
|
||||
## その他
|
||||
|
||||
@ -4,7 +4,9 @@ Misskeyではサーバーによる広告をタイムラインなどに表示で
|
||||
広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。
|
||||
|
||||
:::tip
|
||||
|
||||
広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。
|
||||
|
||||
:::
|
||||
|
||||
## 広告の設定(管理者)
|
||||
|
||||
@ -3,7 +3,9 @@
|
||||
ドライブは、Misskey上でファイルを管理できる機能です。
|
||||
|
||||
:::tip
|
||||
|
||||
技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。
|
||||
|
||||
:::
|
||||
|
||||
Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。
|
||||
@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー
|
||||
ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。
|
||||
|
||||
:::warning
|
||||
|
||||
現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。
|
||||
|
||||
:::
|
||||
|
||||
## センシティブ (NSFW)
|
||||
|
||||
@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー
|
||||
MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。
|
||||
|
||||
:::tip
|
||||
|
||||
一部の構文はMarkdownやHTMLと互換性があります。
|
||||
|
||||
:::
|
||||
|
||||
## MFMが使用可能な場所の例
|
||||
@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
|
||||
|
||||
アットマーク + ユーザー名で、特定のユーザーを示すことができます。
|
||||
:::tip
|
||||
|
||||
メンションについての詳細は[こちら](./mention.md)を参照してください。
|
||||
|
||||
:::
|
||||
|
||||
```
|
||||
@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
|
||||
|
||||
ナンバーサイン + タグで、ハッシュタグを示すことができます。
|
||||
:::tip
|
||||
|
||||
ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。
|
||||
|
||||
:::
|
||||
|
||||
```
|
||||
@ -70,6 +76,7 @@ https://example.com
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。
|
||||
|
||||
```
|
||||
@ -83,8 +90,11 @@ https://example.com
|
||||
### カスタム絵文字
|
||||
|
||||
コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。
|
||||
|
||||
:::tip
|
||||
|
||||
カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。
|
||||
|
||||
:::
|
||||
|
||||
```
|
||||
|
||||
@ -5,11 +5,15 @@
|
||||
ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。
|
||||
|
||||
:::tip
|
||||
|
||||
ミュートとブロックは併用できます。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。
|
||||
|
||||
:::
|
||||
|
||||
Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。
|
||||
@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ
|
||||
Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。
|
||||
|
||||
:::tip
|
||||
|
||||
ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。
|
||||
|
||||
:::
|
||||
|
||||
## ブロック
|
||||
@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの
|
||||
Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。
|
||||
|
||||
:::warning
|
||||
|
||||
ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。
|
||||
|
||||
:::
|
||||
|
||||
@ -3,7 +3,9 @@
|
||||
Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。
|
||||
|
||||
:::warning
|
||||
|
||||
v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。
|
||||
|
||||
:::
|
||||
|
||||
## ページ設定
|
||||
|
||||
@ -13,7 +13,9 @@
|
||||
追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。
|
||||
|
||||
:::warning
|
||||
|
||||
いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。
|
||||
|
||||
:::
|
||||
|
||||
## 複数回答を可能にする
|
||||
@ -41,7 +43,9 @@
|
||||
未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。
|
||||
|
||||
:::tip
|
||||
|
||||
未投票アンケートには、結果を表示した状態でも投票できます。
|
||||
|
||||
:::
|
||||
|
||||
投票をすると、自分の投票した選択肢に✔がつきます。
|
||||
|
||||
@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
|
||||
## クエリパラメータ
|
||||
|
||||
:::tip
|
||||
|
||||
すべてのパラメータは**オプション**であり、必須ではありません。
|
||||
|
||||
:::
|
||||
|
||||
| 名前 | 説明 |
|
||||
@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
|
||||
| `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) |
|
||||
|
||||
:::warning
|
||||
|
||||
`visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。
|
||||
|
||||
:::
|
||||
|
||||
### 添付ファイル
|
||||
|
||||
@ -1,7 +1,9 @@
|
||||
# スレッドミュート
|
||||
|
||||
:::tip
|
||||
|
||||
バージョン 12.95.0 以降の機能です。
|
||||
|
||||
:::
|
||||
|
||||
スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。
|
||||
@ -11,5 +13,7 @@
|
||||
Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。
|
||||
|
||||
:::warning
|
||||
|
||||
スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。
|
||||
|
||||
:::
|
||||
|
||||
@ -1,11 +1,15 @@
|
||||
# Webhook
|
||||
|
||||
:::tip
|
||||
|
||||
バージョン 12.109.0 以降の機能です。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。
|
||||
|
||||
:::
|
||||
|
||||
MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。
|
||||
|
||||
@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
|
||||
# トラブルシューティング
|
||||
|
||||
:::tip
|
||||
|
||||
[よくある質問](./faq.md)も合わせてお役立てください。
|
||||
|
||||
:::
|
||||
|
||||
問題が発生したときは、まずこちらをご確認ください。
|
||||
@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
|
||||
クライアントの設定の「キャッシュをクリア」すると直ります。
|
||||
|
||||
:::warning
|
||||
|
||||
「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。
|
||||
|
||||
:::
|
||||
|
||||
## 通知やアンテナ等の点滅が消えない
|
||||
|
||||
@ -13,20 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は
|
||||
- [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share)
|
||||
|
||||
:::tip
|
||||
|
||||
高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。
|
||||
|
||||
:::
|
||||
|
||||
:::tip
|
||||
|
||||
額に応じて以下の返礼を用意しています。
|
||||
|
||||
- 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与
|
||||
- 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載
|
||||
- 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
**バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。**
|
||||
|
||||
(メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります)
|
||||
|
||||
:::
|
||||
|
||||
また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。
|
||||
|
||||
@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、
|
||||
Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub)
|
||||
|
||||
:::tip
|
||||
|
||||
Misskey HubはNuxtを使ってビルドされた静的サイトです。
|
||||
|
||||
:::
|
||||
|
||||
## Misskey Hubに貢献する
|
||||
|
||||
@ -5,12 +5,14 @@
|
||||
お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。
|
||||
|
||||
:::warning
|
||||
|
||||
アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。
|
||||
|
||||
- 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する
|
||||
- 「非通知」オプションを有効にしてお知らせを作成する
|
||||
- 終了したお知らせはアーカイブする
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
## 表示形式
|
||||
|
||||
|
||||
@ -21,11 +21,13 @@
|
||||
- **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール)
|
||||
|
||||
:::warning
|
||||
|
||||
コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。
|
||||
|
||||
- 手動でのアサイン/アサイン解除は行えません。
|
||||
- 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
## 権限
|
||||
|
||||
@ -53,6 +55,7 @@
|
||||
**優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。**
|
||||
|
||||
:::tip
|
||||
|
||||
例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、
|
||||
|
||||
- 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。
|
||||
@ -62,7 +65,8 @@
|
||||
|
||||
- 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。
|
||||
- ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
### ベースロールの値を使用
|
||||
|
||||
@ -85,11 +89,15 @@
|
||||
アサインする際にアサインされる期間を設定することが可能です。
|
||||
|
||||
:::tip
|
||||
|
||||
ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
コンディショナル ロールには手動でのアサインはできません。
|
||||
|
||||
:::
|
||||
|
||||
## ユーザーのポリシーの確認
|
||||
|
||||
@ -7,15 +7,19 @@ description: Misskeyサーバーの作成方法についての案内です。
|
||||
Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。
|
||||
|
||||
Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。
|
||||
|
||||
詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。
|
||||
|
||||
:::
|
||||
|
||||
## Xserver VPSでインストール
|
||||
|
||||
@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが
|
||||
3. Cloudflareアカウント（推奨）
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。
|
||||
|
||||
@ -7,13 +7,16 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法
|
||||
このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
:::tip{label='前提条件'}
|
||||
|
||||
- DockerおよびDocker Composeがインストールされていること。
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
## リポジトリの取得
|
||||
|
||||
@ -59,7 +62,9 @@ GLHF✨
|
||||
## Misskeyのアップデート方法
|
||||
|
||||
:::warning
|
||||
|
||||
アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
```sh
|
||||
|
||||
@ -3,7 +3,9 @@
|
||||
このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
## TrueCharts と TrueNAS Scale
|
||||
|
||||
@ -7,7 +7,9 @@ description: このガイドではMisskeyのインストール・セットアッ
|
||||
このガイドではMisskeyのインストール・セットアップ方法について解説します。
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！
|
||||
|
||||
:::
|
||||
|
||||
:::tip{label='前提条件'}
|
||||
@ -108,7 +110,9 @@ WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
:::warning
|
||||
|
||||
CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。
|
||||
|
||||
:::
|
||||
|
||||
systemdを再読み込みしmisskeyサービスを有効化
|
||||
@ -125,7 +129,9 @@ sudo systemctl start misskey
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
`systemctl status misskey`と入力すると、サービスの状態を調べることができます。
|
||||
|
||||
:::
|
||||
|
||||
::::
|
||||
@ -133,7 +139,9 @@ sudo systemctl start misskey
|
||||
## Misskeyのアップデート方法
|
||||
|
||||
:::warning
|
||||
|
||||
アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います:
|
||||
@ -156,8 +164,10 @@ sudo systemctl restart misskey
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください:
|
||||
|
||||
- `pnpm run clean`または`pnpm run clean-all`
|
||||
- `pnpm rebuild`
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
@ -11,11 +11,15 @@
|
||||
[**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/)
|
||||
|
||||
:::tip
|
||||
|
||||
シェルスクリプトでの開発環境へのインストールは想定されていません。
|
||||
|
||||
:::
|
||||
|
||||
:::tip
|
||||
|
||||
ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。
|
||||
|
||||
:::
|
||||
|
||||
不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。
|
||||
@ -27,7 +31,9 @@
|
||||
[docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
## はじめに
|
||||
@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン
|
||||
- ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明）
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！
|
||||
|
||||
:::
|
||||
|
||||
## nanoの使い方
|
||||
@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合はユーザーを分ける必要はありません
|
||||
|
||||
:::
|
||||
|
||||
## 基本的なソフトウェアのインストールと設定
|
||||
@ -177,7 +187,9 @@ activeならOK。
|
||||
nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合はnginxのセットアップは不要です
|
||||
|
||||
:::
|
||||
|
||||
nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。
|
||||
@ -238,7 +250,9 @@ sudo apt install -y git build-essential
|
||||
サーバーをインターネットに公開する準備をする。
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です
|
||||
|
||||
:::
|
||||
|
||||
### ファイヤーウォール
|
||||
@ -272,7 +286,9 @@ sudo systemctl enable ufw
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。
|
||||
|
||||
:::
|
||||
|
||||
### CloudFlare
|
||||
@ -376,7 +392,9 @@ nano .config/default.yml
|
||||
設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合、urlは`url: http://localhost:3000`と指定します。
|
||||
|
||||
:::
|
||||
|
||||
```yml
|
||||
@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。
|
||||
|
||||
:::
|
||||
|
||||
### サーバーでビルドできない場合
|
||||
@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一
|
||||
## Misskeyのデーモンを作成
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合、デーモンの作成は不要です。
|
||||
|
||||
:::
|
||||
|
||||
いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。
|
||||
|
||||
@ -17,5 +17,7 @@ CDNで以下の設定を行なってください。
|
||||
- `/api/*`以外のリクエストをすべてキャッシュする
|
||||
|
||||
:::tip
|
||||
|
||||
Misskeyをアップデートした際にキャッシュのクリアは不要です。
|
||||
|
||||
:::
|
||||
|
||||
@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利
|
||||
|
||||
各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。
|
||||
|
||||
### ローディングが終わらない
|
||||
|
||||
Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。
|
||||
|
||||
***
|
||||
|
||||
# まったく解決しなかった場合
|
||||
|
||||
@ -8,7 +8,9 @@ LTLやSTLは、そのサーバー全員の投稿が見れるため、新規の
|
||||
もしデメリットの方が上回っていると感じたら、それらのタイムラインを無効化することも検討してください。
|
||||
|
||||
:::warning
|
||||
|
||||
無効化を行うと、ユーザーが困惑し、短期的に見て利用者が減る可能性があります。そのため、無効化の際は影響を慎重に検討し、事前に説明してフォローを整える期間を一定程度設けることを推奨します。
|
||||
|
||||
:::
|
||||
|
||||
なお、管理者/モデレーターは、これらのタイムラインの無効化状態は適用されず、引き続き利用することが可能です。
|
||||
|
||||
67
content/cn/docs/4.for-developers/aiscript.md
Normal file
67
content/cn/docs/4.for-developers/aiscript.md
Normal file
@ -0,0 +1,67 @@
|
||||
# AiScript
|
||||
|
||||
AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。
|
||||
|
||||
- [プラグイン](./plugin/)
|
||||
- [ウィジェット](/docs/for-users/features/widgets/)
|
||||
- ボタン
|
||||
- AiScriptコンソール
|
||||
- AiScript App
|
||||
- Misskey Play
|
||||
- スクラッチパッド
|
||||
|
||||
:::tip
|
||||
|
||||
AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。
|
||||
|
||||
:::
|
||||
|
||||
## 使い方
|
||||
|
||||
AiScript標準の構文や組み込み関数などが使用できます。
|
||||
|
||||
:::tip
|
||||
|
||||
ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\
|
||||
Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。
|
||||
|
||||
:::
|
||||
|
||||
これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。
|
||||
|
||||
### Misskey AiScript API
|
||||
|
||||
接頭辞: `Mk:`\
|
||||
Misskey内の全てのAiScript環境で使用できる定関数群です。
|
||||
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。
|
||||
|
||||
### プラグインAPI
|
||||
|
||||
接頭辞: `Plugin:`\
|
||||
[プラグイン](./plugin/)でのみ使用できる定関数群です。
|
||||
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。
|
||||
|
||||
### UI API
|
||||
|
||||
接頭辞: `Ui:`\
|
||||
[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。
|
||||
ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。
|
||||
|
||||
### 標準入出力
|
||||
|
||||
AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。
|
||||
|
||||
#### readline(message)
|
||||
|
||||
`message`: `str`\
|
||||
返り値: `str`\
|
||||
Misskey内の全てのAiScript環境で使用できます。\
|
||||
文字列の入力を求めるポップアップを表示します。
|
||||
|
||||
#### print(message)
|
||||
|
||||
`message`: `any`\
|
||||
返り値: `null`\
|
||||
[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\
|
||||
コンソールに文字列を出力します。\
|
||||
`<:`構文も同様の働きをします。
|
||||
@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント
|
||||
ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。
|
||||
|
||||
:::tip
|
||||
Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\
|
||||
|
||||
Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\
|
||||
|
||||
:::
|
||||
|
||||
<MkIndex />
|
||||
|
||||
@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧
|
||||
## Python
|
||||
|
||||
- [Misskey.py](https://github.com/YuzuRyo61/Misskey.py)
|
||||
- [MiPA](https://github.com/yupix/MiPA)
|
||||
- [MiPAC](https://github.com/yupix/MiPAC)
|
||||
|
||||
## .Net
|
||||
|
||||
|
||||
@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧
|
||||
# 権限の一覧
|
||||
|
||||
:::tip
|
||||
|
||||
このページは[misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。
|
||||
|
||||
:::
|
||||
|
||||
<ApiPermissions></ApiPermissions>
|
||||
|
||||
@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々
|
||||
# ストリーミングAPI
|
||||
|
||||
:::tip
|
||||
|
||||
最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。
|
||||
|
||||
:::
|
||||
|
||||
ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。
|
||||
@ -26,7 +28,9 @@ wss://{host}/streaming?i={token}
|
||||
- `{token}`の部分は、ユーザーのアクセストークンに置き換えます。
|
||||
|
||||
:::tip
|
||||
|
||||
アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。
|
||||
|
||||
:::
|
||||
|
||||
ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。
|
||||
@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
|
||||
ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。
|
||||
|
||||
:::tip
|
||||
|
||||
ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。
|
||||
|
||||
:::
|
||||
|
||||
以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。
|
||||
@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
|
||||
- `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。
|
||||
|
||||
:::tip
|
||||
|
||||
IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。
|
||||
|
||||
:::
|
||||
|
||||
### チャンネルからのメッセージを受け取る
|
||||
|
||||
@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた**
|
||||
アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。
|
||||
|
||||
:::tip
|
||||
|
||||
ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。
|
||||
|
||||
:::
|
||||
|
||||
あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。
|
||||
@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた**
|
||||
Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。
|
||||
|
||||
:::danger
|
||||
|
||||
アクセストークンは他人に知られないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
### アプリケーション利用者にアクセストークンの発行をリクエストする
|
||||
@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行
|
||||
以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。
|
||||
|
||||
[アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app)
|
||||
|
||||
:::
|
||||
|
||||
#### Step 1
|
||||
@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行
|
||||
UUIDを生成する。以後これを**セッションID**と呼びます。
|
||||
|
||||
:::danger
|
||||
|
||||
このセッションIDは毎回生成し、使いまわさないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
#### Step 2
|
||||
@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check
|
||||
APIの詳細は、APIリファレンスを参照してください。
|
||||
|
||||
:::warning
|
||||
|
||||
MisskeyはRESTを採用していません。
|
||||
|
||||
:::
|
||||
|
||||
また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。
|
||||
|
||||
88
content/cn/docs/4.for-developers/api/token/1.index.md
Normal file
88
content/cn/docs/4.for-developers/api/token/1.index.md
Normal file
@ -0,0 +1,88 @@
|
||||
# アクセストークンの取得
|
||||
|
||||
APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。
|
||||
このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。
|
||||
|
||||
基本的に、APIはリクエストにはアクセストークンが必要となります。
|
||||
アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。
|
||||
|
||||
:::tip
|
||||
|
||||
ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。
|
||||
|
||||
:::
|
||||
|
||||
あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。
|
||||
|
||||
- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む
|
||||
- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む
|
||||
|
||||
## 自分自身のアクセストークンを手動発行する
|
||||
|
||||
Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。
|
||||
|
||||
:::danger
|
||||
|
||||
アクセストークンは他人に知られないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
## アプリケーション利用者にアクセストークンの発行をリクエストする
|
||||
|
||||
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。
|
||||
|
||||
:MkIndex
|
||||
|
||||
## APIの利用
|
||||
|
||||
アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。
|
||||
|
||||
:::tip
|
||||
|
||||
- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。
|
||||
- 要求ヘッダーに`Content-Type: application/json`を指定します。
|
||||
- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。
|
||||
- ベースURLは`https://{サーバーのドメイン}/api`です。
|
||||
|
||||
:::
|
||||
|
||||
### Authorization headerを使う方式
|
||||
|
||||
以下のようにヘッダーの`Authorization`フィールドを指定します。
|
||||
|
||||
```js
|
||||
fetch("https://misskey.io/api/notes/create", {
|
||||
method: 'POST',
|
||||
body: JSON.stringify({
|
||||
text: "Hello Misskey API World with My Application!"
|
||||
}),
|
||||
headers: {
|
||||
Authorization: `Bearer ${accessToken}`,
|
||||
'Content-Type': 'application/json',
|
||||
},
|
||||
credentials: 'omit',
|
||||
});
|
||||
```
|
||||
|
||||
### iを使う方式
|
||||
|
||||
アクセストークン付きのボディの例（metaの場合）:
|
||||
|
||||
```json
|
||||
{
|
||||
"i": "HogEFugA1341",
|
||||
"detail": false
|
||||
}
|
||||
```
|
||||
|
||||
<!--TODO:「APIリファレンス」をリンクに差し替え-->
|
||||
|
||||
APIの詳細は、APIリファレンスを参照してください。
|
||||
|
||||
:::warning
|
||||
|
||||
MisskeyはRESTを採用していません。
|
||||
|
||||
:::
|
||||
|
||||
また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。
|
||||
76
content/cn/docs/4.for-developers/api/token/2.miauth.md
Normal file
76
content/cn/docs/4.for-developers/api/token/2.miauth.md
Normal file
@ -0,0 +1,76 @@
|
||||
---
|
||||
description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。
|
||||
---
|
||||
|
||||
# MiAuth方式でのアクセストークン取得方式
|
||||
|
||||
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。
|
||||
|
||||
:::tip
|
||||
|
||||
以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。
|
||||
|
||||
- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md)
|
||||
- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md)
|
||||
|
||||
:::
|
||||
|
||||
## Step 1
|
||||
|
||||
UUIDを生成する。以後これを**セッションID**と呼びます。
|
||||
|
||||
:::danger
|
||||
|
||||
このセッションIDは毎回生成し、使いまわさないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
## Step 2
|
||||
|
||||
アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます:
|
||||
|
||||
```
|
||||
https://{host}/miauth/{session}
|
||||
```
|
||||
|
||||
ここで、
|
||||
|
||||
- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。
|
||||
- `{session}`の部分は、セッションIDに置き換えます。
|
||||
|
||||
また、URLにクエリパラメータとしていくつかのオプションを設定できます:
|
||||
|
||||
| 名前 | 説明 |
|
||||
| ------------ | ------------------------------------------------------------------------------ |
|
||||
| `name` | アプリケーション名。 |
|
||||
| `icon` | アプリケーションのアイコン画像URL。 |
|
||||
| `callback` | 認証が終わった後にリダイレクトするURL。<br>リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 |
|
||||
| `permission` | アプリケーションが要求する権限。<br>要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 |
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```
|
||||
https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
## Step 3
|
||||
|
||||
ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。
|
||||
|
||||
```
|
||||
https://{host}/api/miauth/{session}/check
|
||||
```
|
||||
|
||||
ここで、
|
||||
|
||||
- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。
|
||||
- `{session}`の部分は、セッションIDに置き換えます。
|
||||
|
||||
レスポンスに含まれるプロパティは以下の通りです:
|
||||
|
||||
| 名前 | 説明 |
|
||||
| ------- | -------------- |
|
||||
| `token` | ユーザーのアクセストークン。 |
|
||||
| `user` | ユーザーの情報。 |
|
||||
179
content/cn/docs/4.for-developers/api/token/3.oauth.md
Normal file
179
content/cn/docs/4.for-developers/api/token/3.oauth.md
Normal file
@ -0,0 +1,179 @@
|
||||
---
|
||||
description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。
|
||||
---
|
||||
|
||||
# OAuth方式でのアクセストークン取得方式
|
||||
|
||||
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。
|
||||
|
||||
:::tip
|
||||
|
||||
以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。
|
||||
|
||||
OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。
|
||||
|
||||
現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。
|
||||
|
||||
- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md)
|
||||
- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md)
|
||||
|
||||
:::
|
||||
|
||||
## Step 1
|
||||
|
||||
アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。
|
||||
|
||||
```html
|
||||
<!-- （必須項目）hrefのアドレスが認証コードの転送先になります。 -->
|
||||
<link rel='redirect_uri' href='/redirect'>
|
||||
|
||||
<!-- ユーザーに見せるアプリの名前になります。なかったらこのページのアドレスが名前になります。 -->
|
||||
<div class='h-app'>
|
||||
<a href="/" class="u-url p-name">My Misskey App</a>
|
||||
</div>
|
||||
```
|
||||
|
||||
あとで`redirect_uri`のアドレスに認証コードが転送されます。
|
||||
|
||||
## Step 2
|
||||
|
||||
PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。
|
||||
|
||||
- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。
|
||||
- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。
|
||||
- `state`文字列には特別な制限はありません。ランダムな文字列を使います。
|
||||
|
||||
:::danger
|
||||
|
||||
この文字列は毎回生成し、使いまわさないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
:::tip
|
||||
|
||||
[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。
|
||||
|
||||
:::
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```js
|
||||
import crypto from "node:crypto";
|
||||
|
||||
const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~";
|
||||
const codeVerifier = new Array(128)
|
||||
.fill(0)
|
||||
.map(() => chars[Math.floor(chars.length * Math.random())])
|
||||
.join("");
|
||||
console.log('code_verifier', codeVerifier);
|
||||
|
||||
const codeChallenge = crypto
|
||||
.createHash("sha256")
|
||||
.update(codeVerifier, "ascii")
|
||||
.digest("base64url");
|
||||
console.log('code_challenge', codeChallenge);
|
||||
|
||||
const state = crypto.randomUUID();
|
||||
console.log('state', state);
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
## Step 3
|
||||
|
||||
相手サーバーのOAuth情報を取得します。データはJSON形式になっています。
|
||||
|
||||
```
|
||||
https://{host}/.well-known/oauth-authorization-server
|
||||
```
|
||||
|
||||
`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。
|
||||
|
||||
ここでは`authorization_endpoint`と`token_endpoint`を使います。
|
||||
|
||||
:::tip
|
||||
|
||||
次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。
|
||||
|
||||
:::
|
||||
|
||||
## Step 4
|
||||
|
||||
アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます:
|
||||
|
||||
```
|
||||
{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state}
|
||||
```
|
||||
|
||||
ここで、
|
||||
|
||||
- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。
|
||||
- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。
|
||||
- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます
|
||||
- `code_challenge_method`の部分は常に`S256`にします。
|
||||
- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。
|
||||
- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。
|
||||
- `{state}`の部分は、前に生成した`state`文字列に置き換えます。
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```
|
||||
https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
## Step 5
|
||||
|
||||
ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。
|
||||
|
||||
| 名前 | 説明 |
|
||||
| ------- | ----------------------- |
|
||||
| `code` | ユーザーの認証コード。 |
|
||||
| `state` | 認証リクエストに使われた`state`文字列。 |
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```
|
||||
https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。
|
||||
|
||||
## Step 6
|
||||
|
||||
転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。
|
||||
|
||||
| 名前 | 説明 |
|
||||
| --------------- | ------------------------------ |
|
||||
| `grant_type` | 常に`authorization_code`にします。 |
|
||||
| `client_id` | 認証リクエストに使われた`client_id`文字列。 |
|
||||
| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 |
|
||||
| `scope` | 認証リクエストに使われた`scope`文字列。 |
|
||||
| `code` | 取得した認証コード。 |
|
||||
| `code_verifier` | 前に生成した`code_verifier`文字列。 |
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```js
|
||||
const res = await fetch(endpoint, {
|
||||
method: "POST",
|
||||
body: JSON.stringify({
|
||||
grant_type: "authorization_code",
|
||||
client_id: "https://example.com",
|
||||
redirect_uri: "https://example.com/redirect",
|
||||
scope: "write:notes",
|
||||
code: "...",
|
||||
code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA",
|
||||
}),
|
||||
headers: {
|
||||
"Content-Type": "application/json"
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。
|
||||
@ -74,4 +74,4 @@ Misskey Webはプラグインに対してAPIを公開していて、それらを
|
||||
|
||||
v2023.11.0以降では、あなたのウェブサイトからワンクリックでプラグインを直接インストールできるようになっています。
|
||||
|
||||
プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](./publish-on-your-website.md)をご覧ください。
|
||||
プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](../publish-on-your-website.md)をご覧ください。
|
||||
|
||||
@ -6,6 +6,49 @@ maxTocDepth: 2
|
||||
|
||||
Misskeyのリリースノートを掲載しています。
|
||||
|
||||
## 2023.12.2
|
||||
|
||||
リリース日: 2023/12/28
|
||||
|
||||
### General
|
||||
|
||||
- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正
|
||||
|
||||
### Client
|
||||
|
||||
- Enhance: 検索画面においてEnterキー押下で検索できるように
|
||||
|
||||
## 2023.12.1
|
||||
|
||||
リリース日: 2023/12/27
|
||||
|
||||
### Note
|
||||
|
||||
- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\
|
||||
権限不足になる場合には権限を再設定して再生成してください。
|
||||
|
||||
### General
|
||||
|
||||
- Enhance: ローカリゼーションの更新
|
||||
- Fix: 自分のdirect noteがuser list timelineに追加されない
|
||||
|
||||
### Client
|
||||
|
||||
- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す
|
||||
- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787
|
||||
- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正
|
||||
- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正
|
||||
|
||||
### Server
|
||||
|
||||
- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました
|
||||
- Enhance: `oauth/token`エンドポイントのCORS対応
|
||||
- Fix: 1702718871541-ffVisibility.jsのdownが壊れている
|
||||
- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正
|
||||
- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正
|
||||
- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正
|
||||
- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正
|
||||
|
||||
## 2023.12.0
|
||||
|
||||
リリース日: 2023/12/23
|
||||
@ -1957,7 +2000,9 @@ same as 12.112.0
|
||||
### NOTE
|
||||
|
||||
:::warning
|
||||
|
||||
このバージョンからNode v16.14.0以降が必要です
|
||||
|
||||
:::
|
||||
|
||||
### Changes
|
||||
@ -2069,12 +2114,16 @@ same as 12.112.0
|
||||
### Note
|
||||
|
||||
:::warning
|
||||
|
||||
ビルドする前に`npm run clean`を実行してください。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。
|
||||
マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。
|
||||
|
||||
:::
|
||||
|
||||
### Improvements
|
||||
@ -2142,9 +2191,11 @@ same as 12.112.0
|
||||
### NOTE
|
||||
|
||||
::: warning
|
||||
|
||||
アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。
|
||||
|
||||
12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。
|
||||
|
||||
:::
|
||||
|
||||
### Changes
|
||||
|
||||
@ -15,7 +15,9 @@ While Misskey started centered around Bulletin Boards as its main feature, the g
|
||||
Misskey was not always a decentralized service, but became decentralized through the adoption of ActivityPub in 2018. Since then, it has become a service that is acknowledged and used by many.
|
||||
|
||||
:::tip
|
||||
ℹ️ The name "Misskey" comes from a song called "Brain Diver" by a band that syuilo used to listen to at the time called May'n.
|
||||
|
||||
The name "Misskey" comes from a song called "Brain Diver" by a band that syuilo used to listen to at the time called May'n.
|
||||
|
||||
:::
|
||||
|
||||
With anyone being able to join its development, Misskey is still continually being actively developed.
|
||||
@ -35,7 +37,9 @@ For realizing the distributed nature of Misskey, this concept of open source is
|
||||
Using the same example as before, most profit-oriented services like Twitter, Facebook etc. are not open source.
|
||||
|
||||
:::tip
|
||||
|
||||
Technically speaking, Misskey's source code is managed via Git, and the repository is hosted on [GitHub](https://github.com/misskey-dev)
|
||||
|
||||
:::
|
||||
|
||||
## Joining development and supporting the project
|
||||
@ -143,8 +147,11 @@ As the Misskey Web client supports PWA, it is also possible to make it act as if
|
||||
:::fukidashi{chara="doya_ai" charaName="藍"}
|
||||
|
||||
For more information about me, please visit [this website](https://xn--931a.moe/)!
|
||||
|
||||
:::
|
||||
|
||||
:::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"}
|
||||
|
||||
It's Misskey's guardian deity, Ai.(They called Ai cute, yay!)
|
||||
|
||||
:::
|
||||
|
||||
@ -13,13 +13,13 @@ You can choose any server from the [server list](/servers/).
|
||||
:::tip
|
||||
どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。
|
||||
|
||||
:::g-details{summary='Details'}
|
||||
::::g-details{summary='Details'}
|
||||
|
||||
Misskey has federated functionality.
|
||||
|
||||
This federated functionality allows users on different servers to follow, react, and renote in the same way as users on the same server, even if they are on different servers.
|
||||
|
||||
The federated functionality that Misskey incorporates is based on an open common standard called ActivityPub and is compatible with other software such as Mastodon and Pleroma.
|
||||
:::
|
||||
::::
|
||||
|
||||
:::
|
||||
|
||||
@ -31,5 +31,7 @@ Some servers may have a specific theme, for example, "I like certain a thing or
|
||||
We recommend that you look for a server with a theme that suits you.
|
||||
|
||||
:::tip
|
||||
|
||||
A list of servers can be found [here](/servers/).
|
||||
|
||||
:::
|
||||
|
||||
@ -3,9 +3,11 @@
|
||||
Once you have decided which server to register with, it's time to create an account.
|
||||
|
||||
:::tip
|
||||
|
||||
ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。
|
||||
|
||||
However, the information you enter may vary depending on the server.Please contact your server administrator for more information.
|
||||
|
||||
:::
|
||||
|
||||
## Register
|
||||
|
||||
@ -7,7 +7,9 @@ Here is a summary of what you, the account creator, need to know for now.
|
||||
Posts on Misskey are called "notes.".There are many features compared to Twitter and other popular social networking sites, so be sure to check them out before making your first post.
|
||||
|
||||
:::tip
|
||||
|
||||
For more information, see "[Notes](/docs/for-users/features/note/)".
|
||||
|
||||
:::
|
||||
|
||||
## Timelines
|
||||
@ -15,7 +17,9 @@ For more information, see "[Notes](/docs/for-users/features/note/)".
|
||||
Misskey has multiple timelines.The names alone may be a little confusing, so it is important to know what each of them do.
|
||||
|
||||
:::tip
|
||||
|
||||
For more information, see "[Timeline](/docs/for-users/features/timeline/)".
|
||||
|
||||
:::
|
||||
|
||||
## Other
|
||||
|
||||
@ -4,7 +4,9 @@ Misskey has a feature that displays ads etc. on timelines.
|
||||
You can reduce the frequency of relevant ads by clicking the icon to the right of the ads.
|
||||
|
||||
:::tip
|
||||
|
||||
If the total number of ads is low, ads may reappear even though their frequency has been reduced.
|
||||
|
||||
:::
|
||||
|
||||
## Setting Up Ads (Administrators Only)
|
||||
|
||||
@ -3,7 +3,9 @@
|
||||
ドライブは、Misskey上でファイルを管理できる機能です。
|
||||
|
||||
:::tip
|
||||
|
||||
技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。
|
||||
|
||||
:::
|
||||
|
||||
Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。
|
||||
@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー
|
||||
ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。
|
||||
|
||||
:::warning
|
||||
|
||||
現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。
|
||||
|
||||
:::
|
||||
|
||||
## センシティブ (NSFW)
|
||||
|
||||
@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー
|
||||
MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。
|
||||
|
||||
:::tip
|
||||
|
||||
一部の構文はMarkdownやHTMLと互換性があります。
|
||||
|
||||
:::
|
||||
|
||||
## MFMが使用可能な場所の例
|
||||
@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
|
||||
|
||||
アットマーク + ユーザー名で、特定のユーザーを示すことができます。
|
||||
:::tip
|
||||
|
||||
メンションについての詳細は[こちら](./mention.md)を参照してください。
|
||||
|
||||
:::
|
||||
|
||||
```
|
||||
@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
|
||||
|
||||
ナンバーサイン + タグで、ハッシュタグを示すことができます。
|
||||
:::tip
|
||||
|
||||
ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。
|
||||
|
||||
:::
|
||||
|
||||
```
|
||||
@ -70,6 +76,7 @@ https://example.com
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。
|
||||
|
||||
```
|
||||
@ -84,7 +91,9 @@ https://example.com
|
||||
|
||||
コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。
|
||||
:::tip
|
||||
|
||||
カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。
|
||||
|
||||
:::
|
||||
|
||||
```
|
||||
|
||||
@ -5,11 +5,15 @@
|
||||
ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。
|
||||
|
||||
:::tip
|
||||
|
||||
ミュートとブロックは併用できます。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。
|
||||
|
||||
:::
|
||||
|
||||
Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。
|
||||
@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ
|
||||
Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。
|
||||
|
||||
:::tip
|
||||
|
||||
ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。
|
||||
|
||||
:::
|
||||
|
||||
## ブロック
|
||||
@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの
|
||||
Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。
|
||||
|
||||
:::warning
|
||||
|
||||
ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。
|
||||
|
||||
:::
|
||||
|
||||
@ -3,7 +3,9 @@
|
||||
Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。
|
||||
|
||||
:::warning
|
||||
|
||||
v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。
|
||||
|
||||
:::
|
||||
|
||||
## ページ設定
|
||||
|
||||
@ -13,7 +13,9 @@
|
||||
追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。
|
||||
|
||||
:::warning
|
||||
|
||||
いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。
|
||||
|
||||
:::
|
||||
|
||||
## 複数回答を可能にする
|
||||
@ -41,7 +43,9 @@
|
||||
未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。
|
||||
|
||||
:::tip
|
||||
|
||||
未投票アンケートには、結果を表示した状態でも投票できます。
|
||||
|
||||
:::
|
||||
|
||||
投票をすると、自分の投票した選択肢に✔がつきます。
|
||||
|
||||
@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
|
||||
## クエリパラメータ
|
||||
|
||||
:::tip
|
||||
|
||||
すべてのパラメータは**オプション**であり、必須ではありません。
|
||||
|
||||
:::
|
||||
|
||||
| 名前 | 説明 |
|
||||
@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
|
||||
| `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) |
|
||||
|
||||
:::warning
|
||||
|
||||
`visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。
|
||||
|
||||
:::
|
||||
|
||||
### 添付ファイル
|
||||
|
||||
@ -1,7 +1,9 @@
|
||||
# スレッドミュート
|
||||
|
||||
:::tip
|
||||
|
||||
バージョン 12.95.0 以降の機能です。
|
||||
|
||||
:::
|
||||
|
||||
スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。
|
||||
@ -11,5 +13,7 @@
|
||||
Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。
|
||||
|
||||
:::warning
|
||||
|
||||
スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。
|
||||
|
||||
:::
|
||||
|
||||
@ -1,11 +1,15 @@
|
||||
# Webhook
|
||||
|
||||
:::tip
|
||||
|
||||
バージョン 12.109.0 以降の機能です。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。
|
||||
|
||||
:::
|
||||
|
||||
MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。
|
||||
|
||||
@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
|
||||
# トラブルシューティング
|
||||
|
||||
:::tip
|
||||
|
||||
[よくある質問](./faq.md)も合わせてお役立てください。
|
||||
|
||||
:::
|
||||
|
||||
問題が発生したときは、まずこちらをご確認ください。
|
||||
@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
|
||||
クライアントの設定の「キャッシュをクリア」すると直ります。
|
||||
|
||||
:::warning
|
||||
|
||||
「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。
|
||||
|
||||
:::
|
||||
|
||||
## 通知やアンテナ等の点滅が消えない
|
||||
|
||||
@ -13,22 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は
|
||||
- [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share)
|
||||
|
||||
:::tip
|
||||
|
||||
高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。
|
||||
|
||||
:::
|
||||
|
||||
:::tip
|
||||
|
||||
額に応じて以下の返礼を用意しています。
|
||||
|
||||
- 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与
|
||||
- 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載
|
||||
- 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
:::warning
|
||||
|
||||
**バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。**
|
||||
|
||||
(メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります)
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。
|
||||
|
||||
@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、
|
||||
Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub)
|
||||
|
||||
:::tip
|
||||
|
||||
Misskey HubはNuxtを使ってビルドされた静的サイトです。
|
||||
|
||||
:::
|
||||
|
||||
## Misskey Hubに貢献する
|
||||
|
||||
@ -5,12 +5,14 @@ Announcements are one of the features available in Misskey.
|
||||
Using the announcement feature, you can post server-wide announcements to users, as well as send messages from the server to individual users.
|
||||
|
||||
:::warning
|
||||
|
||||
アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。
|
||||
|
||||
- Create an announcement with the "Existing Users Only" option enabled
|
||||
- Create an announcement with the "do not notify" option enabled
|
||||
- Archive closed announcements.
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
## Display format
|
||||
|
||||
|
||||
@ -21,11 +21,13 @@
|
||||
- **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール)
|
||||
|
||||
:::warning
|
||||
|
||||
コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。
|
||||
|
||||
- 手動でのアサイン/アサイン解除は行えません。
|
||||
- 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
## 権限
|
||||
|
||||
@ -53,6 +55,7 @@
|
||||
**優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。**
|
||||
|
||||
:::tip
|
||||
|
||||
例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、
|
||||
|
||||
- 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。
|
||||
@ -62,7 +65,8 @@
|
||||
|
||||
- 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。
|
||||
- ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
### ベースロールの値を使用
|
||||
|
||||
@ -85,13 +89,15 @@
|
||||
アサインする際にアサインされる期間を設定することが可能です。
|
||||
|
||||
:::tip
|
||||
:::tip
|
||||
|
||||
ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
コンディショナル ロールには手動でのアサインはできません。
|
||||
|
||||
:::
|
||||
|
||||
## ユーザーのポリシーの確認
|
||||
|
||||
@ -7,15 +7,19 @@ description: How to create a Misskey server.
|
||||
Thank you for your interest in creating a Misskey server.There are several ways to create a server, so please choose one below and read the corresponding guide.
|
||||
|
||||
:::danger
|
||||
|
||||
Do not recreate the database with the domain/hostname of the server once you have started using it!
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。
|
||||
|
||||
Do not minify the JavaScript again as it has already been minified, Cloudflare also does not interpret the latest JavaScript correctly and would end up destroying the code inside causing Misskey to not work properly.
|
||||
|
||||
See [misskey-dev/misskey#9791](https://github.com/misskey-dev/misskey/issues/9791) for more information.
|
||||
|
||||
:::
|
||||
|
||||
## Installation on Xserver VPS
|
||||
|
||||
@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが
|
||||
3. Cloudflareアカウント（推奨）
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。
|
||||
@ -28,7 +30,6 @@ Let's Encryptの認証を試行できる回数が少ないので、サーバー
|
||||
## Cloudflareの設定
|
||||
|
||||
Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\
|
||||
\
|
||||
ネームサーバーの適用には最大で3日程度かかる場合があります。
|
||||
|
||||
また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、
|
||||
@ -41,7 +42,6 @@ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してか
|
||||
### 1. SSH
|
||||
|
||||
サーバーにSSH接続します。\
|
||||
\
|
||||
（サーバーのデスクトップを開いている方はシェルを開きましょう。）
|
||||
|
||||
### 2. 環境を最新にする
|
||||
@ -113,13 +113,10 @@ iptablesを使うようにしてください。
|
||||
v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。
|
||||
|
||||
Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\
|
||||
\
|
||||
[docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0)
|
||||
|
||||
Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\
|
||||
\
|
||||
ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\
|
||||
\
|
||||
また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。
|
||||
|
||||
ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。
|
||||
@ -147,14 +144,12 @@ systemdは、Docker Hubにイメージを上げるまでもないものの、フ
|
||||
万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。
|
||||
|
||||
- RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\
|
||||
\
|
||||
host・port設定はそのままEnterを押します。
|
||||
ユーザー名やパスワードは、前回実行した際に指定したものを入力します。
|
||||
|
||||
## .envファイルについて
|
||||
|
||||
インストールスクリプトは、2つの.envファイルを作成します。\
|
||||
\
|
||||
アップデートの際に使用します。
|
||||
|
||||
### /root/.misskey.env
|
||||
@ -165,14 +160,12 @@ misskeyを実行するユーザーを覚えておくために必要です。
|
||||
|
||||
systemdの場合に生成されます。\
|
||||
\
|
||||
主にディレクトリを覚えておくのに使用します。
|
||||
実行されているコンテナとイメージの番号を保存しています。
|
||||
|
||||
### /home/(misskeyユーザー)/.misskey-docker.env
|
||||
|
||||
Dockerの場合に生成されます。\
|
||||
\
|
||||
実行されているコンテナとイメージの番号を保存しています。\
|
||||
\
|
||||
コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。
|
||||
|
||||
## 自分で管理する
|
||||
@ -184,7 +177,6 @@ Dockerの場合に生成されます。\
|
||||
### Misskeyディレクトリ
|
||||
|
||||
Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\
|
||||
\
|
||||
（ユーザー、ディレクトリの初期値はともにmisskeyです。）
|
||||
|
||||
Misskeyディレクトリへは、以下のように移動するとよいでしょう。
|
||||
@ -203,7 +195,6 @@ exit
|
||||
### systemd
|
||||
|
||||
systemdのプロセス名はexample.comです。\
|
||||
\
|
||||
たとえば再起動するには次のようにします。
|
||||
|
||||
```
|
||||
@ -259,7 +250,6 @@ requirepassとbindを`/etc/redis/misskey.conf`で設定しています。
|
||||
## Q. アップデート後に502でアクセスできない
|
||||
|
||||
Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\
|
||||
\
|
||||
マイグレーションが終わっているかどうか確認してみてください。
|
||||
|
||||
systemdの場合では、pnpm installに失敗している可能性があります。
|
||||
@ -275,5 +265,4 @@ journalctlでログを確認すると、たいていre2が云々という記述
|
||||
## Q. 同じサーバーにもう1つMisskeyを建てたい
|
||||
|
||||
スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\
|
||||
\
|
||||
幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。
|
||||
|
||||
@ -1,21 +1,24 @@
|
||||
---
|
||||
description: このガイドはDockerを使ったMisskeyセットアップ方法を説明します。
|
||||
description: This guide explains how to set up Misskey using Docker
|
||||
---
|
||||
|
||||
# Docker Composeを使ったMisskey構築
|
||||
# Building Misskey using Docker Compose
|
||||
|
||||
このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。
|
||||
This guide explains how to set up Misskey using Docker
|
||||
|
||||
:::danger
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
Do not recreate the database with the domain/hostname of the server once you have started using it!
|
||||
|
||||
:::
|
||||
|
||||
:::tip{label='前提条件'}
|
||||
|
||||
- DockerおよびDocker Composeがインストールされていること。
|
||||
:::
|
||||
- Make sure Docker and Docker Compose are installed on your system.
|
||||
|
||||
## リポジトリの取得
|
||||
:::
|
||||
|
||||
## Clone the Repository
|
||||
|
||||
```sh
|
||||
git clone -b master https://github.com/misskey-dev/misskey.git
|
||||
@ -23,9 +26,9 @@ cd misskey
|
||||
git checkout master
|
||||
```
|
||||
|
||||
## 設定
|
||||
## Configuration
|
||||
|
||||
下記コマンドで、各種設定ファイルのサンプルをコピーします。
|
||||
The following commands will copy the various config files from examples to their actual config location.
|
||||
|
||||
```sh
|
||||
cp .config/docker_example.yml .config/default.yml
|
||||
@ -33,23 +36,22 @@ cp .config/docker_example.env .config/docker.env
|
||||
cp ./docker-compose_example.yml ./docker-compose.yml
|
||||
```
|
||||
|
||||
`default.yml`と`docker.env`をファイル内の説明に従って編集してください。\
|
||||
\
|
||||
また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など)
|
||||
Please edit `default.yml` and `docker.env` file as per the description.\
|
||||
Also edit `docker-compose.yml` as needed.(If you want to change the port etc.)
|
||||
|
||||
## ビルドと初期化
|
||||
## Build & Initialize
|
||||
|
||||
次のコマンドでMisskeyのビルドとデータベースの初期化を行います。
|
||||
これにはしばらく時間がかかります。
|
||||
The next set of commands will build Misskey image and perform database initialization.
|
||||
This will take some time.
|
||||
|
||||
```shell
|
||||
sudo docker compose build
|
||||
sudo docker compose run --rm web pnpm run init
|
||||
```
|
||||
|
||||
## 起動
|
||||
## Startup
|
||||
|
||||
お疲れ様でした。以下のコマンドでMisskeyを起動できます。
|
||||
お疲れ様でした。You can launch Misskey with the following command.
|
||||
|
||||
```sh
|
||||
sudo docker compose up -d
|
||||
@ -57,12 +59,12 @@ sudo docker compose up -d
|
||||
|
||||
GLHF✨
|
||||
|
||||
## Misskeyのアップデート方法
|
||||
## Updating Misskey
|
||||
|
||||
:::warning
|
||||
:::warning
|
||||
アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。
|
||||
:::
|
||||
|
||||
Updates are always available in the [release notes](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md). Please make sure to check in advance for any changes that may be required.
|
||||
|
||||
:::
|
||||
|
||||
```sh
|
||||
@ -75,9 +77,9 @@ sudo docker compose build
|
||||
sudo docker compose stop && sudo docker compose up -d
|
||||
```
|
||||
|
||||
アップデート内容、およびデータベースの規模によっては時間がかかることがあります。
|
||||
It may take time depending on the update content and the size of the database.
|
||||
|
||||
## cliコマンドを実行する方法
|
||||
## How to execute CLI commands?
|
||||
|
||||
```sh
|
||||
sudo docker compose run --rm web node packages/backend/built/tools/foo bar
|
||||
|
||||
@ -3,14 +3,16 @@
|
||||
このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
## TrueCharts と TrueNAS Scale
|
||||
|
||||
MisskeyのHelmChartsはTrueNAS Scaleで使用するためのTrueChartsで公開されていますが、HelmChartsとしてインストールすることもできます。
|
||||
|
||||
[TrueCharts](https://truecharts.org/charts/description_list) のサイトには利用可能なすべてのChartsやインストール方法などのドキュメントがあります。
|
||||
現在、Misskeyは_incubator_ trainで進行中です。
|
||||
|
||||
また、不明な点があればTrueChartsの[Discord](https://discord.gg/Ax9ZgzKx9t)サーバーで質問をすることもできます。
|
||||
|
||||
|
||||
@ -7,7 +7,9 @@ description: このガイドではMisskeyのインストール・セットアッ
|
||||
このガイドではMisskeyのインストール・セットアップ方法について解説します。
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！
|
||||
|
||||
:::
|
||||
|
||||
:::tip{label='前提条件'}
|
||||
@ -108,7 +110,9 @@ WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
:::warning
|
||||
|
||||
CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。
|
||||
|
||||
:::
|
||||
|
||||
systemdを再読み込みしmisskeyサービスを有効化
|
||||
@ -125,7 +129,9 @@ sudo systemctl start misskey
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
`systemctl status misskey`と入力すると、サービスの状態を調べることができます。
|
||||
|
||||
:::
|
||||
|
||||
::::
|
||||
@ -133,7 +139,9 @@ sudo systemctl start misskey
|
||||
## Misskeyのアップデート方法
|
||||
|
||||
:::warning
|
||||
|
||||
アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います:
|
||||
@ -156,8 +164,10 @@ sudo systemctl restart misskey
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください:
|
||||
|
||||
- `pnpm run clean`または`pnpm run clean-all`
|
||||
- `pnpm rebuild`
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
@ -11,11 +11,15 @@
|
||||
[**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/)
|
||||
|
||||
:::tip
|
||||
|
||||
シェルスクリプトでの開発環境へのインストールは想定されていません。
|
||||
|
||||
:::
|
||||
|
||||
:::tip
|
||||
|
||||
ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。
|
||||
|
||||
:::
|
||||
|
||||
不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。
|
||||
@ -27,7 +31,9 @@
|
||||
[docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
## はじめに
|
||||
@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン
|
||||
- ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明）
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！
|
||||
|
||||
:::
|
||||
|
||||
## nanoの使い方
|
||||
@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合はユーザーを分ける必要はありません
|
||||
|
||||
:::
|
||||
|
||||
## 基本的なソフトウェアのインストールと設定
|
||||
@ -174,10 +184,12 @@ activeならOK。
|
||||
|
||||
### nginx
|
||||
|
||||
nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。
|
||||
http\://localhost にアクセスし、\*Welcome to nginx!\*と表示されればOK。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合はnginxのセットアップは不要です
|
||||
|
||||
:::
|
||||
|
||||
nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。
|
||||
@ -238,7 +250,9 @@ sudo apt install -y git build-essential
|
||||
サーバーをインターネットに公開する準備をする。
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です
|
||||
|
||||
:::
|
||||
|
||||
### ファイヤーウォール
|
||||
@ -272,7 +286,9 @@ sudo systemctl enable ufw
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。
|
||||
|
||||
:::
|
||||
|
||||
### CloudFlare
|
||||
@ -376,7 +392,9 @@ nano .config/default.yml
|
||||
設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合、urlは`url: http://localhost:3000`と指定します。
|
||||
|
||||
:::
|
||||
|
||||
```yml
|
||||
@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。
|
||||
|
||||
:::
|
||||
|
||||
### サーバーでビルドできない場合
|
||||
@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一
|
||||
## Misskeyのデーモンを作成
|
||||
|
||||
:::tip
|
||||
|
||||
開発環境の場合、デーモンの作成は不要です。
|
||||
|
||||
:::
|
||||
|
||||
いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。
|
||||
|
||||
@ -16,5 +16,7 @@ Please configure your CDN in the following way:
|
||||
- Cache all requests except `/api/*`
|
||||
|
||||
:::tip
|
||||
It is not necessary to clear the cache when updating Misskey.
|
||||
|
||||
Misskeyをアップデートした際にキャッシュのクリアは不要です。
|
||||
|
||||
:::
|
||||
|
||||
@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利
|
||||
|
||||
各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。
|
||||
|
||||
### ローディングが終わらない
|
||||
|
||||
Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。
|
||||
|
||||
***
|
||||
|
||||
# まったく解決しなかった場合
|
||||
|
||||
@ -8,7 +8,9 @@ As the weight of these advantages and disadvantages may vary from server to serv
|
||||
If you feel like the demerits outweigh the merits, please consider deactivating these respective timelines.
|
||||
|
||||
:::warning
|
||||
|
||||
Disabling timelines can lead to confusion and possibly to a short-time drop in users.Therefore, please carefully consider the effects of disabling a timeline, and explain the reasoning for doing so in advance, so that your users can prepare by e. g. following users they often talk with on the LTL/STL.
|
||||
|
||||
:::
|
||||
|
||||
Additionally, Administrators / Moderators will be able to continue viewing these timelines even after they have been disabled.
|
||||
|
||||
67
content/en/docs/4.for-developers/aiscript.md
Normal file
67
content/en/docs/4.for-developers/aiscript.md
Normal file
@ -0,0 +1,67 @@
|
||||
# AiScript
|
||||
|
||||
AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。
|
||||
|
||||
- [プラグイン](./plugin/)
|
||||
- [ウィジェット](/docs/for-users/features/widgets/)
|
||||
- ボタン
|
||||
- AiScriptコンソール
|
||||
- AiScript App
|
||||
- Misskey Play
|
||||
- スクラッチパッド
|
||||
|
||||
:::tip
|
||||
|
||||
AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。
|
||||
|
||||
:::
|
||||
|
||||
## 使い方
|
||||
|
||||
AiScript標準の構文や組み込み関数などが使用できます。
|
||||
|
||||
:::tip
|
||||
|
||||
ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\
|
||||
Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。
|
||||
|
||||
:::
|
||||
|
||||
これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。
|
||||
|
||||
### Misskey AiScript API
|
||||
|
||||
接頭辞: `Mk:`\
|
||||
Misskey内の全てのAiScript環境で使用できる定関数群です。
|
||||
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。
|
||||
|
||||
### プラグインAPI
|
||||
|
||||
接頭辞: `Plugin:`\
|
||||
[プラグイン](./plugin/)でのみ使用できる定関数群です。
|
||||
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。
|
||||
|
||||
### UI API
|
||||
|
||||
接頭辞: `Ui:`\
|
||||
[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。
|
||||
ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。
|
||||
|
||||
### 標準入出力
|
||||
|
||||
AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。
|
||||
|
||||
#### readline(message)
|
||||
|
||||
`message`: `str`\
|
||||
返り値: `str`\
|
||||
Misskey内の全てのAiScript環境で使用できます。\
|
||||
文字列の入力を求めるポップアップを表示します。
|
||||
|
||||
#### print(message)
|
||||
|
||||
`message`: `any`\
|
||||
返り値: `null`\
|
||||
[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\
|
||||
コンソールに文字列を出力します。\
|
||||
`<:`構文も同様の働きをします。
|
||||
@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント
|
||||
ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。
|
||||
|
||||
:::tip
|
||||
Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\
|
||||
|
||||
Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\
|
||||
|
||||
:::
|
||||
|
||||
<MkIndex />
|
||||
|
||||
@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧
|
||||
## Python
|
||||
|
||||
- [Misskey.py](https://github.com/YuzuRyo61/Misskey.py)
|
||||
- [MiPA](https://github.com/yupix/MiPA)
|
||||
- [MiPAC](https://github.com/yupix/MiPAC)
|
||||
|
||||
## .Net
|
||||
|
||||
|
||||
@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧
|
||||
# 権限の一覧
|
||||
|
||||
:::tip
|
||||
|
||||
このページは[misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。
|
||||
|
||||
:::
|
||||
|
||||
<ApiPermissions></ApiPermissions>
|
||||
|
||||
@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々
|
||||
# ストリーミングAPI
|
||||
|
||||
:::tip
|
||||
|
||||
最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。
|
||||
|
||||
:::
|
||||
|
||||
ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。
|
||||
@ -26,7 +28,9 @@ wss://{host}/streaming?i={token}
|
||||
- `{token}`の部分は、ユーザーのアクセストークンに置き換えます。
|
||||
|
||||
:::tip
|
||||
|
||||
アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。
|
||||
|
||||
:::
|
||||
|
||||
ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。
|
||||
@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
|
||||
ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。
|
||||
|
||||
:::tip
|
||||
|
||||
ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。
|
||||
|
||||
:::
|
||||
|
||||
以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。
|
||||
@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
|
||||
- `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。
|
||||
|
||||
:::tip
|
||||
|
||||
IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。
|
||||
|
||||
:::
|
||||
|
||||
### チャンネルからのメッセージを受け取る
|
||||
|
||||
@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた**
|
||||
アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。
|
||||
|
||||
:::tip
|
||||
|
||||
ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。
|
||||
|
||||
:::
|
||||
|
||||
あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。
|
||||
@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた**
|
||||
Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。
|
||||
|
||||
:::danger
|
||||
|
||||
アクセストークンは他人に知られないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
### アプリケーション利用者にアクセストークンの発行をリクエストする
|
||||
@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行
|
||||
以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。
|
||||
|
||||
[アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app)
|
||||
|
||||
:::
|
||||
|
||||
#### Step 1
|
||||
@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行
|
||||
UUIDを生成する。以後これを**セッションID**と呼びます。
|
||||
|
||||
:::danger
|
||||
|
||||
このセッションIDは毎回生成し、使いまわさないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
#### Step 2
|
||||
@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check
|
||||
APIの詳細は、APIリファレンスを参照してください。
|
||||
|
||||
:::warning
|
||||
|
||||
MisskeyはRESTを採用していません。
|
||||
|
||||
:::
|
||||
|
||||
また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。
|
||||
|
||||
88
content/en/docs/4.for-developers/api/token/1.index.md
Normal file
88
content/en/docs/4.for-developers/api/token/1.index.md
Normal file
@ -0,0 +1,88 @@
|
||||
# アクセストークンの取得
|
||||
|
||||
APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。
|
||||
このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。
|
||||
|
||||
基本的に、APIはリクエストにはアクセストークンが必要となります。
|
||||
アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。
|
||||
|
||||
:::tip
|
||||
|
||||
ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。
|
||||
|
||||
:::
|
||||
|
||||
あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。
|
||||
|
||||
- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む
|
||||
- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む
|
||||
|
||||
## 自分自身のアクセストークンを手動発行する
|
||||
|
||||
Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。
|
||||
|
||||
:::danger
|
||||
|
||||
アクセストークンは他人に知られないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
## アプリケーション利用者にアクセストークンの発行をリクエストする
|
||||
|
||||
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。
|
||||
|
||||
:MkIndex
|
||||
|
||||
## APIの利用
|
||||
|
||||
アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。
|
||||
|
||||
:::tip
|
||||
|
||||
- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。
|
||||
- 要求ヘッダーに`Content-Type: application/json`を指定します。
|
||||
- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。
|
||||
- ベースURLは`https://{サーバーのドメイン}/api`です。
|
||||
|
||||
:::
|
||||
|
||||
### Authorization headerを使う方式
|
||||
|
||||
以下のようにヘッダーの`Authorization`フィールドを指定します。
|
||||
|
||||
```js
|
||||
fetch("https://misskey.io/api/notes/create", {
|
||||
method: 'POST',
|
||||
body: JSON.stringify({
|
||||
text: "Hello Misskey API World with My Application!"
|
||||
}),
|
||||
headers: {
|
||||
Authorization: `Bearer ${accessToken}`,
|
||||
'Content-Type': 'application/json',
|
||||
},
|
||||
credentials: 'omit',
|
||||
});
|
||||
```
|
||||
|
||||
### iを使う方式
|
||||
|
||||
アクセストークン付きのボディの例（metaの場合）:
|
||||
|
||||
```json
|
||||
{
|
||||
"i": "HogEFugA1341",
|
||||
"detail": false
|
||||
}
|
||||
```
|
||||
|
||||
<!--TODO:「APIリファレンス」をリンクに差し替え-->
|
||||
|
||||
APIの詳細は、APIリファレンスを参照してください。
|
||||
|
||||
:::warning
|
||||
|
||||
MisskeyはRESTを採用していません。
|
||||
|
||||
:::
|
||||
|
||||
また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。
|
||||
76
content/en/docs/4.for-developers/api/token/2.miauth.md
Normal file
76
content/en/docs/4.for-developers/api/token/2.miauth.md
Normal file
@ -0,0 +1,76 @@
|
||||
---
|
||||
description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。
|
||||
---
|
||||
|
||||
# MiAuth方式でのアクセストークン取得方式
|
||||
|
||||
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。
|
||||
|
||||
:::tip
|
||||
|
||||
以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。
|
||||
|
||||
- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md)
|
||||
- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md)
|
||||
|
||||
:::
|
||||
|
||||
## Step 1
|
||||
|
||||
UUIDを生成する。以後これを**セッションID**と呼びます。
|
||||
|
||||
:::danger
|
||||
|
||||
このセッションIDは毎回生成し、使いまわさないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
## Step 2
|
||||
|
||||
アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます:
|
||||
|
||||
```
|
||||
https://{host}/miauth/{session}
|
||||
```
|
||||
|
||||
ここで、
|
||||
|
||||
- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。
|
||||
- `{session}`の部分は、セッションIDに置き換えます。
|
||||
|
||||
また、URLにクエリパラメータとしていくつかのオプションを設定できます:
|
||||
|
||||
| 名前 | 説明 |
|
||||
| ------------ | ------------------------------------------------------------------------------ |
|
||||
| `name` | アプリケーション名。 |
|
||||
| `icon` | アプリケーションのアイコン画像URL。 |
|
||||
| `callback` | 認証が終わった後にリダイレクトするURL。<br>リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 |
|
||||
| `permission` | アプリケーションが要求する権限。<br>要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 |
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```
|
||||
https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
## Step 3
|
||||
|
||||
ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。
|
||||
|
||||
```
|
||||
https://{host}/api/miauth/{session}/check
|
||||
```
|
||||
|
||||
ここで、
|
||||
|
||||
- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。
|
||||
- `{session}`の部分は、セッションIDに置き換えます。
|
||||
|
||||
レスポンスに含まれるプロパティは以下の通りです:
|
||||
|
||||
| 名前 | 説明 |
|
||||
| ------- | -------------- |
|
||||
| `token` | ユーザーのアクセストークン。 |
|
||||
| `user` | ユーザーの情報。 |
|
||||
179
content/en/docs/4.for-developers/api/token/3.oauth.md
Normal file
179
content/en/docs/4.for-developers/api/token/3.oauth.md
Normal file
@ -0,0 +1,179 @@
|
||||
---
|
||||
description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。
|
||||
---
|
||||
|
||||
# OAuth方式でのアクセストークン取得方式
|
||||
|
||||
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。
|
||||
|
||||
:::tip
|
||||
|
||||
以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。
|
||||
|
||||
OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。
|
||||
|
||||
現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。
|
||||
|
||||
- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md)
|
||||
- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md)
|
||||
|
||||
:::
|
||||
|
||||
## Step 1
|
||||
|
||||
アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。
|
||||
|
||||
```html
|
||||
<!-- （必須項目）hrefのアドレスが認証コードの転送先になります。 -->
|
||||
<link rel='redirect_uri' href='/redirect'>
|
||||
|
||||
<!-- ユーザーに見せるアプリの名前になります。なかったらこのページのアドレスが名前になります。 -->
|
||||
<div class='h-app'>
|
||||
<a href="/" class="u-url p-name">My Misskey App</a>
|
||||
</div>
|
||||
```
|
||||
|
||||
あとで`redirect_uri`のアドレスに認証コードが転送されます。
|
||||
|
||||
## Step 2
|
||||
|
||||
PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。
|
||||
|
||||
- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。
|
||||
- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。
|
||||
- `state`文字列には特別な制限はありません。ランダムな文字列を使います。
|
||||
|
||||
:::danger
|
||||
|
||||
この文字列は毎回生成し、使いまわさないようにしてください。
|
||||
|
||||
:::
|
||||
|
||||
:::tip
|
||||
|
||||
[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。
|
||||
|
||||
:::
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```js
|
||||
import crypto from "node:crypto";
|
||||
|
||||
const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~";
|
||||
const codeVerifier = new Array(128)
|
||||
.fill(0)
|
||||
.map(() => chars[Math.floor(chars.length * Math.random())])
|
||||
.join("");
|
||||
console.log('code_verifier', codeVerifier);
|
||||
|
||||
const codeChallenge = crypto
|
||||
.createHash("sha256")
|
||||
.update(codeVerifier, "ascii")
|
||||
.digest("base64url");
|
||||
console.log('code_challenge', codeChallenge);
|
||||
|
||||
const state = crypto.randomUUID();
|
||||
console.log('state', state);
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
## Step 3
|
||||
|
||||
相手サーバーのOAuth情報を取得します。データはJSON形式になっています。
|
||||
|
||||
```
|
||||
https://{host}/.well-known/oauth-authorization-server
|
||||
```
|
||||
|
||||
`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。
|
||||
|
||||
ここでは`authorization_endpoint`と`token_endpoint`を使います。
|
||||
|
||||
:::tip
|
||||
|
||||
次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。
|
||||
|
||||
:::
|
||||
|
||||
## Step 4
|
||||
|
||||
アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます:
|
||||
|
||||
```
|
||||
{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state}
|
||||
```
|
||||
|
||||
ここで、
|
||||
|
||||
- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。
|
||||
- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。
|
||||
- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます
|
||||
- `code_challenge_method`の部分は常に`S256`にします。
|
||||
- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。
|
||||
- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。
|
||||
- `{state}`の部分は、前に生成した`state`文字列に置き換えます。
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```
|
||||
https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
## Step 5
|
||||
|
||||
ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。
|
||||
|
||||
| 名前 | 説明 |
|
||||
| ------- | ----------------------- |
|
||||
| `code` | ユーザーの認証コード。 |
|
||||
| `state` | 認証リクエストに使われた`state`文字列。 |
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```
|
||||
https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。
|
||||
|
||||
## Step 6
|
||||
|
||||
転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。
|
||||
|
||||
| 名前 | 説明 |
|
||||
| --------------- | ------------------------------ |
|
||||
| `grant_type` | 常に`authorization_code`にします。 |
|
||||
| `client_id` | 認証リクエストに使われた`client_id`文字列。 |
|
||||
| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 |
|
||||
| `scope` | 認証リクエストに使われた`scope`文字列。 |
|
||||
| `code` | 取得した認証コード。 |
|
||||
| `code_verifier` | 前に生成した`code_verifier`文字列。 |
|
||||
|
||||
:::tip{label='例'}
|
||||
|
||||
```js
|
||||
const res = await fetch(endpoint, {
|
||||
method: "POST",
|
||||
body: JSON.stringify({
|
||||
grant_type: "authorization_code",
|
||||
client_id: "https://example.com",
|
||||
redirect_uri: "https://example.com/redirect",
|
||||
scope: "write:notes",
|
||||
code: "...",
|
||||
code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA",
|
||||
}),
|
||||
headers: {
|
||||
"Content-Type": "application/json"
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。
|
||||
@ -6,6 +6,49 @@ maxTocDepth: 2
|
||||
|
||||
Misskeyのリリースノートを掲載しています。
|
||||
|
||||
## 2023.12.2
|
||||
|
||||
リリース日: 2023/12/28
|
||||
|
||||
### General
|
||||
|
||||
- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正
|
||||
|
||||
### Client
|
||||
|
||||
- Enhance: 検索画面においてEnterキー押下で検索できるように
|
||||
|
||||
## 2023.12.1
|
||||
|
||||
リリース日: 2023/12/27
|
||||
|
||||
### Note
|
||||
|
||||
- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\
|
||||
権限不足になる場合には権限を再設定して再生成してください。
|
||||
|
||||
### General
|
||||
|
||||
- Enhance: ローカリゼーションの更新
|
||||
- Fix: 自分のdirect noteがuser list timelineに追加されない
|
||||
|
||||
### Client
|
||||
|
||||
- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す
|
||||
- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787
|
||||
- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正
|
||||
- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正
|
||||
|
||||
### Server
|
||||
|
||||
- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました
|
||||
- Enhance: `oauth/token`エンドポイントのCORS対応
|
||||
- Fix: 1702718871541-ffVisibility.jsのdownが壊れている
|
||||
- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正
|
||||
- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正
|
||||
- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正
|
||||
- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正
|
||||
|
||||
## 2023.12.0
|
||||
|
||||
リリース日: 2023/12/23
|
||||
@ -1957,7 +2000,9 @@ same as 12.112.0
|
||||
### NOTE
|
||||
|
||||
:::warning
|
||||
|
||||
このバージョンからNode v16.14.0以降が必要です
|
||||
|
||||
:::
|
||||
|
||||
### Changes
|
||||
@ -2069,12 +2114,16 @@ same as 12.112.0
|
||||
### Note
|
||||
|
||||
:::warning
|
||||
|
||||
ビルドする前に`npm run clean`を実行してください。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。
|
||||
マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。
|
||||
|
||||
:::
|
||||
|
||||
### Improvements
|
||||
@ -2145,6 +2194,7 @@ same as 12.112.0
|
||||
アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。
|
||||
|
||||
12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。
|
||||
|
||||
:::
|
||||
|
||||
### Changes
|
||||
|
||||
@ -15,7 +15,9 @@ Misskeyはオープンソースの分散型マイクロブログプラットフ
|
||||
当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。
|
||||
|
||||
:::tip
|
||||
|
||||
Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。
|
||||
|
||||
:::
|
||||
|
||||
誰でも開発に参加することができ、現在でも活発に開発が続いています。
|
||||
@ -35,7 +37,9 @@ Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev
|
||||
再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。
|
||||
|
||||
:::tip
|
||||
|
||||
技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev)
|
||||
|
||||
:::
|
||||
|
||||
## 開発に参加する、プロジェクトを支援する
|
||||
@ -143,8 +147,11 @@ Misskeyは開発が進むにつれ使用する技術も大きく変わってき
|
||||
:::fukidashi{chara="doya_ai" charaName="藍"}
|
||||
|
||||
わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！
|
||||
|
||||
:::
|
||||
|
||||
:::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"}
|
||||
|
||||
Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ!
|
||||
|
||||
:::
|
||||
|
||||
@ -11,14 +11,17 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作
|
||||
[サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。
|
||||
|
||||
:::tip
|
||||
|
||||
どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。
|
||||
|
||||
:::g-details{summary='詳細'}
|
||||
|
||||
Misskeyには連合機能が備わっています。
|
||||
|
||||
連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。
|
||||
|
||||
Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。
|
||||
|
||||
:::
|
||||
|
||||
:::
|
||||
@ -31,5 +34,7 @@ Misskeyが搭載している連合機能はActivityPubというオープンな
|
||||
自分にあったテーマのサーバーを探すのもおすすめです。
|
||||
|
||||
:::tip
|
||||
|
||||
サーバーの一覧は[こちら](/servers/)からご覧いただけます。
|
||||
|
||||
:::
|
||||
|
||||
@ -3,9 +3,11 @@
|
||||
登録するサーバーが決まったら、さっそくアカウントを作成しましょう。
|
||||
|
||||
:::tip
|
||||
|
||||
ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。
|
||||
|
||||
ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。
|
||||
|
||||
:::
|
||||
|
||||
## 登録する
|
||||
|
||||
@ -7,7 +7,9 @@
|
||||
Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！
|
||||
|
||||
:::tip
|
||||
|
||||
詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。
|
||||
|
||||
:::
|
||||
|
||||
## タイムライン
|
||||
@ -15,7 +17,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一
|
||||
Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。
|
||||
|
||||
:::tip
|
||||
|
||||
詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。
|
||||
|
||||
:::
|
||||
|
||||
## その他
|
||||
|
||||
@ -4,7 +4,9 @@ Misskeyではサーバーによる広告をタイムラインなどに表示で
|
||||
広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。
|
||||
|
||||
:::tip
|
||||
|
||||
広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。
|
||||
|
||||
:::
|
||||
|
||||
## 広告の設定(管理者)
|
||||
|
||||
@ -3,7 +3,9 @@
|
||||
ドライブは、Misskey上でファイルを管理できる機能です。
|
||||
|
||||
:::tip
|
||||
|
||||
技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。
|
||||
|
||||
:::
|
||||
|
||||
Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。
|
||||
@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー
|
||||
ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。
|
||||
|
||||
:::warning
|
||||
|
||||
現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。
|
||||
|
||||
:::
|
||||
|
||||
## センシティブ (NSFW)
|
||||
|
||||
@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー
|
||||
MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。
|
||||
|
||||
:::tip
|
||||
|
||||
一部の構文はMarkdownやHTMLと互換性があります。
|
||||
|
||||
:::
|
||||
|
||||
## MFMが使用可能な場所の例
|
||||
@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
|
||||
|
||||
アットマーク + ユーザー名で、特定のユーザーを示すことができます。
|
||||
:::tip
|
||||
|
||||
メンションについての詳細は[こちら](./mention.md)を参照してください。
|
||||
|
||||
:::
|
||||
|
||||
```
|
||||
@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
|
||||
|
||||
ナンバーサイン + タグで、ハッシュタグを示すことができます。
|
||||
:::tip
|
||||
|
||||
ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。
|
||||
|
||||
:::
|
||||
|
||||
```
|
||||
@ -70,6 +76,7 @@ https://example.com
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。
|
||||
|
||||
```
|
||||
@ -83,8 +90,11 @@ https://example.com
|
||||
### カスタム絵文字
|
||||
|
||||
コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。
|
||||
|
||||
:::tip
|
||||
|
||||
カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。
|
||||
|
||||
:::
|
||||
|
||||
```
|
||||
|
||||
@ -5,11 +5,15 @@
|
||||
ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。
|
||||
|
||||
:::tip
|
||||
|
||||
ミュートとブロックは併用できます。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。
|
||||
|
||||
:::
|
||||
|
||||
Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。
|
||||
@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ
|
||||
Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。
|
||||
|
||||
:::tip
|
||||
|
||||
ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。
|
||||
|
||||
:::
|
||||
|
||||
## ブロック
|
||||
@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの
|
||||
Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。
|
||||
|
||||
:::warning
|
||||
|
||||
ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。
|
||||
|
||||
:::
|
||||
|
||||
@ -3,7 +3,9 @@
|
||||
Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。
|
||||
|
||||
:::warning
|
||||
|
||||
v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。
|
||||
|
||||
:::
|
||||
|
||||
## ページ設定
|
||||
|
||||
@ -13,7 +13,9 @@
|
||||
追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。
|
||||
|
||||
:::warning
|
||||
|
||||
いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。
|
||||
|
||||
:::
|
||||
|
||||
## 複数回答を可能にする
|
||||
@ -41,7 +43,9 @@
|
||||
未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。
|
||||
|
||||
:::tip
|
||||
|
||||
未投票アンケートには、結果を表示した状態でも投票できます。
|
||||
|
||||
:::
|
||||
|
||||
投票をすると、自分の投票した選択肢に✔がつきます。
|
||||
|
||||
@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
|
||||
## クエリパラメータ
|
||||
|
||||
:::tip
|
||||
|
||||
すべてのパラメータは**オプション**であり、必須ではありません。
|
||||
|
||||
:::
|
||||
|
||||
| 名前 | 説明 |
|
||||
@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
|
||||
| `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) |
|
||||
|
||||
:::warning
|
||||
|
||||
`visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。
|
||||
|
||||
:::
|
||||
|
||||
### 添付ファイル
|
||||
|
||||
@ -1,7 +1,9 @@
|
||||
# スレッドミュート
|
||||
|
||||
:::tip
|
||||
|
||||
バージョン 12.95.0 以降の機能です。
|
||||
|
||||
:::
|
||||
|
||||
スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。
|
||||
@ -11,5 +13,7 @@
|
||||
Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。
|
||||
|
||||
:::warning
|
||||
|
||||
スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。
|
||||
|
||||
:::
|
||||
|
||||
@ -1,11 +1,15 @@
|
||||
# Webhook
|
||||
|
||||
:::tip
|
||||
|
||||
バージョン 12.109.0 以降の機能です。
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。
|
||||
|
||||
:::
|
||||
|
||||
MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。
|
||||
|
||||
@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
|
||||
# トラブルシューティング
|
||||
|
||||
:::tip
|
||||
|
||||
[よくある質問](./faq.md)も合わせてお役立てください。
|
||||
|
||||
:::
|
||||
|
||||
問題が発生したときは、まずこちらをご確認ください。
|
||||
@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
|
||||
クライアントの設定の「キャッシュをクリア」すると直ります。
|
||||
|
||||
:::warning
|
||||
|
||||
「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。
|
||||
|
||||
:::
|
||||
|
||||
## 通知やアンテナ等の点滅が消えない
|
||||
|
||||
@ -13,22 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は
|
||||
- [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share)
|
||||
|
||||
:::tip
|
||||
|
||||
高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。
|
||||
|
||||
:::
|
||||
|
||||
:::tip
|
||||
|
||||
額に応じて以下の返礼を用意しています。
|
||||
|
||||
- 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与
|
||||
- 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載
|
||||
- 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
:::warning
|
||||
|
||||
**バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。**
|
||||
|
||||
(メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります)
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。
|
||||
|
||||
@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、
|
||||
Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub)
|
||||
|
||||
:::tip
|
||||
|
||||
Misskey HubはNuxtを使ってビルドされた静的サイトです。
|
||||
|
||||
:::
|
||||
|
||||
## Misskey Hubに貢献する
|
||||
|
||||
@ -5,12 +5,14 @@
|
||||
お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。
|
||||
|
||||
:::warning
|
||||
|
||||
アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。
|
||||
|
||||
- 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する
|
||||
- 「非通知」オプションを有効にしてお知らせを作成する
|
||||
- 終了したお知らせはアーカイブする
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
## 表示形式
|
||||
|
||||
|
||||
@ -21,11 +21,13 @@
|
||||
- **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール)
|
||||
|
||||
:::warning
|
||||
|
||||
コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。
|
||||
|
||||
- 手動でのアサイン/アサイン解除は行えません。
|
||||
- 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
## 権限
|
||||
|
||||
@ -53,6 +55,7 @@
|
||||
**優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。**
|
||||
|
||||
:::tip
|
||||
|
||||
例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、
|
||||
|
||||
- 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。
|
||||
@ -62,7 +65,8 @@
|
||||
|
||||
- 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。
|
||||
- ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
### ベースロールの値を使用
|
||||
|
||||
@ -85,13 +89,15 @@
|
||||
アサインする際にアサインされる期間を設定することが可能です。
|
||||
|
||||
:::tip
|
||||
:::tip
|
||||
|
||||
ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。
|
||||
:::
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
コンディショナル ロールには手動でのアサインはできません。
|
||||
|
||||
:::
|
||||
|
||||
## ユーザーのポリシーの確認
|
||||
|
||||
@ -7,15 +7,19 @@ description: Misskeyサーバーの作成方法についての案内です。
|
||||
Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。
|
||||
|
||||
Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。
|
||||
|
||||
詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。
|
||||
|
||||
:::
|
||||
|
||||
## Xserver VPSでインストール
|
||||
|
||||
@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが
|
||||
3. Cloudflareアカウント（推奨）
|
||||
|
||||
:::danger
|
||||
|
||||
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
|
||||
|
||||
:::
|
||||
|
||||
Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。
|
||||
@ -28,7 +30,6 @@ Let's Encryptの認証を試行できる回数が少ないので、サーバー
|
||||
## Cloudflareの設定
|
||||
|
||||
Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\
|
||||
\
|
||||
ネームサーバーの適用には最大で3日程度かかる場合があります。
|
||||
|
||||
また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、
|
||||
@ -41,7 +42,6 @@ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してか
|
||||
### 1. SSH
|
||||
|
||||
サーバーにSSH接続します。\
|
||||
\
|
||||
（サーバーのデスクトップを開いている方はシェルを開きましょう。）
|
||||
|
||||
### 2. 環境を最新にする
|
||||
@ -113,13 +113,10 @@ iptablesを使うようにしてください。
|
||||
v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。
|
||||
|
||||
Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\
|
||||
\
|
||||
[docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0)
|
||||
|
||||
Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\
|
||||
\
|
||||
ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\
|
||||
\
|
||||
また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。
|
||||
|
||||
ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。
|
||||
@ -147,14 +144,12 @@ systemdは、Docker Hubにイメージを上げるまでもないものの、フ
|
||||
万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。
|
||||
|
||||
- RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\
|
||||
\
|
||||
host・port設定はそのままEnterを押します。
|
||||
ユーザー名やパスワードは、前回実行した際に指定したものを入力します。
|
||||
|
||||
## .envファイルについて
|
||||
|
||||
インストールスクリプトは、2つの.envファイルを作成します。\
|
||||
\
|
||||
アップデートの際に使用します。
|
||||
|
||||
### /root/.misskey.env
|
||||
@ -165,14 +160,12 @@ misskeyを実行するユーザーを覚えておくために必要です。
|
||||
|
||||
systemdの場合に生成されます。\
|
||||
\
|
||||
主にディレクトリを覚えておくのに使用します。
|
||||
実行されているコンテナとイメージの番号を保存しています。
|
||||
|
||||
### /home/(misskeyユーザー)/.misskey-docker.env
|
||||
|
||||
Dockerの場合に生成されます。\
|
||||
\
|
||||
実行されているコンテナとイメージの番号を保存しています。\
|
||||
\
|
||||
コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。
|
||||
|
||||
## 自分で管理する
|
||||
@ -184,7 +177,6 @@ Dockerの場合に生成されます。\
|
||||
### Misskeyディレクトリ
|
||||
|
||||
Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\
|
||||
\
|
||||
（ユーザー、ディレクトリの初期値はともにmisskeyです。）
|
||||
|
||||
Misskeyディレクトリへは、以下のように移動するとよいでしょう。
|
||||
@ -203,7 +195,6 @@ exit
|
||||
### systemd
|
||||
|
||||
systemdのプロセス名はexample.comです。\
|
||||
\
|
||||
たとえば再起動するには次のようにします。
|
||||
|
||||
```
|
||||
@ -259,7 +250,6 @@ requirepassとbindを`/etc/redis/misskey.conf`で設定しています。
|
||||
## Q. アップデート後に502でアクセスできない
|
||||
|
||||
Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\
|
||||
\
|
||||
マイグレーションが終わっているかどうか確認してみてください。
|
||||
|
||||
systemdの場合では、pnpm installに失敗している可能性があります。
|
||||
@ -275,5 +265,4 @@ journalctlでログを確認すると、たいていre2が云々という記述
|
||||
## Q. 同じサーバーにもう1つMisskeyを建てたい
|
||||
|
||||
スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\
|
||||
\
|
||||
幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user