SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

วิธีติดตั้ง AFFiNE บน VPS ด้วย Docker Compose

เรียนรู้วิธีติดตั้ง AFFiNE บนเซิร์ฟเวอร์ส่วนตัวผ่าน Docker Compose ครบทั้ง 4 คอนเทนเนอร์ การตั้งค่า image tags การจัดการข้อมูล และการประเมินการใช้ RAM 2 GB สำหรับการใช้งานจริง

สิ่งที่คุณจะได้รับเมื่อทำ Self-host AFFiNE

การทำ self-host AFFiNE ช่วยให้คุณมีพื้นที่ทำงานสไตล์ Notion บนเซิร์ฟเวอร์ที่คุณควบคุมเอง โดยรันเป็นคอนเทนเนอร์ 4 ตัว ได้แก่ ตัวแอปพลิเคชัน, งาน migration แบบครั้งเดียว, Postgres และ Redis ระบบรองรับการทำงานร่วมกันแบบเรียลไทม์ โดยรองรับผู้ใช้งานสูงสุด 10 ที่นั่งสำหรับพื้นที่ทำงานแบบ self-hosted ตามค่าเริ่มต้น การติดตั้งประกอบด้วยไฟล์ compose 1 ไฟล์ และไฟล์ config JSON 1 ไฟล์ สิ่งที่ต้องพิจารณาคือ image tags, การจัดวางดิสก์, ขีดจำกัดของหน่วยความจำ และ proxy ที่คุณจะวางไว้ด้านหน้า

AFFiNE รวมโปรแกรมแก้ไขเอกสารและพื้นที่ทำงานแบบไม่จำกัด (infinite canvas) ไว้ในพื้นที่ทำงานเดียวกัน ทำให้หน้าเอกสารหนึ่งหน้าสามารถอ่านในรูปแบบเอกสารหรือกางออกเป็นไวท์บอร์ดได้ หากคุณยังตัดสินใจไม่ได้ว่าจะรันซอฟต์แวร์ตัวใด ให้ลองอ่าน การเปรียบเทียบทางเลือก Notion แบบ self-hosted ก่อน คู่มือนี้ถือว่าคุณตัดสินใจเลือกแล้ว และจะเน้นไปที่การรัน AFFiNE อย่างถูกต้องแทนการเปรียบเทียบซ้ำอีกครั้ง

ข้อมูลทั้งหมดในที่นี้ได้รับการตรวจสอบกับเอกสารประกอบการทำ self-host ของ AFFiNE และไฟล์ release ที่เผยแพร่เมื่อวันที่ 8 สิงหาคม 2026 โดย release เสถียรล่าสุด ณ วันนั้นคือ 0.27.3 ซึ่งเผยแพร่เมื่อวันที่ 23 กรกฎาคม 2026 ข้อความด้านล่างที่มีวันที่ระบุภายหลังได้รับการตรวจสอบซ้ำกับแหล่งข้อมูลหลักเมื่อวันที่ 12 ตุลาคม 2026 ซึ่ง ณ เวลานั้น release เสถียรล่าสุดคือ 0.27.4 ซึ่งเผยแพร่เมื่อวันที่ 18 สิงหาคม 2026

หน้าที่ของคอนเทนเนอร์ทั้งสี่ตัว

affine คือเซิร์ฟเวอร์และเว็บไคลเอนต์ที่รวมอยู่ในอิมเมจเดียว โดยจะรอรับการเชื่อมต่อที่พอร์ต 3010

affine_migration เป็นงานแบบ one-shot ที่รัน node ./scripts/self-host-predeploy.js เพื่อปรับปรุงโครงสร้างฐานข้อมูล (database migrations) แล้วจบการทำงาน แอปพลิเคชันได้ประกาศ condition: service_completed_successfully ไว้ในงานดังกล่าว ดังนั้นหากการ migration จบลงด้วยสถานะที่ไม่ใช่ศูนย์ จะส่งผลให้ affine ไม่เริ่มทำงานเลย หากหน้าเว็บอินเทอร์เฟซไม่แสดงขึ้นมา ให้ตรวจสอบ log ของงานนี้เป็นอันดับแรก

postgres เป็นที่เก็บเอกสาร ผู้ใช้ พื้นที่ทำงาน และสิทธิ์การเข้าถึงของคุณ อิมเมจที่มาพร้อมกับซอฟต์แวร์คือ pgvector/pgvector:pg16 ซึ่งเป็น Postgres 16 มาตรฐานที่คอมไพล์รวมกับส่วนขยาย pgvector ไว้แล้ว pgvector จะเพิ่มชนิดข้อมูล vector เข้าไปใน Postgres ซึ่งเป็นรูปแบบตัวเลขที่ใช้เก็บ embeddings เพื่อให้สามารถค้นหาข้อความตามความหมายได้

redis เป็น dependency ที่จำเป็น: ทั้งเซิร์ฟเวอร์และงาน migration จะรอให้ health check ของบริการนี้ผ่านก่อนจึงจะเริ่มทำงาน สังเกตว่าไฟล์ compose ที่มาพร้อมกับซอฟต์แวร์ไม่ได้กำหนด volume ให้กับ Redis ข้อมูลภายในนั้นจะไม่คงอยู่หลังจากการ docker compose down ซึ่งบ่งบอกชัดเจนว่ามันไม่ได้เก็บเนื้อหาของคุณและไม่จำเป็นต้องสำรองข้อมูล

เหตุผลที่อิมเมจ Postgres เป็น pgvector ไม่ใช่ stock postgres

ความต้องการนี้มาจากโครงสร้าง schema ของ AFFiNE ไม่ใช่ความชอบส่วนตัว ในเวอร์ชัน v0.27.4 นั้น schema.prisma ยังคงประกาศ extensions = [pgvector(map: "vector")] อยู่ แต่ไม่มีคอลัมน์สำหรับ embedding ทั้ง 4 โมเดลที่มีคอลัมน์ embedding ซึ่งกำหนดชนิดเป็น vector(1024) ใน v0.27.3 ได้ถูกตัดออกไปใน v0.27.4 ดังนั้นให้คงการใช้ pgvector/pgvector:pg16 ตามที่ระบุไว้ เพราะส่วนขยายดังกล่าวยังคงถูกเรียกใช้งานอยู่ และ postgres:16 แบบมาตรฐานไม่มีส่วนขยายนี้มาให้

เทมเพลตอย่างเป็นทางการของ v0.27.4 ใช้อิมเมจ pgvector ในขณะที่เทมเพลต v0.21.0 ยังคงใช้ postgres:16 สำหรับการติดตั้งเวอร์ชันเก่า การแก้ไขบรรทัดอิมเมจเพียงอย่างเดียวไม่ใช่ขั้นตอนการอัปเกรดทั้งหมด ดังนั้นโปรดอ่านหน้าการอัปเกรดใน เอกสารการ self-host ของ AFFiNE ก่อนที่จะดึงอิมเมจใดๆ

