Skip to main content
Taiki Ito

MulmoClaudeをVPSで動かす

このページは英語版の要約です。手順・コマンド・設定ファイルは英語版にしかありません。 同じ内容を2か所に持つと、片方を直したときにもう片方が必ず取り残されるので、ここに翻訳は置いていません。

すでにMulmoClaudeを使っている方へ。英語版を自分で読み切る必要はありません。 詳細はすべて英語版に書いてあるので、そのURLを自分のMulmoClaude(やClaude)に渡して「この内容で設定したい」と頼めば、読んで、必要な作業までやってくれます。あなたが決めるべき場面ではAIが手を止めてあなたに聞くように、その箇所も英語版に明示してあります。

このページについて

MulmoClaude公式のREADMEの番外編です。インストールや前提条件は公式ドキュメントに譲ります。扱うのは、公式が用意していない構成 — VPSにMulmoClaudeを置き、自分のドメインで、外出先のPCやスマホからブラウザのUIをそのまま使えるようにする方法 — だけです。

トークンなしで通れる経路があることを開発元に報告した際、「警告を先頭に置いて、利用者の側で公開してほしい」と提案されて書いたのが英語版です。公式の保証はない、非公式の個人記事です。試すときはご自身の判断でお願いします。

大事な話

MulmoClaudeは /api/* をトークンで守っていますが、2つの経路だけは、あえてトークンを要求しない設計になっています。

  • /api/files/* — HTMLの <img> タグは認証情報を付けられないため、ここを閉じるとチャット内の画像が表示できなくなります。どの版でも素通しのまま
  • /ws/pubsub — WebSocketの接続時の確認。こちらは修正済みです(2026-10-10マージ)

127.0.0.1 だけで動かしている限り、これは正しい設計です。そこに到達できるのは、そのPCの前に座っている本人だけだからです。公開ドメインを付けると、扉の前に立てる人が「本人だけ」から「URLを知っている人全員」に変わります。 何も対策しなければ、他人がトークンなしでワークスペースのファイルを読み、会話を覗けます。

だから、リクエストがMulmoClaudeに届く「前」に認証する仕組み(Cloudflare Access、認証付きリバースプロキシ、VPN、Tailscaleなど)が必須です。/api/files/* はどの版でも素通しなので、これはバージョンに関係なく必要です。

そもそも、この構成が要らない人

  • スマホから使えれば十分なら、公式の Remote Access という選択肢があります。 両方の端末で同じGoogleアカウントにサインインするだけで、ドメインもプロキシも運用も不要。ただしスマホに出るのはアプリ全体ではなく専用の簡易画面なので、それで足りるかどうかで決めてください
  • 127.0.0.1 のまま、そのPCだけで使っている人は、何もする必要がありません
  • VPNやTailscale越しにしか使わない場合も同じです

ハマりどころ(詳細は英語版で)

  • systemdのユニットに @latest と書かない。 リリース直後の再起動が黙って上書き更新になり、途中で失敗すると同じ失敗を延々と繰り返します。私の環境では約12分で75回再起動しました。止めるのは再起動の間隔ではなく、試行回数の上限です
  • 公開URLの監視では、サーバーの生死は分かりません。 認証の後ろに置くと、監視はログイン画面を見て「正常」と報告し続けます。上の12分の障害で、アラートは1本も鳴りませんでした
  • 監視を入れたら、一度わざと失敗させて、本当に通知が来るか確かめておく。 確かめたことのない監視は当てになりません
  • 公開ドメインを設定に足したら、再起動を忘れない。 忘れると「読めるのに書き込めない」状態になります(画面は正常に見えるのに、送信・添付・削除が全部拒否される)
  • Cloudflare Tunnelをダッシュボードから作ると、サーバー側の設定ファイルは無視されます。 いくら編集しても何も変わりません
  • cloudflared に SIGHUP を送らない。 再読み込みではなく終了してしまい、全経路が落ちます

この先、古くなる情報

#3435 は2026-10-10にマージ済みで、/ws/pubsub の接続にトークンが必須になりました。それより前に出たリリースには入っていません。ページに書かれた版番号ではなく、このマージと自分の環境を突き合わせて確認してください。 Cloudflare周りの細かい話は、このページの中でいちばん早く古くなります。


報告に丁寧に応じ、この記事を書くきっかけをくださった開発者の isamu arimoto さんに感謝します。

← All writing