0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

自宅サーバーで SaaS にして、OSS として公開するまで ― FactorEye 開発記(2)

0
Last updated at Posted at 2026-11-17

この記事で書くこと

工場の設備を見える化する OSS「FactorEye」の開発記、2 回目です。

  1. 個人で「AI の会社」を作って、工場監視 OSS を作り始めた
  2. 自宅サーバーで SaaS にして、OSS として公開するまで(この記事)
  3. M5Stack から 1 秒ごとのデータを送る
  4. 自宅が止まっても戻せるように、AWS に控えを置く

前回、3 日で最初の版が動きました。今回は、それを自宅のサーバーから外に出し、11 月 5 日に OSS として公開するまでです。ただし、開発はまだ続いていて仕様も変わりうるので、GitHub は公開にしたり非公開に戻したりを繰り返しています。この記事は「公開した時点」までの話として読んでください。

動くものを作るのは 3 日でしたが、人に使ってもらえる形にするには、そこから 1 か月かかりました。この回の中心は、機能よりも「守り」の話です。

個人の開発です。 勤務先の業務とは関係ありません。「ecopower」は Claude Code に役割を持たせるために自分で作った設定の名前で、実在の会社・団体とは関係ありません。

4 日目:自宅のサーバーから外に出した

Ambient の良さは、登録すればすぐ使えることです。FactorEye も、サーバーを用意しなくても試せるように、ログインして使うクラウド版(SaaS 版)を作りました。1 日目に「まだ早い」と削った機能です。最初の版が動いた翌日に作り始め、10 月 4 日に公開しました。

置き場所は、自宅の Proxmox(仮想化サーバー)です。

SaaS 版の構成図。利用者のブラウザとセンサーが Cloudflare を通り、トンネルで自宅の Proxmox 上のコンテナにつながる。中は Caddy が画面と API に振り分け、API の後ろに PostgreSQL がある

外との出入り口は Cloudflare Tunnel に任せました。自宅の側からトンネルを張るので、ルーターに穴を開ける必要も、固定 IP も要りません。

利用者ごとのデータは、DB を分けずに、行に「どのワークスペースのものか」を付けて分けています。この印が無い行は、自分のサーバーで動かす OSS 版のデータです。同じコードが、設定 1 つでどちらにもなります。無料で使える範囲は、センサー 10 個までにしました。

外に出したら、穴が見つかった

公開した当日に、穴が 2 つ見つかりました。

  • センサーの名前が「全体で 1 つ」だったので、別の人が同じ名前を使えない
  • 通知の設定が全体で 1 行しかなく、ある人のアラームが、別の人の Discord に届くおそれがある

どちらも、1 人で使う前提で作った名残です。その日のうちに直しましたが、「1 人用に作ったものは、複数人で使う形にした瞬間に壊れる」と分かりました。

同じ日に、もう 1 つ方針を変えています。最初の設計には、Python のプラグインで機能を足す仕組みがあり、実際に作ってもいました。これを丸ごと消して、Webhook(何か起きたら、決めた URL に JSON を送る)に置き換えました。

使うのは工場の現場の人です。Python を書いてもらう前提は無理があります。Webhook なら、Zapier や n8n のようなサービスと、コードを書かずにつなげます。

設定画面のセンサー管理。左にセンサー・機器・アラーム・通知・Webhook連携・データ移行・バックアップ・API・取り込みのメニューがあり、右にセンサーの一覧が、今の値としきい値つきで並ぶ
設定画面。通知・Webhook・バックアップも、ここから操作する

守りは「壊されたとき」から考えた

人のデータを預かる以上、バックアップが要ります。ここで考えたのは、「サーバーが壊れたら」より先に、「サーバーが乗っ取られたら」 でした。乗っ取られた本番から、バックアップまで消されたら終わりだからです。

