0 Fork 0

Files

T

tianma-if dcfd11468d feat(sharing): add optional password protection for public note shares

Allow owners to turn on an auto-generated access password when sharing a note. Visitors must unlock the share page before reading the note or its attachments; existing public links stay open until a password is enabled.

2026-09-17 14:44:43 +08:00

25 KiB

Raw Blame History

EdgeEver

简体中文 | 繁體中文 | English | 日本語

EdgeEver：オープンソース、AI ネイティブ、Cloudflare 無料枠 / Docker で自前運用できる Evernote 代替ノート。

EdgeEver は、オープンソースのノートと知識ベースの作業領域です。Evernote の三ペインを残しつつ、データを自分で持ち、AI Agent と連携できます。

💡 サーバーレス、ずっと無料 EdgeEver は Cloudflare の無料枠内で動かせ、サーバーを借りたり保守したりする必要はありません。VPS、NAS、自宅サーバーを使いたい場合は、同じアプリを Docker で導入できます。

⭐ EdgeEver が役に立ったら、Star をお願いします。発見のきっかけになります。

なぜ EdgeEver か

長年 Evernote を使ってきた人が欲しいのは、信頼でき、開かれていて、速い個人知識ベースです。よくある代替には、それぞれ代償があります。

Evernote：広告と余分な機能で重くなり、書き出しが煩雑で、無料枠は狭く、AI / MCP は有料プランです。
Obsidian：ファイルは開いていますが、コアはクローズドです。公式同期は有料、第三者同期は手間がかかります。画像と添付をノートと一緒に置くと保管庫が膨らみ、モバイル同期が遅く、削除後に添付が残りやすいです。気軽な取り込みには重いことがあります。
Memos などのタイムライン型：簡潔ですが、三ペインの整理作業とはレイアウトが違います。

EdgeEver はその隙間を埋めます。 同期と自前運用を含めてスタック全体がオープンソースです。使い慣れた三ペイン、ネイティブな AI Agent、無料で始められる導入を残しています。

💡 おすすめの使い方： どの端末でも着想を取り込み、三ペインで深く整理します。ネイティブ MCP で AI Agent が知識を読み、まとめ、Notion や Feishu などの道具ともつなぎます。体裁付きコピーでどこへでも出せます。データは自分のインスタンスに置き、本当に自分の第二の脳を持てます。

オンラインデモ

Demo: https://demo.edgeever.org

公開デモは毎日 3:00（中国標準時）にリセットされ、サンプルノートが戻ります。非公開の内容は置かないでください。

クライアントのダウンロード

iOS アプリは、中国本土以外の Apple ID が必要です。

機能

導入方法を選べる：Cloudflare の無料 Serverless、または VPS / NAS / 自宅サーバーの Docker。Cloudflare の無料保存の目安では、個人なら短いノート約 15 万、画像約 5 万。Docker の保存は必要に応じて伸ばせ、ノート数百万件と大きな画像庫にも足ります。
開かれたデータ、囲い込みなし：標準 SQLite、REST API、MCP、CLI。知識は透明に保存され、特定アプリに縛られません。
欠損のない ZIP バックアップ：Markdown、Front Matter、入れ子フォルダ、相対パスの添付、版履歴をまとめて書き出し、どこでも復元できます。
ネイティブな AI Agent 連携：MCP で Claude Code、Codex、Antigravity などがノートを読み、整理し、要約できます。Notion や Feishu Bitable ともつなぎます。
自分の AI モデル：OpenAI、Anthropic、Gemini 互換と第三者リレーを接続し、全文または選択範囲の要約、要点抽出、校正、翻訳、続きの執筆ができます。
プラグイン API： Plugin API で拡張できます。
台数制限のない同期：商用の端末数上限はありません。Web、PWA、ブラウザ経由で PC、タブレット、モバイルを同期します。
クラシックな三ペインとフォーカスモード：ノートブックツリー、ノート一覧、広い編集領域。デスクトップではフォーカスモードもあります。
入れ子ノートブック：階層の深さに上限はありません。
ニュースレターとブログ向けの体裁付きコピー：Markdown をインライン CSS のリッチテキストへ変換し、Substack、Medium、WordPress、ニュースレターへそのまま貼れます。
双方向エディタ：デスクトップではリッチテキストと Markdown ソースを切り替えられます。
1 件のノート書き出し：Markdown、HTML、PDF に書き出せます。
Mermaid の描画：フローチャート、シーケンス、マインドマップをノート内で描画し、Markdown とリッチテキストの両方で編集可能なソースを残します。
視覚的な図のノート：Web とデスクトップでマインドマップ、フローチャート、アーキテクチャ図を作れます。意味のある部品、システム境界、ラベル付き接続、自動レイアウト、版履歴、PNG / SVG 書き出し。Android と iOS は同じデータを保持し、意味のある読み取り専用表示をします。詳しくは visual diagram notes design を見てください。
版履歴：過去の版を見て、戻せます。
公開共有：ノートを公開し、いつでも止められます。必要なら共有リンクに自動生成のアクセスパスワードを付けられます。
モバイルでの微信公式アカウント記事の取り込み：スマホから微信公式アカウントの記事を EdgeEver に共有すると、本文を取り出して編集できるノートにします。
クライアント側の画像圧縮：アップロード前に WebP 圧縮し、よくある画像で 50%〜90% 小さくします。サーバー追加料金はかかりません。
汎用添付：PDF、Office、zip、音声、動画をノートに付けてプレビューできます。分割アップロードとストリーミングで最大 1 GiB まで扱えます。
一括操作と並び替え：複数ノートの結合や移動、ノートブックのドラッグ並べ替え。
オフライン下書きとキュー：オフラインでも書け、復帰後に自動同期します。
総当たりログイン対策：サーバー側でアカウントと IP の失敗を数え、冷却します。
複数アカウントの分離：1 インスタンスで複数ユーザーをホストし、作業領域を分けます。
必要な場所すべて：Web、Android、macOS、Windows、Linux、iOS。Web Clipper は Chrome、Edge、Firefox に対応しています。

