• Fri. Sep 20th, 2024

كيفية تثبيت برنامج OnTrack Budgeting على Linux

Byadmin

Aug 6, 2024

صورة لرجل يستخدم الكمبيوتر المحمول.

Ontrack هو برنامج بسيط ولكنه قوي لإدارة الميزانية يتم استضافته ذاتيًا لنظام Linux. يعمل عن طريق إنشاء واجهة نظيفة وجميلة حيث يمكنك إدراج ميزانيتك ومراجعة شؤونك المالية وحتى تتبع تاريخ إنفاقك. توضح لك هذه المقالة كيفية تثبيت Ontrack على Ubuntu Linux 22.04 باستخدام Docker Compose وCaddy.

افتراض: تفترض هذه المقالة أنك تقوم بتثبيت Ontrack على VPS Ubuntu LTS بسعة ذاكرة وصول عشوائي (RAM) لا تقل عن 2 جيجابايت. كما تفترض أن جهازك يمكن الوصول إليه عبر الإنترنت وأنك تمتلك اسم نطاق.

الحصول على التبعيات لـ Ontrack

الخطوة الأولى في التثبيت على الطريق تتمثل إحدى ميزات برامج إعداد الميزانية في Linux في الحصول على Docker وCaddy. سيقوم الأول بتشغيل تطبيق الويب بالكامل في حاوية معزولة، بينما سيسمح لك الأخير ببثه إلى الإنترنت.

للبدء، قم بالحصول على مفتاح التوقيع لمستودع Docker من موقع الويب الخاص بالمطور:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpgbr>sudo chmod a+r /etc/apt/keyrings/docker.gpg

إنشاء ملف مستودع apt جديد لـ Docker:

sudo nano /etc/apt/sources.list.d/docker.list

اكتب سطر التعليمات البرمجية التالي داخل ملف المستودع الخاص بك:

deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable

تنزيل مفتاح التوقيع لمستودع مشروع Caddy:

curl -fsSL ' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg

احصل على ملف مستودع مشروع Caddy عن طريق تشغيل الأمر التالي:

curl -fsSL ' | sudo tee /etc/apt/sources.list.d/caddy.list

قم بتطبيق مستودعاتك الجديدة وتأكد من أن نظامك محدث بالكامل:

sudo apt update && sudo apt upgrade

قم بتثبيت Docker وDocker Compose وCaddy باستخدام apt:

sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin caddy git

جيد ان تعلم: تعرف على كيفية إصلاح الحزم المعطوبة في Linux.

الحصول على حاوية Docker Ontrack

احصل على مستودع Ontrack الحالي لنظام Linux من صفحة المطور على Github:

git clone https://github.com/inoda/ontrack.git && cd ./ontrack

قم بتشغيل الأمر التالي مرتين لإنشاء سلسلتين طويلتين من النص العشوائي:

cat /dev/urandom | tr -dc 'A-Za-z0-9' | fold -w 32 | head -n 1 >> ~/random-pass.txt
محطة طرفية تعرض كلمتي المرور اللتين تم توليدهما عشوائيًا لتطبيق Ontrack.

افتح ملف “docker-compose.yml” الخاص بـ Ontrack باستخدام محرر النصوص المفضل لديك:

nano ./docker-compose.yml

انتقل إلى المتغير “SECRET_KEY_BASE” وقم بتغيير القيمة من “super-secret” إلى السلسلة العشوائية الأولى.

محطة تسلط الضوء على قاعدة المفتاح السري العشوائية لـ Ontrack.

استبدل السلسلة “secret” في المتغير “DATABASE_URL” بالسلسلة العشوائية الثانية.

محطة تسلط الضوء على كلمة المرور العشوائية الثانية لقاعدة بيانات Postgres.

قم بالتمرير لأسفل إلى المتغير “POSTGRES_PASSWORD” واستبدل القيمة “secret” بالسلسلة العشوائية الثانية.

محطة تسلط الضوء على نفس كلمة المرور الثانية على متغير POSTGRES_PASSWORD.

تحديث وبناء حاوية Ontrack

افتح ملف Dockerfile الخاص بـ Ontrack باستخدام محرر النصوص المفضل لديك:

استبدال قيمة FROM متغير بما يلي:

محطة تسلط الضوء على إصدارات Ruby المختلفة لـ Ontrack.

احفظ ملف Dockerfile المعدّل، ثم افتح الملف “package.json”:

ابحث عن السطر الذي يبدأ بـ @babel/preset-env، ثم أدخل الكود التالي أسفله:

"babel-plugin-macros": "^3.0.1",
محطة طرفية تظهر التبعية المضافة لـ Ontrack.

قم بالتمرير لأسفل إلى فئة “devDependencies”، ثم أضف ما يلي أسفل @babel/eslint-parser خط:

"@babel/plugin-proposal-object-rest-spread": "^7.15.4",
محطة طرفية تظهر اعتماد التطوير الثاني لـ Ontrack.

افتح ملف تكوين مثيلك باستخدام محرر النصوص المفضل لديك:

nano ~/ontrack/config/environments/development.rb

أضف سطر التعليمات البرمجية التالي أسفله مباشرة Rails.application.configure do:

config.hosts = [
    "SUBDOMAIN.YOUR-ROOT.DOMAIN"
]
محطة طرفية تعرض الإعداد الخاص باسم مضيف المثيل.

احفظ ملف تكوين مثيلك، ثم قم بتشغيل الأمر التالي لبناء Ontrack وقاعدة بيانات Postgres الخاصة به:

sudo docker compose up --detach

ملحوظة: قد تستغرق عملية بناء حاوية Ontrack Docker ما بين 5 إلى 10 دقائق حسب موارد الخادم لديك. إذا كان جهازك يحتوي على أقل من 2 جيجابايت من ذاكرة الوصول العشوائي ولا يحتوي على ملف مبادلة، فسوف يفشل Docker دون الإبلاغ عن أي أخطاء على المحطة الطرفية.

تأكد من تشغيل حاويات Ontrack بشكل صحيح عن طريق إدراج جميع عمليات Docker النشطة:

محطة طرفية تُظهر حاويتي Docker اللتين تعملان بنظام Ontrack.

إنشاء وكيل عكسي SSL باستخدام Caddy

في هذه المرحلة، لديك برنامج Ontrack للميزانية قيد التشغيل على المنفذ 3000 بجهازك. للوصول إلى هذا المنفذ بأمان، تحتاج إلى إنشاء وكيل عكسي SSL يقوم بتشفير الاتصال بينك وبين الخادم.

انتقل إلى مدير DNS الخاص بنطاقك، ثم أضف سجل “A” جديدًا لمثيل Ontrack الخاص بك.

لقطة شاشة تعرض سجل DNS المخصص لـ Ontrack.

قم بعمل نسخة احتياطية لملف Caddyfile الأصلي، ثم قم بإنشاء ملف Caddyfile جديد ضمن “/etc/caddy/”:

sudo mv /etc/caddy/Caddyfile ~/Caddyfile.backup
sudo nano /etc/caddy/Caddyfile

قم بلصق كتلة التعليمات البرمجية التالية داخل ملف Caddyfile الجديد الخاص بك:

SUBDOMAIN.YOUR-ROOT.DOMAIN {
    reverse_proxy :3000
}

احفظ ملف Caddy الجديد، ثم ابدأ تشغيل برنامج Caddy daemon لتشغيل الوكيل العكسي الجديد:

sudo systemctl enable --now caddy.service

اختبر ما إذا كان وكيل SSL العكسي الخاص بك يعمل عن طريق الانتقال إلى عنوان URL الخاص بك.

لقطة شاشة توضح أن مثيل Ontrack يعمل بشكل صحيح.

جيد ان تعلم: تعرف على المزيد حول SSL وكيفية حمايته للويب من الجهات الضارة عن طريق إصدار شهادة موقعة ذاتيًا في OpenSSL.

استخدام Ontrack وإنشاء حساب مستخدم

مع تشغيل Ontrack، يمكنك الآن إنشاء حساب مستخدم. للقيام بذلك، ارجع إلى نافذة المحطة الطرفية الخاصة بخادمك ثم افتح غلاف حاوية Ontrack:

sudo docker exec -it ontrack sh

افتح معالج قاعدة البيانات داخل حاوية Ontrack الخاصة بك:

قم بإنشاء حساب المستخدم الجديد الخاص بك عن طريق تشغيل الأمر التالي:

User.create!(username: "YOUR-USERNAME", password: "YOUR-SECURE-PASSWORD")
محطة طرفية تعرض بيانات اعتماد المستخدم النموذجية.

اكتب “خروج”، ثم اضغط على يدخل لمغادرة معالج قاعدة البيانات.

يضعط كنترول + د لمغادرة غلاف الجذر الخاص بحاوية Docker الخاصة بك.

محطة طرفية تُظهر عملية الخروج لحاوية Ontrack Docker.

قم باختبار حسابك الجديد عن طريق فتح Ontrack على متصفح الويب الخاص بك وتسجيل الدخول إلى حسابك.

إنشاء معاملتك الأولى على Ontrack

لاستخدام Ontrack لتسجيل المعاملات، تحتاج إلى إنشاء فئة نفقات. يتيح هذا لتطبيق الويب تجميع نفقاتك في مجموعات، مما يسهل استنتاج رؤى حول عادات الإنفاق الخاصة بك.

قم بالتمرير لأسفل لوحة معلومات Ontrack، ثم انقر فوق أضف فئة.

لقطة شاشة تظهر

قم بتوفير اسم الفئة ولون العلامة وما إذا كانت لها حد إنفاق أم لا. على سبيل المثال، قمت بتسمية فئتي بـ “الترفيه” بعلامة حمراء وحد إنفاق 200 دولار.

لقطة شاشة توضح تفاصيل فئة العينة في Ontrack.

انقر أضف مصروفًا على لوحة معلومات Ontrack.

لقطة شاشة تظهر

قم بإدخال تفاصيل نفقاتك، ثم انقر فوق يحفظ لتثبيته في مثيل Ontrack الخاص بك.

لقطة شاشة توضح نموذج النفقات الخاص بـ Ontrack.

أخيرًا، تأكد من أن Ontrack نجح في حفظ معاملتك من خلال التحقق من سجل نفقاتك. للقيام بذلك، انتقل لأعلى الصفحة، ثم انقر فوق تاريخ الرابط في الزاوية اليمنى العليا للصفحة.

لقطة شاشة تعرض معاملة نموذجية في سجل Ontrack.

إن تثبيت برنامج تعقب النفقات الخاص بك ونشره هو مجرد الخطوة الأولى لاستعادة السيطرة على حياتك الإلكترونية والرقمية. تعرف على كيفية ضمان خصوصيتك عند إرسال رسائل البريد الإلكتروني من خلال تثبيت خادم بديل مثل SimpleLogin.

By admin

Leave a Reply

Your email address will not be published. Required fields are marked *