バックアップと復旧の図。本番は毎日 3 時にバックアップを取り、別のラズパイが読むだけの鍵で毎日取りに行く。クラウドの保管庫はロックで消せない。復旧ツールは本体と別のプログラムで、書き戻しは 4 段階

そこで、控えは「本番から送る」のではなく、別のラズパイが、読むだけの鍵で取りに行く 形にしました。本番の側からは、ラズパイにある控えに手が出せません。

戻すための道具(復旧ツール)も、本体とは別のプログラムにしました。本体が壊れたときに使う道具が、本体の中にあっては困ります。書き戻しは「無い行を足すだけ」にして、今あるデータは変えません。まず書き込まずに試して件数を出し、人が確かめた件数と同じときだけ実行します。

ここで、役割を分けていた効果が出ました。品質担当のレビューで、「細工されたバックアップを開くと、任意のコマンドが動きうる」と指摘されたのです。バックアップは改ざんされている前提で、権限を絞った作業用の DB に流し込んでから調べる形に直しました。

作っただけでは信用できないので、10 月 8 日に本番で訓練もしました。訓練用のデータを作り、バックアップを取り、消して、画面から書き戻す。全件戻ることを確かめています。

使う人の「最初の 5 分」を作る

OSS として出すなら、入れるのが簡単でないと試してもらえません。インストールは 1 行にしました。

curl -fsSL https://raw.githubusercontent.com/hide23link/factoreye/main/install/install.sh | sudo bash

Docker が無ければ入れ、鍵やパスワードは乱数で作ります。ビルド済みのイメージを用意したので、Raspberry Pi でもそのまま動きます。この「入れる → 動作確認 → 入れ直す」は、まっさらな Ubuntu の上で、変更のたびに自動で試しています。

設定は 1 つのファイルにまとめ、画面からも変えられるようにしました。

取り込みの設定画面。サーバーの設定ファイルの内容が表示され、取り込みキーと、キーなしで受け付けるかの選択がある

クラウド版で試した人が、あとで自分のサーバーに引っ越せるように、データの書き出しと取り込みも付けています。センサーの ID と送信用のキーはそのまま移るので、センサー側の設定は変えなくて済みます。

11 月 5 日:履歴を作り直して公開

最後に残ったのは、Git の履歴でした。

OSS 公開の流れ。非公開の履歴には個人のメールアドレス、自宅のネットワークの情報、開発メモが混ざっていた。点検して移動し、1 コミットから始まる新しい履歴で公開した。下に 1 行のインストールコマンド

5 週間ぶんの履歴には、個人のメールアドレスや、自宅のネットワークの情報、開発中のメモが混ざっていました。今のファイルから消しても、過去のコミットには残ります。

そこで、ファイルの中身は 1 文字も変えずに、履歴だけを 1 コミットから作り直しました。 作り直す前後で中身が完全に同じことを確かめたので、動いている本番を作り直す必要はありませんでした。古い履歴は、丸ごと手元に保管しています。

こうして 11 月 5 日に、MIT ライセンスで公開しました。

ただ、これで完成ではありません。まだ開発中で、出したあとにも変更が入る可能性があります。そのため、公開と非公開を行き来していて、どの時点で出すのがよいかは、今も迷っています。

まとめ

  • 最初の版が動いた翌日にクラウド版を作り始め、4 日目に自宅のサーバーから公開しました
  • 複数人で使う形にしたら、1 人用の作りの穴がすぐ見つかりました
  • バックアップは「乗っ取られても消せない」ことを先に決めました。戻す訓練までやって、はじめて安心できました
  • 公開の前に、コードだけでなく履歴も確かめました
  • 開発中のため、公開・非公開は今も行き来しています。出す時点を決めるのは難しいです

次回は、センサーの側の話です。M5Stack から、1 秒ごとのデータを送ります。


※ 本記事は個人の開発記録です。勤務先・所属組織の業務とは関係ありません。「ecopower」は自分で作った設定の名前で、実在の会社・団体とは関係ありません。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?