อีกเรื่องหนึ่งเกี่ยวกับแท็กดังกล่าว pg16 หมายถึง Postgres 16 ซึ่งเลขเวอร์ชันหลักของ Postgres ไม่ใช่สิ่งที่คุณจะปรับเพิ่มขึ้นได้เอง หากคุณเปลี่ยนเป็น pg17 บนไดเรกทอรีข้อมูลเดิม Postgres จะปฏิเสธการเริ่มทำงาน โดยจะแสดงข้อความในลักษณะ The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17 ใน docker compose logs postgres การย้ายเวอร์ชันหลักจำเป็นต้องใช้วิธีใดวิธีหนึ่งใน 3 วิธีที่ระบุไว้ในบันทึกประจำรุ่นของ PostgreSQL 17 ได้แก่ การ dump และ restore ข้อมูลลงในไดเรกทอรีใหม่, การใช้ pg_upgrade หรือการทำ logical replication สำหรับการติดตั้งผ่าน Compose แบบเดี่ยว การ dump และ restore มักเป็นวิธีที่ง่ายที่สุด เนื่องจาก pg_upgrade จำเป็นต้องใช้ไฟล์ binary ของเซิร์ฟเวอร์เวอร์ชันเก่าและใหม่ควบคู่กันไป

AFFiNE ที่โฮสต์เองต้องการ CPU และ RAM เท่าใด

หน้าความต้องการของระบบของ AFFiNE ระบุว่าต้องการ CPU อย่างน้อย 4 คอร์ และ RAM 2 GB และจะเพิ่มหน่วยความจำเป็น 4 GB เมื่อเอกสารของคุณมีจำนวนคำเกิน 10,000 คำ หน้าเดียวกันนี้ระบุว่าหน่วยความจำถูกใช้ไปกับส่วนใดบ้าง นั่นคือระบบซิงค์และการรวมเอกสาร (document merging) มีตัวเลขหนึ่งที่ควรจำไว้คือ การรวมเอกสารที่มีการแก้ไข 10,000 รายการ อาจใช้หน่วยความจำสูงสุดถึง 1 GB

เมื่อพิจารณาเทียบกับแผน 2 GB ที่มีผู้เขียน 2 คน ค่าเฉลี่ยถือว่าอยู่ในเกณฑ์ปกติ Postgres และกระบวนการ Node ทำงานได้ภายใต้ขีดจำกัดและยังมีพื้นที่เหลือ แต่ปัญหาจะอยู่ที่ช่วงที่มีการใช้งานสูงสุด (peak) การรวมเอกสารขนาดใหญ่เพียงรายการเดียวอาจผลักดันให้การใช้หน่วยความจำของเซิร์ฟเวอร์พุ่งสูงขึ้นถึงประมาณ 1 GB และบนเครื่องขนาด 2 GB ที่ไม่มี swap ค่าสูงสุดนั้นรวมกับ Postgres และกระบวนการอื่นๆ ที่ทำงานอยู่ อาจทำให้หน่วยความจำหมดลงได้ จากนั้น kernel ของระบบจะเรียกใช้ out-of-memory (OOM) killer เพื่อปิดกระบวนการหนึ่งทิ้งเพื่อคืนหน่วยความจำ เซิร์ฟเวอร์ AFFiNE ซึ่งเป็นกระบวนการที่ใหญ่ที่สุดมักจะตกเป็นเหยื่อ แม้ว่าเอกสารของ Docker จะระบุชัดเจนว่ากระบวนการใดก็อาจถูกเลือกได้ รวมถึงตัว Docker เองด้วย

เมื่อเป็นเซิร์ฟเวอร์ AFFiNE ที่ถูกปิด เพื่อนร่วมงานของคุณจะไม่เห็นข้อผิดพลาด แต่จะเห็นหน้าเว็บโหลดใหม่ เพราะ restart: unless-stopped จะนำคอนเทนเนอร์กลับมาทำงานภายในไม่กี่วินาที อย่าเดาสาเหตุ ให้ตรวจสอบดังนี้:

docker inspect affine_server --format '{{.State.OOMKilled}} {{.RestartCount}}'
sudo dmesg -T | grep -i -E 'out of memory|killed process'

true จากคำสั่งแรก หรือบรรทัด Killed process ที่ระบุชื่อ node จากคำสั่งที่สอง หมายความว่าหน่วยความจำของคุณหมด ไม่ใช่เพราะพบข้อผิดพลาดในซอฟต์แวร์ ให้แก้ไขจากทั้งสองด้าน ขั้นแรกให้เพิ่ม swap เพื่อให้ช่วงที่ใช้งานสูงมีพื้นที่รองรับก่อนที่ OOM killer จะทำงาน:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
free -h

free -h ควรรายงานค่า swap รวม 2.0Gi ในตอนนี้ Swap ไม่ได้ทำให้ AFFiNE ทำงานเร็วขึ้นและไม่ได้ถูกออกแบบมาเพื่อจุดประสงค์นั้น แต่มันช่วยให้ช่วงที่ใช้งานสูงมีที่ไป ซึ่งมีโอกาสสูงกว่ามากที่การใช้งานจะช้าลงเพียงชั่วครู่ แทนที่จะทำให้คอนเทนเนอร์หยุดทำงาน มันเป็นเพียงบัฟเฟอร์ไม่ใช่การรับประกัน อีกด้านของการแก้ไขคือการจำกัดไม่ให้ Postgres ขยายแคชเข้าไปในพื้นที่ที่แอปพลิเคชันต้องการในขณะรวมเอกสาร ซึ่งเป็นหน้าที่ของ การจำกัดหน่วยความจำบนบริการ Compose หากยังมีการหยุดทำงานหลังจากทำทั้งสองอย่างแล้ว เซิร์ฟเวอร์จำเป็นต้องใช้ 4 GB ตามที่หน้าความต้องการของ AFFiNE ระบุไว้สำหรับเอกสารขนาดใหญ่

การจัดเก็บข้อมูลนั้นคาดการณ์ได้ง่ายกว่า นี่คือตัวเลขที่ AFFiNE เผยแพร่ไว้ในหน้าเดียวกัน:

แผนภูมิPublished AFFiNE storage figures, August 2026
ข้อมูลเบื้องหลังแผนภูมินี้
[
  {
    "label": "Server install",
    "gb": 1.5
  },
  {
    "label": "Postgres per 1,000 docs",
    "gb": 0.1
  },
  {
    "label": "Blob store per 1,000 uploads",
    "gb": 10
  }
]

