−25%

በWindows ዓመታዊ ክፍያ ላይ፣ እስከ ኦክቶበር 31። ዕቅዶችን ይመልከቱ

EQVPS
ጀምር

Docker Compose ለAI ወኪሎች፦ በአንድ VPS ላይ ሙሉ ራስ-የተስተናገደ ስታክ

ሴፕቴ 6 2026 · 3 ደቂቃ ንባብ · EQVPS Team

AI ወኪል ብዙ ጊዜ ነጠላ ሂደት አይደለም። የወኪል ዙሩ ራሱ አለ፣ ለማህደረ ትውስታ ቬክተር ማከማቻ፣ ካሽ፣ አብዛኛውን ጊዜ ለሁኔታ ዳታቤዝ፣ እና ምናልባት ትንሽ ዳሽቦርድ። እያንዳንዱን በእጅ ማሄድ — ማስጀመር፣ ከዳግም ማስነሳት በኋላ ዳግም ማንሳት፣ የትኛው ወደብ የትኛው እንደሆነ ማስታወስ — በፍጥነት ያሰለቻል። Docker Compose ሙሉውን ጉዳይ በአንድ ፋይል ይገልጻል እና በአንድ ትዕዛዝ ያሄደዋል። ይህ ወኪልን በንጹህ መንገድ በVPS ላይ ለማስቀመጥ copy-paste ስታክ ነው።

Docker የሌለውን የማሰማራት ስሪት ብቻ ከፈለግክ፣ AI ወኪልን 24/7 ማሄድ መመሪያ በምትኩ systemd ይሸፍናል። ይህ ገጽ የኮንቴይነር-ተወላጅ ስሪት ነው።

ስታኩ

የተለመደ ራስ-የተስተናገደ ወኪል ከጎኑ አራት ነገሮች ይፈልጋል፦ የወኪል ሂደት፣ Qdrant (የቬክተር ማህደረ ትውስታ)፣ Redis (ካሽ / ወረፋ) እና Postgres (ሁኔታ)። ይህ ሁሉንም የሚያሄድ docker-compose.yml ነው፣ ውስጣዊ አገልግሎቶች ከሕዝብ ኢንተርኔት የተጠበቁ ሆነው፦

# /opt/agent/docker-compose.yml
services:
  agent:
    build: .                      # your agent image (or image: your/agent:latest)
    restart: unless-stopped
    env_file: [.env]              # OPENAI/ANTHROPIC keys etc. — never in this file
    environment:
      QDRANT_URL: http://qdrant:6333
      REDIS_URL: redis://redis:6379
      DATABASE_URL: postgres://agent:${DB_PASSWORD}@postgres:5432/agent
    depends_on: [qdrant, redis, postgres]
    # no ports: — this agent only makes outbound calls. Publish one only if it serves webhooks.

  qdrant:
    image: qdrant/qdrant:latest
    restart: unless-stopped
    volumes: ["qdrant:/qdrant/storage"]   # internal only — not published

  redis:
    image: redis:7-alpine
    restart: unless-stopped
    command: ["redis-server", "--save", "60", "1"]
    volumes: ["redis:/data"]

  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: agent
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: agent
    volumes: ["pg:/var/lib/postgresql/data"]

volumes: { qdrant: {}, redis: {}, pg: {} }

ሚስጥሮች በ.env ውስጥ ይኖራሉ፣ በcompose ፋይል ውስጥ አይደለም፦

# /opt/agent/.env  (chmod 600, never committed)
ANTHROPIC_API_KEY=sk-ant-...
DB_PASSWORD=a-long-random-string

አንሳው፦

apt update && apt install -y docker.io docker-compose-v2
systemctl enable --now docker
cd /opt/agent && docker compose up -d
docker compose logs -f agent

እያንዳንዱ ውስጣዊ አገልግሎት (Qdrant፣ Redis፣ Postgres) በcompose አውታረ መረብ ላይ በአገልግሎት ስም ብቻ ተደራሽ ነው — አንዳቸውም ወደ ኢንተርኔት አልታተሙም። ወኪሉ በዚያ የግል አውታረ መረብ በኩል ከእነሱ ጋር ይነጋገራል፣ እና በእነዚያ ወደቦች ላይ ምንም ወደ ዓለም አይመለከትም።

የሚቆጠሩ ዝርዝሮች

  • በእያንዳንዱ አገልግሎት ላይ restart: unless-stopped — ዳግም ማስነሳትን ወይም ብልሽትን የሚተርፍ ይህ ነው። Docker በማስነሳት አንቃ እና ሙሉ ስታኩ ራሱ ይመለሳል።
  • ቁልፎች በ.env፣ በYAML አይደለም። እንደ env ተለዋዋጮች ጥቀሳቸው፤ .env ን በchmod 600 እና ከgit ውጭ አቆይ። ንቁ ቁልፍ ያለው የተለቀቀ compose ፋይል ጥንታዊው ስህተት ነው።
  • ማተም የማይገባህን ምንም አታትም። የሞዴል API እና የራሱን አገልግሎቶች ብቻ የሚጠራ ወኪል ምንም ገቢ ወደብ አያስፈልገውም — ስለዚህ NAT እቅድ ይሰራል። የተወሰነ IP የምትጨምረው webhooks ወይም ዳሽቦርድ ካገለገለ ብቻ ነው።
  • በማህደረ ትውስታ መጠን ውሰድ፣ በኮር አይደለም። በAPI የተደገፉ ወኪሎች ቀላል ናቸው። የQdrant ኢንዴክስ ትልቅ ሲሆን ወይም የቦታ ሞዴል ስትጨምር፣ ወደ ላይ የምትወጣው ያኔ ነው — ለወኪሎች ከፍተኛ-ማህደረ ትውስታ VPS ተመልከት።

