同步 Aino 知識庫

Aino 同步適合個人在電腦、iPhone 與 Android 之間使用同一份 Markdown 知識庫。資料存放在你選擇的儲存服務中。請另外保留備份,避免多台裝置同時編輯同一個檔案。

繁體中文、英文及其他非簡體中文介面預設推薦 Cloudflare R2(S3);簡體中文介面預設推薦 阿里雲 OSS(S3)。應用中的服務順序和新增 S3 連線預設值遵循相同規則;切換語言不會更換既有連線的服務。請先從常用網路測試。

開啟 設定 → 同步與備份,啟用同步並選擇 S3。Git 備份是同一頁的獨立設定。

選擇同步服務

服務Aino 中的選擇設定重點
Cloudflare R2S3 → Cloudflare R2(S3)帳號級 Endpoint、Region auto、開啟路徑定址
阿里雲 OSSS3 → 阿里雲 OSS(S3)實際區域、私有桶、關閉路徑定址
騰訊雲 COSS3 → 騰訊雲 COS(S3)完整 APPID 後綴桶名、關閉路徑定址
Amazon S3S3 → 自訂實際桶區域、限桶 IAM 憑證
MinIOS3 → MinIO各裝置可連線的服務位址、管理員提供的 Region
NextcloudWebDAV → Nextcloud完整 WebDAV 位址、帳號 ID、應用程式專用密碼

同一知識庫的各裝置須使用一致的服務位址、Bucket 或 WebDAV 帳號,以及遠端目錄。各服務的憑證不能混用,預設也不會代為開通帳號或建立儲存桶。

Cloudflare R2(S3)

  1. 在 Cloudflare 控制台開通 R2,建立私有 Bucket。
  2. 建立 R2 API Token,選擇 Object Read & Write,只授權該桶。
  3. 儲存提供給 S3 用戶端的 Access Key ID 與 Secret Access Key。
  4. 複製控制台的 S3 API Endpoint。
  5. 在 Aino 選擇 Cloudflare R2(S3) 預設。
欄位內容
Endpointhttps://<ACCOUNT_ID>.r2.cloudflarestorage.com
BucketR2 桶名
Regionauto
AccessKey ID / Secret上一步建立的 S3 憑證
Prefix/Aino,各裝置保持一致
路徑定址開啟

R2 預設:Region 為 auto,路徑定址開啟;圖為簡體中文介面

將預設位址中的 account-id 換成實際帳號 ID,或直接貼上控制台的完整 Endpoint。EU 管轄區 Bucket 使用對應的管轄區 Endpoint。不要將 Cloudflare API 的 bearer token 填入 S3 憑證欄位;同步不需要公開 Bucket 或開啟公共開發 URL。

參考:R2 S3 設定、S3 API 與 Region、管轄區 Endpoint。

