Syno Package Land

開始使用

此路徑帶您從空白專案到 NAS 上的 Personal App — 以 DSM 帳號開啟，無需額外平台密碼。

15 分鐘目標是產品標準，可能無法達成。假設筆電已安裝 Docker 與 synopkgland，目標 NAS 已安裝 SynoPkgLandService 與 Container Manager。您不需要 Pull Request、DDNS、公開網域或手寫 SPK。

先決條件

  • 開發機上的 Docker。
  • 來自 @synopackageland/cli 的 synopkgland，或在 agent 中載入的 Skill Pack。公開 npm 可能尚未發佈；套件名稱為預期的安裝目標。
  • 已安裝 SynoPkgLandService 與 Container Manager 的目標 NAS。

黃金路徑

  1. 初始化專案。 選擇符合意圖的範本：hello-web（僅身分）、hello-files（身分 + Shared Folder Mount），或 compose-import（包裝現有 compose.yaml）。 
    synopkgland init -t hello-web
  2. 本機開發。 Docker Compose 在筆電上以 mock Broker 執行 — 假的 User Context 與假的檔案樹。Platform SDK 呼叫與真實 NAS 相同的 API 形狀。 
    synopkgland dev
  3. 驗證與測試。 在觸碰 NAS 之前修正 schema 與 Compose 交叉參照。測試證明 contract 與本機 Compose 就緒；不證明真實 DSM ACL。 
    synopkgland validate
synopkgland test
  4. 部署到 NAS。 Inner Loop Deploy 產生 thin SPK，要求 NAS 管理員透過 DSM 授權，寫入 Local Attestation，並安裝 Personal App。無需 SSH，也無需手動將 Compose 貼到 Container Manager。 
    synopkgland deploy --host <nas>
  5. 在 DSM 中開啟。 在 Package Center 或 DSM 中按 Open。若您已登入 DSM，App 不會再要求密碼。Browser SDK 的 requireLogin 與 File API（若已宣告）對真實 DSM 身分與 ACL 執行。

您不需要的項目

  • 手寫 SPK INFO、精靈或套件腳本。
  • Community Repository Pull Request（那是發佈路徑，不是先決條件）。
  • DDNS、DNS、固定網域、路由器規則或預設入口的連接埠轉發。

下一步