Assistela Docker

나만의 서버 또는 NAS

직접 운영하는 Linux 서버나 호환 NAS에서 브라우저 화면 및 무료 iOS Client와 함께 Assistela를 사용하세요.

채팅, 메모리, 파일, 도구 및 연동 기능은 무료입니다. Assistela Pro는 개인 비서와 스케줄러를 추가합니다. Assistela Client는 무료입니다.

필요한 사항

Docker Engine과 Docker Compose가 설치된 Linux ARM64 또는 AMD64.
작업 공간, 설정 및 백업을 위한 쓰기 가능한 영구 저장소.
컨테이너에서 접근할 수 있는 AI 모델 엔드포인트.
계정 서비스와 기기 페어링을 위한 인터넷 연결.

로컬 또는 호스팅 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 호스트에서만 접근할 수 있습니다.

compose.yaml 다운로드

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

http://localhost:8234/admin/

설치 후 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를 확인하세요. 필요한 경우 폴더 경로를 조정하세요.

Synology용 compose.yaml 다운로드

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 예제는 신뢰할 수 있는 LAN에서 암호화되지 않은 HTTP를 사용합니다. 인터넷을 통해 접근하려면 HTTPS 리버스 프록시를 사용하고 ASSISTELA_PUBLIC_URL을 해당 프록시의 정확한 주소로 설정하세요.

Synology — Container Manager / Project

업데이트 및 백업

데이터는 /data에 마운트된 스토리지인 Docker 볼륨 또는 NAS 폴더에 유지됩니다. 스토리지 매핑, 프로젝트 이름, 호스트 이름을 변경하지 마세요. 업데이트 전에 /data를 백업하고, 그 내용은 절대 삭제하지 마세요.

업데이트하려면 이미지 태그를 새 버전으로 변경하고 pull과 up -d를 다시 실행하세요. Container Manager에서는 YAML을 편집하고 프로젝트를 다시 배포하세요.

Docker 설치 문의 All pricing details