From 66ae9a38ea134607ecb32837bf580321ab9075c5 Mon Sep 17 00:00:00 2001 From: saltbo Date: Tue, 9 Jun 2026 15:25:17 -0400 Subject: [PATCH] docs(i18n): translate README and CHANGELOG into 6 languages Add zh-CN, ja, ko, ru, es, pt-BR translations under docs/i18n/, keeping the canonical English README/CHANGELOG at the repo root. Each file gets a language switcher bar with the current language bolded. Co-Authored-By: Claude Opus 4.8 (1M context) --- CHANGELOG.md | 12 ++ README.md | 10 ++ docs/i18n/CHANGELOG.es.md | 211 +++++++++++++++++++++++++++++++++++ docs/i18n/CHANGELOG.ja.md | 211 +++++++++++++++++++++++++++++++++++ docs/i18n/CHANGELOG.ko.md | 210 ++++++++++++++++++++++++++++++++++ docs/i18n/CHANGELOG.pt-BR.md | 211 +++++++++++++++++++++++++++++++++++ docs/i18n/CHANGELOG.ru.md | 211 +++++++++++++++++++++++++++++++++++ docs/i18n/CHANGELOG.zh-CN.md | 211 +++++++++++++++++++++++++++++++++++ docs/i18n/README.es.md | 176 +++++++++++++++++++++++++++++ docs/i18n/README.ja.md | 176 +++++++++++++++++++++++++++++ docs/i18n/README.ko.md | 176 +++++++++++++++++++++++++++++ docs/i18n/README.pt-BR.md | 176 +++++++++++++++++++++++++++++ docs/i18n/README.ru.md | 176 +++++++++++++++++++++++++++++ docs/i18n/README.zh-CN.md | 176 +++++++++++++++++++++++++++++ 14 files changed, 2343 insertions(+) create mode 100644 docs/i18n/CHANGELOG.es.md create mode 100644 docs/i18n/CHANGELOG.ja.md create mode 100644 docs/i18n/CHANGELOG.ko.md create mode 100644 docs/i18n/CHANGELOG.pt-BR.md create mode 100644 docs/i18n/CHANGELOG.ru.md create mode 100644 docs/i18n/CHANGELOG.zh-CN.md create mode 100644 docs/i18n/README.es.md create mode 100644 docs/i18n/README.ja.md create mode 100644 docs/i18n/README.ko.md create mode 100644 docs/i18n/README.pt-BR.md create mode 100644 docs/i18n/README.ru.md create mode 100644 docs/i18n/README.zh-CN.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 7573b5cd..231f7817 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,15 @@ +# Changelog + +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ ## v2.7.2 — 2026-06-07 ### Features diff --git a/README.md b/README.md index e01bd537..94e94578 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,16 @@ License