การติดตั้งเซิร์ฟเวอร์ใช้พื้นที่ 1.5 GB เอกสาร 1,000 ฉบับที่แต่ละฉบับมีประมาณ 1,000 คำ จะเพิ่มข้อมูล Postgres อีก 0.1 GB ซึ่งแทบไม่มีนัยสำคัญ ไฟล์ที่อัปโหลด 1,000 ไฟล์จะเพิ่มพื้นที่อีก 10 GB ซึ่งเป็นส่วนหลักของทั้งหมด ตัวเลขเหล่านี้เป็นตัวเลขสำหรับการวางแผนที่เผยแพร่ ไม่ใช่การวัดจากอินสแตนซ์ที่กำลังทำงานจริง ดังนั้นให้ถือว่าเป็นแนวทางไม่ใช่ข้อตกลง สิ่งที่สำคัญคือรูปแบบ: ฐานข้อมูลของคุณจะมีขนาดเล็ก และไฟล์ที่อัปโหลดจะเป็นตัวกำหนดพื้นที่ดิสก์ของคุณ

เขียนไฟล์ compose ด้วยตนเองพร้อมระบุเวอร์ชันของ image ให้ชัดเจน

วิธีการติดตั้งตามเอกสารแนะนำให้ดาวน์โหลดไฟล์สำเร็จรูปด้วย curl -L -o docker-compose.yml https://github.com/toeverything/AFFiNE/releases/latest/download/docker-compose.yml ซึ่งใช้งานได้จริง แต่มีรายละเอียดหนึ่งที่ควรทราบก่อนเริ่มใช้งาน: ณ วันที่ 8 สิงหาคม 2026 ไฟล์ที่แนบมากับ release 0.27.3 ยังคงอ่าน path จากไฟล์ .env โดยใช้ ${UPLOAD_LOCATION}, ${CONFIG_LOCATION} และ ${DB_DATA_LOCATION} ในขณะที่หน้าอ้างอิงของเอกสารแสดงโครงสร้างใหม่ที่เก็บข้อมูล storage และ PostgreSQL ไว้ภายใต้ ./data, เก็บการตั้งค่าไว้ภายใต้ ./config และไม่จำเป็นต้องใช้ .env อีกต่อไป ต่อมา release 0.27.4 ได้ปรับไฟล์ที่แนบมาให้เป็นโครงสร้างดังกล่าว และ ณ วันที่ 12 ตุลาคม 2026 ทั้งสองแหล่งข้อมูลจึงตรงกัน หากคุณติดตั้งจากไฟล์เวอร์ชันเก่า path ของคุณจะยังคงมาจาก .env และหน้าอัปเกรดของ AFFiNE ได้เตือนไว้ว่าการเปลี่ยนไฟล์ compose โดยไม่ย้ายการตั้งค่าเหล่านั้นตามไปด้วย อาจทำให้ Postgres เริ่มทำงานด้วยไดเรกทอรีข้อมูลที่ว่างเปล่า การเขียนไฟล์ด้วยตนเองจะช่วยหลีกเลี่ยงปัญหานี้ได้ทั้งหมด อีกทั้งคุณยังต้องแก้ไขไฟล์เพื่อระบุเวอร์ชันของ image และตั้งรหัสผ่านฐานข้อมูลอยู่ดี

mkdir -p ~/affine/config ~/affine/data
cd ~/affine
printf 'DB_PASSWORD=%s\n' "$(openssl rand -hex 24)" > .env
chmod 600 .env

Compose จะอ่านค่า .env จากไดเรกทอรีโปรเจกต์โดยอัตโนมัติและแทนที่ค่า ${DB_PASSWORD} ให้คุณ ดังนั้นรหัสผ่านจะไม่ปรากฏในไฟล์ที่คุณอาจนำไปวางในกระทู้สนับสนุน นิสัยนี้ควรนำไปใช้กับทุก stack ที่คุณใช้งาน ซึ่งเหตุผลอธิบายไว้ใน การเก็บความลับไว้นอกไฟล์ compose

ตอนนี้ให้เขียนไฟล์ ~/affine/docker-compose.yml ดังนี้:

name: affine
services:
  affine:
    image: ghcr.io/toeverything/affine:stable
    container_name: affine_server
    ports:
      - '127.0.0.1:3010:3010'
    depends_on:
      redis:
        condition: service_healthy
      postgres:
        condition: service_healthy
      affine_migration:
        condition: service_completed_successfully
    volumes:
      - ./data/storage:/root/.affine/storage
      - ./config:/root/.affine/config
    environment:
      - REDIS_SERVER_HOST=redis
      - DATABASE_URL=postgresql://affine:${DB_PASSWORD}@postgres:5432/affine
      - AFFINE_INDEXER_ENABLED=false
    restart: unless-stopped

  affine_migration:
    image: ghcr.io/toeverything/affine:stable
    container_name: affine_migration_job
    command: ['sh', '-c', 'node ./scripts/self-host-predeploy.js']
    volumes:
      - ./data/storage:/root/.affine/storage
      - ./config:/root/.affine/config
    environment:
      - REDIS_SERVER_HOST=redis
      - DATABASE_URL=postgresql://affine:${DB_PASSWORD}@postgres:5432/affine
      - AFFINE_INDEXER_ENABLED=false
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy

  redis:
    image: redis:8-alpine
    container_name: affine_redis
    healthcheck:
      test: ['CMD', 'redis-cli', '--raw', 'incr', 'ping']
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped

  postgres:
    image: pgvector/pgvector:pg16
    container_name: affine_postgres
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: affine
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: affine
      POSTGRES_INITDB_ARGS: '--data-checksums'
    healthcheck:
      test: ['CMD', 'pg_isready', '-U', 'affine', '-d', 'affine']
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped

มีความแตกต่าง 4 ประการจากไฟล์ที่ผู้พัฒนาจัดเตรียมไว้ ซึ่งแต่ละจุดมีเหตุผลดังนี้:

  • 127.0.0.1:3010:3010 จะเผยแพร่พอร์ตบน loopback address เท่านั้น Docker เวอร์ชันก่อน 28.0.0 อนุญาตให้โฮสต์บน L2 segment เดียวกันเข้าถึงพอร์ตที่เผยแพร่บน localhost ได้ และการตั้งค่า direct routing อาจทำให้พอร์ตของคอนเทนเนอร์ถูกเปิดเผยแม้จะเผยแพร่บน loopback แล้วก็ตาม ควรใช้ Docker 28.0.0 หรือใหม่กว่าและปิดการใช้งาน direct routing ระหว่างการติดตั้ง ไฟล์ '3010:3010' ของผู้พัฒนาจะผูกกับทุก interface ซึ่งใน VPS ส่วนใหญ่รวมถึง interface สาธารณะด้วย
  • POSTGRES_HOST_AUTH_METHOD: trust ถูกนำออกและเปลี่ยนเป็นการตั้งรหัสผ่านแทน การยืนยันตัวตนแบบ trust จะยอมรับการเชื่อมต่อใดๆ ไปยังฐานข้อมูลนั้นในฐานะผู้ใช้ affine โดยไม่ต้องใช้รหัสผ่าน ซึ่งจำกัดอยู่แค่ภายในเครือข่ายส่วนตัวของ Compose เท่านั้น ซึ่งอาจจะปลอดภัยจนกว่าวันหนึ่งที่คุณจะเชื่อมต่อคอนเทนเนอร์เพิ่มเข้าไปในเครือข่ายนั้น หรือเผลอเปิดพอร์ต 5432 ขณะกำลังดีบั๊ก
  • redis:8-alpine ถูกนำมาใช้แทน redis แบบเดิม ซึ่งจะชี้ไปที่ latest ณ เดือนสิงหาคม 2026 คือ Redis 8 ดังนั้นการระบุเวอร์ชันจะช่วยล็อกเวอร์ชันหลักที่คุณทดสอบไว้และป้องกันไม่ให้ Redis 9 ถูกติดตั้งเข้ามาโดยไม่ตั้งใจระหว่างการทำ docker compose pull
  • pgvector/pgvector:pg16 ยังคงค่าเดิมตามที่ผู้พัฒนากำหนดไว้ ด้วยเหตุผลที่กล่าวไปข้างต้น

