所需条件
- 运行 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 模型，通过二维码配对 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 并重新部署项目。