+

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ ## What is ZPan? ZPan is a lightweight file hosting platform built on top of S3-compatible storage. Files upload directly from the client to S3 through presigned URLs, bypassing server bandwidth entirely. The server is the control plane: auth, metadata, shares, quotas, teams, WebDAV, tool integrations, and admin operations. diff --git a/docs/i18n/CHANGELOG.es.md b/docs/i18n/CHANGELOG.es.md new file mode 100644 index 00000000..badaa745 --- /dev/null +++ b/docs/i18n/CHANGELOG.es.md @@ -0,0 +1,211 @@ +# Registro de cambios + +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## v2.7.2 — 2026-06-07 + +### Funcionalidades +- Logo y marca de ZPan renovados. + +### Correcciones +- El volumen de datos del descargador remoto ahora es escribible en Docker. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.2) + +## v2.7.1 — 2026-06-07 + +### Funcionalidades +- Renombra tus descargadores remotos desde la interfaz de administración. + +### Correcciones +- Asignación de descargadores más fiable e informes precisos de velocidad de transferencia. +- Exposición del puerto de escucha de torrents y uso del nombre de host del anfitrión para los descargadores en Docker. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.1) + +## v2.7.0 — 2026-06-06 · Descargas remotas, WebDAV y más + +### Funcionalidades +- **Gestor de descargas remotas** — delega las descargas de torrent/HTTP a workers remotos, + con un inspector detallado de tareas, geo-regiones de pares, retención de semillas BT y + subidas que preservan las carpetas de vuelta a tu unidad. +- **Descargador con CLI `zpan`** — inicio de sesión de dispositivo con un solo comando y una URL de servidor configurable. +- **Acceso WebDAV** — monta tu unidad mediante WebDAV con contraseñas de aplicación por usuario + (compatible con RFC 4918 Clase 2). +- **Archivado del lado del servidor** — encola trabajos de ZIP en streaming y haz un seguimiento en una nueva + página de tareas en segundo plano. +- **Subidas de carpetas** en la interfaz web. +- **Créditos en la nube** — egreso de almacenamiento medido y facturado mediante créditos, con una tienda de créditos. +- Protección con **Captcha** para el inicio de sesión y el registro. +- Gestión unificada de claves de API. + +### Correcciones +- Endurecimiento del ciclo de vida de las descargas remotas (reinicios, recuperación y gestión de semillas), + además de varias correcciones de vista previa y subida. + +> **Cambio incompatible:** rutas de API RESTful más estrictas; los enlaces de descarga públicos se movieron de +> `/dl/:token` a `/r/:token`. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.0) + +## v2.6.2 — 2026-05-11 + +### Funcionalidades +- Administración: panel lateral con los detalles de los pedidos en la nube. + +### Correcciones +- Diseño de la tabla de planes de almacenamiento, enmascaramiento de tarjetas de regalo y diálogos de pago/historial de pedidos. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.2) + +## v2.6.1 — 2026-05-10 + +### Correcciones +- Flujo de redirección de pago y visualización de la cuota de almacenamiento en la barra lateral. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.1) + +## v2.6.0 — 2026-05-10 · Licencias Pro y tienda de cuotas + +### Funcionalidades +- **Licencias Pro** — vincula tu instancia con ZPan Cloud (QR + modal de emparejamiento), + derechos verificados con Ed25519 con actualización en segundo plano, y control de acceso a funciones Pro. +- **Marca de etiqueta blanca** — logo, favicon, logotipo de texto personalizados y pie de página oculto. +- **Tienda de cuotas** — códigos de canje, cuotas mensuales de tráfico, paquetes de suscripción y + de cuota fija, precios medidos por moneda, y excedente de tráfico. +- **Administración** — registros de auditoría de las acciones que cambian el estado, anuncios del sitio, + registro basado en invitaciones, y un panel de configuración y resumen rediseñado. +- La vista previa de archivos gana un visor de Microsoft Office, un reproductor de música y una cola de + progreso de subida de múltiples archivos. + +### Correcciones +- Se movió la facturación al panel de administración; unidades de cuota, cuotas de usuario y avatares en administración. +- Sincronización en segundo plano del uso de tráfico en la nube; aplicación del tráfico mensual en los enlaces de descarga. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.0) + +## v2.5.0 — 2026-04-23 · Despliega en cualquier lugar + +### Funcionalidades +- **Nuevos destinos de despliegue** — AWS Lambda, Vercel, Netlify, Azure Functions y + Google Cloud Run. +- Adaptador de base de datos **libSQL (Turso)**, con una configuración opcional de Docker. +- Subida de avatar en Configuración → Perfil. +- Preferencia por el binding de Cloudflare R2 para las subidas de imágenes, con respaldo a S3. + +### Correcciones +- Se unificó el diseño visual entre las pestañas de configuración y se añadió la i18n de avatar que faltaba. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.5.0) + +## v2.4.1 — 2026-04-22 + +### Correcciones +- Se resolvió un error 404 de Docker en el puerto 8222 y se simplificó la construcción de la imagen. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.1) + +## v2.4.0 — 2026-04-22 · Alojamiento de imágenes + +### Funcionalidades +- **Alojamiento de imágenes** — una galería dedicada con subidas en dos etapas / proxy de streaming, + dominios personalizados (Cloudflare for SaaS) y una página de configuración. +- **Integraciones de herramientas** — configuraciones listas para usar para PicGo, uPic y ShareX. +- Autenticación con clave de API para subidas programáticas. + +### Correcciones +- Se corrigieron las configuraciones de PicGo / uPic / ShareX, el filtrado de imágenes en borrador y + los errores de subida de archivos grandes/multipartes. + +> **Cambio incompatible:** enlaces públicos unificados bajo `/r/:token`. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.0) + +## v2.3.0 — 2026-04-21 · Uso compartido + +### Funcionalidades +- **Uso compartido de archivos y carpetas** — páginas de uso compartido públicas (`/s/:token`) con modos de + aterrizaje y directo, contraseñas autogeneradas opcionales, y navegación de carpetas. +- **Guardar en la unidad** — copia archivos compartidos entre espacios de trabajo con gestión de cuotas y + de conflictos de nombres. +- **Notificaciones dentro de la aplicación** y un panel de Recursos compartidos dedicado. +- Rediseño de la interfaz con la paleta de Google; la campana de notificaciones se movió a la cabecera. + +### Correcciones +- Resolución de conflictos de nombres al estilo Finder, un 403 correcto cuando las contraseñas de uso compartido son erróneas, + y conteos de visualizaciones públicas deduplicados. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.3.0) + +## v2.2.0 — 2026-04-19 · Equipos + +### Funcionalidades +- **Espacios de trabajo de equipo** — crea y gestiona equipos, miembros y roles con + RBAC a nivel de organización. +- Selector de espacio de trabajo en la barra lateral y un feed de actividad por equipo. +- **Invitaciones de equipo** mediante correo electrónico y enlace de invitación. +- Página de inicio pública de usuario en `/u/:username`. + +### Correcciones +- Filtrado de la lista de equipos y conteos de miembros; se movió la entrada de Equipos al menú del avatar. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.2.0) + +## v2.1.0 — 2026-04-14 · Autenticación e incorporación + +### Funcionalidades +- **Proveedores de OAuth dinámicos**, correo/contraseña con verificación, y modos de + registro configurables. +- Control de registro mediante **código de invitación**. +- Abstracción del servicio de correo electrónico (controladores SMTP + HTTP API). +- Renovación de la interfaz de inicio de sesión / registro y una página de configuración de autenticación de administración. + +### Correcciones +- Validación de códigos de invitación y renderizado del modo oscuro en la barra lateral. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.1.0) + +## v2.0.2 — 2026-04-12 + +### Funcionalidades +- Diseño responsivo para escritorio, tableta y móvil, con vista previa adaptativa en móvil. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.2) + +## v2.0.1 — 2026-04-12 + +### Funcionalidades +- Migración a Cloudflare Workers con un botón de despliegue en un solo clic. + +### Correcciones +- Configuración de despliegue y autenticación para Cloudflare Workers (inferencia de baseURL/orígenes + de confianza, `nodejs_compat_v2`). + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.1) + +## v2.0.0 — 2026-04-12 · Reescritura en TypeScript + +### Funcionalidades +- Reescritura completa de Go a TypeScript: una API de Hono + SPA de React, desplegable en + tanto Cloudflare Workers como Node/Docker. +- Subidas directas a S3 mediante URLs prefirmadas, un gestor de archivos personalizado con árbol de carpetas, + búsqueda y una papelera de reciclaje. +- Vista previa de archivos para imágenes, PDF, código, audio y video. +- Gestión de usuarios / almacenamiento / cuotas de administración, cuotas de almacenamiento por organización, e i18n (en/zh). + +### Correcciones +- Búsqueda global del lado del servidor (se activa con Enter) y renderizado de vistas previas multimedia. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.0) + +--- + +Para el registro de cambios de la v1, consulta la [rama v1](https://github.com/saltbo/zpan/tree/v1/CHANGELOG.md). diff --git a/docs/i18n/CHANGELOG.ja.md b/docs/i18n/CHANGELOG.ja.md new file mode 100644 index 00000000..28ce0321 --- /dev/null +++ b/docs/i18n/CHANGELOG.ja.md @@ -0,0 +1,211 @@ +# Changelog + +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## v2.7.2 — 2026-06-07 + +### 新機能 +- ZPan のロゴとブランディングを刷新。 + +### 修正 +- リモートダウンローダーのデータボリュームが Docker で書き込み可能になりました。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.2) + +## v2.7.1 — 2026-06-07 + +### 新機能 +- 管理 UI からリモートダウンローダーの名前を変更できるようになりました。 + +### 修正 +- ダウンローダーの割り当てをより確実にし、転送速度のレポートを正確化。 +- torrent のリッスンポートを公開し、Docker のダウンローダーでホストのホスト名を使用するようにしました。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.1) + +## v2.7.0 — 2026-06-06 · リモートダウンロード、WebDAV ほか + +### 新機能 +- **リモートダウンロードマネージャー** — torrent/HTTP ダウンロードをリモートワーカーへオフロードし、 + 詳細なタスクインスペクター、ピアの地理的リージョン、BT のシード保持、 + ドライブへフォルダ構造を保ったままアップロードする機能を提供。 +- **`zpan` CLI ダウンローダー** — ワンコマンドのデバイスログインと設定可能なサーバー URL。 +- **WebDAV アクセス** — ユーザーごとのアプリパスワードで WebDAV 経由でドライブをマウント + （RFC 4918 Class 2 互換）。 +- **サーバーサイドアーカイブ** — ストリーミング ZIP ジョブをキューに入れ、新しい + バックグラウンドタスクページで追跡。 +- ウェブ UI での**フォルダアップロード**。 +- **クラウドクレジット** — クレジットで課金される従量制のストレージ送信、クレジットストア付き。 +- サインインとサインアップ向けの **Captcha** 保護。 +- 統一された API キー管理。 + +### 修正 +- リモートダウンロードのライフサイクル（リセット、リカバリー、シード処理）を堅牢化し、 + プレビューとアップロードに関する各種修正を実施。 + +> **破壊的変更：** より厳格な RESTful API ルート。公開ダウンロードリンクが +> `/dl/:token` から `/r/:token` へ移動。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.0) + +## v2.6.2 — 2026-05-11 + +### 新機能 +- 管理：クラウド注文詳細ドロワー。 + +### 修正 +- ストレージプランのテーブルレイアウト、ギフトカードのマスキング、チェックアウト/注文履歴ダイアログ。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.2) + +## v2.6.1 — 2026-05-10 + +### 修正 +- チェックアウトのリダイレクトフローと、サイドバーのストレージクォータ表示。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.1) + +## v2.6.0 — 2026-05-10 · Pro ライセンスとクォータストア + +### 新機能 +- **Pro ライセンス** — インスタンスを ZPan Cloud とペアリング（QR + ペアリングモーダル）、 + Ed25519 で検証されたエンタイトルメントとバックグラウンド更新、そして Pro 機能のゲーティング。 +- **ホワイトラベルブランディング** — カスタムロゴ、ファビコン、ワードマーク、フッターの非表示。 +- **クォータストア** — 引き換えコード、月間トラフィッククォータ、サブスクリプションおよび + 固定クォータパッケージ、通貨ごとの従量制価格、トラフィック超過課金。 +- **管理** — 状態を変更する操作にまたがる監査ログ、サイトのお知らせ、 + 招待ベースのサインアップ、再設計された設定と概要ダッシュボード。 +- ファイルプレビューに Microsoft Office ビューア、音楽プレーヤー、複数ファイルの + アップロード進捗キューを追加。 + +### 修正 +- Billing を管理パネルへ移動。管理画面でのクォータ単位、ユーザークォータ、アバター。 +- クラウドのトラフィック使用量をバックグラウンド同期。ダウンロードリンクで月間トラフィックを強制。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.0) + +## v2.5.0 — 2026-04-23 · どこへでもデプロイ + +### 新機能 +- **新しいデプロイ先** — AWS Lambda、Vercel、Netlify、Azure Functions、 + Google Cloud Run。 +- **libSQL（Turso）** データベースアダプター、オプトイン式の Docker 構成付き。 +- Settings → Profile でのアバターアップロード。 +- 画像アップロードに Cloudflare R2 バインディングを優先し、S3 へフォールバック。 + +### 修正 +- 設定タブ全体のビジュアルデザインを統一し、不足していたアバターの i18n を追加。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.5.0) + +## v2.4.1 — 2026-04-22 + +### 修正 +- ポート 8222 での Docker 404 を解消し、イメージビルドを簡素化。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.1) + +## v2.4.0 — 2026-04-22 · 画像ホスティング + +### 新機能 +- **画像ホスティング** — 二段階/ストリームプロキシアップロード、カスタムドメイン + （Cloudflare for SaaS）、設定ページを備えた専用ギャラリー。 +- **ツール連携** — PicGo、uPic、ShareX 向けの既製設定。 +- プログラムによるアップロードのための API キー認証。 + +### 修正 +- PicGo / uPic / ShareX の設定、下書き画像のフィルタリング、 + 大容量/マルチパートアップロードのエラーを修正。 + +> **破壊的変更：** 公開リンクを `/r/:token` の下に統一。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.0) + +## v2.3.0 — 2026-04-21 · 共有 + +### 新機能 +- **ファイル＆フォルダ共有** — ランディングモードとダイレクトモードを備えた + 公開共有ページ（`/s/:token`）、任意で自動生成されるパスワード、フォルダブラウジング。 +- **ドライブへ保存** — クォータと名前の競合を処理しながら、ワークスペース間で + 共有ファイルをコピー。 +- **アプリ内通知**と専用の Shares ダッシュボード。 +- Google パレットの UI 再設計。通知ベルをヘッダーへ移動。 + +### 修正 +- Finder スタイルの名前競合解決、共有パスワード誤りでの正しい 403、 + 公開ビューカウントの重複排除。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.3.0) + +## v2.2.0 — 2026-04-19 · チーム + +### 新機能 +- **チームワークスペース** — 組織レベルの RBAC でチーム、メンバー、ロールを + 作成・管理。 +- サイドバーのワークスペース切り替えと、チームごとのアクティビティフィード。 +- メールと招待リンクによる**チーム招待**。 +- `/u/:username` の公開ユーザーホームページ。 + +### 修正 +- チームリストのフィルタリングとメンバー数。Teams エントリをアバターメニューへ移動。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.2.0) + +## v2.1.0 — 2026-04-14 · 認証とオンボーディング + +### 新機能 +- **動的 OAuth プロバイダー**、検証付きのメール/パスワード、設定可能な + 登録モード。 +- **招待コード**による登録ゲーティング。 +- メールサービスの抽象化（SMTP + HTTP API ドライバー）。 +- サインイン/サインアップ UI の刷新と、管理者向け認証設定ページ。 + +### 修正 +- 招待コードの検証と、サイドバーのダークモード描画。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.1.0) + +## v2.0.2 — 2026-04-12 + +### 新機能 +- デスクトップ、タブレット、モバイル向けのレスポンシブレイアウトと、適応的なモバイルプレビュー。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.2) + +## v2.0.1 — 2026-04-12 + +### 新機能 +- ワンクリックデプロイボタンを備えた Cloudflare Workers への移行。 + +### 修正 +- Cloudflare Workers のデプロイと認証設定（baseURL/trusted + origins の推論、`nodejs_compat_v2`）。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.1) + +## v2.0.0 — 2026-04-12 · TypeScript への書き直し + +### 新機能 +- Go から TypeScript への完全な書き直し：Hono API + React SPA で、 + Cloudflare Workers と Node/Docker の両方にデプロイ可能。 +- presigned URL による S3 への直接アップロード、フォルダツリー、検索、 + ゴミ箱を備えたカスタムファイルマネージャー。 +- 画像、PDF、コード、音声、動画のファイルプレビュー。 +- 管理者向けのユーザー/ストレージ/クォータ管理、組織ごとのストレージクォータ、i18n（en/zh）。 + +### 修正 +- サーバーサイドのグローバル検索（Enter でトリガー）とメディアプレビューの描画。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.0) + +--- + +v1 の変更履歴については [v1 ブランチ](https://github.com/saltbo/zpan/tree/v1/CHANGELOG.md) を参照してください。 diff --git a/docs/i18n/CHANGELOG.ko.md b/docs/i18n/CHANGELOG.ko.md new file mode 100644 index 00000000..970f8d3d --- /dev/null +++ b/docs/i18n/CHANGELOG.ko.md @@ -0,0 +1,210 @@ +# 변경 이력 + +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## v2.7.2 — 2026-06-07 + +### 기능 +- ZPan 로고와 브랜딩을 새롭게 단장했습니다. + +### 수정 +- 원격 다운로더의 데이터 볼륨이 이제 Docker에서 쓰기 가능합니다. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.2) + +## v2.7.1 — 2026-06-07 + +### 기능 +- 관리 UI에서 원격 다운로더의 이름을 변경할 수 있습니다. + +### 수정 +- 더 안정적인 다운로더 할당과 정확한 전송 속도 보고. +- 토렌트 수신 포트를 노출하고 Docker에서 다운로더에 호스트 호스트명을 사용합니다. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.1) + +## v2.7.0 — 2026-06-06 · 원격 다운로드, WebDAV 등 + +### 기능 +- **원격 다운로드 관리자** — 토렌트/HTTP 다운로드를 원격 워커로 오프로드하며, + 상세한 작업 검사기, 피어 지역 정보, BT 시드 보존, 그리고 폴더 구조를 유지하는 + 드라이브 업로드를 제공합니다. +- **`zpan` CLI 다운로더** — 원커맨드 디바이스 로그인과 구성 가능한 서버 URL. +- **WebDAV 접근** — 사용자별 앱 비밀번호로 드라이브를 WebDAV로 마운트합니다 + (RFC 4918 Class 2 호환). +- **서버 측 아카이빙** — 스트리밍 ZIP 작업을 큐에 넣고 새로운 백그라운드 작업 + 페이지에서 추적합니다. +- 웹 UI의 **폴더 업로드**. +- **클라우드 크레딧** — 크레딧을 통해 청구되는 종량제 스토리지 송신과 크레딧 스토어. +- 로그인 및 회원가입을 위한 **캡차** 보호. +- 통합된 API 키 관리. + +### 수정 +- 원격 다운로드 수명 주기(초기화, 복구, 시드 처리)를 강화하고, + 다양한 미리보기 및 업로드 문제를 수정했습니다. + +> **호환성 변경:** 더 엄격한 RESTful API 라우트; 공개 다운로드 링크가 +> `/dl/:token`에서 `/r/:token`으로 이동했습니다. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.0) + +## v2.6.2 — 2026-05-11 + +### 기능 +- 관리자: 클라우드 주문 상세 드로어. + +### 수정 +- 스토리지 요금제 표 레이아웃, 기프트 카드 마스킹, 결제/주문 내역 대화상자. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.2) + +## v2.6.1 — 2026-05-10 + +### 수정 +- 결제 리디렉션 흐름과 사이드바 스토리지 할당량 표시. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.1) + +## v2.6.0 — 2026-05-10 · Pro 라이선스 및 할당량 스토어 + +### 기능 +- **Pro 라이선스** — 인스턴스를 ZPan Cloud와 페어링(QR + 페어링 모달), + Ed25519로 검증되는 권한과 백그라운드 갱신, 그리고 Pro 기능 게이팅. +- **화이트 라벨 브랜딩** — 커스텀 로고, 파비콘, 워드마크, 숨김 푸터. +- **할당량 스토어** — 교환 코드, 월간 트래픽 할당량, 구독형 및 고정 할당량 + 패키지, 통화별 종량제 가격, 트래픽 초과분. +- **관리자** — 상태 변경 작업 전반의 감사 로그, 사이트 공지, 초대 기반 + 가입, 그리고 재설계된 설정 및 개요 대시보드. +- 파일 미리보기에 Microsoft Office 뷰어, 음악 플레이어, 다중 파일 업로드 + 진행 큐가 추가되었습니다. + +### 수정 +- 결제를 관리 패널로 이동; 관리자의 할당량 단위, 사용자 할당량, 아바타. +- 클라우드 트래픽 사용량의 백그라운드 동기화; 다운로드 링크에 월간 트래픽 적용. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.0) + +## v2.5.0 — 2026-04-23 · 어디서나 배포 + +### 기능 +- **새로운 배포 대상** — AWS Lambda, Vercel, Netlify, Azure Functions, + Google Cloud Run. +- **libSQL (Turso)** 데이터베이스 어댑터와 선택적 Docker 구성. +- 설정 → 프로필에서 아바타 업로드. +- 이미지 업로드 시 Cloudflare R2 바인딩을 우선 사용하고 S3로 폴백. + +### 수정 +- 설정 탭 전반의 시각적 디자인을 통일하고 누락된 아바타 i18n을 추가했습니다. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.5.0) + +## v2.4.1 — 2026-04-22 + +### 수정 +- 8222 포트의 Docker 404 문제를 해결하고 이미지 빌드를 단순화했습니다. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.1) + +## v2.4.0 — 2026-04-22 · 이미지 호스팅 + +### 기능 +- **이미지 호스팅** — 2단계 / 스트림 프록시 업로드, 커스텀 도메인 + (Cloudflare for SaaS), 설정 페이지를 갖춘 전용 갤러리. +- **도구 연동** — PicGo, uPic, ShareX를 위한 즉시 사용 가능한 구성. +- 프로그래밍 방식 업로드를 위한 API 키 인증. + +### 수정 +- PicGo / uPic / ShareX 구성, 초안 이미지 필터링, 대용량/멀티파트 + 업로드 오류를 수정했습니다. + +> **호환성 변경:** 공개 링크가 `/r/:token`으로 통일되었습니다. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.0) + +## v2.3.0 — 2026-04-21 · 공유 + +### 기능 +- **파일 및 폴더 공유** — 랜딩 및 직접 모드를 갖춘 공개 공유 페이지 + (`/s/:token`), 선택적 자동 생성 비밀번호, 폴더 탐색. +- **드라이브에 저장** — 할당량 및 이름 충돌 처리와 함께 워크스페이스 간 + 공유 파일 복사. +- **인앱 알림**과 전용 공유 대시보드. +- Google 팔레트 UI 재설계; 알림 벨을 헤더로 이동. + +### 수정 +- Finder 스타일 이름 충돌 해결, 잘못된 공유 비밀번호에 대한 올바른 403, + 중복 제거된 공개 조회수. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.3.0) + +## v2.2.0 — 2026-04-19 · 팀 + +### 기능 +- **팀 워크스페이스** — 조직 수준 RBAC로 팀, 멤버, 역할을 생성하고 관리합니다. +- 사이드바의 워크스페이스 전환기와 팀별 활동 피드. +- 이메일 및 초대 링크를 통한 **팀 초대**. +- `/u/:username`의 공개 사용자 홈페이지. + +### 수정 +- 팀 목록 필터링과 멤버 수; Teams 항목을 아바타 메뉴로 이동. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.2.0) + +## v2.1.0 — 2026-04-14 · 인증 및 온보딩 + +### 기능 +- **동적 OAuth 제공자**, 검증을 포함한 이메일/비밀번호, 구성 가능한 + 가입 모드. +- **초대 코드** 기반 가입 제한. +- 이메일 서비스 추상화 (SMTP + HTTP API 드라이버). +- 로그인 / 회원가입 UI 개편과 관리자 인증 설정 페이지. + +### 수정 +- 초대 코드 검증과 사이드바 다크 모드 렌더링. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.1.0) + +## v2.0.2 — 2026-04-12 + +### 기능 +- 데스크톱, 태블릿, 모바일을 위한 반응형 레이아웃과 적응형 모바일 미리보기. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.2) + +## v2.0.1 — 2026-04-12 + +### 기능 +- 원클릭 배포 버튼과 함께 Cloudflare Workers로 마이그레이션. + +### 수정 +- Cloudflare Workers를 위한 배포 및 인증 구성 (baseURL/신뢰할 수 있는 + 오리진 추론, `nodejs_compat_v2`). + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.1) + +## v2.0.0 — 2026-04-12 · TypeScript 재작성 + +### 기능 +- Go에서 TypeScript로 완전 재작성: Hono API + React SPA로, Cloudflare + Workers와 Node/Docker 양쪽에 배포 가능. +- presigned URL을 통한 S3 직접 업로드, 폴더 트리·검색·휴지통을 갖춘 + 커스텀 파일 관리자. +- 이미지, PDF, 코드, 오디오, 비디오 파일 미리보기. +- 관리자 사용자 / 스토리지 / 할당량 관리, 조직별 스토리지 할당량, i18n (en/zh). + +### 수정 +- 서버 측 전역 검색(Enter로 실행)과 미디어 미리보기 렌더링. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.0) + +--- + +v1 변경 이력은 [v1 브랜치](https://github.com/saltbo/zpan/tree/v1/CHANGELOG.md)를 참고하세요. diff --git a/docs/i18n/CHANGELOG.pt-BR.md b/docs/i18n/CHANGELOG.pt-BR.md new file mode 100644 index 00000000..1b575dc3 --- /dev/null +++ b/docs/i18n/CHANGELOG.pt-BR.md @@ -0,0 +1,211 @@ +# Changelog + +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## v2.7.2 — 2026-06-07 + +### Recursos +- Logo e identidade visual do ZPan renovados. + +### Correções +- O volume de dados do downloader remoto agora é gravável no Docker. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.2) + +## v2.7.1 — 2026-06-07 + +### Recursos +- Renomeie seus downloaders remotos pela interface administrativa. + +### Correções +- Atribuição de downloader mais confiável e relatório preciso de velocidade de transferência. +- Exposição da porta de escuta de torrent e uso do hostname do host para downloaders no Docker. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.1) + +## v2.7.0 — 2026-06-06 · Downloads remotos, WebDAV e mais + +### Recursos +- **Gerenciador de downloads remotos** — transfira downloads de torrent/HTTP para + workers remotos, com um inspetor detalhado de tarefas, geo-regiões de peers, + retenção de seeds BT e uploads de volta ao seu drive preservando as pastas. +- **Downloader CLI `zpan`** — login de dispositivo em um único comando e URL de servidor configurável. +- **Acesso WebDAV** — monte seu drive via WebDAV com senhas de aplicativo por usuário + (compatível com RFC 4918 Class 2). +- **Arquivamento no servidor** — enfileire jobs de ZIP em streaming e acompanhe-os em uma nova + página de tarefas em segundo plano. +- **Upload de pastas** na interface web. +- **Créditos de nuvem** — egress de armazenamento medido e cobrado via créditos, com uma loja de créditos. +- Proteção por **captcha** no login e no cadastro. +- Gerenciamento unificado de chaves de API. + +### Correções +- Endurecimento do ciclo de vida de download remoto (resets, recuperação e tratamento de seeds), + além de diversas correções de prévia e upload. + +> **Mudança incompatível:** rotas de API RESTful mais rigorosas; links públicos de download movidos de +> `/dl/:token` para `/r/:token`. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.0) + +## v2.6.2 — 2026-05-11 + +### Recursos +- Admin: drawer de detalhes de pedido de nuvem. + +### Correções +- Layout da tabela de planos de armazenamento, mascaramento de gift-card e diálogos de checkout/histórico de pedidos. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.2) + +## v2.6.1 — 2026-05-10 + +### Correções +- Fluxo de redirecionamento do checkout e exibição da cota de armazenamento na barra lateral. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.1) + +## v2.6.0 — 2026-05-10 · Licenciamento Pro e loja de cotas + +### Recursos +- **Licenciamento Pro** — pareie sua instância com o ZPan Cloud (modal de QR + pareamento), + direitos (entitlements) verificados por Ed25519 com atualização em segundo plano e gating de recursos Pro. +- **Identidade visual white-label** — logo, favicon, wordmark customizados e rodapé oculto. +- **Loja de cotas** — códigos de resgate, cotas mensais de tráfego, pacotes de assinatura e + de cota fixa, preços medidos por moeda e excedente de tráfego. +- **Admin** — logs de auditoria em ações que alteram estado, anúncios do site, + cadastro baseado em convite e um dashboard de configurações e visão geral redesenhado. +- A prévia de arquivos ganha um visualizador do Microsoft Office, um reprodutor de música e uma + fila de progresso de upload de múltiplos arquivos. + +### Correções +- Cobrança movida para o painel admin; unidades de cota, cotas de usuários e avatares no admin. +- Sincronização em segundo plano do uso de tráfego de nuvem; aplicação do tráfego mensal em links de download. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.0) + +## v2.5.0 — 2026-04-23 · Deploy em qualquer lugar + +### Recursos +- **Novos alvos de deploy** — AWS Lambda, Vercel, Netlify, Azure Functions e + Google Cloud Run. +- Adaptador de banco de dados **libSQL (Turso)**, com uma configuração Docker opcional. +- Upload de avatar em Settings → Profile. +- Preferência pelo binding do Cloudflare R2 para uploads de imagem, com fallback para o S3. + +### Correções +- Unificação do design visual entre as abas de configurações e adição de i18n de avatar que faltava. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.5.0) + +## v2.4.1 — 2026-04-22 + +### Correções +- Resolvido um 404 do Docker na porta 8222 e simplificada a build da imagem. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.1) + +## v2.4.0 — 2026-04-22 · Hospedagem de imagens + +### Recursos +- **Hospedagem de imagens** — uma galeria dedicada com uploads em dois estágios / stream-proxy, + domínios customizados (Cloudflare for SaaS) e uma página de configurações. +- **Integrações com ferramentas** — configurações prontas para PicGo, uPic e ShareX. +- Autenticação por chave de API para uploads programáticos. + +### Correções +- Corrigidas as configurações de PicGo / uPic / ShareX, a filtragem de imagens em rascunho e + os erros de upload grande/multipart. + +> **Mudança incompatível:** links públicos unificados sob `/r/:token`. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.0) + +## v2.3.0 — 2026-04-21 · Compartilhamento + +### Recursos +- **Compartilhamento de arquivos e pastas** — páginas públicas de compartilhamento (`/s/:token`) com modos + landing e direto, senhas geradas automaticamente opcionais e navegação por pastas. +- **Salvar no Drive** — copie arquivos compartilhados entre workspaces com tratamento de cota e + de conflito de nomes. +- **Notificações no app** e um dashboard de Compartilhamentos dedicado. +- Redesign de UI na paleta do Google; o sino de notificações movido para o cabeçalho. + +### Correções +- Resolução de conflito de nomes no estilo Finder, um 403 correto em senhas de compartilhamento erradas + e contagens de visualização pública deduplicadas. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.3.0) + +## v2.2.0 — 2026-04-19 · Equipes + +### Recursos +- **Workspaces de equipe** — crie e gerencie equipes, membros e papéis com + RBAC em nível de organização. +- Seletor de workspace na barra lateral e um feed de atividades por equipe. +- **Convites de equipe** via e-mail e link de convite. +- Página pública de usuário em `/u/:username`. + +### Correções +- Filtragem da lista de equipes e contagem de membros; entrada de Equipes movida para o menu do avatar. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.2.0) + +## v2.1.0 — 2026-04-14 · Autenticação e onboarding + +### Recursos +- **Provedores OAuth dinâmicos**, e-mail/senha com verificação e modos de + cadastro configuráveis. +- Controle de cadastro por **código de convite**. +- Abstração de serviço de e-mail (drivers SMTP + API HTTP). +- Reformulação da UI de login / cadastro e uma página admin de configurações de autenticação. + +### Correções +- Validação de código de convite e renderização da barra lateral no modo escuro. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.1.0) + +## v2.0.2 — 2026-04-12 + +### Recursos +- Layout responsivo para desktop, tablet e mobile, com prévia adaptativa em mobile. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.2) + +## v2.0.1 — 2026-04-12 + +### Recursos +- Migração para o Cloudflare Workers com um botão de deploy de um clique. + +### Correções +- Configuração de deploy e autenticação para Cloudflare Workers (inferência de baseURL/trusted + origins, `nodejs_compat_v2`). + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.1) + +## v2.0.0 — 2026-04-12 · Reescrita em TypeScript + +### Recursos +- Reescrita completa de Go para TypeScript: uma API Hono + SPA React, passível de deploy + tanto no Cloudflare Workers quanto no Node/Docker. +- Uploads diretos para o S3 via URLs pré-assinadas, um gerenciador de arquivos customizado com árvore de pastas, + busca e uma lixeira. +- Prévia de arquivos para imagens, PDF, código, áudio e vídeo. +- Gerenciamento admin de usuários / armazenamento / cotas, cotas de armazenamento por organização e i18n (en/zh). + +### Correções +- Busca global no servidor (acionada com Enter) e renderização de prévia de mídia. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.0) + +--- + +Para o changelog da v1, veja a [branch v1](https://github.com/saltbo/zpan/tree/v1/CHANGELOG.md). diff --git a/docs/i18n/CHANGELOG.ru.md b/docs/i18n/CHANGELOG.ru.md new file mode 100644 index 00000000..21f810b2 --- /dev/null +++ b/docs/i18n/CHANGELOG.ru.md @@ -0,0 +1,211 @@ +# Журнал изменений + +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## v2.7.2 — 2026-06-07 + +### Возможности +- Обновлённые логотип и брендинг ZPan. + +### Исправления +- Том данных удалённого загрузчика теперь доступен для записи в Docker. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.2) + +## v2.7.1 — 2026-06-07 + +### Возможности +- Переименование удалённых загрузчиков из административного интерфейса. + +### Исправления +- Более надёжное назначение загрузчиков и точное отображение скорости передачи. +- Открытие порта прослушивания торрентов и использование хостнейма хоста для загрузчиков в Docker. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.1) + +## v2.7.0 — 2026-06-06 · Удалённые загрузки, WebDAV и многое другое + +### Возможности +- **Менеджер удалённых загрузок** — перенаправляйте torrent/HTTP-загрузки на удалённые воркеры + с подробным инспектором задач, гео-регионами пиров, удержанием BT-сидов и + загрузкой обратно на ваш диск с сохранением структуры папок. +- **CLI-загрузчик `zpan`** — вход на устройстве одной командой и настраиваемый URL сервера. +- **Доступ по WebDAV** — монтируйте свой диск по WebDAV с персональными паролями приложений + (совместимо с RFC 4918 Class 2). +- **Серверное архивирование** — ставьте в очередь потоковые задачи ZIP и отслеживайте их на новой + странице фоновых задач. +- **Загрузка папок** в веб-интерфейсе. +- **Облачные кредиты** — тарифицируемый исходящий трафик хранилища, оплачиваемый кредитами, с магазином кредитов. +- **Капча** для защиты входа и регистрации. +- Унифицированное управление API-ключами. + +### Исправления +- Укреплён жизненный цикл удалённой загрузки (сбросы, восстановление и обработка сидов), + а также различные исправления предпросмотра и загрузки. + +> **Несовместимое изменение:** более строгие RESTful-маршруты API; публичные ссылки на загрузку перенесены с +> `/dl/:token` на `/r/:token`. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.0) + +## v2.6.2 — 2026-05-11 + +### Возможности +- Админ: выдвижная панель с деталями облачного заказа. + +### Исправления +- Вёрстка таблицы тарифов хранилища, маскирование подарочных карт и диалоги оформления заказа/истории заказов. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.2) + +## v2.6.1 — 2026-05-10 + +### Исправления +- Поток перенаправления при оформлении заказа и отображение квоты хранилища в боковой панели. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.1) + +## v2.6.0 — 2026-05-10 · Pro-лицензирование и магазин квот + +### Возможности +- **Pro-лицензирование** — свяжите свой экземпляр с ZPan Cloud (QR + модальное окно сопряжения), + права, проверенные через Ed25519, с фоновым обновлением, и ограничение доступа к Pro-функциям. +- **White-label брендинг** — собственный логотип, фавикон, текстовый логотип и скрытый футер. +- **Магазин квот** — коды погашения, ежемесячные квоты трафика, пакеты подписки и + фиксированных квот, тарификация по объёму в разных валютах и превышение трафика. +- **Админ** — журналы аудита по изменяющим состояние действиям, объявления на сайте, + регистрация по приглашениям и переработанная панель настроек и обзора. +- Предпросмотр файлов получил просмотрщик Microsoft Office, музыкальный плеер и + очередь прогресса загрузки нескольких файлов. + +### Исправления +- Раздел биллинга перенесён в административную панель; единицы квот, пользовательские квоты и аватары в админке. +- Фоновая синхронизация использования облачного трафика; контроль ежемесячного трафика на ссылках загрузки. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.0) + +## v2.5.0 — 2026-04-23 · Развёртывание где угодно + +### Возможности +- **Новые цели развёртывания** — AWS Lambda, Vercel, Netlify, Azure Functions и + Google Cloud Run. +- Адаптер базы данных **libSQL (Turso)** с опциональной конфигурацией Docker. +- Загрузка аватара в Settings → Profile. +- Предпочтение биндинга Cloudflare R2 для загрузки изображений с откатом на S3. + +### Исправления +- Унифицирован визуальный дизайн на вкладках настроек и добавлена недостающая локализация аватаров. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.5.0) + +## v2.4.1 — 2026-04-22 + +### Исправления +- Устранена ошибка Docker 404 на порту 8222 и упрощена сборка образа. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.1) + +## v2.4.0 — 2026-04-22 · Хостинг изображений + +### Возможности +- **Хостинг изображений** — отдельная галерея с двухэтапной / потоковой прокси-загрузкой, + собственными доменами (Cloudflare for SaaS) и страницей настроек. +- **Интеграции с инструментами** — готовые конфигурации для PicGo, uPic и ShareX. +- Аутентификация по API-ключу для программных загрузок. + +### Исправления +- Исправлены конфигурации PicGo / uPic / ShareX, фильтрация черновиков изображений и + ошибки больших/многосоставных загрузок. + +> **Несовместимое изменение:** публичные ссылки унифицированы под `/r/:token`. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.0) + +## v2.3.0 — 2026-04-21 · Общий доступ + +### Возможности +- **Общий доступ к файлам и папкам** — публичные страницы общего доступа (`/s/:token`) с режимами + лендинга и прямой ссылки, опциональными автоматически генерируемыми паролями и просмотром папок. +- **Сохранение на диск** — копирование общих файлов между рабочими пространствами с обработкой квот и + конфликтов имён. +- **Уведомления внутри приложения** и отдельная панель общего доступа. +- Редизайн интерфейса в палитре Google; колокольчик уведомлений перенесён в шапку. + +### Исправления +- Разрешение конфликтов имён в стиле Finder, корректный код 403 при неверном пароле общего доступа + и дедупликация счётчиков публичных просмотров. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.3.0) + +## v2.2.0 — 2026-04-19 · Команды + +### Возможности +- **Командные рабочие пространства** — создавайте команды, участников и роли и управляйте ими с + RBAC на уровне организации. +- Переключатель рабочих пространств в боковой панели и лента активности по каждой команде. +- **Приглашения в команду** по электронной почте и по ссылке-приглашению. +- Публичная домашняя страница пользователя по адресу `/u/:username`. + +### Исправления +- Фильтрация списка команд и подсчёт участников; вход в раздел команд перенесён в меню аватара. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.2.0) + +## v2.1.0 — 2026-04-14 · Аутентификация и онбординг + +### Возможности +- **Динамические OAuth-провайдеры**, email/пароль с подтверждением и настраиваемые + режимы регистрации. +- Ограничение регистрации по **инвайт-коду**. +- Абстракция почтового сервиса (драйверы SMTP + HTTP API). +- Переработка интерфейса входа / регистрации и страница административных настроек аутентификации. + +### Исправления +- Валидация инвайт-кода и отрисовка боковой панели в тёмной теме. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.1.0) + +## v2.0.2 — 2026-04-12 + +### Возможности +- Адаптивная вёрстка для настольных ПК, планшетов и мобильных устройств с адаптивным мобильным предпросмотром. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.2) + +## v2.0.1 — 2026-04-12 + +### Возможности +- Переход на Cloudflare Workers с кнопкой развёртывания в один клик. + +### Исправления +- Настройка развёртывания и аутентификации для Cloudflare Workers (определение baseURL/доверенных + источников, `nodejs_compat_v2`). + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.1) + +## v2.0.0 — 2026-04-12 · Переписывание на TypeScript + +### Возможности +- Полное переписывание с Go на TypeScript: API на Hono + React SPA, разворачиваемые + как на Cloudflare Workers, так и на Node/Docker. +- Прямые загрузки в S3 через предподписанные URL, собственный файловый менеджер с деревом папок, + поиском и корзиной. +- Предпросмотр файлов для изображений, PDF, кода, аудио и видео. +- Административное управление пользователями / хранилищем / квотами, квоты хранилища по организациям и локализация (en/zh). + +### Исправления +- Серверный глобальный поиск (срабатывает по Enter) и отрисовка предпросмотра медиа. + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.0) + +--- + +Журнал изменений v1 см. в [ветке v1](https://github.com/saltbo/zpan/tree/v1/CHANGELOG.md). diff --git a/docs/i18n/CHANGELOG.zh-CN.md b/docs/i18n/CHANGELOG.zh-CN.md new file mode 100644 index 00000000..31014a02 --- /dev/null +++ b/docs/i18n/CHANGELOG.zh-CN.md @@ -0,0 +1,211 @@ +# 更新日志 + +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## v2.7.2 — 2026-06-07 + +### 新功能 +- 全新的 ZPan logo 与品牌形象。 + +### 修复 +- 远程下载节点的数据卷现在在 Docker 中可写。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.2) + +## v2.7.1 — 2026-06-07 + +### 新功能 +- 可在管理界面中重命名你的远程下载节点。 + +### 修复 +- 更可靠的下载节点分配以及更准确的传输速度上报。 +- 暴露 torrent 监听端口，并在 Docker 中为下载节点使用宿主机主机名。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.1) + +## v2.7.0 — 2026-06-06 · 远程下载、WebDAV 及更多 + +### 新功能 +- **远程下载管理器** — 将 torrent/HTTP 下载卸载到远程节点， + 配有详尽的任务检视器、节点地理区域、BT 做种保留，以及 + 保留文件夹结构地回传到你的网盘。 +- **`zpan` CLI 下载器** — 一条命令完成设备登录，并支持自定义服务器 URL。 +- **WebDAV 访问** — 通过 WebDAV 挂载你的网盘，支持每用户应用密码 + （兼容 RFC 4918 Class 2）。 +- **服务端打包** — 将流式 ZIP 任务排入队列，并在全新的 + 后台任务页面中跟踪它们。 +- 在 Web 界面中支持**文件夹上传**。 +- **云端积分** — 计量的存储出口流量通过积分计费，并配有积分商店。 +- 为登录和注册提供**验证码**保护。 +- 统一的 API 密钥管理。 + +### 修复 +- 加固了远程下载的生命周期（重置、恢复和做种处理）， + 以及若干预览和上传修复。 + +> **破坏性变更：** 更严格的 RESTful API 路由；公开下载链接从 +> `/dl/:token` 改为 `/r/:token`。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.0) + +## v2.6.2 — 2026-05-11 + +### 新功能 +- 管理端：云端订单详情抽屉。 + +### 修复 +- 存储套餐表格布局、礼品卡掩码，以及结账/订单历史对话框。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.2) + +## v2.6.1 — 2026-05-10 + +### 修复 +- 结账跳转流程以及侧边栏存储配额显示。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.1) + +## v2.6.0 — 2026-05-10 · Pro 授权与配额商店 + +### 新功能 +- **Pro 授权** — 将你的实例与 ZPan Cloud 配对（二维码 + 配对弹窗）， + 基于 Ed25519 验证的权益并支持后台刷新，以及 Pro 功能门控。 +- **白标品牌** — 自定义 logo、favicon、文字标识，以及隐藏页脚。 +- **配额商店** — 兑换码、每月流量配额、订阅制与 + 固定配额套餐、按币种计量的定价，以及流量超额。 +- **管理端** — 覆盖状态变更操作的审计日志、站点公告、 + 基于邀请的注册，以及重新设计的设置与概览仪表盘。 +- 文件预览新增 Microsoft Office 查看器、音乐播放器，以及多文件 + 上传进度队列。 + +### 修复 +- 将计费移入管理面板；管理端中的配额单位、用户配额和头像。 +- 后台同步云端流量用量；对下载链接强制执行每月流量限制。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.6.0) + +## v2.5.0 — 2026-04-23 · 随处部署 + +### 新功能 +- **新的部署目标** — AWS Lambda、Vercel、Netlify、Azure Functions，以及 + Google Cloud Run。 +- **libSQL (Turso)** 数据库适配器，并提供可选的 Docker 配置。 +- 在设置 → 个人资料中支持头像上传。 +- 图片上传优先使用 Cloudflare R2 绑定，回退到 S3。 + +### 修复 +- 统一了各设置标签页的视觉设计，并补齐了缺失的头像 i18n。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.5.0) + +## v2.4.1 — 2026-04-22 + +### 修复 +- 解决了 Docker 在 8222 端口上的 404，并简化了镜像构建。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.1) + +## v2.4.0 — 2026-04-22 · 图床 + +### 新功能 +- **图床** — 专属图库，支持两阶段/流式代理上传、 + 自定义域名（Cloudflare for SaaS），以及设置页面。 +- **工具集成** — 为 PicGo、uPic 和 ShareX 提供开箱即用的配置。 +- 用于程序化上传的 API 密钥认证。 + +### 修复 +- 修正了 PicGo / uPic / ShareX 配置、草稿图片过滤，以及 + 大文件/分片上传错误。 + +> **破坏性变更：** 公开链接统一到 `/r/:token` 下。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.4.0) + +## v2.3.0 — 2026-04-21 · 分享 + +### 新功能 +- **文件与文件夹分享** — 公开分享页面（`/s/:token`），支持落地页与 + 直链模式、可选的自动生成密码，以及文件夹浏览。 +- **转存到网盘** — 跨工作区复制分享文件，并处理配额与 + 命名冲突。 +- **应用内通知**以及专属的分享仪表盘。 +- Google 配色 UI 重新设计；通知铃移至顶部栏。 + +### 修复 +- Finder 风格的命名冲突解决、分享密码错误时返回正确的 403， + 以及对公开浏览量去重。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.3.0) + +## v2.2.0 — 2026-04-19 · 团队 + +### 新功能 +- **团队工作区** — 创建和管理团队、成员和角色，配有 + 组织级 RBAC。 +- 侧边栏中的工作区切换器以及每团队活动流。 +- 通过邮件和邀请链接发起**团队邀请**。 +- 位于 `/u/:username` 的公开用户主页。 + +### 修复 +- 团队列表筛选与成员计数；将团队入口移入头像菜单。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.2.0) + +## v2.1.0 — 2026-04-14 · 认证与入门引导 + +### 新功能 +- **动态 OAuth 提供商**、带验证的邮箱/密码登录，以及可配置的 + 注册模式。 +- **邀请码**注册门控。 +- 邮件服务抽象（SMTP + HTTP API 驱动）。 +- 登录/注册 UI 大改版以及管理端认证设置页面。 + +### 修复 +- 邀请码校验以及侧边栏深色模式渲染。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.1.0) + +## v2.0.2 — 2026-04-12 + +### 新功能 +- 适配桌面、平板和移动端的响应式布局，并提供自适应的移动端预览。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.2) + +## v2.0.1 — 2026-04-12 + +### 新功能 +- 迁移到 Cloudflare Workers，并提供一键部署按钮。 + +### 修复 +- Cloudflare Workers 的部署与认证配置（baseURL/受信任 + 来源推断、`nodejs_compat_v2`）。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.1) + +## v2.0.0 — 2026-04-12 · TypeScript 重写 + +### 新功能 +- 从 Go 完全重写为 TypeScript：Hono API + React SPA，可同时部署在 + Cloudflare Workers 和 Node/Docker 上。 +- 通过预签名 URL 实现直传 S3，配有自定义文件管理器（含文件夹树、 + 搜索）以及回收站。 +- 支持图片、PDF、代码、音频和视频的文件预览。 +- 管理端用户/存储/配额管理、每组织存储配额，以及 i18n（en/zh）。 + +### 修复 +- 服务端全局搜索（按回车触发）以及媒体预览渲染。 + +[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.0.0) + +--- + +v1 的更新日志请查看 [v1 分支](https://github.com/saltbo/zpan/tree/v1/CHANGELOG.md)。 diff --git a/docs/i18n/README.es.md b/docs/i18n/README.es.md new file mode 100644 index 00000000..958bc77f --- /dev/null +++ b/docs/i18n/README.es.md @@ -0,0 +1,176 @@ +