POSTGRES_PASSWORD จะถูกอ่านเฉพาะตอนที่ Postgres สร้างไดเรกทอรีข้อมูลเป็นครั้งแรกเท่านั้น สำหรับ instance ที่มีอยู่แล้ว ให้ตั้งรหัสผ่านด้วย docker compose exec postgres psql -U affine -c "ALTER USER affine WITH PASSWORD 'yourpassword'" จากนั้นอัปเดต DATABASE_URL ให้ตรงกัน

การตั้งค่าอยู่ใน config/config.json

AFFiNE อ่านการตั้งค่าจาก config/config.json ซึ่งเป็นไดเรกทอรีที่คุณ mount ไว้ที่ /root/.affine/config เนื่องจากไม่มีกระบวนการใดสร้างไฟล์นี้ให้คุณโดยอัตโนมัติ คุณจึงต้องเขียนไฟล์นี้ขึ้นมาก่อนการเริ่มทำงานครั้งแรก ให้เปิด ~/affine/config/config.json ด้วยโปรแกรมแก้ไขข้อความและใส่เนื้อหาต่อไปนี้ โดยเปลี่ยนโดเมนตัวอย่างให้เป็นโดเมนของคุณ:

{
  "$schema": "https://github.com/toeverything/affine/releases/latest/download/config.schema.json",
  "server": {
    "name": "Team workspace",
    "externalUrl": "https://affine.example.com"
  },
  "copilot": {
    "enabled": false,
    "byok": {
      "enabled": false
    }
  }
}

server.externalUrl ต้องเป็นที่อยู่ที่ผู้ใช้ของคุณใช้เปิดผ่านเบราว์เซอร์จริงๆ AFFiNE จะสร้างลิงก์แชร์และคำเชิญเข้า workspace จากค่านี้ ดังนั้นหากปล่อยไว้เป็น http://localhost:3010 คำเชิญที่คุณส่งไปจะชี้ไปยังเครื่องของผู้รับเองและทำให้ใช้งานไม่ได้ คุณต้องตั้งค่านี้ให้เป็นที่อยู่ HTTPS สาธารณะก่อนการเริ่มทำงานครั้งแรก เพื่อให้ไฟล์ตั้งค่าและแผงควบคุมผู้ดูแลระบบมีข้อมูลที่ตรงกันเสมอ การตั้งค่าที่คุณเปลี่ยนในแผงควบคุมผู้ดูแลระบบในภายหลังจะถูกบันทึกลงในฐานข้อมูล ไม่ได้ถูกเขียนกลับลงในไฟล์นี้

copilot ใช้ควบคุมฟีเจอร์ AI ส่วน copilot.byok.enabled คือสวิตช์สำหรับนำคีย์มาใช้เอง (bring-your-own-key) ซึ่งช่วยให้เจ้าของ workspace สามารถวางคีย์ของผู้ให้บริการโมเดลของตนเองลงในการตั้งค่า workspace ได้ การ self-host AFFiNE จะไม่รวมการสมัครสมาชิก AI ไว้ด้วย ให้คงค่า false ไว้ทั้งสองรายการหากคุณไม่ต้องการใช้งาน

เริ่มการทำงานของ stack:

docker compose up -d
docker compose ps --all

docker compose ps --all ควรแสดงรายการ affine_postgres และ affine_redis ว่าอยู่ในสถานะ healthy, affine_server อยู่ในสถานะ running และ affine_migration_job อยู่ในสถานะ exited (0) สิ่งสำคัญคือ --all เพราะหากไม่มีค่านี้ docker compose ps จะแสดงเฉพาะคอนเทนเนอร์ที่กำลังทำงานอยู่เท่านั้น ทำให้งาน migration ที่เสร็จสมบูรณ์ไปแล้วไม่ปรากฏให้เห็น หากงาน migration มี exit code อื่นที่ไม่ใช่ค่าปกติ คุณต้องตรวจสอบที่จุดนั้น โดยดู log เพื่อระบุขั้นตอนที่เกิดปัญหา:

docker compose logs affine_migration

ตรึงอิมเมจไว้ก่อนที่คุณจะลืม

stable เป็นแท็กที่มีการเปลี่ยนแปลงอยู่ตลอด เวิร์กโฟลว์การปล่อยซอฟต์แวร์ของ AFFiNE จะชี้แท็กหลายรายการไปยัง build ที่เสถียรแต่ละตัว โดยมีสองแท็กที่สำคัญในที่นี้คือ stable ซึ่งจะถูกเปลี่ยนจุดชี้ทุกครั้งที่มีการปล่อยเวอร์ชันใหม่ และ stable- ตามด้วย git short hash ซึ่งจะไม่มีการเปลี่ยนแปลง หากคุณปล่อยไว้ที่ stable การทำ docker compose pull ในอีกหกเดือนข้างหน้าจะไปดึงอิมเมจตัวอื่นมาใช้งาน และรันการย้ายฐานข้อมูล (migration) ในเวลาที่คุณไม่ได้เป็นคนกำหนดเอง คุณควรตรึงอิมเมจตัวที่คุณได้ทดสอบแล้วไว้:

docker compose pull
docker image inspect ghcr.io/toeverything/affine:stable --format '{{index .RepoDigests 0}}'

