د BookStack لپاره VPS: پخپله کوربه شوې د ټیم ویکي

د ټیم اسناد معمولاً په یوه له دوو لارو مري: په داسې چټ تارونو کې خپاره چې هېڅوک پکې لټون نشي کولی، یا په داسې بدې ویکي کې ښخ چې هېڅوک یې نه تازه کوي. BookStack هغه نادره پخپله کوربه شوې ویکي ده چې خلک یې واقعاً کاروي. منځپانګه په المارۍ، کتابونو، فصلونو او پاڼو کې ده — داسې جوړښت چې هر څوک یې پرته له روزنې پوهېږي. او تقریباً هېڅ سرور ته اړتیا نه لري.

ولې BookStack

• روښانه جوړښت. د پاڼو د هوار انبار پر ځای کتابونه او فصلونه.
• داسې سمون چې هېڅوک نه ډاروي. په ډیفالټ ډول WYSIWYG اېډیټر، او د خوښوونکو لپاره Markdown.
• ریښتیني اجازې. د هرې المارۍ، کتاب یا پاڼې لپاره رولونه — د بشري سرچینو اسناد له قراردادیانو لرې ساتل کېږي.
• د شرکت ننوتل. LDAP، SAML2 او OpenID Connect دننه جوړ دي.
• ستاسو ډېټا. هر څه په یو MariaDB ډېټابېس او ستاسو په سرور کې په یو فولډر کې دي.

دا د هر کار لپاره سمه وسیله نه ده. د پراختیاکوونکو اسناد چې باید له کوډ سره بدل شي، ځای یې ریپوزیټري ده، نه ویکي.

څه ته اړتیا لري

BookStack سپک دی. د ډېرو ټیمونو لپاره Micro-IP — 1 vCPU، 2 GB، $10 میاشتنی — له اړتیا زیات دی. ځانګړی IP هغه څه دی چې همکارانو ته اجازه ورکوي ستاسو په ډومېن د HTTPS له لارې ورته ورسېږي. ډیسک د اپلوډ شویو سکرین شاټونو او PDFs سره لویېږي، نه د پاڼو د شمېر سره.

د Docker Compose سره نصب

موږ به د LinuxServer.io مشهور image-ونه وکاروو. لومړی د اپلیکېشن کیلي جوړه کړئ:

docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey

هغه base64:... ارزښت کاپي کړئ چې چاپوي یې. بیا docker-compose.yml جوړ کړئ:

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=https://wiki.example.com
      - APP_KEY=base64:paste-your-key-here
      - DB_HOST=db
      - DB_PORT=3306
      - DB_DATABASE=bookstack
      - DB_USERNAME=bookstack
      - DB_PASSWORD=change-me
    volumes:
      - ./bookstack:/config
    ports:
      - 127.0.0.1:6875:80
    depends_on:
      - db
    restart: unless-stopped
  db:
    image: lscr.io/linuxserver/mariadb:latest
    environment:
      - PUID=1000
      - PGID=1000
      - MYSQL_ROOT_PASSWORD=change-me-too
      - MYSQL_DATABASE=bookstack
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=change-me
    volumes:
      - ./db:/config
    restart: unless-stopped

docker compose up -d
docker compose logs -f bookstack

APP_URL باید د هغې پتې سره سمون ولري چې خلک به یې کاروي، د https:// په ګډون. که غلط وي، انځورونه او لینکونه په عجیبو لارو ماتېږي. د Compose په اړه نور زموږ د سټیک ډیپلای لارښود کې دي.

HTTPS او لومړی ننوتل

یو فرعي ډومېن سرور ته وګرځوئ (څنګه)، د 127.0.0.1:6875 مخې ته nginx کېږدئ او د certbot سره تصدیق‌لیک ورزیات کړئ — د reverse proxy لارښود ګام په ګام لارښوونه کوي.

بیا د ډیفالټ حساب سره ننوځئ: admin@admin.com / password. د لینک له شریکولو مخکې برېښنالیک او پاسورډ سمدستي بدل کړئ. نور ټول خپل حسابونه ترلاسه کوي یا ستاسو د پېژند چمتو کوونکي له لارې ننوځي.

بیک اپونه

دوه شیان باید وساتل شي: ډېټابېس او د ./bookstack دننه اپلوډونه. داسې یوه د شپې دنده ډېټابېس پوښي:

docker compose exec -T db mysqldump -u bookstack -pchange-me bookstack > /var/backups/bookstack.sql

بیا د /var/backups او د compose فولډر بیک اپ له سرور بهر واخلئ — زموږ د restic لارښود همدا کار کوي. Managed Backups پر دې سربېره د ټول سرور ورځني د بېرته راګرځولو ټکي ورزیاتوي.

ساتنه

تازه کول docker compose pull && docker compose up -d دي. BookStack د پیل پر مهال د ډېټابېس مهاجرتونه چلوي. د لویو نسخو مخکې د خپرونې یادښتونه ولولئ؛ لنډ او روښانه دي.

که ستاسو ټیم د ټکټونو او کوډ لپاره هم ځای غواړي، پخپله کوربه شوی Git سرور په ورته ډول پلان کې یې تر څنګ ښه ځای نیسي.