この記事で書くこと
工場の設備を見える化する OSS「FactorEye」の開発記、2 回目です。
- 個人で「AI の会社」を作って、工場監視 OSS を作り始めた
- 自宅サーバーで SaaS にして、OSS として公開するまで(この記事)
- M5Stack から 1 秒ごとのデータを送る
- 自宅が止まっても戻せるように、AWS に控えを置く
前回、3 日で最初の版が動きました。今回は、それを自宅のサーバーから外に出し、11 月 5 日に OSS として公開するまでです。ただし、開発はまだ続いていて仕様も変わりうるので、GitHub は公開にしたり非公開に戻したりを繰り返しています。この記事は「公開した時点」までの話として読んでください。
動くものを作るのは 3 日でしたが、人に使ってもらえる形にするには、そこから 1 か月かかりました。この回の中心は、機能よりも「守り」の話です。
個人の開発です。 勤務先の業務とは関係ありません。「ecopower」は Claude Code に役割を持たせるために自分で作った設定の名前で、実在の会社・団体とは関係ありません。
4 日目:自宅のサーバーから外に出した
Ambient の良さは、登録すればすぐ使えることです。FactorEye も、サーバーを用意しなくても試せるように、ログインして使うクラウド版(SaaS 版)を作りました。1 日目に「まだ早い」と削った機能です。最初の版が動いた翌日に作り始め、10 月 4 日に公開しました。
置き場所は、自宅の Proxmox(仮想化サーバー)です。
外との出入り口は Cloudflare Tunnel に任せました。自宅の側からトンネルを張るので、ルーターに穴を開ける必要も、固定 IP も要りません。
利用者ごとのデータは、DB を分けずに、行に「どのワークスペースのものか」を付けて分けています。この印が無い行は、自分のサーバーで動かす OSS 版のデータです。同じコードが、設定 1 つでどちらにもなります。無料で使える範囲は、センサー 10 個までにしました。
外に出したら、穴が見つかった
公開した当日に、穴が 2 つ見つかりました。
- センサーの名前が「全体で 1 つ」だったので、別の人が同じ名前を使えない
- 通知の設定が全体で 1 行しかなく、ある人のアラームが、別の人の Discord に届くおそれがある
どちらも、1 人で使う前提で作った名残です。その日のうちに直しましたが、「1 人用に作ったものは、複数人で使う形にした瞬間に壊れる」と分かりました。
同じ日に、もう 1 つ方針を変えています。最初の設計には、Python のプラグインで機能を足す仕組みがあり、実際に作ってもいました。これを丸ごと消して、Webhook(何か起きたら、決めた URL に JSON を送る)に置き換えました。
使うのは工場の現場の人です。Python を書いてもらう前提は無理があります。Webhook なら、Zapier や n8n のようなサービスと、コードを書かずにつなげます。

設定画面。通知・Webhook・バックアップも、ここから操作する
守りは「壊されたとき」から考えた
人のデータを預かる以上、バックアップが要ります。ここで考えたのは、「サーバーが壊れたら」より先に、「サーバーが乗っ取られたら」 でした。乗っ取られた本番から、バックアップまで消されたら終わりだからです。
そこで、控えは「本番から送る」のではなく、別のラズパイが、読むだけの鍵で取りに行く 形にしました。本番の側からは、ラズパイにある控えに手が出せません。
戻すための道具(復旧ツール)も、本体とは別のプログラムにしました。本体が壊れたときに使う道具が、本体の中にあっては困ります。書き戻しは「無い行を足すだけ」にして、今あるデータは変えません。まず書き込まずに試して件数を出し、人が確かめた件数と同じときだけ実行します。
ここで、役割を分けていた効果が出ました。品質担当のレビューで、「細工されたバックアップを開くと、任意のコマンドが動きうる」と指摘されたのです。バックアップは改ざんされている前提で、権限を絞った作業用の 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 の履歴でした。
5 週間ぶんの履歴には、個人のメールアドレスや、自宅のネットワークの情報、開発中のメモが混ざっていました。今のファイルから消しても、過去のコミットには残ります。
そこで、ファイルの中身は 1 文字も変えずに、履歴だけを 1 コミットから作り直しました。 作り直す前後で中身が完全に同じことを確かめたので、動いている本番を作り直す必要はありませんでした。古い履歴は、丸ごと手元に保管しています。
こうして 11 月 5 日に、MIT ライセンスで公開しました。
ただ、これで完成ではありません。まだ開発中で、出したあとにも変更が入る可能性があります。そのため、公開と非公開を行き来していて、どの時点で出すのがよいかは、今も迷っています。
まとめ
- 最初の版が動いた翌日にクラウド版を作り始め、4 日目に自宅のサーバーから公開しました
- 複数人で使う形にしたら、1 人用の作りの穴がすぐ見つかりました
- バックアップは「乗っ取られても消せない」ことを先に決めました。戻す訓練までやって、はじめて安心できました
- 公開の前に、コードだけでなく履歴も確かめました
- 開発中のため、公開・非公開は今も行き来しています。出す時点を決めるのは難しいです
次回は、センサーの側の話です。M5Stack から、1 秒ごとのデータを送ります。
- FactorEye(GitHub): https://github.com/hide23link/factoreye
※ 本記事は個人の開発記録です。勤務先・所属組織の業務とは関係ありません。「ecopower」は自分で作った設定の名前で、実在の会社・団体とは関係ありません。