คำสั่งดังกล่าวจะแสดงบรรทัดที่คล้ายกับ ghcr.io/toeverything/affine@sha256: ตามด้วยค่าแฮชยาวๆ ให้คัดลอกสตริงทั้งหมดไปวางในบรรทัด image: ของทั้ง affine และ affine_migration ทั้งสองไฟล์นี้ต้องตรงกันเสมอเนื่องจากเป็นอิมเมจเดียวกันที่ทำหน้าที่สองอย่าง หากไม่ตรงกันจะส่งผลให้เกิดการย้ายฐานข้อมูลไปยังสคีมาหนึ่ง แต่กลับให้บริการด้วยอีกสคีมาหนึ่ง การอัปเกรดจึงควรเป็นการแก้ไขที่ตั้งใจทำ ไม่ใช่เรื่องเซอร์ไพรส์: ให้เปลี่ยนค่า digest, สำรองข้อมูล, docker compose pull, docker compose up -d

สร้างบัญชีผู้ดูแลระบบก่อนที่ผู้อื่นจะทำได้

เมื่อเปิด /admin บนอินสแตนซ์ใหม่ AFFiNE จะนำคุณไปยังหน้าสร้างบัญชี เนื่องจากเซิร์ฟเวอร์ยังไม่มีผู้ดูแลระบบ ในขั้นตอนดังกล่าวจะไม่มีรหัสเชิญหรือโทเค็นการตั้งค่าใดๆ บุคคลแรกที่ลงทะเบียนสำเร็จจะกลายเป็นผู้ดูแลระบบของเซิร์ฟเวอร์คุณ ดังนั้นจึงต้องปิดพอร์ตไว้จนกว่าคุณจะลงทะเบียนเสร็จสิ้น

นี่คือเหตุผลที่ไฟล์ compose ด้านบนผูกไว้กับ 127.0.0.1 ให้เข้าถึงผ่าน SSH tunnel จากเครื่องของคุณเอง:

ssh -L 3010:127.0.0.1:3010 you@your-server-ip

ปล่อยให้คำสั่งนั้นทำงานอยู่แล้วเปิด http://127.0.0.1:3010/admin ในเบราว์เซอร์บนเครื่องของคุณ ลงทะเบียนและเข้าสู่ระบบให้เรียบร้อย จากนั้นจึงปิด tunnel เมื่อถึงตอนนี้เท่านั้นจึงจะปลอดภัยที่จะนำอินสแตนซ์ไปใช้งานผ่านชื่อโดเมนสาธารณะ การแย่งชิงสิทธิ์ในลักษณะเดียวกันนี้เกิดขึ้นในแอปที่ self-host อื่นๆ และจะร้ายแรงกว่าในกรณีที่การเข้าสู่ระบบครั้งแรกสร้าง passkey ที่ผูกกับชื่อโฮสต์ ซึ่งเป็นเหตุผลว่าทำไม TLS และโดเมนสุดท้ายจึงต้องถูกกำหนดให้เรียบร้อยก่อนการสร้างบัญชีแรกเมื่อคุณ self-host openGym

ตำแหน่งที่ AFFiNE จัดเก็บข้อมูลของคุณ

ข้อมูลทั้งหมดจะถูกจัดเก็บไว้ใน 3 เส้นทาง ซึ่งทั้งหมดจะอยู่ภายในไดเรกทอรีที่คุณสร้างขึ้น

  • ./data/postgres คือไดเรกทอรีข้อมูลของ Postgres ซึ่งประกอบด้วยเอกสาร, ผู้ใช้, พื้นที่ทำงาน, สิทธิ์การเข้าถึง และการตั้งค่าเซิร์ฟเวอร์ใดๆ ที่บันทึกผ่านแผงควบคุมผู้ดูแลระบบ
  • ./data/storage จะถูก mount ไว้ที่ /root/.affine/storage ภายในคอนเทนเนอร์ และใช้สำหรับเก็บไฟล์ที่อัปโหลดทั้งหมด
  • ./config จะถูก mount ไว้ที่ /root/.affine/config และใช้สำหรับเก็บ config.json รวมถึง private.key ที่สร้างขึ้นจากงาน migration

ต้นทางเลือกใช้ bind mounts แทนการใช้ named volumes ซึ่งเป็นการตัดสินใจที่ตั้งใจไว้ เพื่อให้คุณสามารถใช้คำสั่งทั่วไปในการ tar และคัดลอกเส้นทางเหล่านี้ได้โดยไม่ต้องตรวจสอบกับ Docker ว่าจัดเก็บข้อมูลไว้ที่ใด สิ่งที่ต้องแลกคือการจัดการความเป็นเจ้าของไฟล์บนโฮสต์จะเป็นหน้าที่ของคุณ ซึ่งเป็นข้อแลกเปลี่ยนที่อธิบายไว้ใน bind mounts และ named volumes

วิธีการสำรองข้อมูล AFFiNE

คุณต้องสำรองข้อมูลสองส่วนโดยใช้วิธีที่แตกต่างกัน ฐานข้อมูลเป็นเซิร์ฟเวอร์ที่ทำงานอยู่ตลอดเวลา ดังนั้นการคัดลอกไฟล์ในขณะที่ระบบกำลังทำงานจะทำให้ได้ไฟล์ที่เสียหาย ให้ใช้วิธีการ dump ข้อมูลแทน:

mkdir -p ~/affine/backup
cd ~/affine
docker compose exec -T postgres pg_dump --format c --username affine affine \
  > backup/affine-$(date +%F).dump
ls -lh backup/

คำสั่ง dump จะทำงานภายใน container ผ่าน local socket จึงไม่ต้องระบุรหัสผ่าน ให้ตรวจสอบขนาดไฟล์ในผลลัพธ์ของ ls หากไฟล์มีขนาดเพียงไม่กี่ร้อยไบต์ แสดงว่าการ dump ล้มเหลวแม้ว่า shell จะสร้างไฟล์ขึ้นมาแล้วก็ตาม ซึ่งเป็นความผิดพลาดที่ผู้ใช้มักจะพบหลังจากผ่านไปหกเดือน การใช้ -T ก็มีความสำคัญเช่นกัน หากไม่มี flag นี้ Compose อาจจัดสรร terminal และทำให้ binary stream เสียหายได้

ไฟล์ที่อัปโหลดเป็นเพียงไฟล์ทั่วไป ให้ใช้ tar ในการสำรองข้อมูล:

tar czf backup/storage-$(date +%F).tgz -C data storage
tar czf backup/config-$(date +%F).tgz config docker-compose.yml .env

