From 0581632b59651d635c6364a0408ffd5b98a9d107 Mon Sep 17 00:00:00 2001 From: tura-ai-agent Date: Thu, 23 Jul 2026 09:09:49 +0200 Subject: [PATCH] docs: add Japanese README (#1088) Add a complete Japanese README and link it from the Chinese and English READMEs. --- CHANGELOG.md | 1 + CHANGELOG_EN.md | 1 + README.md | 3 +- README_EN.md | 3 +- README_JA.md | 202 ++++++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 208 insertions(+), 2 deletions(-) create mode 100644 README_JA.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 98c539c..78303a7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -23,6 +23,7 @@ ### Improvements +- docs: |README| 新增完整日文 README，并在中文和英文 README 中添加日文导航链接 - feat: |Frontend| 「邮箱双栏视图左侧列表宽度占比」最小值由 0.25 放宽至 0，左侧列表可完全折叠使正文近乎全屏，刻度增加 0 点；收件箱与发件箱的双栏拆分同步生效，并优化外观设置文案以明确该比例控制左侧邮件列表宽度 ## v1.9.0 diff --git a/CHANGELOG_EN.md b/CHANGELOG_EN.md index 7fc5a42..5d6f0f6 100644 --- a/CHANGELOG_EN.md +++ b/CHANGELOG_EN.md @@ -23,6 +23,7 @@ ### Improvements +- docs: |README| Add a complete Japanese README and Japanese navigation links to the Chinese and English READMEs - feat: |Frontend| Lower the "Left list width in two-column mailbox view" minimum from 0.25 to 0 so the left list pane can fully collapse for a near-fullscreen content view, with a 0 mark added; applies to both the inbox and send-box two-pane splits, and clarifies the Appearance setting label so it is clear the value controls the left mail list width ## v1.9.0 diff --git a/README.md b/README.md index bc7671a..fea23a9 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,8 @@

中文文档 | - English Document + English Document | + 日本語ドキュメント

> 本项目仅供学习和个人用途，请勿将其用于任何违法行为，否则后果自负。 diff --git a/README_EN.md b/README_EN.md index edcc513..7225951 100644 --- a/README_EN.md +++ b/README_EN.md @@ -30,7 +30,8 @@

中文文档 | - English Document + English Document | + 日本語ドキュメント

> This project is for learning and personal use only. Please do not use it for any illegal activities, or you will be responsible for the consequences. diff --git a/README_JA.md b/README_JA.md new file mode 100644 index 0000000..c5eec27 --- /dev/null +++ b/README_JA.md @@ -0,0 +1,202 @@ + +# Cloudflare 一時メール - 無料で構築できる一時メールサービス + +

+ + docs + + + + + + MIT License + + + GitHub contributors + + + GitHub top language + + + + +

+ +

+ + Featured｜HelloGitHub + +

+ +

+ 中文文档 | + English Document | + 日本語ドキュメント +

+ +> 本プロジェクトは学習および個人利用のみを目的としています。違法行為には使用しないでください。使用した場合、その結果については利用者自身が責任を負うものとします。 + +**機能の充実した一時メールサービスです！** + +- **完全無料** - Cloudflare の無料サービス上に構築され、運用コストはかかりません +- **高性能** - Rust WASM によるメール解析で極めて高速に応答します +- **モダンな UI** - 多言語対応のレスポンシブデザインで、簡単に操作できます +- **アドレスパスワード** - メールアドレスごとに個別のパスワードを設定し、セキュリティを強化できます +- **Agent フレンドリー** - AI agent がメールボックスを利用できる組み込みの [`skill`](skills/cf-temp-mail-agent-mail/SKILL.md) を提供します +- **モバイル管理** - Android の管理画面とメールボックス管理に対応したコミュニティクライアント [CloudMail](https://github.com/Lur1N77777/CloudMail) を利用できます + +## デプロイドキュメント - クイックスタート + +[ドキュメント](https://temp-mail-docs.awsl.uk) | [GitHub Actions デプロイガイド](https://temp-mail-docs.awsl.uk/en/guide/actions/github-action.html) + + + Deploy to Cloudflare Workers + + +## 変更履歴 + +最新の更新内容については [CHANGELOG](CHANGELOG.md) を参照してください。 + +## ライブデモ + +今すぐ試す → [https://mail.awsl.uk/](https://mail.awsl.uk/) + +
+サービス稼働状況（クリックして展開／折りたたみ） + +| | | +| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [Backend](https://temp-email-api.awsl.uk/) | [![Deploy Backend Production](https://github.com/dreamhunter2333/cloudflare_temp_email/actions/workflows/backend_deploy.yaml/badge.svg)](https://github.com/dreamhunter2333/cloudflare_temp_email/actions/workflows/backend_deploy.yaml) ![](https://uptime.aks.awsl.icu/api/badge/10/status) ![](https://uptime.aks.awsl.icu/api/badge/10/uptime) ![](https://uptime.aks.awsl.icu/api/badge/10/ping) ![](https://uptime.aks.awsl.icu/api/badge/10/avg-response) ![](https://uptime.aks.awsl.icu/api/badge/10/cert-exp) ![](https://uptime.aks.awsl.icu/api/badge/10/response) | +| [Frontend](https://mail.awsl.uk/) | [![Deploy Frontend](https://github.com/dreamhunter2333/cloudflare_temp_email/actions/workflows/frontend_deploy.yaml/badge.svg)](https://github.com/dreamhunter2333/cloudflare_temp_email/actions/workflows/frontend_deploy.yaml) ![](https://uptime.aks.awsl.icu/api/badge/12/status) ![](https://uptime.aks.awsl.icu/api/badge/12/uptime) ![](https://uptime.aks.awsl.icu/api/badge/12/ping) ![](https://uptime.aks.awsl.icu/api/badge/12/avg-response) ![](https://uptime.aks.awsl.icu/api/badge/12/cert-exp) ![](https://uptime.aks.awsl.icu/api/badge/12/response) | + +
+ +
+Star History（クリックして展開／折りたたみ） + + + + + Star History Chart + + +
+ +
+目次（クリックして展開／折りたたみ） + +- [Cloudflare 一時メール - 無料で構築できる一時メールサービス](#cloudflare-一時メール---無料で構築できる一時メールサービス) + - [デプロイドキュメント - クイックスタート](#デプロイドキュメント---クイックスタート) + - [変更履歴](#変更履歴) + - [ライブデモ](#ライブデモ) + - [主な機能](#主な機能) + - [メール処理](#メール処理) + - [ユーザー管理](#ユーザー管理) + - [管理機能](#管理機能) + - [多言語対応とインターフェース](#多言語対応とインターフェース) + - [連携と拡張](#連携と拡張) + - [技術アーキテクチャ](#技術アーキテクチャ) + - [システム構成](#システム構成) + - [技術スタック](#技術スタック) + - [主要コンポーネント](#主要コンポーネント) + - [コミュニティに参加](#コミュニティに参加) + +
+ +## 主な機能 + +
+主な機能の詳細（クリックして展開／折りたたみ） + +### メール処理 + +- [x] `rust wasm` でメールを高速に解析します。ほぼすべてのメールを解析でき、Node.js の解析モジュールで失敗するメールも rust wasm なら正常に解析できます +- [x] **AI メール認識** - Cloudflare Workers AI を使用して、メール内の確認コード、認証リンク、サービスリンクなどの重要情報を自動抽出します +- [x] 指定したベースドメインに対して、ランダムな第 2 レベルサブドメインのメールボックスを任意で作成できます +- [x] `DKIM` 検証付きのメール送信に対応します +- [x] `SMTP` や `Resend` など、複数の送信方法に対応します +- [x] 添付ファイルの表示機能を備え、添付画像も表示できます +- [x] S3 での添付ファイルの保存と削除に対応します +- [x] スパム検出とブラックリスト／ホワイトリストの設定に対応します +- [x] グローバル転送先アドレスを指定できるメール転送機能を備えています + +### ユーザー管理 + +- [x] `credentials` を使用して、以前利用したメールボックスへ再ログインできます +- [x] 完全なユーザー登録・ログイン機能を備えています。メールアドレスを紐付けると、そのアドレスのメール JWT 資格情報を自動取得し、複数のメールボックスを切り替えられます +- [x] `OAuth2` によるサードパーティログイン（Github、Authentik など）に対応します +- [x] `Passkey` によるパスワードレスログインに対応します +- [x] 複数ロールのドメインおよびプレフィックスを設定できるユーザーロール管理に対応します +- [x] アドレスやキーワードで絞り込めるユーザー受信箱を提供します + +### 管理機能 + +- [x] 完全な admin コンソールを備えています +- [x] `admin` バックエンドからプレフィックスのないメールボックスを作成できます +- [x] admin ユーザー管理画面でユーザーのアドレスを確認できます +- [x] 複数のクリーンアップ戦略を選べる定期クリーンアップ機能を備えています +- [x] カスタム名のメールボックスを取得でき、`admin` でブラックリストを設定できます +- [x] アクセスパスワードを追加し、プライベートサイトとして利用できます + +### 多言語対応とインターフェース + +- [x] フロントエンドとバックエンドの両方が多言語に対応しています +- [x] レスポンシブレイアウトのモダンな UI デザインを採用しています +- [x] Google Ads の連携に対応します +- [x] shadow DOM を使用してスタイルの干渉を防ぎます +- [x] URL の JWT パラメーターによる自動ログインに対応します + +### 連携と拡張 + +- [x] 完全な `Telegram Bot`、`Telegram` プッシュ通知、Telegram Bot ミニアプリに対応します +- [x] `SMTP proxy server` を追加し、`SMTP` によるメール送信と `IMAP` によるメール閲覧に対応します +- [x] Webhook とメッセージプッシュ連携に対応します +- [x] `CF Turnstile` CAPTCHA 検証に対応します +- [x] 悪用を防ぐためのレート制限を設定できます +- [x] **Agent フレンドリー**：組み込みの [`cf-temp-mail-agent-mail`](skills/cf-temp-mail-agent-mail/SKILL.md) skill により、AI agent がメールボックスを直接利用できます。詳しくは[ドキュメント](vitepress-docs/docs/en/guide/feature/agent-email.md)を参照してください +- [x] コミュニティのモバイル管理クライアント：[CloudMail](https://github.com/Lur1N77777/CloudMail) は本プロジェクト互換の API 向けに Expo / React Native で構築されており、Android 管理コンソール、アドレス管理、受信済み／送信済み／不明メール、確認コードのクイックコピー、OLED ブラックテーマ、ローカルグループ分けを提供します + +
+ +## 技術アーキテクチャ + +
+技術アーキテクチャの詳細（クリックして展開／折りたたみ） + +### システム構成 + +- **データベース**：メインデータベースとして Cloudflare D1 を使用 +- **フロントエンドのデプロイ**：Cloudflare Pages を使用してフロントエンドをデプロイ +- **バックエンドのデプロイ**：Cloudflare Workers を使用してバックエンドをデプロイ +- **メールルーティング**：Cloudflare Email Routing を使用 + +### 技術スタック + +- **フロントエンド**：Vue 3 + Vite + TypeScript +- **バックエンド**：TypeScript + Cloudflare Workers +- **メール解析**：Rust WASM（mail-parser-wasm） +- **データベース**：Cloudflare D1（SQLite） +- **ストレージ**：Cloudflare KV + R2（任意で S3） +- **プロキシサービス**：Python SMTP/IMAP Proxy Server + +### 主要コンポーネント + +- **Worker**：中核となるバックエンドサービス +- **Frontend**：Vue 3 ユーザーインターフェース +- **Mail Parser WASM**：Rust メール解析モジュール +- **SMTP Proxy Server**：Python メールプロキシサービス +- **Pages Functions**：Cloudflare Pages ミドルウェア +- **Documentation**：VitePress ドキュメントサイト + +
+ +### 重要な注意事項 + +- Resend でドメインレコードを追加する際、DNS プロバイダーが第 3 レベルドメイン a.b.com をホストしている場合は、Resend が生成したデフォルト名から第 2 レベルドメインのプレフィックス b を削除してください。削除しないと a.b.b.com が追加され、検証に失敗します。レコードを追加した後、次のコマンドで確認できます。 +```bash +nslookup -qt="mx" a.b.com 1.1.1.1 +``` + +## コミュニティに参加 + +- [Telegram](https://t.me/cloudflare_temp_email)