Skip to main content

​
はじめに

  • 以下のチュートリアルに従えば、今日から Lavalink サーバーをホスティングできます。とても簡単です。サポートが必要な場合は、公式サポートチャンネルからお問い合わせください。
  • 次に、Square Cloud でアカウントを作成する必要があります。これはサインアップページから行えます。メールアドレスを使ってアカウントを作成できます。
  • 最後に、アカウントに有効なプランが必要です。利用可能なプランを比較し、ニーズに合ったものを選んでください。

​
バージョンの選択

公式リリースページから Lavalink.jar をダウンロードします。このガイドでは Lavalink v4 を使用します。最新の 4.x リリースを選び、ボットが v4 向けに作られた Lavalink クライアントを使っていることを確認してください。

​
application.yml の作成

Lavalink.jar と同じ場所に application.yml ファイルを作成します。以下の最小構成は環境変数 PORT のポート (Square Cloud では 80 に設定されます) で待ち受け、公式の youtube-source プラグインで YouTube を再生します。Lavalink に組み込まれた YouTube ソースは非推奨になっているためです。
application.yml
Lavalink は初回起動時にプラグインをダウンロードします。その他のオプション (他のソース、フィルター、バッファー) については、公式のサンプルファイルを参照してください。
address: 0.0.0.0 は変更せず、ポートを 80 以外の固定値に置き換えないでください。Square Cloud はサブドメインへのトラフィックをアプリケーションのポート 80 に届けます。

​
セキュリティの強化

password の値を、32 文字以上の強力でランダムなパスワードに置き換えてください。パスワードをファイルに残さないためには、代わりに環境変数 LAVALINK_SERVER_PASSWORD に設定します。Lavalink では環境変数が application.yml より優先されます。変数は、アップロードフォームの Advanced configuration、ダッシュボードのアプリケーションの Environment Variables ページ、または CLI で追加できます。
その他の管理方法については環境変数を参照してください。

​
Square Cloud 設定ファイルの作成

Lavalink.jar と同じ場所に squarecloud.app ファイルを作成します。SUBDOMAIN フィールドにより、サーバーが https://<subdomain>.squareweb.app で公開されます。
squarecloud.app
MAIN=Lavalink.jar により Square Cloud は java -jar Lavalink.jar でサーバーを起動します。MEMORY はサーバーの RAM (MB) で、AUTORESTART=true はクラッシュしたときにサーバーを再起動します (自動再起動の仕組みを参照)。

詳細はこちら: Square Cloud 用の設定ファイルの作成方法。

squarecloud.app ファイルはアプリケーションを設定するために使用される設定ファイルで、名前、説明、バージョン、メインファイルなどを定義するために使用されます。
Lavalink.jar、application.yml、squarecloud.app を同じフォルダーに置きます (ダッシュボードからアップロードする場合は、これらを .zip ファイルに圧縮してください)。その後、プロジェクトを Square Cloud にアップロードします。

​
ダッシュボード経由

1

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
2

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
3

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。
Square Cloud へのアプリケーションのアップロード
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか？よくある原因と修正方法はトラブルシューティングガイドを参照してください。

​
CLI 経由

この方法を使用するには、プロジェクトのルートに squarecloud.app という名前の設定ファイルが必要です。このファイルは、アプリケーションの実行方法を Square Cloud に伝えます。

設定ファイルガイド

アプリケーションの環境を定義する squarecloud.app 設定ファイルの作成方法を学びます。
1

CLI をインストール

Square Cloud CLI をインストールします。すでにお持ちの場合は、同じコマンドを実行すると更新されます:
2

ログイン

次のコマンドを実行します。ブラウザが開くので、そこでログインを承認すれば CLI の準備は完了です。API キーをコピーする必要はありません。スクリプトや CI については、CLI の認証を参照してください。
3

プロジェクトをアップロード

プロジェクトのフォルダで次のコマンドを実行します。CLI は squarecloud.ignore に記載されたものを除いて現在のフォルダを zip にし、アップロードします:
自分で作成した zip をアップロードするには、--file で指定します:
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか？よくある原因と修正方法はトラブルシューティングガイドを参照してください。

​
ボットの接続

Square Cloud の内部では Lavalink はポート 80 で待ち受けますが、ボットは公開エッジを経由して接続し、エッジはポート 443 で HTTPS を提供します。Lavalink クライアントでノードを次のように設定してください (フィールド名はライブラリによって異なります)。
ポート 80 や secure: false での接続は失敗します。接続がコード 1006 で閉じられる場合は、Lavalink connection closed with code 1006 を参照してください。

​
次のステップ

Discord ボット

Lavalink サーバーに接続するミュージックボットをホストします。

Discord ボットのエラー

無効なトークン、インテントの不足、Lavalink の接続エラーを修正します。

Java ランタイム

Square Cloud が Java アプリケーションを実行する仕組み。

​
お問い合わせ

技術的な問題が解決しない場合は、専門のサポートチームがお手伝いします。お問い合わせいただければ、どのような問題でも喜んで解決をサポートいたします。サポートの質の高さも、開発者が Google と Trustpilot で Square Cloud に402 件のレビューで 4.9/5という評価をつけている理由の 1 つです。