localworker — 自前VPSでCloudflare Workerを動かすツール
概要
localworker は、自前の VPS / ローカルサーバ上で Cloudflare Worker 相当のコードを実行することを目的としたオープンソースプロジェクトです。主に「開発用の実行環境」として機能し、CF の公式サンプルの多くをローカルで試すことができます。Go を使った WebIDE フロントエンドや簡易ランタイムを備え、example ディレクトリにサンプルが用意されています。一方で D1、R2、Worker AI、Workflows といった Cloudflare の統合機能はサポート外で、純粋なランタイム機能にフォーカスしています。
リポジトリの統計情報
- スター数: 3
- フォーク数: 0
- ウォッチャー数: 3
- コミット数: 2
- ファイル数: 11
- メインの言語: Go
主な特徴
- 自前 VPS / ローカル環境で Cloudflare Worker のコードを実行可能にする軽量なランタイム
- Go 製の WebIDE フロントエンドによりブラウザからコード編集と実行が可能
- Cloudflare の公式 Worker サンプルの多くを実行可能(ただし外部サービス統合は限定的)
- example ディレクトリで動作例・チュートリアルを提供
技術的なポイント
localworker のコアは「Cloudflare Worker ランタイムの代替をローカルで提供する」ことにあります。実装は比較的シンプルで、Go を使ったフロントエンド(WebIDE)と軽量なランタイム層が組み合わされています。実際のワークフローは、ユーザーが WebIDE 上でスクリプトを編集し、それをローカルのランタイムが受け取って HTTP レスポンスを生成するという流れです。CF 特有のグローバルサービス(R2、D1、Workflows、Worker AI)はサポートされておらず、Fetch、Request/Response、基本的な環境 API の範囲で互換性を確保する設計になっています。
技術的に注目すべき点は、ランタイム互換性と運用の容易さのバランスです。フル互換を目指すのではなく、CF Worker の「ランタイム的振る舞い」を再現することで、多くのサンプルが動作可能になります。また Go を採用しているため単一バイナリでの配布や軽量なデプロイメントが可能で、低スペックな VPS でも運用しやすい点が利点です。config.json や dev.go といったファイル構成からは、開発者向けに設定の書き換えで環境を切り替えられる柔軟性も読み取れます。セキュリティ面では、ローカル実行のためネットワーク制限や権限管理を自分で設定する必要があり、商用運用よりも開発・検証用途に適しています。最後に、example のサンプル群は実際の CF サンプルを基にしているため、本番移行前のローカル確認用として有用です。
プロジェクトの構成
主要なファイルとディレクトリ:
- .github: dir
- License: file
- config.json: file
- dev.go: file
- example: dir
- img: dir
- main.go: file
- README.md: file
- go.mod: file
- go.sum: file
- web: dir …他 6 ファイル
まとめ
自前VPSで軽量にCFワーカーを試せる、開発・検証向けの実用的なツール。
リポジトリ情報:
- 名前: localworker
- 説明: running worker on local / vps
- スター数: 3
- 言語: Go
- URL: https://github.com/oldfriendme/localworker
- オーナー: oldfriendme
- アバター: https://avatars.githubusercontent.com/u/188733862?v=4
READMEの抜粋:
localworker
在 自有本地 VPS 上运行 Worker
项目简介
localworker 是一个在 自有 VPS / 本地服务器 上运行的 CF Worker。
WebIDE 环境
webide
使用教程
cf官方的worker示例大多数都能正常运行,参考:https://developers.cloudflare.com/workers/examples/return-html/
也可以参考example目录的文件。example目录
注意
没有D1支持。没有R2支持,也没有Worker AI,Workflows支持。基本上CF的集成环境大多数都没有。不过runtime環境基本都有。
技术路线
前端golang(web I…