+ ZPan logo +

+ +

ZPan

+ +

+ Alojamiento de archivos de código abierto para tu almacenamiento compatible con S3. +

+ +

+ Despliega en Cloudflare Workers o Docker. Sube directamente al almacenamiento de objetos. +

+ +

+ CI + codecov + Release + GitHub Release + Docker Image + License +

+ +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## ¿Qué es ZPan? + +ZPan es una plataforma ligera de alojamiento de archivos construida sobre almacenamiento compatible con S3. Los archivos se suben directamente desde el cliente a S3 mediante URLs prefirmadas, evitando por completo el ancho de banda del servidor. El servidor es el plano de control: autenticación, metadatos, recursos compartidos, cuotas, equipos, WebDAV, integraciones de herramientas y operaciones de administración. + +El límite del producto es intencional: ZPan es una unidad web respaldada por S3 diseñada con un propósito específico, no un envoltorio sobre cada unidad de nube de consumo ni una suite completa de software colaborativo. Tú aportas un bucket compatible con S3; ZPan le da una interfaz web limpia, uso compartido público, APIs de alojamiento de imágenes y opciones de despliegue que no requieren un VPS ni un NAS. + +**Escenarios principales:** + +- **Unidad web S3** — Gestiona archivos, carpetas, vistas previas, papelera, cuotas y espacios de trabajo de equipo sobre tu propio almacenamiento de objetos +- **Alojamiento de imágenes** — Sube mediante PicGo, PicList, uPic, ShareX, Flameshot o la API y obtén una URL estable al instante +- **Uso compartido de archivos** — Publica enlaces para compartir con contraseña, expiración, límites de descarga, enlaces directos y flujos de guardado en la unidad +- **Página de inicio personal** — Da a cada usuario una página pública `/u/username` con archivos compartidos curados y navegación estilo carpeta +- **Acceso externo** — Monta archivos mediante WebDAV y ejecuta workers de descarga para flujos de descarga remota + +## ¿Por qué ZPan? + +**Solo S3, por diseño.** ZPan no persigue a cada proveedor de disco en red ni construye una capa de anidamiento de unidades en la nube. El contrato de almacenamiento se mantiene simple y duradero: buckets compatibles con S3 como Cloudflare R2, AWS S3, Backblaze B2, MinIO, RustFS, Tigris y otros servicios compatibles con S3. + +**Cloudflare Workers primero.** ZPan está construido en torno a Cloudflare Workers, D1, Hono y APIs estándar de la web, con Docker y otros entornos de ejecución como destinos de despliegue adicionales. Puedes ejecutar un plano de control real de alojamiento de archivos sin poseer un VPS, sin mantener un NAS en línea ni redirigir las subidas a través de un servidor de larga ejecución. + +**Ruta de transferencia directa.** Las subidas y descargas usan URLs prefirmadas del almacenamiento de objetos siempre que sea posible. Eso mantiene bajo el ancho de banda del servidor, evita un cuello de botella central en la transferencia de archivos y deja que el almacenamiento de objetos haga el trabajo pesado. + +**Flujos de trabajo de archivos prácticos.** ZPan incluye un gestor de archivos web, uso compartido público, configuración de alojamiento de imágenes, claves de API, acceso WebDAV, equipos, cuotas, tareas de descarga remota, vistas previas de archivos y controles de administración sin convertirse en una plataforma de agregación de proveedores. + +**Workers de descarga desplegables.** La descarga remota no tiene por qué ejecutarse dentro de la instancia principal de ZPan. Puedes desplegar el descargador junto con ZPan para una configuración sencilla, o ejecutarlo por separado en un entorno con mejor acceso de red y menos restricciones del sitio de origen, y luego dejar que ZPan importe los archivos completados al almacenamiento de objetos. + +## Límites del producto + +ZPan encaja bien cuando quieres: + +- Una unidad web enfocada y respaldada por S3 en lugar de un zoológico de proveedores de almacenamiento +- Un alojamiento de imágenes y una aplicación de uso compartido de archivos autoalojados y respaldados por tu propio bucket +- Despliegue nativo en Cloudflare sin mantener un VPS ni un NAS +- Transferencias del navegador a S3 en lugar de la redirección de archivos a través del servidor de la aplicación +- Integraciones de herramientas para captura de pantalla, publicación, WebDAV, descarga remota y flujos de trabajo basados en API + +ZPan no intenta ser: + +- Una suite de coedición de documentos en tiempo real como Nextcloud Office +- Un agregador de unidades en la nube de propósito general como AList +- Un navegador de directorios de servidor local como File Browser + +## Cómo se compara ZPan + +La mayoría de los proyectos de archivos autoalojados parten de archivos del servidor, sincronización de escritorio, colaboración o agregación de muchos proveedores. ZPan parte del almacenamiento de objetos compatible con S3 y de un plano de control amigable con Cloudflare Workers. + +| Capacidad | **ZPan** | [Cloudreve](https://docs.cloudreve.org/en/) | [AList](https://alist-repo.github.io/docs/guide/drivers/) | [Nextcloud](https://nextcloud.com/files/) | [Seafile](https://www.seafile.com/en/features/) | [File Browser](https://github.com/filebrowser/filebrowser) | +|------------|----------|------------|--------|-----------|---------|--------------| +| Enfoque de producto respaldado por S3 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Backend de almacenamiento compatible con S3 | ✅ | ✅ | ✅ | ✅ | ⚠️ | ❌ | +| Ruta directa del navegador al almacenamiento de objetos | ✅ | ⚠️ | ⚠️ | ❌ | ❌ | ❌ | +| Despliegue en Cloudflare Workers | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Sin necesidad de VPS/NAS | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Flujo de alojamiento de imágenes PicGo/ShareX | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Página de inicio pública de archivos por usuario | ✅ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ❌ | +| Flujo de descarga remota | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | +| Descargador/nodo desplegable por separado | ✅ | ✅ | ⚠️ | ❌ | ❌ | ❌ | +| Agregación de múltiples discos en red | ❌ | ❌ | ✅ | ⚠️ | ❌ | ❌ | +| Directorio local del servidor como raíz de archivos principal | ❌ | ⚠️ | ⚠️ | ⚠️ | ❌ | ✅ | +| Coedición de documentos en tiempo real | ❌ | ❌ | ❌ | ✅ | ⚠️ | ❌ | +| Clientes de sincronización dedicados | Previsto | ❌ | ❌ | ✅ | ✅ | ❌ | +| Modelo de equipo/espacio de trabajo | ✅ | ⚠️ | ❌ | ✅ | ✅ | ❌ | +| Acceso WebDAV | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | +| Enlaces para compartir | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Despliegue con Docker | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | + +Leyenda: ✅ capacidad principal o de primera clase; ⚠️ parcial, dependiente de la edición, o no es el enfoque principal del producto; ❌ no es una capacidad principal. + +## Despliegue + +### Cloudflare Workers (Recomendado) + +Despliega mediante GitHub Actions sin gestión de servidores. El nivel gratuito cubre el uso personal. + +1. **Haz un fork** de este repositorio +2. En tu fork, ve a **Settings → Secrets and variables → Actions** y añade: + - `CLOUDFLARE_ACCOUNT_ID` — se encuentra en la barra lateral del [panel de Cloudflare](https://dash.cloudflare.com/) + - `CLOUDFLARE_API_TOKEN` — crea uno [aquí](https://dash.cloudflare.com/profile/api-tokens) con permisos de **Workers Scripts:Edit**, **D1:Edit** y **R2 Storage:Edit** (el alcance de R2 es necesario para aprovisionar automáticamente el bucket de avatar/logo) +3. Ve a la pestaña **Actions**, selecciona **Deploy to Cloudflare Workers** y haz clic en **Run workflow** + +Después de la configuración inicial, el flujo de trabajo se ejecuta automáticamente cada vez que sincronizas tu fork con la última versión. + +### AWS Lambda + +Despliega mediante GitHub Actions usando SAM. La Lambda Function URL proporciona HTTPS sin necesidad de API Gateway. + +1. **Haz un fork** de este repositorio +2. En tu fork, ve a **Settings → Secrets and variables → Actions** y añade: + - `TURSO_DATABASE_URL` y `TURSO_AUTH_TOKEN` — de [Turso](https://turso.tech) (gratis, sin tarjeta de crédito) + - `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION` +3. Ve a la pestaña **Actions**, selecciona **Deploy to AWS Lambda** y haz clic en **Run workflow** + +Consulta [docs/deploy/aws-lambda.md](../deploy/aws-lambda.md) para obtener las instrucciones completas de configuración y los permisos de IAM. + +### Docker + +**Inicio rápido** — descarga la imagen precompilada y aporta tu propio almacenamiento S3: + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.yml +docker compose up -d +``` + +**Con RustFS** (almacenamiento compatible con S3 autoalojado, sin dependencias externas): + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.rustfs.yml +docker compose -f docker-compose.rustfs.yml up -d +``` + +Tras el inicio: + +1. Abre la consola de RustFS en `http://localhost:9001` (admin / admin123) y crea un bucket (por ejemplo, `zpan-bucket`) +2. Abre ZPan en `http://localhost:8222`, registra un usuario (el primer usuario obtiene el rol de administrador) +3. Ve a **Admin → Storage** y añade el almacenamiento de RustFS: + - **Endpoint**: `http://localhost:9000` (debe ser accesible desde tu navegador, no el nombre de host interno de Docker) + - **Bucket**: el nombre del bucket que creaste en el paso 1 + - **Region**: `us-east-1` + - **Access Key / Secret Key**: `admin` / `admin123` + +> **Importante:** El endpoint de almacenamiento debe ser accesible desde el **navegador del cliente**, ya que los archivos se suben directamente a S3 mediante URLs prefirmadas. Usa `http://localhost:9000` para desarrollo local, o la URL pública de tu servidor para producción. + +## Documentación + +- [Hoja de ruta](../../V2_ROADMAP.md) +- [Contribuir](../../CONTRIBUTING.md) + +## v1 + +¿Buscas ZPan v1 (versión en Go)? Consulta la [rama v1](https://github.com/saltbo/zpan/tree/v1). + +## Contribuir + +Consulta [CONTRIBUTING.md](../../CONTRIBUTING.md) para más detalles. + +¡Gracias a todas las personas que han contribuido a ZPan! + + + +## Licencia + +ZPan se distribuye bajo la GNU Affero General Public License v3.0. Consulta el archivo +[LICENSE](../../LICENSE) para más detalles. diff --git a/docs/i18n/README.ja.md b/docs/i18n/README.ja.md new file mode 100644 index 00000000..dbaf8350 --- /dev/null +++ b/docs/i18n/README.ja.md @@ -0,0 +1,176 @@ +