ให้เก็บไดเรกทอรี config ทั้งหมด, ไฟล์ Compose และ .env ไว้ในชุดสำรองข้อมูลของคุณ เนื่องจากไฟล์ dump ไม่ได้รวมข้อมูลเหล่านี้ไว้ งาน migration ยังสร้าง config/private.key ขึ้นมาด้วย ดังนั้นการคัดลอกเฉพาะ config.json จะทำให้ไฟล์ดังกล่าวตกหล่นไป การตั้งค่าที่บันทึกผ่านแผงควบคุมผู้ดูแลระบบจะถูกเก็บไว้ในฐานข้อมูล ดังนั้นไฟล์ dump ข้างต้นจึงรวมข้อมูลส่วนนี้ไว้แล้ว และ ณ วันที่ 12 ตุลาคม 2026 หน้าสำรองข้อมูลของ AFFiNE ได้ระบุว่าการตั้งค่าเซิร์ฟเวอร์ที่แก้ไขแล้วสามารถส่งออก (export) จากแผงควบคุมผู้ดูแลระบบได้เช่นกัน ให้คัดลอกไฟล์ทั้งสามชุดออกจากเซิร์ฟเวอร์ การเก็บข้อมูลสำรองไว้ในดิสก์ลูกเดียวกับข้อมูลหลักไม่ใช่การสำรองข้อมูลที่ปลอดภัย รูปแบบการแยกไฟล์ dump ของฐานข้อมูลรวมกับการทำ tar ไดเรกทอรีไฟล์ที่อัปโหลดคือรูปแบบที่คุณควรใช้กับ container อื่นๆ ทุกตัวที่มีการเก็บสถานะ (stateful) และเป็นวิธีเดียวกันกับที่ช่วยรักษาประวัติการสนทนาและไฟล์แนบให้ปลอดภัยเมื่อคุณ self-host Chatwoot เพื่อใช้เป็นระบบ support desk

การกู้คืนข้อมูลและข้อควรระวังในขั้นตอนที่เผยแพร่

โปรดอ่านขั้นตอนการกู้คืนอย่างเป็นทางการก่อนที่คุณจะจำเป็นต้องใช้งานจริง และอ่านอย่างละเอียด ในขั้นตอนที่เผยแพร่เมื่อเดือนสิงหาคม 2026 มีการคัดลอกไฟล์ชื่อ affine.backup เข้าไปในคอนเทนเนอร์แล้วกู้คืนจาก ./pg.backup ซึ่งเป็นชื่อที่แตกต่างกันสองชื่อ และมีการลบไดเรกทอรี ./postgres ทิ้ง ในขณะที่ไฟล์ compose ปัจจุบันเก็บข้อมูลไว้ใน ./data/postgres ณ วันที่ 12 ตุลาคม 2026 หน้าเอกสารดังกล่าวได้เปลี่ยนมาใช้ affine.backup ตลอดทั้งเนื้อหาและระบุให้เก็บไดเรกทอรี Postgres เดิมไว้จนกว่าจะตรวจสอบการกู้คืนเสร็จสิ้น ดังนั้นข้อผิดพลาดดังกล่าวได้รับการแก้ไขที่ต้นทางแล้ว แต่สำเนาของขั้นตอนที่บันทึกไว้ก่อนหน้านั้นยังคงมีข้อผิดพลาดอยู่ ไม่ว่าอย่างไรก็ตาม ให้ปฏิบัติตาม path ที่คุณใช้งานจริงแทนการใช้ path ในตัวอย่างโค้ด นี่คือลำดับขั้นตอนตามโครงสร้างในคู่มือนี้:

cd ~/affine
docker compose down
sudo mv data/postgres data/postgres.old
docker compose up -d postgres
docker compose cp backup/affine-2026-08-08.dump postgres:/tmp/affine.dump
docker compose exec postgres pg_restore --format c --username affine \
  --dbname affine --verbose /tmp/affine.dump
docker compose up -d

สังเกตการใช้ mv แทนที่จะเป็น rm การกู้คืนทับฐานข้อมูลที่คุณไม่ได้สำรองไว้คือสาเหตุที่ทำให้คำสั่งที่ผิดพลาดเพียงคำสั่งเดียวกลายเป็นการสูญเสียข้อมูลทั้งหมด และการย้ายไดเรกทอรีเดิมออกไปนั้นไม่มีค่าใช้จ่ายใดๆ นอกจากนี้ให้กู้คืนไฟล์ที่อัปโหลดด้วย tar xzf backup/storage-2026-08-08.tgz -C data มิฉะนั้นเอกสารทุกฉบับจะแสดงผลพร้อมกับไฟล์แนบที่เสียหาย จากนั้นให้เข้าสู่ระบบและเปิดเอกสารที่มีรูปภาพ นั่นคือการทดสอบ การกู้คืนที่คุณไม่ได้เปิดดูผ่านเบราว์เซอร์นั้นเป็นเพียงไฟล์ ไม่ใช่การสำรองข้อมูลที่สมบูรณ์

การวาง AFFiNE ไว้หลัง Proxy ที่คุณใช้งานอยู่แล้ว

AFFiNE จำเป็นต้องใช้ WebSocket โดยไม่มีข้อยกเว้น เอกสารระบุไว้อย่างชัดเจนว่า WebSocket เป็นพื้นฐานของระบบซิงค์และการทำงานร่วมกันของ AFFiNE ดังนั้นหาก Proxy ไม่รองรับการอัปเกรดการเชื่อมต่อดังกล่าว จะส่งผลให้ Workspace หยุดการซิงค์ข้อมูลโดยไม่มีการแจ้งเตือน หน้าเว็บจะโหลดได้ปกติ การล็อกอินใช้งานได้ แต่การแก้ไขในเบราว์เซอร์หนึ่งจะไม่ไปปรากฏในอีกเบราว์เซอร์หนึ่ง ให้เปิดเครื่องมือสำหรับนักพัฒนา (Developer Tools) ในเบราว์เซอร์ของคุณ ไปที่แท็บ Network แล้วกรองเฉพาะ WS หากพบการเชื่อมต่อที่เปิดและปิดซ้ำๆ แสดงว่า Proxy ของคุณไม่ได้ส่งผ่านการอัปเกรด (Upgrade)

หากคุณใช้งาน Traefik สำหรับคอนเทนเนอร์อื่นอยู่แล้ว คุณสามารถเพิ่ม AFFiNE เข้าไปเป็นบริการปกติได้ ให้ลบส่วน ports: ออกจากบริการ affine แล้วเพิ่มส่วนนี้แทน:

    networks:
      - default
      - proxy
    labels:
      - 'traefik.enable=true'
      - 'traefik.docker.network=proxy'
      - 'traefik.http.routers.affine.rule=Host(`affine.example.com`)'
      - 'traefik.http.routers.affine.entrypoints=websecure'
      - 'traefik.http.routers.affine.tls.certresolver=letsencrypt'
      - 'traefik.http.services.affine.loadbalancer.server.port=3010'

และที่ด้านล่างของไฟล์ ในระดับเดียวกับ services: ให้เพิ่ม:

networks:
  proxy:
    external: true

