flame

لهب

وصف

Flame عبارة عن صفحة بدء مستضافة ذاتيًا لخادمك. تصميمه مستوحى (بشكل كبير) من SUI. اللهب سهل الإعداد والاستخدام. بفضل برامج التحرير المضمنة، يتيح لك إعداد مركز التطبيقات الخاص بك في وقت قصير - دون الحاجة إلى تحرير الملفات.

الوظيفة

• يمكنك إنشاء تطبيقاتك وإشاراتك المرجعية وتحديثها وحذفها مباشرة من التطبيق باستخدام محررات واجهة المستخدم الرسومية المضمنة
• ؟ قم بتثبيت العناصر المفضلة لديك على الشاشة الرئيسية للوصول إليها بسرعة وسهولة
• ؟ شريط بحث متكامل مع تصفية محلية و11 مزودًا لبحث الويب والقدرة على إضافة ما يناسبك
• ؟ نظام مصادقة لحماية إعداداتك وتطبيقاتك وإشاراتك المرجعية
• ؟ العشرات من الخيارات لتخصيص واجهة Flame حسب احتياجاتك، بما في ذلك دعم CSS المخصص و15 سمة ألوان مدمجة ومنشئ السمات المخصصة
• ☀️ أداة الطقس مع درجة الحرارة الحالية والتغطية السحابية وحالة الطقس المتحركة
• ؟ تكامل Docker لاختيار التطبيقات وإضافتها تلقائيًا بناءً على تصنيفاتها

تثبيت

مع دوكر (مستحسن)

رابط دوكر هاب

docker pull pawelmalak/flame

# for ARM architecture (e.g. RaspberryPi)
docker pull pawelmalak/flame:multiarch

# installing specific version
docker pull pawelmalak/flame:2.0.0

النشر

 # run container
docker run -p 5005:5005 -v /path/to/data:/app/data -e PASSWORD=flame_password pawelmalak/flame

بناء الصور

 # build image for amd64 only
docker build -t flame -f .docker/Dockerfile .

# build multiarch image for amd64, armv7 and arm64
# building failed multiple times with 2GB memory usage limit so you might want to increase it
docker buildx build 
  --platform linux/arm/v7,linux/arm64,linux/amd64 
  -f .docker/Dockerfile.multiarch 
  -t flame:multiarch . 

عامل الميناء يؤلف

 version : ' 3.6 '

services :
  flame :
    image : pawelmalak/flame
    container_name : flame
    volumes :
      - /path/to/host/data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock # optional but required for Docker integration
    ports :
      - 5005:5005
    secrets :
      - password # optional but required for (1)
    environment :
      - PASSWORD=flame_password
      - PASSWORD_FILE=/run/secrets/password # optional but required for (1)
    restart : unless-stopped

# optional but required for Docker secrets (1)
secrets :
  password :
    file : /path/to/secrets/password 

أسرار عامل الميناء

يمكن الكتابة فوق كافة متغيرات البيئة عن طريق إلحاق _FILE بقيمة المتغير. على سبيل المثال، يمكنك استخدام PASSWORD_FILE للمرور عبر سر عامل الإرساء بدلاً من PASSWORD . إذا تم تعيين كل من PASSWORD و PASSWORD_FILE ، فستكون لسر عامل الإرساء الأسبقية.

 # ./secrets/flame_password
my_custom_secret_password_123

# ./docker-compose.yml
secrets:
  password:
    file: ./secrets/flame_password

سقالة

 # use skaffold
skaffold dev

بدون دوكر

اتبع التعليمات من الويكي: التثبيت بدون Docker

تطوير

تكنولوجيا

• الخلفية
  • نود.جي إس + اكسبرس
  • تسلسل ORM + SQLite
• الواجهة الأمامية
  • رد فعل
  • إعادة إحياء
  • تايب سكريبت
• النشر
  • عامل ميناء
  • كوبيرنيتيس

خلق بيئة التطوير

 # clone repository
git clone https://github.com/pawelmalak/flame
cd flame

# run only once
npm run dev-init

# start backend and frontend development servers
npm run dev

لقطات الشاشة

الاستخدام

المصادقة