阿里雲 OSS(S3)

  1. 在阿里雲控制台開通 OSS,建立專用 Bucket,選擇 標準儲存、私有存取權限。
  2. 記下 Bucket 的地域與公網 Endpoint。手機及家用電腦不要使用 -internal 內網位址。
  3. 在 RAM 存取控制建立專用使用者與 AccessKey,不使用主帳號金鑰。
  4. 設定限於該桶的權限:acs:oss:*:*:YOUR_BUCKET 允許 oss:ListObjects;acs:oss:*:*:YOUR_BUCKET/* 允許 oss:GetObject、oss:PutObject、oss:DeleteObject。將 YOUR_BUCKET 替換為實際桶名,並將策略綁定至該 RAM 使用者。
  5. 在 Aino 選擇 阿里雲 OSS(S3) 預設,填入下表參數。
欄位內容
Endpoint杭州範例:https://oss-cn-hangzhou.aliyuncs.com,其他地域使用實際接入點
Bucket只填桶名,不包含 URL 或資料夾
Region杭州為 cn-hangzhou;必須符合桶的地域
AccessKey ID / Secret專用 RAM 使用者的金鑰
Prefix/Aino,各裝置保持一致
路徑定址關閉

OSS 預設:核對地域與 Endpoint,關閉路徑定址;圖為簡體中文介面

預設的杭州只是範例,不會替你建立 Bucket。不要將含桶名的物件 URL 當作 Endpoint,也不要開放公共讀寫。若帳號或地域需要額外的存取設定,請依控制台錯誤與官方說明處理。

參考:OSS 的 S3 相容範圍、OSS 憑證與接入點。

騰訊雲 COS(S3)

已有騰訊雲帳號時,也可以使用 騰訊雲 COS(S3),將同步資料保留在自己的私有儲存桶。

  1. 在 COS 控制台建立私有的標準儲存桶,記錄實際區域及完整桶名。桶名須包含 APPID 後綴,例如 aino-sync-1250000000。
  2. 在存取管理 CAM 準備專用子使用者及程式存取憑證,只授予目標儲存桶的物件列舉、讀取、寫入及刪除權限;不需要公開存取或整個帳號的管理權限。
  3. 在 Aino 設定 → 同步與備份 → S3 選擇 騰訊雲 COS(S3)。
欄位填寫內容
Endpoint廣州範例:https://cos.ap-guangzhou.myqcloud.com,不含桶名或物件路徑
Bucket含 APPID 後綴的完整桶名,例如 aino-sync-1250000000
Region廣州為 ap-guangzhou;其他區域依實際儲存桶填寫,並同步修改 Endpoint
AccessKey IDCAM 憑證的 SecretId
AccessKey SecretCAM 憑證的 SecretKey,不是帳號登入密碼
Prefix/Aino,同一知識庫的各裝置保持一致
路徑定址關閉,使用虛擬主機定址

騰訊雲 COS 預設:區域與 Endpoint 一致,關閉路徑定址;圖為簡體中文介面

廣州只是範例,預設不會建立儲存桶。先展開 更多 → 檢查連線,再以少量測試檔案檢查跨裝置新增、修改、重新命名及刪除。儲存桶版本控制可能影響禁止覆寫能力,請先確認設定及測試結果,再接入正式知識庫。桌面端已設定 AI 時,可點擊服務旁的 AI 引導設定同步;金鑰只填入設定,不傳至聊天。

參考:騰訊雲 S3 相容接入、COS 上傳與禁止覆寫。

Amazon S3(自訂 S3)

AWS S3 使用既有的 自訂 S3 連線,不需要 AWS 專用預設。

  1. 在 AWS 控制台建立專用的 一般用途儲存桶,記下實際區域。保持封鎖所有公開存取、停用 ACL,並使用預設 SSE-S3 加密。
  2. 建立同步專用 IAM 使用者與 Access Key,只授權目標桶;不要使用根帳號金鑰。
  3. 在 設定 → 同步與備份 → S3 → 自訂 S3 填寫下表。東京只是範例,Endpoint 與 Region 須符合實際桶區域。
欄位內容
Endpoint東京範例:https://s3.ap-northeast-1.amazonaws.com
Bucket只填桶名,例如 your-aino-vault
Region東京為 ap-northeast-1,不是 R2 的 auto
AccessKey ID / Secret專用 IAM 使用者的 Access Key ID 與 Secret Access Key
Prefix/Aino,同一知識庫的各裝置保持一致
路徑定址開啟;虛擬主機定址亦已完成基礎讀寫驗證

桶資源 arn:aws:s3:::YOUR_BUCKET 允許 s3:ListBucket、s3:GetBucketLocation;物件資源 arn:aws:s3:::YOUR_BUCKET/* 允許 s3:GetObject、s3:PutObject、s3:DeleteObject。請替換實際桶名。同步不需要列出整個帳號的桶或管理 ACL。SSE-KMS、物件鎖定及特殊桶策略可能需要額外權限或有限制,請依設定核對。

先執行 更多 → 檢查連線,再用小型測試庫確認。AWS 已通過真實雲端同步引擎回歸及 macOS 應用連線檢查;AWS 三端大知識庫驗證仍待完成。儲存、請求和出站流量分別計費,請先從常用網路測試。

參考:AWS 桶級 IAM 策略、S3 區域與接入點。

Nextcloud(WebDAV)

已有 Nextcloud 或準備自部署時,在 Aino 選擇 WebDAV → Nextcloud。伺服器、網域、HTTPS 憑證、升級與備份由你或服務提供者管理,Aino 不會代為部署伺服器。

  1. 先確認瀏覽器可以登入並上傳檔案;自部署可從 Nextcloud 安裝說明 開始。
  2. 在 檔案 → 檔案設定 複製 WebDAV 位址。常見格式為 https://cloud.example.com/remote.php/dav/files/USERNAME/;子目錄部署須保留子目錄,使用實例顯示的完整位址。
  3. 在個人安全設定產生 應用程式專用密碼。使用者名稱填 WebDAV 位址對應的帳號 ID,密碼填應用程式專用密碼。
  4. Endpoint 填完整 WebDAV 位址,遠端根目錄填 /Aino。先 檢查連線,再以少量筆記和附件驗證新增、覆寫、重新命名及刪除。

公開分享連結或伺服器首頁不是 WebDAV 位址。啟用雙因素驗證時仍使用應用程式專用密碼。反向代理的上傳限制、逾時、儲存配額及憑證問題須在伺服器端處理;先檢查失敗項目再重試。

參考:Nextcloud 官方 WebDAV 指南。

第一次同步與加入其他裝置

  1. 先備份重要資料,使用小型測試庫確認連線。
  2. 填寫服務、Endpoint、Bucket、Region、憑證與 Prefix。
  3. 在 更多 → 檢查連線 確認可用,再點擊 同步。
  4. 等第一台裝置完整上傳,再接入其他裝置。
  5. 在第二台裝置選擇新的空資料夾,使用相同服務、Endpoint、Bucket、Region 與 Prefix,以及具有該桶權限的憑證。
  6. 同步完成後,確認筆記、圖片與附件可以開啟。

大庫首次同步時,讓手機保持喚醒並將 Aino 留在前景。展開詳情查看目前批次與失敗項;單一批次完成不代表整個知識庫已完成。不同 Prefix(例如 /Aino 與 /Aino-test)是獨立的同步空間。

其他選擇

  • MinIO/自訂 S3:依服務商要求設定接入點、地域與定址方式。
  • Koofr/Nextcloud/自訂 WebDAV:使用應用程式專用密碼。Koofr 位址為 https://app.koofr.net/dav/Koofr/,使用者名稱是帳號電子郵件,遠端根目錄可設為 /Aino。

從舊服務遷移

先確認一台裝置擁有完整資料並備份,再上傳至新服務的獨立桶或 Prefix。其他裝置使用空資料夾接入,確認完整後才停止舊服務。不要讓兩套服務同時寫入同一個本機資料夾,也不要在驗收前刪除舊桶。切換服務需要重新填寫對應憑證。

常見問題

  • 連線失敗:核對 HTTPS 接入點及桶名。OSS 地域必須一致並關閉路徑定址;R2 使用 auto 並開啟路徑定址。COS 需填完整 APPID 後綴桶名,區域與接入點一致並關閉路徑定址。
  • 401/403:核對金鑰、有效期與桶權限。輪替金鑰後,各裝置都要更新。
  • 400:核對接入點、地域與定址方式。公共分享 URL 不是 S3 Endpoint。
  • 429/503:查看重試狀態、服務配額與帳單;反覆點擊同步可能增加請求。
  • 看不到變更:核對 Bucket 與 Prefix 是否完全一致,並檢查忽略規則及失敗項。
  • 首次掃描很久:大庫需要時間,請觀察整體動作進度與錯誤。

儲存、請求及下載流量可能分別計費,開通前請查閱服務商最新價格。不要在公開截圖中展示金鑰,也不要為解決權限錯誤將桶設為公開。

下一步