ชื่อของ certificate resolver ต้องตรงกับที่กำหนดไว้ในคอนฟิกูเรชันของ Traefik และ loadbalancer.server.port คือพอร์ตภายในคอนเทนเนอร์ซึ่งก็คือ 3010 ไม่ใช่พอร์ตของโฮสต์ Traefik จะทำหน้าที่ Proxy การเชื่อมต่อ WebSocket โดยอัตโนมัติโดยไม่ต้องตั้งค่าเพิ่มเติม หากบริการส่วนที่เหลือของคุณอยู่หลัง Authentik สำหรับ single sign-on คุณสามารถใช้ forward auth middleware บนเราเตอร์นี้เพื่อจำกัดการเข้าถึง AFFiNE ผ่านเบราว์เซอร์ได้ แต่แนะนำให้ปิดไว้ก่อนจนกว่าจะทดสอบแอปบนเดสก์ท็อปเสร็จสิ้น เนื่องจากแอปเดสก์ท็อปไม่มี session ของเบราว์เซอร์และจะทำให้การซิงค์ล้มเหลวทันที การรันหลายแอปหลัง Proxy ตัวเดียวได้อธิบายไว้ใน การใช้ Traefik ตัวเดียวหน้าหลายแอป

สำหรับ nginx คุณต้องระบุการอัปเกรดอย่างชัดเจน:

location / {
    proxy_pass http://127.0.0.1:3010;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 100m;
}

ค่าเริ่มต้นของ client_max_body_size ใน nginx คือ 1 MB ดังนั้นหากไม่มีบรรทัดดังกล่าว การอัปโหลดไฟล์ที่ใหญ่กว่ารูปภาพขนาดเล็กจะล้มเหลวด้วยสถานะ 413 และจะไม่ปรากฏข้อความใดๆ ใน log ของ AFFiNE เนื่องจากคำขอดังกล่าวไม่เคยถูกส่งไปถึง สำหรับ Caddy คุณเพียงแค่เพิ่มบรรทัด reverse_proxy http://127.0.0.1:3010 ซึ่งจะจัดการเรื่อง certificate และการอัปเกรด WebSocket ให้โดยอัตโนมัติ

สิ่งที่การติดตั้งแบบ self-hosted ยังขาดไป

โปรดพิจารณาประเด็นเหล่านี้ให้ถี่ถ้วนก่อนที่จะย้ายทีมมาใช้งาน

ระบบการทำงานร่วมกันแบบ real-time มีมาให้ ซึ่งเป็นฟีเจอร์หลักที่คำแนะนำเรื่องขนาดเซิร์ฟเวอร์อ้างถึง เนื่องจากเอกสารของ AFFiNE ระบุว่าการใช้หน่วยความจำส่วนใหญ่มาจากระบบ sync และการรวมเอกสาร (document merging) การแก้ไขแบบ offline เป็นเหตุผลที่หลายคนต้องการเครื่องมือแบบ local-first และแอปพลิเคชันบนเดสก์ท็อปสามารถเพิ่มเซิร์ฟเวอร์ที่คุณติดตั้งเองลงในรายการ workspace และล็อกอินเข้าใช้งานได้ โปรดทดสอบพฤติกรรมขณะ offline ที่ทีมของคุณต้องใช้งานจริงก่อนตัดสินใจ: ให้ลองแก้ไขในแอปเดสก์ท็อปขณะตัดการเชื่อมต่อเครือข่าย จากนั้นเชื่อมต่อใหม่ แล้วตรวจสอบผลลัพธ์บนอุปกรณ์เครื่องที่สอง รายการฟีเจอร์ไม่ใช่หลักฐานยืนยันประสิทธิภาพ และนั่นรวมถึงรายการนี้ด้วย

ระบบ full-text search ฝั่งเซิร์ฟเวอร์ถูกปิดไว้ในไฟล์ compose ที่ให้มา โดยมีการตั้งค่า AFFINE_INDEXER_ENABLED=false ไว้ทั้งบนเซิร์ฟเวอร์และบนงาน migration การเปิดใช้งานฟีเจอร์นี้หมายถึงการเพิ่ม container ของ Manticore Search ซึ่งเป็นบริการที่ห้าและใช้หน่วยความจำเพิ่มขึ้น บนเครื่องขนาด 2 GB การเปลี่ยนแปลงนี้อาจทำให้หน่วยความจำไม่เพียงพอ ทั้งนี้การค้นหาภายในไคลเอนต์ยังคงทำงานได้ปกติสำหรับ workspace ที่คุณเปิดอยู่

มีข้อจำกัดสองประการที่ควรทราบก่อนเชิญผู้อื่นเข้าร่วมใช้งาน: workspace แบบ self-hosted รองรับผู้ใช้ได้สูงสุด 10 ที่นั่ง หากต้องการมากกว่านั้นจำเป็นต้องมี Team license จาก AFFiNE ส่วนเรื่องพื้นที่จัดเก็บ blob แบบไม่จำกัดและขนาดไฟล์ blob แบบไม่จำกัดสำหรับ instance ที่ติดตั้งเองนั้น เอกสารระบุว่าเป็นสิ่งที่ตั้งใจจะทำแต่ยังไม่ได้ดำเนินการอย่างสมบูรณ์ ณ เดือนตุลาคม 2026 ประเด็นเหล่านี้อาจไม่มีผลสำหรับครัวเรือนหรือทีมขนาดเล็ก แต่จะมีผลทันทีหากคุณวางแผนจะย้ายคนจำนวนสี่สิบคนเข้ามาใช้งาน

การอัปเกรด

โปรดอ่านบันทึกประจำรุ่น (release notes) ก่อนเสมอ โดยเฉพาะเมื่อมีการปรับเวอร์ชันย่อย เช่น จาก 0.26 ไปเป็น 0.27 ซึ่งมักมีการเปลี่ยนแปลงที่ส่งผลกระทบต่อระบบเดิม (breaking changes) ให้สำรองข้อมูลฐานข้อมูลและไดเรกทอรีจัดเก็บข้อมูลก่อนดำเนินการใดๆ เนื่องจากกระบวนการย้ายข้อมูล (migration) จะปรับเปลี่ยนโครงสร้างฐานข้อมูล (schema) ทันทีที่เริ่มการทำงานใหม่และไม่สามารถย้อนกลับได้ จากนั้นให้เปลี่ยนค่า digest ที่ระบุไว้ แล้วรัน docker compose pull ตามด้วย docker compose up -d พร้อมทั้งตรวจสอบ docker compose logs -f affine_migration จนกว่ากระบวนการจะเสร็จสิ้นโดยสมบูรณ์ ทั้งนี้ docker image prune จะทำหน้าที่ล้างเลเยอร์เก่าออกในภายหลัง ข้อควรทราบสำหรับผู้ที่ติดตั้งเวอร์ชันเก่ามากคือ ตั้งแต่เวอร์ชัน 0.23.0 เป็นต้นมา ชื่ออิมเมจได้เปลี่ยนจาก affine-graphql เป็น affine ดังนั้นไฟล์ compose ที่เก่ากว่านั้นจำเป็นต้องแก้ไขบรรทัด image ก่อนจึงจะสามารถดึงอิมเมจใหม่ได้ และตั้งแต่เวอร์ชัน 0.27.4 เป็นต้นมา เทมเพลต compose อย่างเป็นทางการได้ย้ายตำแหน่งของ Postgres, ข้อมูลที่อัปโหลด และไฟล์ตั้งค่า รวมถึงเปลี่ยนการเชื่อมต่อฐานข้อมูลเริ่มต้น ดังนั้นควรเปรียบเทียบไฟล์ใหม่กับไฟล์เดิมของคุณแทนการคัดลอกทับการติดตั้งที่ใช้งานได้อยู่เดิม

