クラウドファイル同期デスクトップアプリケーション
file-funeralは、ローカルファイルをAWS S3にバックアップ・同期するための、高速で安全なデスクトップアプリケーションです。複数PC間での双方向ファイル同期を主な用途とし、Dropboxのようなシンプルな操作性を提供します。
- ✅ 双方向同期: ローカルとクラウド間でファイルを自動的に同期
- ✅ AWS S3対応: AWS S3をバックエンドストレージとして使用
- ✅ 競合解決: ファイルの競合を自動検出し、両方のバージョンを保存
- ✅ 削除同期: ファイル削除を両方向で同期(同期履歴に基づく検出)
- ✅ 安全な認証: macOSキーチェーンを使用した認証情報の暗号化保存
- ✅ 視覚的な同期状態: ファイルごとの同期状態を一目で確認
- ✅ 自動同期: アプリ起動時・終了時の自動同期(設定可能)
- ✅ 同期履歴: SQLiteデータベースによる同期操作の履歴管理
- ✅ エラー処理: ネットワークエラーの自動リトライと詳細なエラーログ
(実装後にスクリーンショットを追加予定)
- 複数のMac間でのファイル共有
- ローカルファイルのクラウドバックアップ
- チーム内でのファイル同期(S3バケットを共有)
- 開発プロジェクトの同期(dotfilesなど)
- Backend: Rust + Tauri v2.9.5
- Frontend: React 19 + TypeScript 5.9 + Vite 7
- Cloud: AWS SDK for Rust (v1.0), 将来的にGCS、S3互換対応
- 開発ツール: ESLint, Clippy, Cargo Test
- Rust 1.92.0以降
- Node.js 18以降
- npm または pnpm
# リポジトリをクローン
git clone https://github.com/ohr486/file-funeral.git
cd file-funeral
# 依存関係をインストール
npm install
# Tauri CLIをインストール(グローバル)
cargo install tauri-clinpm run tauri:dev初回起動時は、Rustの依存関係のダウンロード・コンパイルに3-5分かかります。
# 開発サーバー起動
npm run tauri:dev
# ビルド
npm run tauri:build
# テスト実行
npm test
# Lint実行
npm run lint
# 自動修正
npm run lint:fix
# フォーマット
npm run format
# データベース確認
npm run db:inspect
# SQLite対話シェル
npm run db:shell- AWS Management Consoleにサインイン
- IAM(Identity and Access Management)に移動
- 新しいユーザーを作成、または既存のユーザーを選択
- 「AmazonS3FullAccess」ポリシーをアタッチ
- アクセスキーを生成し、以下の情報をコピー:
- Access Key ID(例:
AKIAIOSFODNN7EXAMPLE) - Secret Access Key(例:
wJalrXUtnFEMI/K7MDENG/...)
- Access Key ID(例:
- アプリを起動:
npm run tauri:dev - メイン画面右上の「Settings」ボタンをクリック
- AWS認証情報フォームに入力:
- Access Key ID: 取得したアクセスキーID
- Secret Access Key: 取得したシークレットアクセスキー
- Region: 使用するAWSリージョン(例:
us-east-1,ap-northeast-1) - S3 Bucket Name: 同期先のS3バケット名
- 「Save Credentials」ボタンをクリック
- 自動的に接続テストが実行され、成功すると「Connected successfully」と表示されます
認証情報はmacOSのキーチェーンに安全に保存されます。確認するには:
- Spotlight検索で「キーチェーンアクセス」を開く
- 左側で「ログイン」キーチェーンを選択
- 検索バーで「file-funeral」を検索
- AWS認証情報が暗号化されて保存されていることを確認できます
セキュリティ: 認証情報は平文では保存されず、macOSのキーチェーンAPIを使用して暗号化されます。
file-funeralは同期履歴をSQLiteデータベースに保存します。これにより削除検出やファイル変更の追跡が可能になります。
| 環境 | パス |
|---|---|
| 本番環境 | ~/.file-funeral/sync_history.db |
| テスト環境 | /tmp/.file-funeral-test-{PID}/sync_history.db |
# データベースの概要を表示
npm run db:inspect以下の情報が表示されます:
- スキーマバージョン
- 同期操作の総数
- 成功/失敗の統計
- 最新10件の同期履歴
- 追跡されているファイルの総数
# SQLite対話シェルを開く
npm run db:shellシェル内で使えるコマンド:
-- テーブル一覧を表示
.tables
-- スキーマを表示
.schema sync_history
-- カラム名を表示する設定
.headers on
.mode column
-- 最新の同期履歴を表示
SELECT id, datetime(sync_completed_at) as time,
files_uploaded, files_downloaded, files_deleted, success
FROM sync_history
ORDER BY sync_completed_at DESC
LIMIT 10;
-- 特定の同期のファイル一覧
SELECT file_path, file_size, was_local, was_remote
FROM synced_files
WHERE sync_history_id = 1;
-- 終了
.quit# テーブル一覧
sqlite3 ~/.file-funeral/sync_history.db ".tables"
# 最新5件の同期履歴
sqlite3 -header -column ~/.file-funeral/sync_history.db \
"SELECT id, datetime(sync_completed_at) as time,
files_uploaded as up, files_downloaded as down, files_deleted as del
FROM sync_history ORDER BY sync_completed_at DESC LIMIT 5;"
# 同期履歴の総数
sqlite3 ~/.file-funeral/sync_history.db \
"SELECT COUNT(*) FROM sync_history;"同期操作の履歴を記録します。
| カラム | 型 | 説明 |
|---|---|---|
| id | INTEGER | 主キー |
| sync_started_at | TEXT | 同期開始時刻 (RFC3339) |
| sync_completed_at | TEXT | 同期完了時刻 (RFC3339) |
| local_path | TEXT | ローカルパス |
| remote_prefix | TEXT | リモートプレフィックス |
| files_uploaded | INTEGER | アップロードされたファイル数 |
| files_downloaded | INTEGER | ダウンロードされたファイル数 |
| files_deleted | INTEGER | 削除されたファイル数 |
| conflicts_resolved | INTEGER | 解決された競合数 |
| success | INTEGER | 成功フラグ (0/1) |
| error_message | TEXT | エラーメッセージ(失敗時) |
最終同期時のファイル一覧を記録します(削除検出に使用)。
| カラム | 型 | 説明 |
|---|---|---|
| id | INTEGER | 主キー |
| sync_history_id | INTEGER | sync_historyテーブルへの外部キー |
| file_path | TEXT | ファイルパス |
| file_size | INTEGER | ファイルサイズ(バイト) |
| last_modified | TEXT | 最終更新日時 (RFC3339) |
| etag | TEXT | ETag(S3の場合) |
| was_local | INTEGER | ローカルに存在したか (0/1) |
| was_remote | INTEGER | リモートに存在したか (0/1) |
# CSV形式でエクスポート
sqlite3 -header -csv ~/.file-funeral/sync_history.db \
"SELECT * FROM sync_history;" > sync_history.csv
# JSON形式でエクスポート(jqが必要)
sqlite3 ~/.file-funeral/sync_history.db \
"SELECT json_object(
'id', id,
'completed', sync_completed_at,
'uploaded', files_uploaded,
'downloaded', files_downloaded
) FROM sync_history;" | jq -s '.'file-funeral/
├── src-tauri/ # Rustバックエンド
│ ├── src/
│ │ ├── main.rs # エントリポイント
│ │ ├── lib.rs # メインロジック
│ │ ├── commands.rs # Tauriコマンド
│ │ ├── auth/ # 認証情報管理
│ │ ├── storage/ # ストレージ抽象化層
│ │ ├── sync/ # 同期エンジン
│ │ └── db/ # データベース(SQLite)
│ ├── tests/ # 統合テスト
│ ├── Cargo.toml
│ └── clippy.toml
├── src/ # Reactフロントエンド
│ ├── App.tsx
│ ├── main.tsx
│ ├── components/ # Reactコンポーネント
│ ├── pages/ # ページコンポーネント
│ └── types/ # TypeScript型定義
├── scripts/ # ユーティリティスクリプト
│ └── inspect_db.sh # SQLiteデータベース確認スクリプト
├── ~/.file-funeral/ # アプリケーションデータ(ホームディレクトリ)
│ └── sync_history.db # 同期履歴データベース
├── REQUIREMENTS.md # 詳細要件定義
├── CLAUDE.md # 開発ガイド
└── TODO.md # 実装タスク一覧
- SETUP_GUIDE.md - 詳細なセットアップガイド
- TROUBLESHOOTING.md - トラブルシューティングガイド
- REQUIREMENTS.md - 詳細な要件定義
- ARCHITECTURE.md - システムアーキテクチャ
- API_REFERENCE.md - Tauri Commands APIリファレンス
- CONTRIBUTING.md - コントリビューションガイド
- CLAUDE.md - 開発ガイド(Claude Code用)
- TODO.md - 実装タスク一覧
- CHANGELOG.md - 変更履歴
コントリビューションを歓迎します!詳細はCONTRIBUTING.mdをご覧ください。
このプロジェクトはLICENSEの下でライセンスされています。
- Tauri - クロスプラットフォームデスクトップアプリフレームワーク
- AWS SDK for Rust - AWS S3統合
- React - UIフレームワーク