+ ZPan logo +

+ +

ZPan

+ +

+ S3 互換ストレージのためのオープンソースなファイルホスティング。 +

+ +

+ Cloudflare Workers または Docker にデプロイ。オブジェクトストレージへ直接アップロード。 +

+ +

+ CI + codecov + Release + GitHub Release + Docker Image + License +

+ +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## ZPan とは？ + +ZPan は、S3 互換ストレージの上に構築された軽量なファイルホスティングプラットフォームです。ファイルは presigned URL を通じてクライアントから S3 へ直接アップロードされ、サーバーの帯域幅を完全に経由しません。サーバーはコントロールプレーンとして、認証、メタデータ、共有、クォータ、チーム、WebDAV、ツール連携、管理操作を担います。 + +製品としての境界は意図的に定めています。ZPan は S3 をバックエンドとする目的特化型のウェブドライブであり、あらゆるコンシューマー向けクラウドドライブをラップするものでも、フル機能のグループウェアスイートでもありません。あなたが S3 互換バケットを用意すれば、ZPan はそこに洗練されたウェブ UI、公開共有、画像ホスティング API、そして VPS や NAS を必要としないデプロイ手段を提供します。 + +**主なユースケース：** + +- **S3 ウェブドライブ** — 自分のオブジェクトストレージ上で、ファイル、フォルダ、プレビュー、ゴミ箱、クォータ、チームワークスペースを管理 +- **画像ホスティング** — PicGo、PicList、uPic、ShareX、Flameshot、または API 経由でアップロードし、安定した URL を即座に取得 +- **ファイル共有** — パスワード、有効期限、ダウンロード回数制限、ダイレクトリンク、ドライブへの保存フローを備えた共有リンクを公開 +- **個人ホームページ** — 各ユーザーに、厳選した共有ファイルとフォルダ形式のブラウジングが可能な公開ページ `/u/username` を提供 +- **外部アクセス** — WebDAV 経由でファイルをマウントし、リモートダウンロードワークフロー向けにダウンローダーワーカーを実行 + +## なぜ ZPan なのか？ + +**設計として S3 のみ。** ZPan はあらゆるネットディスクプロバイダーを追いかけたり、クラウドドライブのネスト層を構築したりはしません。ストレージの契約はシンプルで永続的なものに保たれます。Cloudflare R2、AWS S3、Backblaze B2、MinIO、RustFS、Tigris、その他の S3 互換サービスといった S3 互換バケットです。 + +**Cloudflare Workers ファースト。** ZPan は Cloudflare Workers、D1、Hono、そして Web 標準 API を中心に構築されており、Docker やその他のランタイムを追加のデプロイ先としています。VPS を所有したり、NAS を稼働させ続けたり、長時間稼働するサーバーを介してアップロードをプロキシしたりすることなく、本格的なファイルホスティングのコントロールプレーンを運用できます。 + +**ダイレクトな転送経路。** アップロードとダウンロードは可能な限り presigned なオブジェクトストレージ URL を使用します。これによりサーバーの帯域幅を抑え、中央集約的なファイル転送のボトルネックを回避し、重い処理をオブジェクトストレージに任せられます。 + +**実用的なファイルワークフロー。** ZPan は、ウェブファイルマネージャー、公開共有、画像ホスティング設定、API キー、WebDAV アクセス、チーム、クォータ、リモートダウンロードタスク、ファイルプレビュー、管理コントロールを備えており、プロバイダー集約型プラットフォームへと変貌することはありません。 + +**デプロイ可能なダウンローダーワーカー。** リモートダウンロードは、必ずしも ZPan 本体のインスタンス内で実行する必要はありません。シンプルな構成のために ZPan と一緒にダウンローダーをデプロイすることも、ネットワークアクセスが良好でソースサイトの制限が少ない環境に別途配置することもでき、その後 ZPan に完了したファイルをオブジェクトストレージへ取り込ませることができます。 + +## 製品の境界 + +ZPan は次のようなニーズに適しています： + +- ストレージプロバイダーの寄せ集めではなく、S3 をバックエンドとする目的特化型のウェブドライブが欲しい +- 自分自身のバケットを使った、セルフホスト型の画像ベッドとファイル共有アプリが欲しい +- VPS や NAS を維持せずに Cloudflare ネイティブなデプロイがしたい +- アプリサーバーによるファイルプロキシではなく、ブラウザから S3 への転送がしたい +- スクリーンショット、公開、WebDAV、リモートダウンロード、API 駆動ワークフローのためのツール連携が欲しい + +ZPan が目指していないもの： + +- Nextcloud Office のようなリアルタイムドキュメント共同編集スイート +- AList のような汎用クラウドドライブアグリゲーター +- File Browser のようなローカルサーバーディレクトリブラウザ + +## ZPan の比較 + +ほとんどのセルフホスト型ファイルプロジェクトは、サーバーファイル、デスクトップ同期、コラボレーション、あるいは多数のプロバイダー集約のいずれかから出発します。ZPan は S3 互換オブジェクトストレージと、Cloudflare Workers に適したコントロールプレーンから出発します。 + +| 機能 | **ZPan** | [Cloudreve](https://docs.cloudreve.org/en/) | [AList](https://alist-repo.github.io/docs/guide/drivers/) | [Nextcloud](https://nextcloud.com/files/) | [Seafile](https://www.seafile.com/en/features/) | [File Browser](https://github.com/filebrowser/filebrowser) | +|------------|----------|------------|--------|-----------|---------|--------------| +| S3 バックエンドへの製品的注力 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| S3 互換ストレージバックエンド | ✅ | ✅ | ✅ | ✅ | ⚠️ | ❌ | +| ブラウザからオブジェクトストレージへの直接経路 | ✅ | ⚠️ | ⚠️ | ❌ | ❌ | ❌ | +| Cloudflare Workers へのデプロイ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| VPS/NAS 不要 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| PicGo/ShareX 画像ホスティングワークフロー | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| ユーザーごとの公開ファイルホームページ | ✅ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ❌ | +| リモートダウンロードワークフロー | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | +| 個別にデプロイ可能なダウンローダー/ノード | ✅ | ✅ | ⚠️ | ❌ | ❌ | ❌ | +| 複数ネットディスクの集約 | ❌ | ❌ | ✅ | ⚠️ | ❌ | ❌ | +| サーバーのローカルディレクトリを主なファイルルートとする | ❌ | ⚠️ | ⚠️ | ⚠️ | ❌ | ✅ | +| リアルタイムドキュメント共同編集 | ❌ | ❌ | ❌ | ✅ | ⚠️ | ❌ | +| 専用同期クライアント | 予定 | ❌ | ❌ | ✅ | ✅ | ❌ | +| チーム/ワークスペースモデル | ✅ | ⚠️ | ❌ | ✅ | ✅ | ❌ | +| WebDAV アクセス | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | +| 共有リンク | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Docker デプロイ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | + +凡例：✅ 第一級または中核となる機能；⚠️ 部分的、エディション依存、または製品の主な焦点ではない；❌ 中核機能ではない。 + +## デプロイ + +### Cloudflare Workers（推奨） + +サーバー管理なしで GitHub Actions 経由でデプロイ。無料枠で個人利用をカバーします。 + +1. このリポジトリを **Fork** する +2. フォーク先で **Settings → Secrets and variables → Actions** に移動し、以下を追加： + - `CLOUDFLARE_ACCOUNT_ID` — [Cloudflare ダッシュボード](https://dash.cloudflare.com/)のサイドバーで確認できます + - `CLOUDFLARE_API_TOKEN` — **Workers Scripts:Edit**、**D1:Edit**、**R2 Storage:Edit** の権限を付与して[こちら](https://dash.cloudflare.com/profile/api-tokens)で作成します（アバター/ロゴ用バケットの自動プロビジョニングに R2 スコープが必要です） +3. **Actions** タブに移動し、**Deploy to Cloudflare Workers** を選択して **Run workflow** をクリック + +初回セットアップ後は、フォークを最新リリースと同期するたびにワークフローが自動的に実行されます。 + +### AWS Lambda + +SAM を使って GitHub Actions 経由でデプロイ。Lambda Function URL が API Gateway なしで HTTPS を提供します。 + +1. このリポジトリを **Fork** する +2. フォーク先で **Settings → Secrets and variables → Actions** に移動し、以下を追加： + - `TURSO_DATABASE_URL` と `TURSO_AUTH_TOKEN` — [Turso](https://turso.tech) から取得（無料、クレジットカード不要） + - `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、`AWS_REGION` +3. **Actions** タブに移動し、**Deploy to AWS Lambda** を選択して **Run workflow** をクリック + +完全なセットアップ手順と IAM 権限については [docs/deploy/aws-lambda.md](../deploy/aws-lambda.md) を参照してください。 + +### Docker + +**クイックスタート** — ビルド済みイメージをプルし、自分の S3 ストレージを用意します： + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.yml +docker compose up -d +``` + +**RustFS を使う場合**（セルフホスト型の S3 互換ストレージ、外部依存なし）： + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.rustfs.yml +docker compose -f docker-compose.rustfs.yml up -d +``` + +起動後： + +1. RustFS コンソール `http://localhost:9001`（admin / admin123）を開き、バケット（例：`zpan-bucket`）を作成する +2. ZPan `http://localhost:8222` を開き、ユーザーを登録する（最初のユーザーが管理者ロールを取得します） +3. **Admin → Storage** に移動し、RustFS ストレージを追加する： + - **Endpoint**：`http://localhost:9000`（Docker 内部のホスト名ではなく、ブラウザから到達可能である必要があります） + - **Bucket**：ステップ 1 で作成したバケット名 + - **Region**：`us-east-1` + - **Access Key / Secret Key**：`admin` / `admin123` + +> **重要：** ファイルは presigned URL 経由で S3 へ直接アップロードされるため、ストレージのエンドポイントは**クライアントのブラウザ**からアクセス可能である必要があります。ローカル開発では `http://localhost:9000` を、本番環境ではサーバーの公開 URL を使用してください。 + +## ドキュメント + +- [ロードマップ](../../V2_ROADMAP.md) +- [コントリビューション](../../CONTRIBUTING.md) + +## v1 + +ZPan v1（Go 版）をお探しですか？ [v1 ブランチ](https://github.com/saltbo/zpan/tree/v1) を参照してください。 + +## コントリビューション + +詳細は [CONTRIBUTING.md](../../CONTRIBUTING.md) を参照してください。 + +ZPan に貢献してくださったすべての皆さんに感謝します！ + + + +## ライセンス + +ZPan は GNU Affero General Public License v3.0 の下で提供されます。詳細は +[LICENSE](../../LICENSE) ファイルを参照してください。 diff --git a/docs/i18n/README.ko.md b/docs/i18n/README.ko.md new file mode 100644 index 00000000..5ebefd08 --- /dev/null +++ b/docs/i18n/README.ko.md @@ -0,0 +1,176 @@ +