FAQ

ทำไมคอนเทนเนอร์ AFFiNE ถึงไม่เริ่มทำงาน

บริการ affine ประกาศ condition: service_completed_successfully ไว้ในงาน affine_migration ดังนั้นหากการ migration จบลงด้วยสถานะอื่นที่ไม่ใช่ 0 เซิร์ฟเวอร์จะไม่เริ่มทำงานและไม่มีหน้าเว็บปรากฏขึ้น ให้รัน docker compose logs affine_migration เพื่อดูว่าขั้นตอนใดที่หยุดทำงาน ตรวจสอบว่าไฟล์ compose ที่แก้ไขด้วยตนเองยังคงใช้ pgvector/pgvector:pg16 อยู่ เนื่องจาก Postgres รุ่นมาตรฐานไม่มีส่วนขยาย pgvector ที่ schema ของ AFFiNE ยังคงประกาศใช้งานอยู่ แม้ว่า v0.27.4 จะไม่ได้กำหนดโมเดล embedding ทั้งสี่ตัวที่มีใน v0.27.3 แล้วก็ตาม

การ self-host AFFiNE ต้องใช้ RAM เท่าไหร่

หน้าความต้องการของระบบของ AFFiNE ระบุว่าต้องการ CPU อย่างน้อย 4 คอร์และ RAM 2 GB และจะเพิ่มเป็น 4 GB เมื่อเอกสารมีจำนวนคำเกิน 10,000 คำ โดยระบุว่าการรวมเอกสารที่มีการแก้ไข 10,000 ครั้งอาจใช้ RAM สูงสุดถึง 1 GB บนเซิร์ฟเวอร์ที่มี RAM 2 GB ค่าสูงสุดนี้คือสาเหตุที่ทำให้ระบบล่ม ไม่ใช่ภาระงานขณะว่าง (idle load) เพราะ kernel out-of-memory killer จะเลือก process มาหยุดทำงาน ซึ่งส่วนใหญ่มักเป็นเซิร์ฟเวอร์ AFFiNE เนื่องจากมีขนาดใหญ่ที่สุด และ restart: unless-stopped จะเริ่มทำงานใหม่ ทำให้ผู้ใช้เห็นหน้าเว็บโหลดซ้ำแทนที่จะเป็นข้อความแจ้งเตือนข้อผิดพลาด ให้ยืนยันปัญหานี้ด้วย docker inspect affine_server --format '{{.State.OOMKilled}}' และ sudo dmesg -T | grep -i 'out of memory' จากนั้นให้เพิ่ม swap file ขนาด 2 GB เพื่อรองรับการใช้งานที่พุ่งสูงขึ้นชั่วคราว และขยับไปใช้ RAM 4 GB หากยังมีการถูกสั่งหยุดทำงานอยู่

AFFiNE เก็บข้อมูลไว้ที่ไหน และต้องสำรองข้อมูลอะไรบ้าง

มีสาม path ภายใต้ไดเรกทอรี compose ของคุณที่เก็บข้อมูลทั้งหมดไว้ ได้แก่ ./data/postgres สำหรับฐานข้อมูล, ./data/storage สำหรับไฟล์ที่อัปโหลด และ ./config สำหรับ config.json และ private.key ที่สร้างขึ้น ให้สำรองข้อมูลฐานข้อมูลด้วย docker compose exec -T postgres pg_dump --format c --username affine affine > affine.dump แทนการคัดลอกไฟล์โดยตรง เพราะไม่สามารถคัดลอก Postgres ที่กำลังทำงานอยู่ได้อย่างปลอดภัย ข้อมูล dump ดังกล่าวจะรวมถึงการตั้งค่าใดๆ ที่บันทึกไว้ในแผงผู้ดูแลระบบด้วย เนื่องจาก AFFiNE เก็บข้อมูลเหล่านั้นไว้ในฐานข้อมูล ให้ใช้ tar เก็บ ./data/storage สำหรับไฟล์ที่อัปโหลด และเก็บทั้งไดเรกทอรี config, ไฟล์ Compose และ .env ไว้ เพราะไฟล์เหล่านี้ไม่ได้เป็นส่วนหนึ่งของฐานข้อมูล

การทำงานร่วมกันแบบเรียลไทม์ใช้งานได้บน AFFiNE ที่ self-host หรือไม่

ใช้งานได้ และไม่ต้องเปิดใช้งานอะไรเพิ่มเติม ข้อกำหนดเพียงอย่างเดียวคือ reverse proxy ของคุณ เนื่องจากการซิงค์ทำงานผ่านการเชื่อมต่อ WebSocket สำหรับ nginx หมายความว่าต้องมี proxy_http_version 1.1 รวมถึง header Upgrade และ Connection: upgrade ในขณะที่ Traefik และ Caddy จะส่งผ่านการเชื่อมต่อเหล่านี้โดยไม่ต้องตั้งค่าเพิ่มเติม อาการของ proxy ที่ไม่ได้อัปเกรดการเชื่อมต่อเหล่านี้คือ workspace จะโหลดและล็อกอินได้ตามปกติ แต่การแก้ไขในเบราว์เซอร์หนึ่งจะไม่ปรากฏในอีกเบราว์เซอร์หนึ่ง

ฉันสามารถรัน AFFiNE ด้วยอิมเมจ Postgres มาตรฐานได้หรือไม่

ให้ใช้ pgvector/pgvector:pg16 ซึ่งเป็น Postgres 16 ที่คอมไพล์ส่วนขยาย pgvector มาให้แล้ว AFFiNE v0.27.4 ยังคงประกาศ extensions = [pgvector(map: "vector")] ใน schema.prisma แต่ไม่ได้กำหนดโมเดลทั้งสี่ที่มีคอลัมน์ embedding vector(1024) ซึ่งเคยมีใน v0.27.3 อีกต่อไป Postgres มาตรฐานไม่มีส่วนขยายที่ประกาศไว้ดังกล่าว หากคุณชี้ AFFiNE ไปยังเซิร์ฟเวอร์ Postgres ภายนอกแทน ให้ติดตั้ง pgvector บนเซิร์ฟเวอร์นั้นและสร้างส่วนขยายในฐานข้อมูลเป้าหมายก่อนที่จะรันการ migration

บทความนี้มีประโยชน์หรือไม่