所需條件
- 執行 Docker Engine 和 Docker Compose 的 ARM64 或 AMD64 Linux 系統。
- 用於工作區、設定和備份的持久化可寫入儲存空間。
- 可從容器存取的 AI 模型服務位址。
- 用於帳號服務和裝置配對的網際網路連線。
Assistela Docker
您自己的伺服器或 NAS
在您自己的 Linux 伺服器或相容的 NAS 上執行 Assistela，透過瀏覽器介面和免費的 iOS Client 使用。
聊天、記憶、檔案、工具和整合功能免費。Assistela Pro 增加個人助理和排程器。Assistela Client 免費。
本機或託管 AI
連接 LM Studio、相容 OpenAI 的模型伺服器，或選擇支援的 AI 供應商。模型獨立於 Assistela 執行；供應商收取的任何費用均不包含在 Pro 中。
請使用可從 Docker 存取的模型位址。容器內的 localhost 指的是該容器，而不是執行模型的電腦。
您的資料，您的主機
Docker 將工作區儲存在主機上的持久化 /data 磁碟區中。請備份該磁碟區並保持主機可用。處理請求所需的資料可能會傳送給您選擇的 AI 供應商。
平台差異
Docker 提供伺服器整合和 Chromium 瀏覽器。它不會控制 Mac 應用程式，也不會直接存取 Apple Mail、iMessage 或 Apple 的本機行事曆和聯絡人。
安裝與首次連線
從 GitHub 下載可直接執行的映像檔。Docker 會自動選擇 ARM64 或 AMD64，無需 Swift 原始碼或編譯器。
ghcr.io/assistela/assistela:2.0.29
Docker Compose
將以下內容儲存為 compose.yaml，然後在同一資料夾中執行下列指令。此範例只能從 Docker 主機存取。
name: assistela-docker-v2
services:
assistela:
image: ghcr.io/assistela/assistela:2.0.29
hostname: assistela-docker-v2
init: true
restart: unless-stopped
stop_grace_period: 120s
shm_size: 512mb
ports:
- "127.0.0.1:8234:8234"
environment:
ASSISTELA_PUBLIC_URL: http://localhost:8234
ASSISTELA_TIME_ZONE: Europe/Prague
volumes:
- assistela-data:/data
security_opt:
- no-new-privileges:true
volumes:
assistela-data:
docker compose pull
docker compose up -d
docker compose logs assistela安裝後，在 Docker 主機上開啟管理介面，使用容器記錄中的設定權杖並設定管理員密碼。然後連接 AI 模型，透過 QR 碼配對 iOS Client。
Synology Container Manager
在相容的 Synology NAS 上，開啟 Container Manager → Project → Create。選擇資料夾，將以下 YAML 貼到編輯器中，然後啟動專案。
將兩處 NAS_IP 替換為 NAS 的私有 IPv4 位址，例如 192.168.1.10。開啟 http://NAS_IP:8234/admin/，並在容器記錄中尋找設定權杖。
建議的 Synology 設定，已使用 user: "1026:100" 測試。請先建立 /volume1/docker/assistela，並將 user 設定為資料夾擁有者的 UID:GID；透過 SSH 執行 id，查看您的帳戶 ID。如有需要，請調整資料夾路徑。
name: assistela
services:
assistela:
image: ghcr.io/assistela/assistela:2.0.29
user: "1026:100"
hostname: assistela
init: true
restart: unless-stopped
stop_grace_period: 120s
shm_size: 512mb
ports:
- "NAS_IP:8234:8234"
environment:
ASSISTELA_PUBLIC_URL: http://NAS_IP:8234
ASSISTELA_ALLOW_LAN_HTTP: "1"
ASSISTELA_TIME_ZONE: Europe/Prague
volumes:
- /volume1/docker/assistela:/data
security_opt:
- no-new-privileges:true
Synology 範例在您信任的區域網路中使用未加密的 HTTP。如需透過網際網路存取，請使用 HTTPS 反向代理，並將 ASSISTELA_PUBLIC_URL 設定為其確切位址。
Synology — Container Manager / Project
更新與備份
資料保留在掛載至 /data 的儲存空間中：Docker 磁碟區或 NAS 資料夾。請勿變更儲存空間對應、專案名稱和主機名稱。更新前請備份 /data；切勿刪除其中的內容。
更新時，將映像檔標籤變更為新版本，然後再次執行 pull 和 up -d。在 Container Manager 中，編輯 YAML 並重新部署專案。