VPSでHomerをセルフホスティングする方法（完全ガイド）

Homerは、軽量な静的ウェブアプリケーションで、自分のセルフホストアプリのカスタムダッシュボードを作成することができます。このガイドでは、VPS上にHomerをセルフホスティングする手順を解説します。Dockerのインストール、Homerイメージの取得、設定方法について詳しく説明します。

VPSプロバイダーの選択

インストールに入る前に、VPSプロバイダーを選びましょう。以下は、考慮すべき人気のオプションの比較表です。

このガイドでは、コストパフォーマンスと機能面からHetzner Cloudをおすすめします。詳細なVPS比較はこちらの完全比較もご参照ください。

必要な前提条件

1. 少なくとも1GBのRAMを搭載し、UbuntuまたはDebian OSがインストールされたVPS。
2. SSHとDockerの基本的な知識。
3. VPSを指すドメイン名（オプションですが、Homerダッシュボードへのアクセスには推奨します）。

ステップ1：VPSの更新

VPSにSSHでアクセスします。

ssh user@your_vps_ip

システムを最新の状態に更新します。

sudo apt update && sudo apt upgrade -y

ステップ2：Dockerのインストール

Homerアプリケーションを動かすためにDockerをインストールします。以下の手順で進めてください。

Dockerのインストール

次のコマンドを実行します。

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Dockerの動作確認

Dockerが正しくインストールされたか確認します。

sudo systemctl start docker
sudo systemctl enable docker
sudo docker --version

バージョン情報が表示されれば成功です。

ステップ3：Homerのデプロイ

次にHomerをデプロイします。まず、Homer用のディレクトリを作成します。

mkdir -p ~/homer
cd ~/homer

Homer Dockerイメージの取得

以下のコマンドで最新のHomerイメージをプルします。

sudo docker pull b4bz/homer:latest

設定ファイルの作成

デフォルトの設定ファイルをダウンロードします。

curl -o config.yml https://ghproxy.com/https://raw.githubusercontent.com/b4bz/homer/master/config.yml

config.ymlファイルを編集してダッシュボードをカスタマイズします。

nano config.yml

必要に応じてリンクやタイトルを変更し、自分のセルフホストアプリを反映させてください。

Homer Dockerコンテナの起動

次に、Homerコンテナを起動します。

sudo docker run -d \
  --name homer \
  -p 8080:8080 \
  -v ~/homer/config.yml:/www/assets/config.yml \
  b4bz/homer:latest

Homerには http://your_vps_ip:8080 でアクセスできます。ドメインを設定している場合はそちらを利用してください。

ステップ4：リバースプロキシ設定（オプション）

より便利なURLでHomerにアクセスできるように、リバースプロキシを設定しましょう。NginxかTraefikがおすすめです。

Nginxのインストール

sudo apt install nginx -y

Nginxの設定

新しい設定ファイルを作成します。

sudo nano /etc/nginx/sites-available/homer

以下の設定例を入力し、your_domain.comを自身のドメインに置き換えます。

server {
    listen 80;
    server_name your_domain.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

設定を有効にします。

sudo ln -s /etc/nginx/sites-available/homer /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

これでポート番号を気にせず、ドメイン名からHomerにアクセスできるようになります。

よくある質問（FAQs）

Homerのダッシュボードはカスタマイズできますか？

はい、Homerのダッシュボードは非常にカスタマイズ可能です。config.ymlファイルを編集して、各アプリリンクの名前やURLを変更できます。ロゴやアイコンを追加して視覚的に分かりやすくすることも可能です。詳細は HomerのGitHubドキュメント を参照してください。

Dockerのインストールに問題があった場合はどうすればいいですか？

インストール中に問題が発生した場合は、お使いのサーバーが対応しているか、UbuntuまたはDebianのシステムが最新であることを確認してください。Docker公式のトラブルシューティングガイドも参考にしてください。また、ファイアウォールの設定によって通信が妨げられている場合もあるため、外向きのアクセスが許可されているか確認しましょう。

Homerのようなアプリをセルフホストするセキュリティはどうですか？

セルフホストのアプリはセキュリティ対策が必要です。UbuntuにはUFWなどのファイアウォール設定がおすすめです。定期的なアップデートにより脆弱性を防ぎましょう。ダッシュボードをインターネットに公開する場合は、Let’s Encryptを使ったHTTPSの導入も検討してください。これにより、通信が暗号化されて安全です。

このガイドに従えば、VPS上にHomerを効果的にセルフホスティングでき、便利なダッシュボードにアクセスしてお気に入りのアプリをまとめて管理できます。快適なホスティングライフをお楽しみください！