በእውነት የኛ የሆነው ክፍል፦ ወኪሉ የራሱን ማሽን መገንባት ይችላል

EQVPS MCP አገልጋይ ስለሚያጋልጥ፣ ይህን ስታክ የሚያሄድ ወኪል ሌላ ንጹህ VPS በራሱ ማቅረብ ይችላል — ማዘዝ፣ root ማግኘት፣ ማፍረስ — ከቅድመ-ክፍያ ክሪፕቶ ቀሪ ሂሳብ እየከፈለ። አዲስ ሳንድቦክስ የሚያስፈልገው compose ስታክ ያለ ሰው በዙር ውስጥ አንዱን ማንሳት ይችላል።

ለDocker-የተደረገ ወኪል EQVPS ለምን

  • ንጹህ ምስሎች፣ በ~60 ሰከንድ root። Ubuntu/Debian፤ docker compose up እና ስታኩ ሕያው ነው።
  • ያለ KYC፣ በክሪፕቶ ክፍያ። ለመመዝገብ ኢሜይል፣ ለመክፈል USDC/USDT — ማሽኑን ከማንነትህ የሚያስረው ምንም የለም።
  • NVMe + ያልተለካ 1 Gbit/s፣ አውሮፓ (ጀርመን/ፊንላንድ)። ምስሎችን መጎተትና ምዝግቦችን መላክ አስገራሚ ሒሳብ አያመጣም።

ለAI ወኪሎች VPS (አጠቃላይ እይታ) → · ለDocker VPS → · ለወኪል ማህደረ ትውስታ ቬክተር DB አስተናግድ →

FAQ

AI ወኪልን ከራቁት ሂደቶች ይልቅ በDocker Compose ለምን ማሄድ?

ወኪል ብዙ ጊዜ አንድ ሂደት ብቻ አይደለም — የወኪል ዙር ከቬክተር ማከማቻ፣ ካሽ እና አብዛኛውን ጊዜ ዳታቤዝ ጋር ነው። Compose ሙሉውን ስታክ በአንድ ፋይል ይገልጻል፣ ሁሉንም በአንድ ትዕዛዝ ያነሳል፣ በብልሽት ወይም በዳግም ማስነሳት ጊዜ እያንዳንዱን ክፍል ይዳግማል፣ እና ውስጣዊ አገልግሎቶችን (Postgres፣ Redis፣ Qdrant) በግል አውታረ መረብ ላይ ይይዛል ስለዚህ የመረጥከው ብቻ ይጋለጣል። ተንቀሳቃሽ ክፍሎች ያሉት ወኪልን ራስ-ለማስተናገድ በጣም ንጹህ መንገድ ነው።

የወኪል ስታክ ምን እቅድ ይፈልጋል?

በAPI ለተደገፈ ወኪል (ሞዴሉ ለአቅራቢህ ዘንድ ይሄዳል) ስታኩ ቀላል ነው — የወኪል ዙር፣ Qdrant፣ Redis እና Postgres በኛ Small ($8/ወር) ወይም AI-Agent እቅድ ($10/ወር፣ 4 GB) ላይ በምቾት ይገባሉ። ተጨማሪ RAM የሚያስፈልገው ትልቅ የቬክተር ኢንዴክስ በማህደረ ትውስታ ስትይዝ ወይም የቦታ ሞዴል ስታሄድ ብቻ ነው፣ ይህም የተለየ፣ ከባድ ማዋቀር ነው።

የAPI ቁልፎችን የት ላስቀምጥ — በcompose ፋይል ውስጥ?

አይ። ሚስጥሮችን በ.env ፋይል ውስጥ አስቀምጥ (git-የተተወ) እና በcompose ውስጥ እንደ አካባቢ ተለዋዋጮች ጥቀሳቸው፣ ወይም Docker secrets ተጠቀም። ቁልፎችን በጭራሽ ወደ docker-compose.yml አትኮሚት። ውስጣዊ አገልግሎቶችን ወደ compose አውታረ መረብ ብቻ አስረው፤ የወኪሉን ወደብ ብቻ አትም (ወይም ምንም፣ የወጪ ጥሪዎችን ብቻ ካደረገ)።

ኮንቴይነሮች ከዳግም ማስነሳት በኋላ ይመለሳሉ?

ካልካቸው ብቻ። በእያንዳንዱ አገልግሎት ላይ restart: unless-stopped (ወይም always) አዘጋጅና Docker በማስነሳት አንቃ፤ ከዚያ docker compose up -d ዳግም ማስነሳትና ብልሽትን ይተርፋል። ያለ ዳግም-ማስጀመር ፖሊሲ ኮንቴይነር ከሰርቨር ዳግም ማስነሳት በኋላ ተዘግቶ ይቆያል።

KYC ወይም ካርድ ትጠይቃላችሁ?

አይ። ለመመዝገብ ኢሜይል፣ በUSDC ወይም USDT መክፈል — ሰነድ የለም፣ ካርድ የለም። በአንድ ደቂቃ ገደማ root።

አስተያየቶች

እስካሁን አስተያየቶች የሉም። መጀመሪያ ይሁኑ።

አስተያየት ይተዉ

አስተያየቶች ከመታየታቸው በፊት ይጣራሉ።