كيفية استضافة TREK على خادم VPS

لماذا استضافة مدير المشاريع بنفسك

ما الذي تحصل عليه مع TREK المستضاف ذاتيًا

• لوحات Kanban غير محدودة — أنشئ ما تشاء من المشاريع والأعمدة دون قيود على عدد المستخدمين.
• المعالم والسبرينت — خطط بدورات منتظمة وتابع التقدم في لوحة التحكم.
• إدارة الفريق — ادعُ أعضاء وحدد أدواراً (مدير، عضو، مراقب) لكل مشروع.
• واجهة REST API — ادمج خطوط CI/CD لإنشاء التذاكر أو تحديث الحالات تلقائياً.
• OIDC / SSO — وصّل Authentik أو Pocket ID أو Keycloak لتسجيل دخول مركزي.
• مرفقات الملفات — ارفع الملفات ولقطات الشاشة مباشرة على التذاكر.
• SQLite مدمج — لا قاعدة بيانات خارجية، والنسخ الاحتياطي بأمر واحد.

المتطلبات الأساسية

curl -fsSL https://get.docker.com | sh

تثبيت TREK

1. 01

   إنشاء الدليل وملف Compose

   على الخادم، أنشئ دليلاً مخصصاً:

   mkdir -p /opt/trek && cd /opt/trek

   أنشئ /opt/trek/docker-compose.yml:

   services:
     trek:
       image: mauriceboe/trek:4.3.3
       restart: unless-stopped
       ports:
         - "127.0.0.1:3000:3000"
       environment:
         NODE_ENV: production
         ENCRYPTION_KEY: "استبدل-بسلسلة-عشوائية-32-حرفا"
         ADMIN_EMAIL: [email protected]
         ADMIN_PASSWORD: "كلمةمرورقوية42!"
         TRUST_PROXY: "1"
       volumes:
         - trek-data:/app/data
         - trek-uploads:/app/uploads
   
   volumes:
     trek-data: {}
     trek-uploads: {}

   ⚠️ في بيئة الإنتاج، استبدل ENCRYPTION_KEY بسلسلة عشوائية لا تقل عن 32 حرفاً واختر كلمة مرور قوية للمسؤول.

2. 02

   تشغيل TREK

   شغّل الحاوية:

   docker compose up -d

   يُنزّل TREK الصورة (نحو 462 ميغابايت)، ويهيّئ قاعدة SQLite ثم يشغّل Node.js. تُنفَّذ هجرات Drizzle ORM عند أول تشغيل. انتظر من 30 إلى 45 ثانية قبل الوصول إلى الواجهة.

   تحقق من بدء التشغيل:

   docker compose logs -f trek

   ابحث عن السطر Server listening on port 3000، فهو الإشارة إلى أن TREK أصبح جاهزاً.

3. 03

   الوصول إلى الواجهة

   افتح نفقاً SSH من جهازك المحلي:

   ssh -L 3000:127.0.0.1:3000 root@<ip-vps>

   ثم افتح http://localhost:3000 في متصفحك. تظهر صفحة تسجيل الدخول إلى TREK. سجّل الدخول بـ [email protected] وكلمة المرور التي حددتها في ADMIN_PASSWORD.

4. 04

   إنشاء مشروعك الأول

   بعد تسجيل الدخول:
   1. انقر على مساحة عمل جديدة ← وامنحها اسماً.
   2. انقر على مشروع جديد ← واختر قالب Kanban.
   3. أضف أول تذكرة في عمود قيد الانتظار.

   أصبحت جاهزاً للعمل. ادعُ زملاءك من الإعدادات ← الأعضاء.

تكوين نطاق وخادم nginx

server {
    listen 443 ssl;
    server_name trek.your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        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;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

النسخ الاحتياطي والصيانة

# Database
docker run --rm -v trek_trek-data:/data -v /backup:/backup alpine \
  tar czf /backup/trek-data-$(date +%Y%m%d).tar.gz -C /data .

# Uploads
docker run --rm -v trek_trek-uploads:/data -v /backup:/backup alpine \
  tar czf /backup/trek-uploads-$(date +%Y%m%d).tar.gz -C /data .

docker compose pull && docker compose up -d