+ ZPan logo +

+ +

ZPan

+ +

+ S3 호환 스토리지를 위한 오픈소스 파일 호스팅. +

+ +

+ Cloudflare Workers 또는 Docker에 배포하세요. 객체 스토리지로 직접 업로드합니다. +

+ +

+ CI + codecov + Release + GitHub Release + Docker Image + License +

+ +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## ZPan이란? + +ZPan은 S3 호환 스토리지 위에 구축된 경량 파일 호스팅 플랫폼입니다. 파일은 presigned URL을 통해 클라이언트에서 S3로 직접 업로드되어 서버 대역폭을 전혀 사용하지 않습니다. 서버는 인증, 메타데이터, 공유, 할당량, 팀, WebDAV, 도구 연동, 관리 작업을 담당하는 제어 평면(control plane) 역할을 합니다. + +제품의 경계는 의도적으로 설정되어 있습니다. ZPan은 목적에 특화된 S3 기반 웹 드라이브이며, 모든 소비자용 클라우드 드라이브를 감싸는 래퍼도, 완전한 그룹웨어 제품군도 아닙니다. S3 호환 버킷을 직접 준비하면, ZPan이 깔끔한 웹 UI, 공개 공유, 이미지 호스팅 API, 그리고 VPS나 NAS가 필요 없는 배포 옵션을 제공합니다. + +**핵심 시나리오:** + +- **S3 웹 드라이브** — 직접 보유한 객체 스토리지 위에서 파일, 폴더, 미리보기, 휴지통, 할당량, 팀 워크스페이스를 관리합니다 +- **이미지 호스팅** — PicGo, PicList, uPic, ShareX, Flameshot 또는 API로 업로드하고 즉시 안정적인 URL을 받습니다 +- **파일 공유** — 비밀번호, 만료, 다운로드 제한, 직접 링크, 드라이브 저장 기능을 갖춘 공유 링크를 게시합니다 +- **개인 홈페이지** — 각 사용자에게 큐레이션된 공유 파일과 폴더 형식 탐색을 위한 공개 `/u/username` 페이지를 제공합니다 +- **외부 접근** — WebDAV로 파일을 마운트하고, 원격 다운로드 워크플로를 위해 다운로더 워커를 실행합니다 + +## 왜 ZPan인가? + +**의도적으로 S3 전용.** ZPan은 모든 넷디스크 제공업체를 좇거나 클라우드 드라이브를 중첩하는 레이어를 만들지 않습니다. 스토리지 계약은 단순하고 견고하게 유지됩니다. Cloudflare R2, AWS S3, Backblaze B2, MinIO, RustFS, Tigris 등 S3 호환 버킷과 기타 S3 호환 서비스를 지원합니다. + +**Cloudflare Workers 우선.** ZPan은 Cloudflare Workers, D1, Hono, 웹 표준 API를 중심으로 구축되었으며, Docker와 기타 런타임을 추가 배포 대상으로 지원합니다. VPS를 소유하거나, NAS를 항상 켜두거나, 장시간 실행되는 서버를 통해 업로드를 프록시하지 않고도 실제 파일 호스팅 제어 평면을 운영할 수 있습니다. + +**직접 전송 경로.** 업로드와 다운로드는 가능한 한 객체 스토리지의 presigned URL을 사용합니다. 이를 통해 서버 대역폭을 낮게 유지하고, 중앙 집중식 파일 전송 병목을 피하며, 무거운 작업을 객체 스토리지가 처리하도록 합니다. + +**실용적인 파일 워크플로.** ZPan은 웹 파일 관리자, 공개 공유, 이미지 호스팅 구성, API 키, WebDAV 접근, 팀, 할당량, 원격 다운로드 작업, 파일 미리보기, 관리 제어 기능을 제공하며, 제공업체 집계 플랫폼으로 변질되지 않습니다. + +**배포 가능한 다운로더 워커.** 원격 다운로드는 반드시 메인 ZPan 인스턴스 내부에서 실행될 필요가 없습니다. 간단한 구성을 위해 ZPan과 함께 다운로더를 배포하거나, 네트워크 접근성이 더 좋고 소스 사이트 제약이 적은 환경에서 별도로 실행한 뒤, ZPan이 완료된 파일을 객체 스토리지로 가져오도록 할 수 있습니다. + +## 제품 경계 + +ZPan은 다음을 원할 때 적합합니다: + +- 스토리지 제공업체의 동물원이 아닌, 집중된 S3 기반 웹 드라이브 +- 직접 보유한 버킷을 기반으로 하는 셀프 호스팅 이미지 베드 및 파일 공유 앱 +- VPS나 NAS를 유지하지 않는 Cloudflare 네이티브 배포 +- 앱 서버의 파일 프록시 대신 브라우저-S3 직접 전송 +- 스크린샷, 게시, WebDAV, 원격 다운로드, API 기반 워크플로를 위한 도구 연동 + +ZPan은 다음을 지향하지 않습니다: + +- Nextcloud Office와 같은 실시간 문서 공동 편집 제품군 +- AList와 같은 범용 클라우드 드라이브 집계기 +- File Browser와 같은 로컬 서버 디렉터리 브라우저 + +## ZPan 비교 + +대부분의 셀프 호스팅 파일 프로젝트는 서버 파일, 데스크톱 동기화, 협업, 또는 다중 제공업체 집계 중 하나에서 출발합니다. ZPan은 S3 호환 객체 스토리지와 Cloudflare Workers에 친화적인 제어 평면에서 출발합니다. + +| 기능 | **ZPan** | [Cloudreve](https://docs.cloudreve.org/en/) | [AList](https://alist-repo.github.io/docs/guide/drivers/) | [Nextcloud](https://nextcloud.com/files/) | [Seafile](https://www.seafile.com/en/features/) | [File Browser](https://github.com/filebrowser/filebrowser) | +|------------|----------|------------|--------|-----------|---------|--------------| +| S3 기반 제품 집중도 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| S3 호환 스토리지 백엔드 | ✅ | ✅ | ✅ | ✅ | ⚠️ | ❌ | +| 브라우저-객체 스토리지 직접 경로 | ✅ | ⚠️ | ⚠️ | ❌ | ❌ | ❌ | +| Cloudflare Workers 배포 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| VPS/NAS 불필요 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| PicGo/ShareX 이미지 호스팅 워크플로 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| 사용자별 공개 파일 홈페이지 | ✅ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ❌ | +| 원격 다운로드 워크플로 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | +| 별도 배포 가능한 다운로더/노드 | ✅ | ✅ | ⚠️ | ❌ | ❌ | ❌ | +| 다중 넷디스크 집계 | ❌ | ❌ | ✅ | ⚠️ | ❌ | ❌ | +| 서버 로컬 디렉터리를 기본 파일 루트로 | ❌ | ⚠️ | ⚠️ | ⚠️ | ❌ | ✅ | +| 실시간 문서 공동 편집 | ❌ | ❌ | ❌ | ✅ | ⚠️ | ❌ | +| 전용 동기화 클라이언트 | 계획됨 | ❌ | ❌ | ✅ | ✅ | ❌ | +| 팀/워크스페이스 모델 | ✅ | ⚠️ | ❌ | ✅ | ✅ | ❌ | +| WebDAV 접근 | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | +| 공유 링크 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Docker 배포 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | + +범례: ✅ 일급 또는 핵심 기능; ⚠️ 부분적이거나, 에디션에 따라 다르거나, 제품의 주된 초점이 아님; ❌ 핵심 기능 아님. + +## 배포 + +### Cloudflare Workers (권장) + +서버 관리 없이 GitHub Actions를 통해 배포합니다. 무료 등급으로 개인 용도를 충분히 커버합니다. + +1. 이 저장소를 **Fork**합니다 +2. Fork한 저장소에서 **Settings → Secrets and variables → Actions**로 이동하여 다음을 추가합니다: + - `CLOUDFLARE_ACCOUNT_ID` — [Cloudflare 대시보드](https://dash.cloudflare.com/) 사이드바에서 확인할 수 있습니다 + - `CLOUDFLARE_API_TOKEN` — [여기](https://dash.cloudflare.com/profile/api-tokens)에서 **Workers Scripts:Edit**, **D1:Edit**, **R2 Storage:Edit** 권한으로 생성합니다 (아바타/로고 버킷을 자동 프로비저닝하려면 R2 범위가 필요합니다) +3. **Actions** 탭으로 이동하여 **Deploy to Cloudflare Workers**를 선택하고 **Run workflow**를 클릭합니다 + +초기 설정 후에는 Fork를 최신 릴리스와 동기화할 때마다 워크플로가 자동으로 실행됩니다. + +### AWS Lambda + +SAM을 사용하여 GitHub Actions를 통해 배포합니다. Lambda Function URL이 API Gateway 없이 HTTPS를 제공합니다. + +1. 이 저장소를 **Fork**합니다 +2. Fork한 저장소에서 **Settings → Secrets and variables → Actions**로 이동하여 다음을 추가합니다: + - `TURSO_DATABASE_URL`과 `TURSO_AUTH_TOKEN` — [Turso](https://turso.tech)에서 발급 (무료, 신용카드 불필요) + - `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION` +3. **Actions** 탭으로 이동하여 **Deploy to AWS Lambda**를 선택하고 **Run workflow**를 클릭합니다 + +전체 설정 안내와 IAM 권한은 [docs/deploy/aws-lambda.md](../deploy/aws-lambda.md)를 참고하세요. + +### Docker + +**빠른 시작** — 미리 빌드된 이미지를 가져오고 직접 보유한 S3 스토리지를 사용합니다: + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.yml +docker compose up -d +``` + +**RustFS 사용** (셀프 호스팅 S3 호환 스토리지, 외부 의존성 없음): + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.rustfs.yml +docker compose -f docker-compose.rustfs.yml up -d +``` + +시작 후: + +1. RustFS 콘솔을 `http://localhost:9001` (admin / admin123)에서 열고 버킷을 생성합니다 (예: `zpan-bucket`) +2. ZPan을 `http://localhost:8222`에서 열고 사용자를 등록합니다 (첫 번째 사용자가 관리자 역할을 받습니다) +3. **Admin → Storage**로 이동하여 RustFS 스토리지를 추가합니다: + - **Endpoint**: `http://localhost:9000` (Docker 내부 호스트명이 아니라 브라우저에서 접근 가능해야 합니다) + - **Bucket**: 1단계에서 생성한 버킷 이름 + - **Region**: `us-east-1` + - **Access Key / Secret Key**: `admin` / `admin123` + +> **중요:** 파일이 presigned URL을 통해 S3로 직접 업로드되므로, 스토리지 엔드포인트는 **클라이언트 브라우저**에서 접근 가능해야 합니다. 로컬 개발에는 `http://localhost:9000`을, 프로덕션에는 서버의 공개 URL을 사용하세요. + +## 문서 + +- [로드맵](../../V2_ROADMAP.md) +- [기여하기](../../CONTRIBUTING.md) + +## v1 + +ZPan v1(Go 버전)을 찾으시나요? [v1 브랜치](https://github.com/saltbo/zpan/tree/v1)를 참고하세요. + +## 기여하기 + +자세한 내용은 [CONTRIBUTING.md](../../CONTRIBUTING.md)를 참고하세요. + +ZPan에 기여해 주신 모든 분들께 감사드립니다! + + + +## 라이선스 + +ZPan은 GNU Affero General Public License v3.0을 따릅니다. 자세한 내용은 +[LICENSE](../../LICENSE) 파일을 참고하세요. diff --git a/docs/i18n/README.pt-BR.md b/docs/i18n/README.pt-BR.md new file mode 100644 index 00000000..46c6c0c8 --- /dev/null +++ b/docs/i18n/README.pt-BR.md @@ -0,0 +1,176 @@ +

