メインコンテンツへスキップ
見出し画像

11 自宅サーバーの状態を1画面で見たい!Homepageダッシュボードを作るまで(Portainer・Netdata・Glances)

    前回(#10)は、Googleフォトの写真をNextcloudに引っ越しました。今回は、サーバーで動いているものを1つの画面にまとめて見られる「ダッシュボード」を作った話です。

    前回の記事はこちら

    ここまでで、自宅サーバーには、マイクラ(Pterodactyl)、Nextcloud、NASなど、いろいろなものが入りました。それぞれ別のアドレスで開くので、どれが動いていて、サーバーがどのくらい重いのかが、ぱっと分かりません。

    そこで、全部を1つの画面に並べて、状態を見られるようにしました。

    用語メモ|ダッシュボード
    いろいろな情報を1つの画面にまとめて表示するページ。車のメーターパネルのように、見ただけで今の状態が分かるようにしたものです。

    先に書いておくと、ダッシュボード作りはずっとGemini(AI)と相談して進めていましたが、なかなかうまくいかず、途中からClaude(別のAI)にも相談して完成させました。

    この記事の前半(無料)では、何を入れて、どこでつまずいたかを書きます。後半(有料)では、今の設定ファイルを全部と、それぞれのカードの作り方を書きます。

    この記事で分かること

    • サーバーの状態を見るための道具(Portainer、Netdata、Glances、Homepage)

    • Homepageで出たエラーと、その原因

    • AIの答えやネットの記事を、そのまま写しても動かなかった話

    • (有料)Homepageの設定ファイル(docker-compose.yml、services.yaml など)の全部

    • (有料)Nextcloud、Portainer、Netdata、マイクラのカードの作り方

    1. まず、PortainerとNetdataを入れる

    ダッシュボードの前に、AIのおすすめで2つの道具を入れました。どちらもDockerで入れています。

    用語メモ|Portainer(ポーテイナー)
    Dockerのコンテナを、ブラウザから見たり、止めたり動かしたりできる管理画面。

    用語メモ|Netdata(ネットデータ)
    サーバーのCPU、メモリ、ディスク、ネットワークなどの使われ方を、リアルタイムのグラフで見られる道具。

    いろいろ入れるとサーバーが重くならないか、とAIに聞くと、こういう見るだけの道具はとても軽い、という答えでした。実際、今のダッシュボードで見ても、PortainerのCPUはほぼ0%です。

    つまずいた点:Portainerの「セットアップトークン」

    Portainerを入れて開くと、「Setup token」を入れる欄がありました。AIは最初「docker-compose.ymlで入れた場合はトークンは不要です」と答えましたが、実際には必要でした。トークンは、Portainerのログの中に出ています(有料部分でコマンドを書きます)。

    Netdataは、開くと「Netdata Cloud」というネットのサービスにつなぐ画面が出ました。つながなくてもグラフは見られますが、スマホのアプリで見てみたかったので、自分はつないでいます。

    2. ダッシュボードは「Homepage」にした

    ダッシュボードの道具は、AIから「Homepage」と「Heimdall」の2つをすすめられました。

    • Homepage:設定はファイルに書く。各アプリとつないで、中の数字(CPU、空き容量など)までカードに出せる

    • Heimdall:ブラウザで、ボタンを押して登録していける。ほぼリンク集

    難しさよりも、数字まで出せるほうがいいと思って、Homepageにしました。

    用語メモ|Homepage
    自宅サーバー向けのダッシュボード。設定ファイルに書いたアプリをカードにして並べ、アプリによっては中の数字まで表示できます。

    つまずいた点1:開くといきなり「Host validation failed」

    Homepageを入れて開くと、いきなりエラーでした。

    画像

    Homepageは、決めたアドレス以外で開かれるのを断る仕組みを持っています。#9のNextcloudの trusted_domains と同じような仕組みです。HOMEPAGE_ALLOWED_HOSTS という設定に、開くときのアドレスを書く必要がありました。

    AIは、この設定を「全部許可(*)」にする方法を何度もすすめてきて、自分も一度はそれで開きました。今は全部許可ではなく、開くときのアドレスを「IP:ポート」の形で書いています。

    外出先からTailscaleの名前で開いたときも、同じエラーが出ました。そのアドレスも足しています。

    つまずいた点2:「API Error」が直らず、全部消して入れ直す

    次は、Dockerのコンテナを並べるカードで「API Error」が出ました。

    画像

    AIに聞くと、設定ファイルの書き方を変える案が次々に出てきて、そのたびに「これで最後」「今度こそ」と言われました。でも、何度やっても同じエラーのままでした。

    最後は、Homepageを全部消して、入れ直すことにしました。

    つまずいた点3:ネットの記事どおりに書いても、カードが出ない

    入れ直すときは、ネットで見つけたHomepageの解説記事を見ながら進めました。ところが、記事どおりに書いても、カードが1枚も出ません。

    原因は2つありました。

    1つ目は、記事の設定ファイルの置き場所です。記事には /home/ubuntu/homepage/config と書かれていました。これは記事を書いた人のユーザー名(ubuntu)の場所です。自分のユーザー名に直さないと、自分の書いた設定ファイルをHomepageが読みません。

    2つ目は、設定ファイルの書き方そのものです。AIと記事が出していた書き方(title: や items: を使う形)は、Homepageの公式の説明にある書き方と違っていました(推論。公式の説明と比べての判断です)。

    ここで、Geminiだけでは進まなかったので、Claudeにも相談しました。Claudeからは、Homepageの設定ファイルの正しい形(グループの中にサービスを並べる形)と、つまずきやすいところを教えてもらい、それをもとに書き直して、やっとカードが出ました。

    AIが2つとも違うことを言うときは、公式の説明(Homepageなら gethomepage.dev)を開いて確かめるのが早かった、というのが自分の感想です。

    つまずいた点4:Nextcloudのカードが「名前が見つからない」

    Nextcloudのカードは、「EAI_AGAIN」というエラーでした。Homepageのコンテナから、「nextcloud-app」というNextcloudのコンテナの名前が見つからない、という意味です。

    用語メモ|Dockerのネットワーク
    Dockerのコンテナどうしがやりとりするための、コンテナだけのネットワーク。同じネットワークにいるコンテナどうしは、コンテナの名前で相手を呼べます。

    HomepageとNextcloudは、それぞれ別の docker-compose.yml で入れているので、別々のネットワークにいました。HomepageをNextcloudのネットワークにも参加させて、名前で呼べるようにしました。

    #9で書いた、Nextcloudの trusted_domains にある「nextcloud-app」という行は、このときのためのものです。Homepageがコンテナの名前でNextcloudを開くので、Nextcloudにもその名前を受け付けてもらう必要がありました。

    つまずいた点5:Portainerのカードが404

    Portainerのカードは、「404 page not found」でした。AIは「URLの最後に /api を付ける」という案を出しましたが、原因は違いました。Portainerの中の「どの環境か」を表す番号(env)を、設定に書いていなかったのです。

    つまずいた点6:Glancesのメーターが出ない

    最後に、ネットで見つけたおしゃれなダッシュボードをまねして、CPUやメモリのメーターを並べることにしました。このメーターには「Glances」という道具を使います。

    用語メモ|Glances(グランシズ)
    サーバーのCPU、メモリ、ディスク、温度などを調べて表示する道具。Homepageのメーターに数字を渡す役目をします。

    ところが、メーターの枠だけが出て、中身が出ません。AIの案で書き直すと、今度は「Missing Widget Type」と出ました。

    画像

    今の設定ファイルと、そのときの設定を比べると、違うのは2か所です。

    • widgets:(最後に s が付く)を、widget:(s なし)にした

    • GlancesのURLを、サーバーのIPから、コンテナの名前(glances)にした

    このどちらかで直ったのだと思います(推論)。どの順番で直したのかは、覚えていません。

    今の状態

    今のダッシュボードです。

    画像
    • 一番上:日付、サーバー全体のCPU・メモリ・ディスク・通信量、動き続けている時間

    • Monitor:Glancesのメーター(CPU、メモリ、ネットワーク、SSD、HDD、CPUの温度、動いているプロセス、コンテナ)

    • Docker:Nextcloud、Portainer、Netdata、マイクラ(Pterodactyl)、マイクラのオンライン人数のカード

    Dawarichのカードもありますが、これは次回(#12)の話です。

    このスクリーンショットのときも、HDDの読み書きは 0 b/s でした。#6や#9でHDDを止めるために頑張った結果が、ここで見られます。

    有料部分に書いていること

    この先は、今のダッシュボードの設定ファイルを全部と、それぞれのカードの作り方を書いています。

    1. PortainerとNetdataを入れる

    • それぞれの docker-compose.yml

    • Portainerのセットアップトークンの出し方

    • Netdata Cloudにつなぐコマンド

    2. HomepageとGlancesを入れる

    • docker-compose.yml の全体(Host validation を通すアドレスの書き方、Nextcloudのネットワークへの参加)

    • 画面の一番上の表示(widgets.yaml)と、Docker連携(docker.yaml)

    3. カードの作り方(services.yaml)

    • 今の services.yaml の全体

    • Nextcloud:コンテナの名前で中の数字を取る方法と、Nextcloud側の設定

    • Portainer:APIキーの作り方と、404 になったときの env の番号の調べ方

    • Netdata、マイクラ(Pterodactyl):APIキーとサーバーIDの調べ方

    • Glancesのメーター9枚の書き方

    4. 仕上げ

    • 一番下の Developer などのリンクを消す方法

    • 外出先からTailscale経由で見る方法

    こんな人に向けて書いています。

    • 自宅サーバーの状態を、1つの画面で見たい人

    • Homepageを入れたけれど、エラーやカードが出なくて困っている人

    • Pterodactylのマイクラサーバーを、ダッシュボードにも出したい人

    あなたへのおすすめ