تفضل بزيارة موقع wiki الخاص بالمشروع لقراءة المزيد حول المصادقة

شريط البحث

البحث

إعداد البحث الافتراضي هو البحث في جميع تطبيقاتك وإشاراتك المرجعية. إذا كنت تريد البحث باستخدام محرك بحث محدد، فستحتاج إلى كتابة استعلام البحث الخاص بك بالبادئة المحددة. على سبيل المثال، للبحث عن "ما هو عامل الإرساء" باستخدام بحث جوجل، يمكنك كتابة: /g what is docker .

للحصول على قائمة بمحركات البحث المدعومة والاختصارات والمزيد حول وظيفة البحث، تفضل بزيارة موقع wiki الخاص بالمشروع.

إعداد وحدة الطقس

1. الحصول على مفتاح API من Weather API.

   تسمح الخطة المجانية بإجراء مليون مكالمة شهريًا. يقوم Flame بإجراء أقل من 3 آلاف مكالمات API شهريًا.

2. احصل على خطوط العرض/الطول لموقعك. يمكنك الحصول عليها من latlong.net.
3. أدخل وحفظ البيانات. سيتم الآن تحديث أداة الطقس ويجب أن تكون مرئية على الصفحة الرئيسية.

تكامل عامل الميناء

من أجل استخدام تكامل Docker، يجب أن تحتوي كل حاوية على التصنيفات التالية:

 labels :
  - flame.type=application # "app" works too
  - flame.name=My container
  - flame.url=https://example.com
  - flame.icon=icon-name # optional, default is "docker"
# - flame.icon=custom to make changes in app. ie: custom icon upload

يجب تمكين خيار "استخدام Docker API" حتى يعمل هذا. يمكنك العثور عليه في الإعدادات> Docker

يمكنك أيضًا إعداد تطبيقات مختلفة في نفس التصنيف بإضافة ; بين كل واحد.

 labels :
  - flame.type=application
  - flame.name=First App;Second App
  - flame.url=https://example1.com;https://example2.com
  - flame.icon=icon-name1;icon-name2

إذا كنت تريد استخدام مضيف عامل إرساء بعيد، فاتبع هذه التعليمات في المضيف:

• افتح الملف /lib/systemd/system/docker.service ، وابحث عن ExecStart وقم بتحرير القيمة

 ExecStart=/usr/bin/dockerd -H tcp://0.0.0.0:${PORT} -H unix:///var/run/docker.sock

سيربط الأمر أعلاه خادم محرك الإرساء بمقبس Unix بالإضافة إلى منفذ TCP الذي تختاره. "0.0.0.0" يعني أن docker-engine يقبل الاتصالات من جميع عناوين IP.

• أعد تشغيل البرنامج الخفي وخدمة Docker

sudo systemctl daemon-reload
sudo service docker restart

• اختبار ما إذا كان يعمل

curl http:// ${IP} : ${PORT} /version

التكامل Kubernetes

من أجل استخدام تكامل Kubernetes، يجب أن يحتوي كل إدخال على التعليقات التوضيحية التالية:

 metadata :
  annotations :
  - flame.pawelmalak/type=application # "app" works too
  - flame.pawelmalak/name=My container
  - flame.pawelmalak/url=https://example.com
  - flame.pawelmalak/icon=icon-name # optional, default is "kubernetes"

يجب تمكين خيار "استخدام Kubernetes Ingress API" حتى يعمل هذا. يمكنك العثور عليه في الإعدادات> Docker

استيراد إشارات HTML المرجعية (تجريبية)

• متطلبات
  • بيثون3
  • حزم النقطة: وسادة، حساء جميل4
• قم بعمل نسخة احتياطية من db.sqlite الخاص بك قبل تشغيل البرنامج النصي!
• المشكلات المعروفة:
  • الرموز التي تم إنشاؤها غير صحيحة في بعض الأحيان

pip3 install Pillow, beautifulsoup4

cd flame/.dev
python3 bookmarks_importer.py --bookmarks < path to bookmarks.html > --data < path to flame data folder >

CSS والموضوعات المخصصة

راجع ويكي المشروع لمعرفة CSS المخصص والموضوع المخصص باستخدام CSS.