導入

Cloudflare が、サーバーを持たない導入の推奨です。VPS、NAS、自宅サーバーなら Docker も使えます。

Cloudflare のオンライン導入は、次のいずれかです。

方法 A: AI Agent で導入（推奨）

次のプロンプトを AI Agent（Codex、Claude、Cursor、workbuddy、Antigravity、OpenClaw、Hermes Agent など）へそのまま送ってください。実行中に GitHub や Cloudflare へのアクセスが求められたら、権限を確認して認可してください。

EdgeEver をオンラインで導入してください:
1. Fork https://github.com/tianma-if/edgeever.
2. Cloudflare で D1 `edgeever` と R2 `edgeever-resources` を作成します。
3. その Fork を Cloudflare Workers & Pages に取り込み、`main` を本番ブランチにします。
4. Worker Secret `EDGE_EVER_AUTH_PASSWORD` を追加し、ユーザーが選んだパスワードを値にします。
   このインスタンス専用の、32 文字以上の強いパスワードを推奨します。
5. 初回ビルドを開始し、`/api/health` と `/api/openapi.json` を確認してから、
   ユーザー名 `admin` と設定したパスワードでログインできることを確認します。
6. GitHub Actions の `Update deployed EdgeEver` を有効にし、一度手動実行して、
   Fork が最新の機能と修正を自動で受け取れるようにします。

詳細な要件: AI Agent Cloudflare Deployment。

方法 B: 手動のオンライン導入

ウェブ上の 6 手順で完了します。

リポジトリを Fork：GitHub 右上の Fork で、EdgeEver を自分のアカウントへ Fork します。
Cloudflare リソースを作成：D1 edgeever と R2 edgeever-resources を作ります。
プロジェクトを取り込み、設定：Fork を Cloudflare Workers & Pages に取り込み、main を本番ブランチにします。binding は導入コマンドが作ります。Fork 内のファイルは編集しないでください。
管理者パスワードを設定：Worker Secret EDGE_EVER_AUTH_PASSWORD を追加し、管理者ログイン用パスワードを値にします。このインスタンス専用の、32 文字以上の強いパスワードを推奨します。
ビルドと確認：初回ビルドを開始します。導入後、/api/health が 200 を返すことと、ユーザー名 admin と設定したパスワードでログインできることを確認します。
自動更新を有効化：Fork の Actions タブで I understand my workflows, go ahead and enable them を押し、Update deployed EdgeEver を一度手動実行して、以降の機能と修正を自動で受け取れるようにします。

📖 手順と設定の詳細は Online Deployment Guide を見てください。

💡 Cloudflare R2 の有効化：Cloudflare R2 にはノート用途で足りる無料保存枠がありますが、先に R2 のサブスクリプションを有効にし、支払い方法を登録する必要があります。Cloudflare は公式に UnionPay、Visa、Mastercard などのカードと、PayPal、Apple Pay、Google Pay などを受け付けます。

方法 C: VPS または NAS で Docker

GitHub ホストのインストーラと公式 GHCR イメージを使います。

curl -fsSL https://edgeever.org/install.sh | bash

このコマンドは最新イメージを引き、管理者パスワードを生成し、Docker Compose で EdgeEver を起動し、毎日の自動更新を設定します。

