Linkwarden

الوصول

1. افتح http://<SERVER_IP>.
2. اضغط على "Sign Up".
3. أنشئ الحساب الأول.
4. يصبح الحساب الأول مسؤول الخادم لأن NEXT_PUBLIC_ADMIN=1 مُفعَّل.

التسجيل

التسجيل مُفعَّل افتراضيًا.

بعد إنشاء حساب المسؤول، يمكن تعطيل التسجيل.

لتعطيله، عدّل /root/linkwarden/.env واضبط:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

ثم طبّق الإعدادات:

cd /root/linkwarden
docker compose up -d

المسارات المهمة

• مسار التثبيت: /root/linkwarden
• ملف Compose: /root/linkwarden/docker-compose.yml
• ملف البيئة: /root/linkwarden/.env
• بيانات التطبيق: /root/linkwarden/data
• بيانات PostgreSQL: /root/linkwarden/pgdata
• بيانات Meilisearch: /root/linkwarden/meili_data
• إعدادات Nginx: /etc/nginx/sites-available/linkwarden

إدارة Docker

تحقّق من الحاويات:

cd /root/linkwarden
docker compose ps

عرض السجلات:

cd /root/linkwarden
docker compose logs -f

اعرض سجلات Linkwarden:

cd /root/linkwarden
docker compose logs -f linkwarden

أعد تشغيل Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

أوقف المجموعة:

cd /root/linkwarden
docker compose down

ابدأ تشغيل المجموعة:

cd /root/linkwarden
docker compose up -d

إدارة NGINX

تحقّق من NGINX:

systemctl status nginx

اختبر الإعدادات:

nginx -t

أعد تشغيل NGINX:

systemctl restart nginx

أعد تحميل NGINX:

systemctl reload nginx

النطاق وHTTPS

1. أنشئ سجل A لاسم مضيف تطبيقك ووجّهه إلى عنوان IP العام لخادمك (مثل app.example.com).

2. ثبّت Certbot:

apt update
apt install -y certbot python3-certbot-nginx

3. عدّل إعدادات NGINX واستبدل server_name _; بنطاقك (مثل server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. اختبر الإعدادات:

nginx -t

5. أعد تحميل NGINX:

systemctl reload nginx

6. أصدر شهادة TLS:

certbot --nginx -d app.example.com

7. حدّث متغيرات بيئة Linkwarden (.env الملف):

NEXTAUTH_URL=https://app.example.com/api/v1/auth
BASE_URL=https://app.example.com

8. بعد تغيير متغيرات البيئة، أعد تشغيل Linkwarden:

cd /root/linkwarden
docker compose down
docker compose up -d

9. افتح متصفحك وزُر: https://app.example.com

ملاحظات

• يُتاح Linkwarden للعامة عبر Nginx على المنفذ 80.
• أما تطبيق Linkwarden نفسه فيستمع فقط على 127.0.0.1:3000.
• PostgreSQL وMeilisearch خدمتان داخليتان في Docker ولا تُعرضان مباشرة للمضيف.
• عند إعداد النطاق، تأكّد من استبدال http:// بـ https:// في كل موضع يُضبط فيه رابط التطبيق، بما في ذلك NEXTAUTH_URL و BASE_URL.
• استخدم النطاق نفسه بـ HTTPS بشكل متسق في كامل إعدادات NGINX وLinkwarden.
• BASE_URL مفيد بشكل خاص عند استخدام ميزات البريد مثل إعادة تعيين كلمة المرور أو رسائل التحقّق.
• غيّر إعدادات Linkwarden بحسب تفضيلاتك.