+ ZPan logo +

+ +

ZPan

+ +

+ Hospedagem de arquivos open-source para seu armazenamento S3-compatible. +

+ +

+ Faça deploy no Cloudflare Workers ou Docker. Envie arquivos diretamente para o armazenamento de objetos. +

+ +

+ CI + codecov + Release + GitHub Release + Docker Image + License +

+ +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## O que é o ZPan? + +O ZPan é uma plataforma leve de hospedagem de arquivos construída sobre armazenamento S3-compatible. Os arquivos são enviados diretamente do cliente para o S3 por meio de URLs pré-assinadas, dispensando totalmente a banda do servidor. O servidor é o plano de controle: autenticação, metadados, compartilhamentos, cotas, equipes, WebDAV, integrações com ferramentas e operações administrativas. + +A fronteira do produto é intencional: o ZPan é um web drive sob medida com backend S3, não um wrapper em torno de todo drive de nuvem para consumidor nem uma suíte completa de groupware. Você traz um bucket S3-compatible; o ZPan dá a ele uma interface web limpa, compartilhamento público, APIs de hospedagem de imagens e opções de deploy que não exigem um VPS ou NAS. + +**Cenários principais:** + +- **Web drive S3** — Gerencie arquivos, pastas, prévias, lixeira, cotas e workspaces de equipe sobre seu próprio armazenamento de objetos +- **Hospedagem de imagens** — Faça upload via PicGo, PicList, uPic, ShareX, Flameshot ou API e obtenha uma URL estável na hora +- **Compartilhamento de arquivos** — Publique links de compartilhamento com senha, expiração, limites de download, links diretos e fluxos de salvar-no-drive +- **Página pessoal** — Dê a cada usuário uma página pública `/u/username` para arquivos compartilhados selecionados e navegação no estilo de pastas +- **Acesso externo** — Monte arquivos via WebDAV e execute workers de download para fluxos de download remoto + +## Por que o ZPan? + +**Somente S3, por design.** O ZPan não persegue todo provedor de net-disk nem constrói uma camada de aninhamento de drives de nuvem. O contrato de armazenamento permanece simples e durável: buckets S3-compatible como Cloudflare R2, AWS S3, Backblaze B2, MinIO, RustFS, Tigris e outros serviços S3-compatible. + +**Cloudflare Workers em primeiro lugar.** O ZPan é construído em torno de Cloudflare Workers, D1, Hono e APIs web padrão, com Docker e outros runtimes como alvos adicionais de deploy. Você pode rodar um plano de controle real de hospedagem de arquivos sem possuir um VPS, manter um NAS ligado ou intermediar uploads através de um servidor de longa duração. + +**Caminho de transferência direta.** Uploads e downloads usam URLs pré-assinadas de armazenamento de objetos sempre que possível. Isso mantém a banda do servidor baixa, evita um gargalo central de transferência de arquivos e deixa o armazenamento de objetos fazer o trabalho pesado. + +**Fluxos práticos de arquivos.** O ZPan inclui um gerenciador de arquivos web, compartilhamento público, configuração de hospedagem de imagens, chaves de API, acesso WebDAV, equipes, cotas, tarefas de download remoto, prévias de arquivos e controles administrativos sem virar uma plataforma de agregação de provedores. + +**Workers de download deployáveis.** O download remoto não precisa rodar dentro da instância principal do ZPan. Você pode fazer o deploy do downloader junto com o ZPan para uma configuração simples, ou rodá-lo separadamente em um ambiente com melhor acesso de rede e menos restrições de site de origem, deixando então o ZPan importar os arquivos concluídos para o armazenamento de objetos. + +## Fronteiras do produto + +O ZPan é uma boa escolha quando você quer: + +- Um web drive focado com backend S3, em vez de um zoológico de provedores de armazenamento +- Um image bed e app de compartilhamento de arquivos self-hosted respaldado pelo seu próprio bucket +- Deploy Cloudflare-native sem manter um VPS ou NAS +- Transferências browser-to-S3 em vez de proxy de arquivos pelo app-server +- Integrações com ferramentas para screenshot, publicação, WebDAV, download remoto e fluxos orientados por API + +O ZPan não tenta ser: + +- Uma suíte de co-edição de documentos em tempo real como o Nextcloud Office +- Um agregador de drives de nuvem de propósito geral como o AList +- Um navegador de diretório local do servidor como o File Browser + +## Como o ZPan se compara + +A maioria dos projetos self-hosted de arquivos parte ou de arquivos do servidor, ou de sincronização desktop, ou de colaboração, ou de agregação de muitos provedores. O ZPan parte de armazenamento de objetos S3-compatible e de um plano de controle amigável ao Cloudflare Workers. + +| Capacidade | **ZPan** | [Cloudreve](https://docs.cloudreve.org/en/) | [AList](https://alist-repo.github.io/docs/guide/drivers/) | [Nextcloud](https://nextcloud.com/files/) | [Seafile](https://www.seafile.com/en/features/) | [File Browser](https://github.com/filebrowser/filebrowser) | +|------------|----------|------------|--------|-----------|---------|--------------| +| Foco em produto com backend S3 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Backend de armazenamento S3-compatible | ✅ | ✅ | ✅ | ✅ | ⚠️ | ❌ | +| Caminho direto browser-to-object-storage | ✅ | ⚠️ | ⚠️ | ❌ | ❌ | ❌ | +| Deploy no Cloudflare Workers | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Sem necessidade de VPS/NAS | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Fluxo de hospedagem de imagens PicGo/ShareX | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Página pública de arquivos por usuário | ✅ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ❌ | +| Fluxo de download remoto | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | +| Downloader/nó deployável separadamente | ✅ | ✅ | ⚠️ | ❌ | ❌ | ❌ | +| Agregação de múltiplos net-disks | ❌ | ❌ | ✅ | ⚠️ | ❌ | ❌ | +| Diretório local do servidor como raiz primária de arquivos | ❌ | ⚠️ | ⚠️ | ⚠️ | ❌ | ✅ | +| Co-edição de documentos em tempo real | ❌ | ❌ | ❌ | ✅ | ⚠️ | ❌ | +| Clientes de sincronização dedicados | Planejado | ❌ | ❌ | ✅ | ✅ | ❌ | +| Modelo de equipe/workspace | ✅ | ⚠️ | ❌ | ✅ | ✅ | ❌ | +| Acesso WebDAV | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | +| Links de compartilhamento | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Deploy com Docker | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | + +Legenda: ✅ capacidade de primeira classe ou central; ⚠️ parcial, dependente de edição ou não é o foco principal do produto; ❌ não é uma capacidade central. + +## Deploy + +### Cloudflare Workers (Recomendado) + +Faça deploy via GitHub Actions sem gerenciamento de servidor. O plano gratuito cobre uso pessoal. + +1. **Faça um fork** deste repositório +2. No seu fork, vá em **Settings → Secrets and variables → Actions** e adicione: + - `CLOUDFLARE_ACCOUNT_ID` — encontrado na barra lateral do [dashboard da Cloudflare](https://dash.cloudflare.com/) + - `CLOUDFLARE_API_TOKEN` — crie um [aqui](https://dash.cloudflare.com/profile/api-tokens) com permissões **Workers Scripts:Edit**, **D1:Edit** e **R2 Storage:Edit** (o escopo R2 é necessário para auto-provisionar o bucket de avatar/logo) +3. Vá na aba **Actions**, selecione **Deploy to Cloudflare Workers** e clique em **Run workflow** + +Após a configuração inicial, o workflow roda automaticamente toda vez que você sincronizar seu fork com a última release. + +### AWS Lambda + +Faça deploy via GitHub Actions usando SAM. A Lambda Function URL fornece HTTPS sem necessidade de API Gateway. + +1. **Faça um fork** deste repositório +2. No seu fork, vá em **Settings → Secrets and variables → Actions** e adicione: + - `TURSO_DATABASE_URL` e `TURSO_AUTH_TOKEN` — do [Turso](https://turso.tech) (gratuito, sem cartão de crédito) + - `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION` +3. Vá na aba **Actions**, selecione **Deploy to AWS Lambda** e clique em **Run workflow** + +Veja [docs/deploy/aws-lambda.md](../deploy/aws-lambda.md) para instruções completas de configuração e permissões IAM. + +### Docker + +**Início rápido** — baixe a imagem pré-construída e traga seu próprio armazenamento S3: + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.yml +docker compose up -d +``` + +**Com RustFS** (armazenamento S3-compatible self-hosted, sem dependências externas): + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.rustfs.yml +docker compose -f docker-compose.rustfs.yml up -d +``` + +Após a inicialização: + +1. Abra o console do RustFS em `http://localhost:9001` (admin / admin123) e crie um bucket (ex.: `zpan-bucket`) +2. Abra o ZPan em `http://localhost:8222`, registre um usuário (o primeiro usuário recebe o papel de admin) +3. Vá em **Admin → Storage** e adicione o armazenamento RustFS: + - **Endpoint**: `http://localhost:9000` (precisa ser acessível pelo seu navegador, não pelo hostname interno do Docker) + - **Bucket**: o nome do bucket que você criou no passo 1 + - **Region**: `us-east-1` + - **Access Key / Secret Key**: `admin` / `admin123` + +> **Importante:** O endpoint de armazenamento precisa ser acessível a partir do **navegador do cliente**, já que os arquivos são enviados diretamente para o S3 via URLs pré-assinadas. Use `http://localhost:9000` para desenvolvimento local, ou a URL pública do seu servidor para produção. + +## Documentação + +- [Roadmap](../../V2_ROADMAP.md) +- [Contribuindo](../../CONTRIBUTING.md) + +## v1 + +Procurando o ZPan v1 (versão em Go)? Veja a [branch v1](https://github.com/saltbo/zpan/tree/v1). + +## Contribuindo + +Veja [CONTRIBUTING.md](../../CONTRIBUTING.md) para detalhes. + +Obrigado a todas as pessoas que contribuíram com o ZPan! + + + +## Licença + +O ZPan está sob a GNU Affero General Public License v3.0. Veja o +arquivo [LICENSE](../../LICENSE) para detalhes. diff --git a/docs/i18n/README.ru.md b/docs/i18n/README.ru.md new file mode 100644 index 00000000..cf374777 --- /dev/null +++ b/docs/i18n/README.ru.md @@ -0,0 +1,176 @@ +

