ITSkillsCenter
الأعمال الرقمية

نشر Outline على Coolify و VPS Hetzner: درس كامل 2026

2 min de lecture

📍 المقالة الرئيسية: Outline 2026: الدليل الكامل.

ثلاثون دقيقة لتحويل VPS فارغ إلى خادم Outline إنتاج. الطريقة موثقة في عدة شركات إفريقية فرنكوفونية، بتكلفة إجمالية 4.51 يورو/شهرياً لـ 100 مستخدم.

المتطلبات

Hetzner CX22 minimum (2 vCPU، 4 GB RAM). Coolify v4. اسم نطاق DNS A: wiki.votre-entreprise.com. SMTP (Brevo، Resend) للدعوات. المستوى: متوسط. الوقت: 30-45 دقيقة.

الخطوة 1 — DNS و MinIO

أنشئ DNS A: wiki.votre-entreprise.com → IP الـ VPS. MinIO يمكن نشره عبر Coolify أيضاً (Resources → MinIO). Bucket outline مع credentials مدوَّنة.

الخطوة 2 — خدمة Outline في Coolify

Resources → + New → Service → ابحث عن «Outline». Coolify ينشر القالب الرسمي. الاسم: outline-prod.

الخطوة 3 — متغيرات البيئة

SECRET_KEY و UTILS_SECRET أساسية للأمان (32 octets hex). DATABASE_URL يربط Postgres. Storage S3 يستخدم MinIO أو Backblaze B2.

NODE_ENV=production
SECRET_KEY=générer-32-octets-hex
UTILS_SECRET=générer-32-octets-hex
URL=https://wiki.votre-entreprise.com
PORT=3000

DATABASE_URL=postgres://outline:password@outline-db:5432/outline
PGSSLMODE=disable
REDIS_URL=redis://outline-redis:6379

AWS_ACCESS_KEY_ID=minio-access-key
AWS_SECRET_ACCESS_KEY=minio-secret-key
AWS_REGION=us-east-1
AWS_S3_UPLOAD_BUCKET_URL=https://minio.votre-entreprise.com
AWS_S3_UPLOAD_BUCKET_NAME=outline
AWS_S3_FORCE_PATH_STYLE=true

SMTP_HOST=smtp-relay.brevo.com
SMTP_PORT=587
SMTP_USERNAME=login
SMTP_PASSWORD=clé-api
SMTP_FROM_EMAIL=wiki@votre-entreprise.com
EMAIL_LOGIN=true
DEPLOYMENT=production

الخطوة 4 — النطاق HTTPS

تبويب Domains: https://wiki.votre-entreprise.com. Force HTTPS ON.

الخطوة 5 — إطلاق Deploy

Coolify يسحب outlinewiki/outline:latest، postgres:16، redis:7. احسب 3-4 دقائق.

الخطوة 6 — أول حساب

افتح https://wiki.votre-entreprise.com. صفحة signup: أدخل email admin. Outline يرسل magic link، انقر للتأكيد. أول حساب = admin workspace.

الخطوة 7 — أول collection

Sidebar → New Collection → اسم (Engineering)، وصف، أيقونة، لون. الصلاحيات: Members (الفريق كاملاً)، Restricted. أنشئ عدة: Engineering، Marketing، Onboarding، Legal.

الخطوة 8 — دعوة الأعضاء

Settings → Members → Invite people. Admin/Member/Viewer.

الخطوة 9 — تكوين SSO

Settings → Authentication → OIDC. راجع SSO Authentik.

الخطوة 10 — النسخ الاحتياطية

# Cron يومي
docker exec outline-db pg_dump -U outline outline | gzip > /tmp/outline-pg.gz
mc mirror minio/outline /backup/outline-files/
restic backup /tmp/outline-pg.gz /backup/outline-files
rm -f /tmp/outline-pg.gz

الأخطاء الشائعة

الخطأ الحل
Upload صور يفشل AWS_S3_FORCE_PATH_STYLE=true لـ MinIO
Email magic link غير مستلم SMTP غير مختبر
WebSocket متأخر Caddy لا يُحوِّل WS
Migration loop postgres:16 إجباري

التكيف مع السياق

SMTP موثوق (Brevo، Resend). MinIO محلي على نفس VPS أو Hetzner Storage Box. النسخ الاحتياطية كل 6 ساعات إلزامية.

دروس الإخوة

الأسئلة المتكررة

السعة CX22؟ 100 مستخدم + 10k مستند.

Maintenance؟ 30 دقيقة شهرياً.

للاستزادة

Besoin d'un site web ?

Confiez-nous la Création de Votre Site Web

Site vitrine, e-commerce ou application web — nous transformons votre vision en réalité digitale. Accompagnement personnalisé de A à Z.

À partir de 250.000 FCFA
Parlons de Votre Projet
Publicité