公式コンテナイメージは GitHub Container Registry（GHCR）にあります。中国本土などの一部ネットワークでは遅い、またはタイムアウトすることがあります。引き出せない場合は、導入前に使えるネットワークプロキシか信頼できるレジストリミラーを設定してください。第三者のネットワークやレジストリの可用性と安全性は、利用者自身が判断してください。

手動導入と設定は Docker deployment guide を見てください。

複数アカウント

導入後、1 インスタンスで複数アカウントのログインができます。

インスタンス管理者は プロフィール -> ユーザーアカウント でメンバーの作成、無効化、パスワードリセットができます。メンバーごとにノートブック、ノート、添付、ゴミ箱、インポート / エクスポート、MCP トークンが分離されます。

ブラウザ Web Clipper

Web Clipper は Chrome、Microsoft Edge、Firefox の公式ストアにあります。使っているブラウザのストアから入れてください（Microsoft Edge は Chrome Web Store 版を直接入れられます）。

コミュニティとフィードバック

不具合、機能要望、導入の問題: GitHub Issues
コード貢献: Contribution Guide を読んでください。Fork を EdgeEver の導入にも使う場合、その main は導入専用にしてください。同期、開発、Pull Request は公式 upstream/main から切った別ブランチで行い、導入用 main では開発も Sync fork もしないでください。

Telegram コミュニティ

EdgeEver の使い方、AI Agent の実例、費用対効果の高い / 無料の AI 資源、自動化の流れを話す場です。

👉 EdgeEver の Telegram グループに参加

プラグインとテーマ

EdgeEver の Web とデスクトップはプラグインと、コードなしテーマに対応します。プラグインマーケット、GitHub、Manifest URL から入れられます。インストール一覧は現在の作業領域に付き、ブラウザとデスクトップのあいだで共有されます。各クライアントはパッケージを手元でダウンロードし、検証します。ネイティブの Android と iOS はプラグインを実行しません。設定と秘密情報は今の端末に残ります。公式マーケットは無料かつオープンソースのプラグインだけを掲載します。GitHub や Manifest URL からの直接インストールには、この条件は適用しません。開発者は @edgeever/plugin-api を使えます。 plugin development guide と marketplace submission policy を見てください。

技術スタック

Bun workspace の monorepo。Web、API、公式サイト、共有型パッケージ。
フロントエンド: Vite、React、React Router、TanStack Query、Tailwind CSS、shadcn/ui、Radix UI。
エディタ: TipTap / ProseMirror と Markdown。PWA は vite-plugin-pwa、Workbox、Dexie。
Android アプリ: apps/mobile の Expo + React Native。SQLite のローカル保存と差分同期。
iOS アプリ: apps/ios のネイティブ SwiftUI（iOS 17+）。同梱の TipTap EditorBundle、GRDB のローカルミラー / outbox、Android に揃えたシェル。
ネイティブデスクトップ: Electron + Rust sidecar。横断プラットフォームの操作感と、速いローカルデータ。SQLite でオフライン編集、復帰後の差分同期、ローカルバックアップ。
Web Clipper: Manifest V3、Mozilla Readability、Turndown。Chrome、Microsoft Edge、Firefox。
バックエンド: Hono / Zod の業務アプリ 1 式。REST API と Remote MCP。Cloudflare は Workers / D1 / R2、Docker は Bun / SQLite / ローカルファイルまたは S3。
公式サイト: apps/site の Astro 静的サイト。Cloudflare Pages に出せます。

クイックスタート

bun install
bun run dev

ローカル開発は自動ログインします。新しいデータベースの初期アカウントは owner / edgeever-local-dev です。ログイン画面を試すときはログアウトしてください。

リポジトリ構成

apps/web          Vite + React フロントエンド、PWA、オフライン下書き、同期キュー
apps/extension    Chrome/Edge/Firefox Manifest V3 Web Clipper
apps/api          Cloudflare Worker + Hono API、MCP
apps/mobile       Expo + React Native の Android アプリ
apps/ios          ネイティブ SwiftUI の iOS アプリ（TipTap EditorBundle、GRDB）
apps/desktop      Electron のデスクトップシェル、preload、ネイティブ梱包
apps/site         Astro の公式サイト。独立して導入できます
packages/client   Web とモバイルで共有する API クライアント
packages/shared   共有型、Zod、TipTap / Markdown 変換
crates/desktop-sidecar
                   ローカル SQLite、オフラインデータ、バックアップ、リソースの Rust sidecar