+ ZPan logo +

+ +

ZPan

+ +

+ Файловый хостинг с открытым исходным кодом для вашего S3-совместимого хранилища. +

+ +

+ Разворачивайте на Cloudflare Workers или в Docker. Загружайте файлы напрямую в объектное хранилище. +

+ +

+ CI + codecov + Release + GitHub Release + Docker Image + License +

+ +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## Что такое ZPan? + +ZPan — это лёгкая платформа файлового хостинга, построенная поверх S3-совместимого хранилища. Файлы загружаются напрямую с клиента в S3 через предподписанные (presigned) URL, полностью минуя пропускную способность сервера. Сервер выступает как уровень управления: аутентификация, метаданные, общий доступ, квоты, команды, WebDAV, интеграции с инструментами и административные операции. + +Границы продукта намеренно очерчены: ZPan — это специализированный веб-диск на базе S3, а не обёртка над всеми потребительскими облачными дисками и не полноценный набор групповых приложений. Вы предоставляете S3-совместимый бакет, а ZPan даёт ему чистый веб-интерфейс, публичный общий доступ, API для хостинга изображений и варианты развёртывания, которые не требуют VPS или NAS. + +**Основные сценарии:** + +- **Веб-диск на S3** — управляйте файлами, папками, предпросмотрами, корзиной, квотами и командными рабочими пространствами поверх собственного объектного хранилища +- **Хостинг изображений** — загружайте через PicGo, PicList, uPic, ShareX, Flameshot или API и мгновенно получайте стабильный URL +- **Общий доступ к файлам** — публикуйте ссылки с паролем, сроком действия, лимитом загрузок, прямыми ссылками и возможностью сохранения на диск +- **Персональная домашняя страница** — дайте каждому пользователю публичную страницу `/u/username` с подобранными общими файлами и просмотром в стиле папок +- **Внешний доступ** — монтируйте файлы через WebDAV и запускайте воркеры-загрузчики для удалённой загрузки + +## Почему ZPan? + +**Только S3, по замыслу.** ZPan не гонится за каждым облачным диском и не строит слой вложенных облачных хранилищ. Контракт хранилища остаётся простым и надёжным: S3-совместимые бакеты, такие как Cloudflare R2, AWS S3, Backblaze B2, MinIO, RustFS, Tigris и другие S3-совместимые сервисы. + +**Cloudflare Workers в первую очередь.** ZPan построен вокруг Cloudflare Workers, D1, Hono и веб-стандартных API, а Docker и другие среды выполнения служат дополнительными целями развёртывания. Вы можете запустить полноценный уровень управления файловым хостингом, не владея VPS, не держа NAS включённым и не проксируя загрузки через постоянно работающий сервер. + +**Прямой путь передачи.** Загрузки и скачивания используют предподписанные URL объектного хранилища, когда это возможно. Это снижает нагрузку на пропускную способность сервера, устраняет центральное узкое место передачи файлов и позволяет объектному хранилищу выполнять основную работу. + +**Практичные сценарии работы с файлами.** ZPan включает веб-файловый менеджер, публичный общий доступ, настройку хостинга изображений, API-ключи, доступ по WebDAV, команды, квоты, задачи удалённой загрузки, предпросмотр файлов и административные элементы управления — не превращаясь при этом в платформу-агрегатор провайдеров. + +**Разворачиваемые воркеры-загрузчики.** Удалённая загрузка не обязана выполняться внутри основного экземпляра ZPan. Вы можете развернуть загрузчик вместе с ZPan для простой настройки или запустить его отдельно в окружении с лучшим сетевым доступом и меньшими ограничениями со стороны исходных сайтов, а затем позволить ZPan импортировать завершённые файлы в объектное хранилище. + +## Границы продукта + +ZPan хорошо подходит, когда вам нужно: + +- Сфокусированный веб-диск на базе S3 вместо зоопарка провайдеров хранилищ +- Самостоятельно размещаемый хостинг изображений и приложение для обмена файлами на базе собственного бакета +- Развёртывание в экосистеме Cloudflare без обслуживания VPS или NAS +- Передача из браузера в S3 вместо проксирования файлов через сервер приложения +- Интеграции с инструментами для скриншотов, публикации, WebDAV, удалённой загрузки и сценариев на основе API + +ZPan не стремится быть: + +- Набором для совместного редактирования документов в реальном времени, как Nextcloud Office +- Универсальным агрегатором облачных дисков, как AList +- Браузером локальных серверных каталогов, как File Browser + +## Как ZPan соотносится с другими + +Большинство проектов самостоятельного файлового хостинга отталкиваются либо от серверных файлов, либо от синхронизации с настольным ПК, либо от совместной работы, либо от агрегации множества провайдеров. ZPan отталкивается от S3-совместимого объектного хранилища и уровня управления, дружественного к Cloudflare Workers. + +| Возможность | **ZPan** | [Cloudreve](https://docs.cloudreve.org/en/) | [AList](https://alist-repo.github.io/docs/guide/drivers/) | [Nextcloud](https://nextcloud.com/files/) | [Seafile](https://www.seafile.com/en/features/) | [File Browser](https://github.com/filebrowser/filebrowser) | +|------------|----------|------------|--------|-----------|---------|--------------| +| Ориентация на продукт на базе S3 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| S3-совместимый бэкенд хранилища | ✅ | ✅ | ✅ | ✅ | ⚠️ | ❌ | +| Прямой путь из браузера в объектное хранилище | ✅ | ⚠️ | ⚠️ | ❌ | ❌ | ❌ | +| Развёртывание на Cloudflare Workers | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Не требуется VPS/NAS | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Сценарий хостинга изображений PicGo/ShareX | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| Публичная домашняя страница файлов для каждого пользователя | ✅ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ❌ | +| Сценарий удалённой загрузки | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | +| Отдельно разворачиваемый загрузчик/узел | ✅ | ✅ | ⚠️ | ❌ | ❌ | ❌ | +| Агрегация нескольких облачных дисков | ❌ | ❌ | ✅ | ⚠️ | ❌ | ❌ | +| Локальный серверный каталог как основной корень файлов | ❌ | ⚠️ | ⚠️ | ⚠️ | ❌ | ✅ | +| Совместное редактирование документов в реальном времени | ❌ | ❌ | ❌ | ✅ | ⚠️ | ❌ | +| Выделенные клиенты синхронизации | Запланировано | ❌ | ❌ | ✅ | ✅ | ❌ | +| Модель команд/рабочих пространств | ✅ | ⚠️ | ❌ | ✅ | ✅ | ❌ | +| Доступ по WebDAV | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | +| Ссылки для общего доступа | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Развёртывание в Docker | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | + +Условные обозначения: ✅ первоклассная или ключевая возможность; ⚠️ частичная, зависящая от редакции или не являющаяся основным фокусом продукта; ❌ не является ключевой возможностью. + +## Развёртывание + +### Cloudflare Workers (рекомендуется) + +Разворачивайте через GitHub Actions без управления сервером. Бесплатного тарифа достаточно для личного использования. + +1. **Сделайте форк** этого репозитория +2. В своём форке перейдите в **Settings → Secrets and variables → Actions** и добавьте: + - `CLOUDFLARE_ACCOUNT_ID` — находится в боковой панели [панели управления Cloudflare](https://dash.cloudflare.com/) + - `CLOUDFLARE_API_TOKEN` — создайте его [здесь](https://dash.cloudflare.com/profile/api-tokens) с правами **Workers Scripts:Edit**, **D1:Edit** и **R2 Storage:Edit** (область R2 нужна для автоматического создания бакета для аватаров/логотипа) +3. Перейдите на вкладку **Actions**, выберите **Deploy to Cloudflare Workers** и нажмите **Run workflow** + +После первоначальной настройки workflow запускается автоматически каждый раз, когда вы синхронизируете свой форк с последним релизом. + +### AWS Lambda + +Разворачивайте через GitHub Actions с использованием SAM. Lambda Function URL обеспечивает HTTPS без необходимости в API Gateway. + +1. **Сделайте форк** этого репозитория +2. В своём форке перейдите в **Settings → Secrets and variables → Actions** и добавьте: + - `TURSO_DATABASE_URL` и `TURSO_AUTH_TOKEN` — из [Turso](https://turso.tech) (бесплатно, без банковской карты) + - `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION` +3. Перейдите на вкладку **Actions**, выберите **Deploy to AWS Lambda** и нажмите **Run workflow** + +См. [docs/deploy/aws-lambda.md](../deploy/aws-lambda.md) для полных инструкций по настройке и прав IAM. + +### Docker + +**Быстрый старт** — загрузите готовый образ и подключите своё S3-хранилище: + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.yml +docker compose up -d +``` + +**С RustFS** (самостоятельно размещаемое S3-совместимое хранилище, без внешних зависимостей): + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.rustfs.yml +docker compose -f docker-compose.rustfs.yml up -d +``` + +После запуска: + +1. Откройте консоль RustFS по адресу `http://localhost:9001` (admin / admin123) и создайте бакет (например, `zpan-bucket`) +2. Откройте ZPan по адресу `http://localhost:8222`, зарегистрируйте пользователя (первый пользователь получает роль администратора) +3. Перейдите в **Admin → Storage** и добавьте хранилище RustFS: + - **Endpoint**: `http://localhost:9000` (должен быть доступен из вашего браузера, а не внутренний хостнейм Docker) + - **Bucket**: имя бакета, который вы создали на шаге 1 + - **Region**: `us-east-1` + - **Access Key / Secret Key**: `admin` / `admin123` + +> **Важно:** конечная точка хранилища должна быть доступна из **браузера клиента**, поскольку файлы загружаются напрямую в S3 через предподписанные URL. Используйте `http://localhost:9000` для локальной разработки или публичный URL вашего сервера для продакшена. + +## Документация + +- [Дорожная карта](../../V2_ROADMAP.md) +- [Участие в разработке](../../CONTRIBUTING.md) + +## v1 + +Ищете ZPan v1 (версия на Go)? См. [ветку v1](https://github.com/saltbo/zpan/tree/v1). + +## Участие в разработке + +Подробности см. в [CONTRIBUTING.md](../../CONTRIBUTING.md). + +Спасибо всем, кто внёс свой вклад в ZPan! + + + +## Лицензия + +ZPan распространяется под лицензией GNU Affero General Public License v3.0. Подробности см. в файле +[LICENSE](../../LICENSE). diff --git a/docs/i18n/README.zh-CN.md b/docs/i18n/README.zh-CN.md new file mode 100644 index 00000000..fc642e0f --- /dev/null +++ b/docs/i18n/README.zh-CN.md @@ -0,0 +1,176 @@ +

+ ZPan logo +

+ +

ZPan

+ +

+ 面向 S3-compatible 存储的开源文件托管服务。 +

+ +

+ 部署在 Cloudflare Workers 或 Docker 上。文件直传对象存储。 +

+ +

+ CI + codecov + Release + GitHub Release + Docker Image + License +

+ +

+ English · + 简体中文 · + 日本語 · + 한국어 · + Русский · + Español · + Português (BR) +

+ +## ZPan 是什么？ + +ZPan 是一个构建在 S3-compatible 存储之上的轻量级文件托管平台。文件通过预签名 URL 从客户端直接上传到 S3，完全绕过服务器带宽。服务器作为控制平面，负责认证、元数据、分享、配额、团队、WebDAV、工具集成以及管理操作。 + +产品边界是刻意划定的：ZPan 是一个专为 S3 后端打造的 Web 网盘，而不是封装各种消费级云盘的工具，也不是一套完整的协同办公套件。你提供一个 S3-compatible 存储桶，ZPan 为它提供整洁的 Web 界面、公开分享、图床 API，以及无需 VPS 或 NAS 的部署方式。 + +**核心场景：** + +- **S3 网盘** — 在你自己的对象存储之上管理文件、文件夹、预览、回收站、配额和团队工作区 +- **图床** — 通过 PicGo、PicList、uPic、ShareX、Flameshot 或 API 上传，即刻获得稳定的 URL +- **文件分享** — 发布带密码、过期时间、下载次数限制、直链以及转存到网盘的分享链接 +- **个人主页** — 为每个用户提供一个公开的 `/u/username` 页面，用于精选分享文件和文件夹式浏览 +- **外部访问** — 通过 WebDAV 挂载文件，并运行下载节点以支持远程下载工作流 + +## 为什么选择 ZPan？ + +**专注 S3，源于设计。** ZPan 不追逐每一个网盘服务商，也不构建云盘嵌套层。存储契约始终保持简单而持久：Cloudflare R2、AWS S3、Backblaze B2、MinIO、RustFS、Tigris 等 S3-compatible 存储桶及其他 S3-compatible 服务。 + +**Cloudflare Workers 优先。** ZPan 围绕 Cloudflare Workers、D1、Hono 和 Web 标准 API 构建，并将 Docker 及其他运行时作为额外的部署目标。你无需拥有 VPS、维持 NAS 在线，也无需通过长驻服务器代理上传，就能运行一个真正的文件托管控制平面。 + +**直传路径。** 上传和下载尽可能使用预签名的对象存储 URL。这能保持服务器带宽处于低位，避免集中式文件传输瓶颈，并让对象存储承担繁重的工作。 + +**实用的文件工作流。** ZPan 包含 Web 文件管理器、公开分享、图床配置、API 密钥、WebDAV 访问、团队、配额、远程下载任务、文件预览和管理控制，而不会演变成一个服务商聚合平台。 + +**可独立部署的下载节点。** 远程下载不必在主 ZPan 实例内运行。你可以将下载节点与 ZPan 一起部署以获得简单的配置，也可以将它单独部署在网络访问更佳、源站限制更少的环境中，再让 ZPan 把已完成的文件导入对象存储。 + +## 产品边界 + +如果你想要以下这些，ZPan 会很合适： + +- 一个专注的 S3 后端 Web 网盘，而不是一堆存储服务商的大杂烩 +- 一个由你自己的存储桶支撑的自托管图床和文件分享应用 +- Cloudflare 原生部署，无需维护 VPS 或 NAS +- 浏览器到 S3 的传输，而不是应用服务器代理文件 +- 面向截图、发布、WebDAV、远程下载和 API 驱动工作流的工具集成 + +ZPan 并不打算成为： + +- 像 Nextcloud Office 那样的实时文档协同编辑套件 +- 像 AList 那样的通用云盘聚合器 +- 像 File Browser 那样的本地服务器目录浏览器 + +## ZPan 对比 + +大多数自托管文件项目的出发点要么是服务器文件、桌面同步、协作，要么是多服务商聚合。而 ZPan 的出发点是 S3-compatible 对象存储和对 Cloudflare Workers 友好的控制平面。 + +| 能力 | **ZPan** | [Cloudreve](https://docs.cloudreve.org/en/) | [AList](https://alist-repo.github.io/docs/guide/drivers/) | [Nextcloud](https://nextcloud.com/files/) | [Seafile](https://www.seafile.com/en/features/) | [File Browser](https://github.com/filebrowser/filebrowser) | +|------------|----------|------------|--------|-----------|---------|--------------| +| 专注 S3 后端的产品定位 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| S3-compatible 存储后端 | ✅ | ✅ | ✅ | ✅ | ⚠️ | ❌ | +| 浏览器到对象存储的直传路径 | ✅ | ⚠️ | ⚠️ | ❌ | ❌ | ❌ | +| Cloudflare Workers 部署 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| 无需 VPS/NAS | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| PicGo/ShareX 图床工作流 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| 每用户公开文件主页 | ✅ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ❌ | +| 远程下载工作流 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | +| 可独立部署的下载节点 | ✅ | ✅ | ⚠️ | ❌ | ❌ | ❌ | +| 多网盘聚合 | ❌ | ❌ | ✅ | ⚠️ | ❌ | ❌ | +| 服务器本地目录作为主文件根 | ❌ | ⚠️ | ⚠️ | ⚠️ | ❌ | ✅ | +| 实时文档协同编辑 | ❌ | ❌ | ❌ | ✅ | ⚠️ | ❌ | +| 专用同步客户端 | 计划中 | ❌ | ❌ | ✅ | ✅ | ❌ | +| 团队/工作区模型 | ✅ | ⚠️ | ❌ | ✅ | ✅ | ❌ | +| WebDAV 访问 | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | +| 分享链接 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Docker 部署 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | + +图例：✅ 一流或核心能力；⚠️ 部分支持、依赖版本，或非产品主要关注点；❌ 非核心能力。 + +## 部署 + +### Cloudflare Workers（推荐） + +通过 GitHub Actions 部署，无需任何服务器管理。免费额度足以覆盖个人使用。 + +1. **Fork** 本仓库 +2. 在你的 fork 中，进入 **Settings → Secrets and variables → Actions** 并添加： + - `CLOUDFLARE_ACCOUNT_ID` — 可在 [Cloudflare 控制台](https://dash.cloudflare.com/) 侧边栏找到 + - `CLOUDFLARE_API_TOKEN` — 在[这里](https://dash.cloudflare.com/profile/api-tokens)创建一个，并赋予 **Workers Scripts:Edit**、**D1:Edit** 和 **R2 Storage:Edit** 权限（R2 权限用于自动创建头像/Logo 存储桶） +3. 进入 **Actions** 标签页，选择 **Deploy to Cloudflare Workers**，然后点击 **Run workflow** + +完成初始设置后，每次你将 fork 与最新版本同步时，该工作流都会自动运行。 + +### AWS Lambda + +通过 GitHub Actions 使用 SAM 部署。Lambda Function URL 直接提供 HTTPS，无需 API Gateway。 + +1. **Fork** 本仓库 +2. 在你的 fork 中，进入 **Settings → Secrets and variables → Actions** 并添加： + - `TURSO_DATABASE_URL` 和 `TURSO_AUTH_TOKEN` — 来自 [Turso](https://turso.tech)（免费，无需信用卡） + - `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、`AWS_REGION` +3. 进入 **Actions** 标签页，选择 **Deploy to AWS Lambda**，然后点击 **Run workflow** + +完整的设置说明和 IAM 权限详见 [docs/deploy/aws-lambda.md](../deploy/aws-lambda.md)。 + +### Docker + +**快速开始** — 拉取预构建镜像并自带 S3 存储： + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.yml +docker compose up -d +``` + +**搭配 RustFS**（自托管的 S3-compatible 存储，无外部依赖）： + +```bash +curl -O https://raw.githubusercontent.com/saltbo/zpan/master/deploy/docker-compose.rustfs.yml +docker compose -f docker-compose.rustfs.yml up -d +``` + +启动后： + +1. 打开 RustFS 控制台 `http://localhost:9001`（admin / admin123）并创建一个存储桶（例如 `zpan-bucket`） +2. 打开 ZPan `http://localhost:8222`，注册一个用户（第一个用户将获得管理员角色） +3. 进入 **Admin → Storage** 并添加 RustFS 存储： + - **Endpoint**：`http://localhost:9000`（必须能从你的浏览器访问，而不是 Docker 内部主机名） + - **Bucket**：你在第 1 步中创建的存储桶名称 + - **Region**：`us-east-1` + - **Access Key / Secret Key**：`admin` / `admin123` + +> **重要：** 存储端点必须能从**客户端浏览器**访问，因为文件通过预签名 URL 直接上传到 S3。本地开发使用 `http://localhost:9000`，生产环境则使用你服务器的公网 URL。 + +## 文档 + +- [路线图](../../V2_ROADMAP.md) +- [贡献指南](../../CONTRIBUTING.md) + +## v1 + +在寻找 ZPan v1（Go 版本）？请查看 [v1 分支](https://github.com/saltbo/zpan/tree/v1)。 + +## 贡献 + +详情请参阅 [CONTRIBUTING.md](../../CONTRIBUTING.md)。 + +感谢所有为 ZPan 做出贡献的人！ + + + +## 许可证 + +ZPan 采用 GNU Affero General Public License v3.0 许可证。详见 +[LICENSE](../../LICENSE) 文件。