scripts           Wrangler ラッパ、パスワード hash、CLI、MCP stdio、Evernote ENEX 取り込み
migrations        D1/SQLite 共用の、追加のみの migration
docs              アーキテクチャ、移行、導入の文書
.github/workflows Web、モバイル、iOS、デスクトップ梱包、導入、Release の CI
wrangler.toml     Cloudflare Workers、Assets、D1、R2 の設定

内容の形式

EdgeEver はノート本文を 3 つの形で持ちます。

content_json      TipTap/ProseMirror 文書。エディタの正本
content_markdown  API、Agent、取り込み、書き出し
content_text      検索、要約、索引

プロフィール -> インポートとエクスポート から EdgeEver ZIP を書き出し、または取り込めます。notes/ は Markdown として読め、持ち出せます。構造化データは EdgeEver インスタンス間の完全復元に使います。取り込みは関係ない対象データを残し、同じ EdgeEver ID の記録は上書きします。

MCP

プロフィール -> MCP 設定 で API トークンを作り、AI Agent に渡してください。Agent はアカウントの権限の範囲で知識ベースを扱えます。テキストノートと図のノート（マインドマップ、フローチャート、アーキテクチャ図）の CRUD、ノートテンプレートと AI 指示の管理、Notion データベースや Feishu Bitable との接続に対応します。

💡 着想： AI を知識の整理役と創作の相棒にしてください。構想をインタラクティブなマインドマップやアーキテクチャ図へすぐ落とし、Agent に私有の文脈を渡せます。EdgeEver のリッチテキストと体裁と組み合わせると、AI が手伝った内容は、整った、配布できる知識になります。

画像圧縮

画像圧縮は Web クライアントがアップロード前に行い、ノート内画像を圧縮 の設定で制御します。オンのとき、PNG、JPEG、WebP、AVIF は得があれば WebP にし、長辺を 2560px までにします。小さくならなければ原ファイルを残します。

Worker 側の画像処理は避け、計算と画像処理枠を抑えます。REST API と MCP のアップロードは、クライアントが渡した内容を追加圧縮せず保存します。

高度なオブジェクトストレージ

インスタンスのオーナーは 設定 → 詳細 → OSS オブジェクトストレージ で S3 互換ストレージを設定できます。切り替えは既存添付を移さず、影響しません。

移行

他のプラットフォームから EdgeEver へ移す場合は、次の短いガイドを見てください。

Evernote からの移行: docs/evernote-migration-guide.md
flomo からの移行: docs/flomo-migration-guide.md
Memos からの移行: docs/memos-migration-guide.md
Notion からの移行: docs/notion-migration-guide.md

Docker 導入

Docker は Cloudflare と同じフロントエンド、API、サービス、認証、MCP、migration です。コンテナは SQLite と、ローカルファイルまたは S3 互換の添付保存を使い、amd64 と arm64 に対応します。 Deploy EdgeEver with Docker と Self-hosting and Docker architecture を見てください。

同期のタイミング

Web、PWA、デスクトップは、編集が 30 秒止まったあとでノートをアップロードし、表示中は 5 分ごとに遠隔の変更を見ます。フォーカスと手動更新はすぐです。DEFERRED_MEMO_SYNC_DELAY_MS と BACKGROUND_WORKSPACE_REFRESH_INTERVAL_MS は apps/web/src/lib/workspace-refresh.ts で変えられます。

謝辞

ノート製品の設計は、Evernote など成熟したノートツールの公開されている製品体験も参考にしています。関連機能は EdgeEver が独自に設計し、実装しています。
マインドマップと視覚的な図のノートは、XMind と ProcessOn の公開されている製品体験を参考にしています。関連機能は EdgeEver が独自に設計し、実装しています。
エディタテーマのタイポグラフィ、見出し階層、章立ては obsidian-minimal、Outline、墨格の公開成果を参考にしています。名称、素材、実装は EdgeEver のオリジナルです。

商標とブランド

EdgeEver の名称、ロゴ、その他のブランド表示は公式プロジェクトを区別します。Fork や改変版は EdgeEver に基づくと述べられますが、公式であるように装ったり、利用者を誤認させたりしてはなりません。オープンソースライセンスは商標権を与えません。ほかの利用は、メンテナの事前の書面による許可が必要です。

免責

EdgeEver は、個人とコミュニティが開発・維持する独立したオープンソースのノートアプリです。Evernote Corporation およびその関係会社と提携、認可、後援、推奨の関係はありません。

EdgeEver はセルフホスト型ソフトウェアです。公式デモを除き、メンテナはユーザー内容をホスト、管理、審査しません。インスタンスに保存または表示される内容は、その利用者または運用者の責任であり、メンテナの見解ではありません。

25 KiB Raw Blame History Unescape Escape