diff --git a/docs/vserver-one-click-apps-installer.md b/docs/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..c10298bf8 --- /dev/null +++ b/docs/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: One Click Apps Installer" +description: "Deploy apps with the VPS One Click Apps Installer, manage projects through the web interface, and use Coolify for advanced app management -> Learn more now" +sidebar_label: One Click App Installer +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introduction + +The One Click Apps Installer lets you browse an extensive app catalogue and deploy apps directly from your VPS web interface. In this guide, you will learn how to prepare your server, choose the correct installation type, install and manage apps, and use the advanced settings and troubleshooting tools when needed. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## Preparation + +Before you use the One Click Apps Installer, your VPS must meet the minimum requirements and use a supported operating system. + +:::info Minimum Requirements +The apps feature requires your VPS to be online and configured with enough resources to run both the platform services and your installed apps reliably. +::: + +| Requirement | Minimum | Recommended | +| --- | --- | --- | +| Server status | Online | Online | +| Storage | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2 cores | 4 cores | +| Operating system | Debian or Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution Fresh Operating System Recommended +It is strongly recommended to set up the apps feature on a fresh operating system installation. This helps avoid conflicts with existing services, occupied ports, Docker setups, or custom configurations already present on the server. +::: + +If you need to reinstall your VPS before continuing, use a fresh supported Debian or Ubuntu LTS image from your VPS management interface. + +## Accessing the One Click Apps Installer + +Open your VPS in the ZAP-Hosting web interface and locate the One Click Apps section. From there, you can start the initial setup and later return to manage all apps installed on the server. + +The first time you open this feature, you need to choose how the platform should be installed on your VPS. + +## Choosing an Installation Type + +You can select between a full installation and a node-only installation. The correct option depends on whether this VPS should host both the management panel and apps, or only act as a linked node for another panel. + +### Full Installation + +Choose **Full Installation** if you want to set up the server with the panel and the server itself as a node. This is the recommended option for first-time users and for most standard deployments. + +With this method, you can: + +- deploy apps from the app catalogue +- manage projects and environments +- organize all apps in one place +- use the integrated web interface management tools +- access the advanced panel later if required + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip Recommended for Most Users +If this is your first time using the apps feature, select the full installation option. It provides the simplest setup and gives you complete management directly from the ZAP-Hosting web interface. +::: + +### Node-only Installation + +Choose **Node-only Installation** if you want this VPS to act only as a node. You can then link it to another VPS server or to an external panel instance. + +This option is useful if you want to: + +- scale across multiple VPS systems +- centralize management on one panel +- link this server to an existing deployment +- expand an existing multi-node setup + +:::note Advanced Deployment Option +Node-only installation is intended for users who already have another panel instance available or who want to connect this server to an external environment. +::: + +## Installing the Apps Feature + +After selecting the installation type, start the setup from the web interface. The initial installation usually only takes a few minutes. + +During this process, the platform services required for the One Click Apps feature are deployed to your VPS. Once complete, the app catalogue and management sections become available in the web interface. + +:::info Installation Behavior +Exact installation progress details may vary depending on your VPS performance, operating system state, and network conditions. If the setup does not complete successfully, review the troubleshooting section later in this guide. +::: + +## Browsing the App Catalogue + +Once installation is complete, you can open the app catalogue and browse the available apps. The catalogue contains more than 300 ready-to-deploy apps and supports filtering to help you find the correct app quickly. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Searching and Filtering Apps + +In the catalogue, you can search for apps by name and filter by category. This helps you narrow down all apps available in the app store style interface and find the right deployment target for your project. + +Typical actions include: + +- searching by app name +- filtering by category +- reviewing available app entries +- selecting an app for deployment + +This workflow is especially useful if you are managing many apps download targets or comparing multiple services before installation. + +### Starting an App Installation + +After selecting an app from the catalogue, begin the installation through the web interface. Depending on the app, you may need to define values such as: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +These placeholders represent values specific to your deployment. For example, `[your_domain]` should be replaced with the domain you want to use for the app. + +:::tip Projects and Environments +Use projects and environments to keep your deployment organized. This is especially helpful when you host multiple apps, test versions, or separate production and staging services. +::: + +## Managing Installed Apps + +After deployment, your installed apps are listed in the management section of the web interface. From here, you can monitor and control your services without manually working with the underlying containers. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Available Management Actions + +The installed apps section allows you to perform common lifecycle actions directly from the web interface. + +| Action | Purpose | +| --- | --- | +| Start | Starts a stopped app | +| Stop | Stops a running app | +| Check logs | Opens the app logs for troubleshooting | +| Reinstall | Re-deploys the app | + +These tools make it easier to manage all apps from one place, especially if you want simple web-based control instead of manual command line administration. + +### Organizing Projects and Environments + +Projects and environments help you structure your deployments clearly. You can use them to separate: + +- personal and production apps +- test and live environments +- multiple customer or team deployments +- different stacks on the same VPS + +This organization becomes increasingly important as your app store apps collection grows and you manage more services on one or more nodes. + +## Domains, Cloud Access, and SSL + +The One Click Apps feature supports custom domains and ZAP Cloud integration. This allows you to expose apps securely and provision SSL certificates for your deployments. + +:::info Domain and SSL Support +You can use custom domains for your apps and benefit from SSL certificate provisioning where supported by the platform setup. +::: + +When assigning a domain, ensure that your DNS records point to `[your_server_ip]`. If your domain is not configured correctly, the app may not become reachable from the internet. + +| Value | Description | +| --- | --- | +| `[your_domain]` | The domain or subdomain assigned to your app | +| `[your_server_ip]` | The public IP address of your VPS | + +:::caution DNS Must Point to Your VPS +If the DNS for `[your_domain]` does not point to `[your_server_ip]`, domain validation and app access may fail. +::: + +## Using Advanced Settings + +Advanced users can access additional functionality through the external panel available in the advanced settings section. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +This can be useful if you need deeper customization, expanded deployment control, or direct access to features beyond the standard web interface. + +### Important Support Limitation + +:::caution Support Scope for Advanced Panel Usage +Advanced users are welcome to utilize the external Coolify panel for additional customization and functionality. However, support is limited to the ZAP-Hosting web interface. If you make changes outside of the web interface, assistance may not be available for those custom modifications. +::: + +### When to Use the Advanced Panel + +You may want to use the advanced panel if you need: + +- more detailed deployment customization +- direct node linking workflows +- advanced app configuration +- panel-level management beyond the simplified interface + +If you lose access or the integration stops responding, use the troubleshooting tools described below before making manual changes. + +## Linking Nodes + +If you selected the node-only installation type, you can link this VPS to another VPS server or an external panel instance. This allows you to scale your infrastructure and manage multiple nodes from a single location. + +Node linking is useful when you want to: + +- distribute apps across several VPS systems +- centralize management +- expand capacity without creating isolated deployments +- connect to an external panel environment + +:::note External Panel Linking +You can link your node to another VPS or an external panel instance. Exact linking details depend on the target environment already in use. +::: + +## Troubleshooting Degraded Status + +If the web interface shows a degraded status, it means the platform cannot contact or retrieve data from the instance powering the One Click Apps feature. Follow the troubleshooting steps in chronological order. + +### Status Indicators + +The troubleshooting popup may show indicators such as the following: + +| Status | Meaning | +| --- | --- | +| Coolify Status: Active | The panel service appears to be running | +| API Status: Accessible | The API can currently be reached | +| Service Status: Online | Your VPS itself is online | + +If one or more parts are not functioning correctly, continue with the steps below. + +### Step 1: Confirm the VPS Is Online + +First, ensure that your VPS service is online in the ZAP-Hosting web interface. If the server is offline, the apps platform cannot function. + +### Step 2: Refresh the Status + +Use the **Refresh Status** action to run the health check again with the latest data. This can resolve temporary intermittent issues. + +:::tip Temporary Connectivity Issues +A degraded state may sometimes be caused by a short-lived communication issue. Refreshing the status is the fastest first check. +::: + +### Step 3: Restart Docker + +If the status remains degraded, use the **Restart Docker** action. This forces the platform instance to restart. After a successful response, wait `1-2 minutes` and refresh the status again. + +:::caution Service Restart +Restarting Docker may temporarily interrupt running apps while the services restart. +::: + +### Step 4: Refresh Credentials + +As a final step, use **Refresh Credentials**. This is especially important if the status appears online but web interface functions such as app installation are not working. + +This action: + +- does **not** delete your data +- refreshes the root user credentials +- refreshes the API token used by the web interface +- updates the panel credentials automatically on success + +:::info Safe Credential Refresh +Refreshing credentials does not remove your installed apps or deployment data. It only renews the credentials required for access and communication. +::: + +### When to Contact Support + +If the issue still persists after completing all troubleshooting steps, create a support ticket through the ZAP-Hosting website. + +## Best Practices + +To keep the One Click Apps Installer stable and easy to manage, follow these recommendations: + +| Best practice | Reason | +| --- | --- | +| Use a fresh OS installation | Reduces conflicts with existing services and ports | +| Meet recommended resources | Improves performance and reliability | +| Organize apps into projects and environments | Keeps deployments manageable | +| Configure DNS before assigning domains | Prevents access and SSL issues | +| Use advanced settings carefully | Avoids unsupported custom changes | + +:::tip Keep Deployments Organized +If you plan to host many apps, create a clear naming scheme for `[your_project_name]`, `[your_environment_name]`, and `[your_app_name]` before deploying your first services. +::: + +## Conclusion + +Congratulations, you have successfully set up and used the VPS One Click Apps Installer to deploy and manage apps on your server. For further questions or assistance, please don't hesitate to contact our support team, which is available daily to assist you! + + \ No newline at end of file diff --git a/i18n/ar/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/ar/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..2ab36d48b --- /dev/null +++ b/i18n/ar/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: مثبت التطبيقات بنقرة واحدة" +description: "قم بنشر التطبيقات باستخدام مثبت التطبيقات بنقرة واحدة على VPS، إدارة المشاريع عبر واجهة الويب، واستخدم Coolify لإدارة التطبيقات المتقدمة -> تعلّم المزيد الآن" +sidebar_label: مثبت التطبيقات بنقرة واحدة +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## مقدمة + +يتيح لك مثبت التطبيقات بنقرة واحدة تصفح كتالوج تطبيقات واسع ونشر التطبيقات مباشرة من واجهة الويب الخاصة بـ VPS. في هذا الدليل، ستتعلم كيفية تجهيز سيرفرك، اختيار نوع التثبيت الصحيح، تثبيت وإدارة التطبيقات، واستخدام الإعدادات المتقدمة وأدوات استكشاف الأخطاء وإصلاحها عند الحاجة. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## التحضير + +قبل استخدام مثبت التطبيقات بنقرة واحدة، يجب أن يفي VPS الخاص بك بالحد الأدنى من المتطلبات وأن يستخدم نظام تشغيل مدعوم. + +:::info الحد الأدنى من المتطلبات +تتطلب ميزة التطبيقات أن يكون VPS الخاص بك متصلًا بالإنترنت ومجهزًا بموارد كافية لتشغيل خدمات المنصة والتطبيقات المثبتة بشكل موثوق. +::: + +| المتطلب | الحد الأدنى | الموصى به | +| --- | --- | --- | +| حالة السيرفر | متصل | متصل | +| التخزين | 30 جيجابايت | 50 جيجابايت | +| RAM | 2 جيجابايت | 4 جيجابايت | +| أنوية CPU | 2 أنوية | 4 أنوية | +| نظام التشغيل | Debian أو Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution يُفضل نظام تشغيل جديد +ننصح بشدة بإعداد ميزة التطبيقات على تثبيت نظام تشغيل جديد. هذا يساعد على تجنب التعارضات مع الخدمات الحالية، المنافذ المشغولة، إعدادات Docker، أو التكوينات المخصصة الموجودة بالفعل على السيرفر. +::: + +إذا كنت بحاجة لإعادة تثبيت VPS الخاص بك قبل المتابعة، استخدم صورة Debian أو Ubuntu LTS مدعومة وجديدة من واجهة إدارة VPS. + +## الوصول إلى مثبت التطبيقات بنقرة واحدة + +افتح VPS الخاص بك في واجهة الويب الخاصة بـ ZAP-Hosting وابحث عن قسم التطبيقات بنقرة واحدة. من هناك، يمكنك بدء الإعداد الأولي والعودة لاحقًا لإدارة جميع التطبيقات المثبتة على السيرفر. + +عند فتح هذه الميزة لأول مرة، تحتاج إلى اختيار كيفية تثبيت المنصة على VPS الخاص بك. + +## اختيار نوع التثبيت + +يمكنك الاختيار بين تثبيت كامل أو تثبيت عقدة فقط. الخيار الصحيح يعتمد على ما إذا كان هذا VPS سيستضيف كل من لوحة التحكم والتطبيقات، أو يعمل فقط كعقدة مرتبطة بلوحة أخرى. + +### التثبيت الكامل + +اختر **التثبيت الكامل** إذا كنت تريد إعداد السيرفر مع اللوحة والسيرفر نفسه كعقدة. هذا هو الخيار الموصى به للمستخدمين الجدد ولأغلب عمليات النشر القياسية. + +مع هذه الطريقة، يمكنك: + +- نشر التطبيقات من كتالوج التطبيقات +- إدارة المشاريع والبيئات +- تنظيم جميع التطبيقات في مكان واحد +- استخدام أدوات إدارة واجهة الويب المدمجة +- الوصول إلى اللوحة المتقدمة لاحقًا إذا لزم الأمر + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip موصى به لمعظم المستخدمين +إذا كانت هذه هي المرة الأولى التي تستخدم فيها ميزة التطبيقات، اختر خيار التثبيت الكامل. يوفر إعدادًا بسيطًا ويمنحك إدارة كاملة مباشرة من واجهة الويب الخاصة بـ ZAP-Hosting. +::: + +### تثبيت عقدة فقط + +اختر **تثبيت عقدة فقط** إذا كنت تريد أن يعمل هذا VPS كعقدة فقط. يمكنك ربطه لاحقًا بسيرفر VPS آخر أو بنسخة لوحة خارجية. + +هذا الخيار مفيد إذا كنت تريد: + +- التوسع عبر أنظمة VPS متعددة +- مركزية الإدارة على لوحة واحدة +- ربط هذا السيرفر بنشر موجود +- توسيع إعداد متعدد العقد موجود + +:::note خيار نشر متقدم +تثبيت عقدة فقط موجه للمستخدمين الذين لديهم نسخة لوحة أخرى متاحة أو الذين يريدون ربط هذا السيرفر ببيئة خارجية. +::: + +## تثبيت ميزة التطبيقات + +بعد اختيار نوع التثبيت، ابدأ الإعداد من واجهة الويب. عادةً ما يستغرق التثبيت الأولي بضع دقائق فقط. + +خلال هذه العملية، يتم نشر خدمات المنصة المطلوبة لميزة التطبيقات بنقرة واحدة على VPS الخاص بك. بمجرد الانتهاء، يصبح كتالوج التطبيقات وأقسام الإدارة متاحة في واجهة الويب. + +:::info سلوك التثبيت +قد تختلف تفاصيل تقدم التثبيت حسب أداء VPS، حالة نظام التشغيل، وظروف الشبكة. إذا لم يكتمل الإعداد بنجاح، راجع قسم استكشاف الأخطاء وإصلاحها لاحقًا في هذا الدليل. +::: + +## تصفح كتالوج التطبيقات + +بمجرد اكتمال التثبيت، يمكنك فتح كتالوج التطبيقات وتصفح التطبيقات المتاحة. يحتوي الكتالوج على أكثر من 300 تطبيق جاهز للنشر ويدعم التصفية لمساعدتك في العثور على التطبيق المناسب بسرعة. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### البحث وتصفية التطبيقات + +في الكتالوج، يمكنك البحث عن التطبيقات بالاسم والتصفية حسب الفئة. هذا يساعدك على تضييق نطاق جميع التطبيقات المتاحة في واجهة متجر التطبيقات والعثور على الهدف المناسب لنشر مشروعك. + +الإجراءات النموذجية تشمل: + +- البحث باسم التطبيق +- التصفية حسب الفئة +- مراجعة إدخالات التطبيقات المتاحة +- اختيار تطبيق للنشر + +هذا التدفق مفيد بشكل خاص إذا كنت تدير العديد من أهداف تنزيل التطبيقات أو تقارن بين خدمات متعددة قبل التثبيت. + +### بدء تثبيت تطبيق + +بعد اختيار تطبيق من الكتالوج، ابدأ التثبيت عبر واجهة الويب. حسب التطبيق، قد تحتاج إلى تحديد قيم مثل: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +تمثل هذه العناصر النائبة قيمًا خاصة بنشرك. على سبيل المثال، يجب استبدال `[your_domain]` بالنطاق الذي تريد استخدامه للتطبيق. + +:::tip المشاريع والبيئات +استخدم المشاريع والبيئات للحفاظ على تنظيم نشراتك. هذا مفيد بشكل خاص عند استضافة تطبيقات متعددة، اختبار الإصدارات، أو فصل خدمات الإنتاج والاختبار. +::: + +## إدارة التطبيقات المثبتة + +بعد النشر، تُدرج تطبيقاتك المثبتة في قسم الإدارة بواجهة الويب. من هنا، يمكنك مراقبة خدماتك والتحكم بها دون الحاجة للعمل يدويًا مع الحاويات الأساسية. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### إجراءات الإدارة المتاحة + +يسمح لك قسم التطبيقات المثبتة بأداء إجراءات دورة حياة شائعة مباشرة من واجهة الويب. + +| الإجراء | الغرض | +| --- | --- | +| بدء | تشغيل تطبيق متوقف | +| إيقاف | إيقاف تطبيق يعمل | +| فحص السجلات | فتح سجلات التطبيق لاستكشاف الأخطاء | +| إعادة التثبيت | إعادة نشر التطبيق | + +تجعل هذه الأدوات إدارة جميع التطبيقات من مكان واحد أسهل، خاصة إذا كنت تريد تحكمًا بسيطًا عبر الويب بدلاً من الإدارة اليدوية عبر سطر الأوامر. + +### تنظيم المشاريع والبيئات + +تساعدك المشاريع والبيئات على هيكلة نشراتك بوضوح. يمكنك استخدامها لفصل: + +- التطبيقات الشخصية والإنتاجية +- بيئات الاختبار والإنتاج الحي +- نشرات متعددة لعملاء أو فرق مختلفة +- حزم مختلفة على نفس VPS + +تصبح هذه التنظيمات أكثر أهمية مع نمو مجموعة تطبيقات متجر التطبيقات وإدارتك لمزيد من الخدمات على عقدة واحدة أو أكثر. + +## النطاقات، الوصول السحابي، وSSL + +تدعم ميزة التطبيقات بنقرة واحدة النطاقات المخصصة وتكامل ZAP Cloud. هذا يسمح لك بكشف التطبيقات بأمان وتوفير شهادات SSL لنشرك. + +:::info دعم النطاق وSSL +يمكنك استخدام نطاقات مخصصة لتطبيقاتك والاستفادة من توفير شهادات SSL حيثما تدعمها إعدادات المنصة. +::: + +عند تعيين نطاق، تأكد من أن سجلات DNS تشير إلى `[your_server_ip]`. إذا لم يتم تكوين نطاقك بشكل صحيح، قد لا يصبح التطبيق متاحًا من الإنترنت. + +| القيمة | الوصف | +| --- | --- | +| `[your_domain]` | النطاق أو النطاق الفرعي المعين لتطبيقك | +| `[your_server_ip]` | عنوان IP العام الخاص بـ VPS | + +:::caution يجب أن يشير DNS إلى VPS الخاص بك +إذا لم يشير DNS لـ `[your_domain]` إلى `[your_server_ip]`، قد تفشل عملية التحقق من النطاق والوصول إلى التطبيق. +::: + +## استخدام الإعدادات المتقدمة + +يمكن للمستخدمين المتقدمين الوصول إلى وظائف إضافية عبر اللوحة الخارجية المتاحة في قسم الإعدادات المتقدمة. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +هذا مفيد إذا كنت بحاجة إلى تخصيص أعمق، تحكم موسع في النشر، أو وصول مباشر إلى ميزات تتجاوز واجهة الويب القياسية. + +### حد دعم مهم + +:::caution نطاق الدعم لاستخدام اللوحة المتقدمة +نرحب بالمستخدمين المتقدمين لاستخدام لوحة Coolify الخارجية لمزيد من التخصيص والوظائف. مع ذلك، الدعم يقتصر على واجهة الويب الخاصة بـ ZAP-Hosting. إذا أجريت تغييرات خارج واجهة الويب، قد لا يتوفر الدعم لتلك التعديلات المخصصة. +::: + +### متى تستخدم اللوحة المتقدمة + +قد ترغب في استخدام اللوحة المتقدمة إذا كنت بحاجة إلى: + +- تخصيص نشر أكثر تفصيلاً +- سير عمل ربط العقد مباشرة +- تكوين تطبيقات متقدم +- إدارة على مستوى اللوحة تتجاوز الواجهة المبسطة + +إذا فقدت الوصول أو توقفت التكاملات عن الاستجابة، استخدم أدوات استكشاف الأخطاء أدناه قبل إجراء تغييرات يدوية. + +## ربط العقد + +إذا اخترت نوع التثبيت عقدة فقط، يمكنك ربط هذا VPS بسيرفر VPS آخر أو نسخة لوحة خارجية. هذا يسمح لك بتوسيع البنية التحتية وإدارة عدة عقد من موقع واحد. + +يكون ربط العقد مفيدًا عندما تريد: + +- توزيع التطبيقات عبر أنظمة VPS متعددة +- مركزية الإدارة +- توسيع السعة دون إنشاء نشرات معزولة +- الاتصال ببيئة لوحة خارجية + +:::note ربط لوحة خارجية +يمكنك ربط عقدتك بسيرفر VPS آخر أو نسخة لوحة خارجية. تعتمد تفاصيل الربط الدقيقة على البيئة المستهدفة المستخدمة بالفعل. +::: + +## استكشاف حالة متدهورة + +إذا أظهرت واجهة الويب حالة متدهورة، فهذا يعني أن المنصة لا تستطيع الاتصال أو استرجاع البيانات من النسخة التي تشغل ميزة التطبيقات بنقرة واحدة. اتبع خطوات استكشاف الأخطاء بالترتيب الزمني. + +### مؤشرات الحالة + +قد يظهر مربع استكشاف الأخطاء مؤشرات مثل: + +| الحالة | المعنى | +| --- | --- | +| حالة Coolify: نشط | يبدو أن خدمة اللوحة تعمل | +| حالة API: متاحة | يمكن الوصول إلى API حاليًا | +| حالة الخدمة: متصل | VPS الخاص بك متصل بالإنترنت | + +إذا لم تعمل جزء أو أكثر بشكل صحيح، تابع الخطوات التالية. + +### الخطوة 1: تأكد من أن VPS متصل + +أولاً، تأكد من أن خدمة VPS الخاصة بك متصلة في واجهة الويب الخاصة بـ ZAP-Hosting. إذا كان السيرفر غير متصل، لا يمكن لمنصة التطبيقات العمل. + +### الخطوة 2: تحديث الحالة + +استخدم إجراء **تحديث الحالة** لإجراء فحص صحي مرة أخرى بأحدث البيانات. هذا يمكن أن يحل مشاكل مؤقتة متقطعة. + +:::tip مشاكل اتصال مؤقتة +قد يكون الوضع المتدهور أحيانًا بسبب مشكلة اتصال قصيرة الأمد. تحديث الحالة هو أسرع فحص أولي. +::: + +### الخطوة 3: إعادة تشغيل Docker + +إذا استمرت الحالة متدهورة، استخدم إجراء **إعادة تشغيل Docker**. هذا يجبر نسخة المنصة على إعادة التشغيل. بعد استجابة ناجحة، انتظر `1-2 دقيقة` ثم حدث الحالة مرة أخرى. + +:::caution إعادة تشغيل الخدمة +إعادة تشغيل Docker قد توقف التطبيقات قيد التشغيل مؤقتًا أثناء إعادة تشغيل الخدمات. +::: + +### الخطوة 4: تحديث بيانات الاعتماد + +كخطوة أخيرة، استخدم **تحديث بيانات الاعتماد**. هذا مهم بشكل خاص إذا كانت الحالة تظهر متصلة لكن وظائف واجهة الويب مثل تثبيت التطبيقات لا تعمل. + +هذا الإجراء: + +- لا يحذف بياناتك +- يحدث بيانات اعتماد مستخدم root +- يحدث رمز API المستخدم من قبل واجهة الويب +- يحدث بيانات اعتماد اللوحة تلقائيًا عند النجاح + +:::info تحديث بيانات اعتماد آمن +تحديث بيانات الاعتماد لا يزيل التطبيقات المثبتة أو بيانات النشر. فقط يجدد بيانات الاعتماد المطلوبة للوصول والتواصل. +::: + +### متى تتواصل مع الدعم + +إذا استمرت المشكلة بعد إكمال جميع خطوات استكشاف الأخطاء، أنشئ تذكرة دعم عبر موقع ZAP-Hosting. + +## أفضل الممارسات + +للحفاظ على مثبت التطبيقات بنقرة واحدة مستقر وسهل الإدارة، اتبع هذه التوصيات: + +| أفضل ممارسة | السبب | +| --- | --- | +| استخدم تثبيت نظام تشغيل جديد | يقلل التعارضات مع الخدمات والمنافذ الحالية | +| استوفِ الموارد الموصى بها | يحسن الأداء والموثوقية | +| نظم التطبيقات في مشاريع وبيئات | يحافظ على قابلية إدارة النشر | +| قم بتكوين DNS قبل تعيين النطاقات | يمنع مشاكل الوصول وSSL | +| استخدم الإعدادات المتقدمة بحذر | يتجنب التعديلات المخصصة غير المدعومة | + +:::tip حافظ على تنظيم النشرات +إذا كنت تخطط لاستضافة العديد من التطبيقات، أنشئ نظام تسمية واضح لـ `[your_project_name]`، `[your_environment_name]`، و`[your_app_name]` قبل نشر خدماتك الأولى. +::: + +## الخاتمة + +تهانينا، لقد قمت بإعداد واستخدام مثبت التطبيقات بنقرة واحدة على VPS بنجاح لنشر وإدارة التطبيقات على سيرفرك. لأي أسئلة أو مساعدة إضافية، لا تتردد في التواصل مع فريق الدعم لدينا، المتوفر يوميًا لمساعدتك! + + \ No newline at end of file diff --git a/i18n/de/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/de/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..0ca997823 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: One Click Apps Installer" +description: "Setze Apps mit dem VPS One Click Apps Installer ein, verwalte Projekte über die Weboberfläche und nutze Coolify für erweiterte App-Verwaltung -> Jetzt mehr erfahren" +sidebar_label: One Click App Installer +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Einführung + +Der One Click Apps Installer ermöglicht dir, durch einen umfangreichen App-Katalog zu stöbern und Apps direkt über die Weboberfläche deines VPS zu deployen. In dieser Anleitung lernst du, wie du deinen Server vorbereitest, den richtigen Installationstyp auswählst, Apps installierst und verwaltest sowie erweiterte Einstellungen und Troubleshooting-Tools bei Bedarf nutzt. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## Vorbereitung + +Bevor du den One Click Apps Installer nutzt, muss dein VPS die Mindestanforderungen erfüllen und ein unterstütztes Betriebssystem verwenden. + +:::info Mindestanforderungen +Die Apps-Funktion benötigt, dass dein VPS online ist und mit ausreichend Ressourcen konfiguriert wurde, um sowohl die Plattformdienste als auch deine installierten Apps zuverlässig auszuführen. +::: + +| Anforderung | Minimum | Empfohlen | +| --- | --- | --- | +| Serverstatus | Online | Online | +| Speicherplatz | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2 Kerne | 4 Kerne | +| Betriebssystem | Debian oder Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution Frisches Betriebssystem empfohlen +Es wird dringend empfohlen, die Apps-Funktion auf einer frischen Betriebssysteminstallation einzurichten. So vermeidest du Konflikte mit bestehenden Diensten, belegten Ports, Docker-Setups oder individuellen Konfigurationen, die bereits auf dem Server vorhanden sind. +::: + +Falls du deinen VPS neu installieren musst, nutze ein frisches, unterstütztes Debian- oder Ubuntu LTS-Image aus deinem VPS-Management-Interface. + +## Zugriff auf den One Click Apps Installer + +Öffne deinen VPS im ZAP-Hosting Webinterface und finde den Bereich One Click Apps. Dort kannst du die Erstkonfiguration starten und später alle installierten Apps auf dem Server verwalten. + +Beim ersten Öffnen dieser Funktion musst du auswählen, wie die Plattform auf deinem VPS installiert werden soll. + +## Auswahl des Installationstyps + +Du kannst zwischen einer Vollinstallation und einer Node-only-Installation wählen. Die richtige Option hängt davon ab, ob dieser VPS sowohl das Management-Panel als auch die Apps hosten soll oder nur als verknüpfter Node für ein anderes Panel fungiert. + +### Vollinstallation + +Wähle **Vollinstallation**, wenn du den Server mit dem Panel und dem Server selbst als Node einrichten möchtest. Dies ist die empfohlene Option für Einsteiger und die meisten Standard-Deployments. + +Mit dieser Methode kannst du: + +- Apps aus dem App-Katalog deployen +- Projekte und Umgebungen verwalten +- alle Apps an einem Ort organisieren +- die integrierten Webinterface-Verwaltungstools nutzen +- bei Bedarf später auf das erweiterte Panel zugreifen + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip Für die meisten Nutzer empfohlen +Wenn du die Apps-Funktion zum ersten Mal nutzt, wähle die Vollinstallation. Sie bietet die einfachste Einrichtung und volle Verwaltung direkt über das ZAP-Hosting Webinterface. +::: + +### Node-only-Installation + +Wähle **Node-only-Installation**, wenn dieser VPS nur als Node fungieren soll. Du kannst ihn dann mit einem anderen VPS-Server oder einer externen Panel-Instanz verknüpfen. + +Diese Option ist sinnvoll, wenn du: + +- über mehrere VPS-Systeme skalieren möchtest +- das Management auf einem zentralen Panel bündeln willst +- diesen Server an eine bestehende Deployment-Umgebung anbinden möchtest +- ein bestehendes Multi-Node-Setup erweitern willst + +:::note Erweiterte Deployment-Option +Die Node-only-Installation ist für Nutzer gedacht, die bereits eine andere Panel-Instanz haben oder diesen Server an eine externe Umgebung anbinden möchten. +::: + +## Installation der Apps-Funktion + +Nach der Auswahl des Installationstyps startest du die Einrichtung über das Webinterface. Die Erstinstallation dauert in der Regel nur wenige Minuten. + +Während dieses Prozesses werden die Plattformdienste für die One Click Apps-Funktion auf deinem VPS bereitgestellt. Nach Abschluss sind der App-Katalog und die Verwaltungsbereiche im Webinterface verfügbar. + +:::info Installationsverlauf +Der genaue Fortschritt der Installation kann je nach VPS-Leistung, Zustand des Betriebssystems und Netzwerkbedingungen variieren. Falls die Einrichtung nicht erfolgreich abgeschlossen wird, schaue später im Troubleshooting-Abschnitt dieser Anleitung nach. +::: + +## Durchstöbern des App-Katalogs + +Nach der Installation kannst du den App-Katalog öffnen und die verfügbaren Apps durchsuchen. Der Katalog enthält über 300 sofort einsatzbereite Apps und unterstützt Filter, damit du schnell die passende App findest. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Apps suchen und filtern + +Im Katalog kannst du Apps nach Namen suchen und nach Kategorien filtern. So kannst du die große Auswahl im App-Store-Stil eingrenzen und das passende Deployment-Ziel für dein Projekt finden. + +Typische Aktionen sind: + +- Suche nach App-Namen +- Filterung nach Kategorie +- Durchsicht der verfügbaren App-Einträge +- Auswahl einer App zur Installation + +Dieser Workflow ist besonders praktisch, wenn du viele Apps verwaltest oder mehrere Dienste vor der Installation vergleichst. + +### Start einer App-Installation + +Nach der Auswahl einer App aus dem Katalog startest du die Installation über das Webinterface. Je nach App musst du Werte wie diese definieren: + +- `[dein_projektname]` +- `[dein_umgebungsname]` +- `[deine_domain]` +- `[dein_appname]` + +Diese Platzhalter stehen für spezifische Werte deiner Deployment-Umgebung. Zum Beispiel sollte `[deine_domain]` durch die Domain ersetzt werden, die du für die App nutzen möchtest. + +:::tip Projekte und Umgebungen +Nutze Projekte und Umgebungen, um dein Deployment übersichtlich zu halten. Das ist besonders hilfreich, wenn du mehrere Apps hostest, Versionen testest oder Produktions- und Staging-Services trennst. +::: + +## Verwaltung installierter Apps + +Nach dem Deployment werden deine installierten Apps im Verwaltungsbereich des Webinterfaces aufgelistet. Von hier aus kannst du deine Services überwachen und steuern, ohne manuell mit den zugrundeliegenden Containern arbeiten zu müssen. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Verfügbare Verwaltungsaktionen + +Der Bereich für installierte Apps erlaubt dir, gängige Lifecycle-Aktionen direkt über das Webinterface auszuführen. + +| Aktion | Zweck | +| --- | --- | +| Starten | Startet eine gestoppte App | +| Stoppen | Stoppt eine laufende App | +| Logs prüfen | Öffnet die App-Logs zur Fehlerbehebung | +| Neu installieren | Setzt die App neu auf | + +Diese Tools erleichtern die Verwaltung aller Apps an einem Ort, besonders wenn du einfache Web-basierte Kontrolle statt manueller Kommandozeilenarbeit bevorzugst. + +### Organisation von Projekten und Umgebungen + +Projekte und Umgebungen helfen dir, deine Deployments klar zu strukturieren. Du kannst sie nutzen, um zu trennen: + +- private und produktive Apps +- Test- und Live-Umgebungen +- mehrere Kunden- oder Team-Deployments +- verschiedene Stacks auf demselben VPS + +Diese Organisation wird immer wichtiger, je größer deine App-Store-App-Sammlung wird und je mehr Services du auf einem oder mehreren Nodes verwaltest. + +## Domains, Cloud-Zugriff und SSL + +Die One Click Apps-Funktion unterstützt eigene Domains und die ZAP Cloud-Integration. So kannst du Apps sicher zugänglich machen und SSL-Zertifikate für deine Deployments bereitstellen. + +:::info Domain- und SSL-Unterstützung +Du kannst eigene Domains für deine Apps verwenden und von der automatischen SSL-Zertifikatsbereitstellung profitieren, sofern die Plattform das Setup unterstützt. +::: + +Beim Zuweisen einer Domain stelle sicher, dass deine DNS-Einträge auf `[deine_server_ip]` zeigen. Wenn deine Domain nicht korrekt konfiguriert ist, wird die App möglicherweise nicht aus dem Internet erreichbar sein. + +| Wert | Beschreibung | +| --- | --- | +| `[deine_domain]` | Die Domain oder Subdomain, die deiner App zugewiesen ist | +| `[deine_server_ip]` | Die öffentliche IP-Adresse deines VPS | + +:::caution DNS muss auf deinen VPS zeigen +Wenn der DNS für `[deine_domain]` nicht auf `[deine_server_ip]` zeigt, kann die Domainvalidierung und der App-Zugriff fehlschlagen. +::: + +## Nutzung erweiterter Einstellungen + +Fortgeschrittene Nutzer können über das externe Panel im Bereich der erweiterten Einstellungen zusätzliche Funktionen nutzen. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Das ist praktisch, wenn du tiefere Anpassungen, erweiterte Deployment-Kontrolle oder direkten Zugriff auf Funktionen jenseits der Standard-Weboberfläche brauchst. + +### Wichtige Support-Einschränkung + +:::caution Supportumfang bei Nutzung des erweiterten Panels +Fortgeschrittene Nutzer können das externe Coolify-Panel für zusätzliche Anpassungen und Funktionen verwenden. Der Support beschränkt sich jedoch auf das ZAP-Hosting Webinterface. Änderungen außerhalb des Webinterfaces können vom Support nicht abgedeckt werden. +::: + +### Wann das erweiterte Panel nutzen? + +Das erweiterte Panel ist sinnvoll, wenn du: + +- detailliertere Deployment-Anpassungen brauchst +- direkte Node-Verknüpfungs-Workflows nutzen möchtest +- erweiterte App-Konfigurationen vornehmen willst +- Panel-Management jenseits der vereinfachten Oberfläche benötigst + +Falls du den Zugriff verlierst oder die Integration nicht mehr reagiert, nutze die unten beschriebenen Troubleshooting-Tools, bevor du manuelle Änderungen vornimmst. + +## Nodes verknüpfen + +Wenn du die Node-only-Installation gewählt hast, kannst du diesen VPS mit einem anderen VPS-Server oder einer externen Panel-Instanz verknüpfen. So kannst du deine Infrastruktur skalieren und mehrere Nodes zentral verwalten. + +Node-Verknüpfung ist sinnvoll, wenn du: + +- Apps auf mehrere VPS-Systeme verteilen möchtest +- das Management zentralisieren willst +- Kapazitäten erweitern möchtest, ohne isolierte Deployments zu erstellen +- dich mit einer externen Panel-Umgebung verbinden willst + +:::note Externe Panel-Verknüpfung +Du kannst deinen Node mit einem anderen VPS oder einer externen Panel-Instanz verbinden. Die genauen Verknüpfungsdetails hängen von der bereits genutzten Zielumgebung ab. +::: + +## Troubleshooting bei degradiertem Status + +Wenn das Webinterface einen degradierten Status anzeigt, bedeutet das, dass die Plattform die Instanz, die die One Click Apps-Funktion betreibt, nicht erreichen oder keine Daten abrufen kann. Folge den Troubleshooting-Schritten in chronologischer Reihenfolge. + +### Statusanzeigen + +Das Troubleshooting-Popup kann folgende Indikatoren anzeigen: + +| Status | Bedeutung | +| --- | --- | +| Coolify Status: Aktiv | Der Panel-Dienst scheint zu laufen | +| API Status: Erreichbar | Die API ist aktuell erreichbar | +| Service Status: Online | Dein VPS selbst ist online | + +Wenn ein oder mehrere Teile nicht korrekt funktionieren, fahre mit den folgenden Schritten fort. + +### Schritt 1: VPS-Status prüfen + +Stelle zuerst sicher, dass dein VPS im ZAP-Hosting Webinterface online ist. Wenn der Server offline ist, kann die Apps-Plattform nicht funktionieren. + +### Schritt 2: Status aktualisieren + +Nutze die Aktion **Status aktualisieren**, um den Gesundheitscheck mit den neuesten Daten erneut auszuführen. Das kann temporäre Verbindungsprobleme beheben. + +:::tip Temporäre Verbindungsprobleme +Ein degradierten Zustand kann manchmal durch kurzzeitige Kommunikationsprobleme verursacht werden. Das Aktualisieren des Status ist der schnellste erste Check. +::: + +### Schritt 3: Docker neu starten + +Bleibt der Status degradiert, nutze die Aktion **Docker neu starten**. Dadurch wird die Plattform-Instanz neu gestartet. Nach erfolgreicher Rückmeldung warte `1-2 Minuten` und aktualisiere den Status erneut. + +:::caution Dienstneustart +Das Neustarten von Docker kann laufende Apps vorübergehend unterbrechen, während die Dienste neu starten. +::: + +### Schritt 4: Zugangsdaten aktualisieren + +Als letzten Schritt nutze **Zugangsdaten aktualisieren**. Das ist besonders wichtig, wenn der Status online anzeigt, aber Funktionen im Webinterface wie App-Installation nicht funktionieren. + +Diese Aktion: + +- löscht **nicht** deine Daten +- aktualisiert die Root-Benutzer-Zugangsdaten +- erneuert den API-Token, der vom Webinterface genutzt wird +- aktualisiert die Panel-Zugangsdaten automatisch bei Erfolg + +:::info Sicheres Aktualisieren der Zugangsdaten +Das Aktualisieren der Zugangsdaten entfernt keine installierten Apps oder Deployment-Daten. Es erneuert nur die für Zugriff und Kommunikation benötigten Zugangsdaten. +::: + +### Wann Support kontaktieren? + +Wenn das Problem nach allen Troubleshooting-Schritten weiterhin besteht, erstelle bitte ein Support-Ticket über die ZAP-Hosting Webseite. + +## Best Practices + +Damit der One Click Apps Installer stabil und einfach zu verwalten bleibt, beachte diese Empfehlungen: + +| Best Practice | Grund | +| --- | --- | +| Frische OS-Installation nutzen | Vermeidet Konflikte mit bestehenden Diensten und Ports | +| Empfohlene Ressourcen erfüllen | Verbessert Performance und Zuverlässigkeit | +| Apps in Projekte und Umgebungen organisieren | Hält Deployments übersichtlich | +| DNS vor Domain-Zuweisung konfigurieren | Verhindert Zugriffs- und SSL-Probleme | +| Erweiterte Einstellungen mit Bedacht nutzen | Vermeidet nicht unterstützte individuelle Änderungen | + +:::tip Deployments organisiert halten +Wenn du viele Apps hosten möchtest, erstelle vor dem ersten Deployment ein klares Namensschema für `[dein_projektname]`, `[dein_umgebungsname]` und `[dein_appname]`. +::: + +## Fazit + +Glückwunsch, du hast den VPS One Click Apps Installer erfolgreich eingerichtet und genutzt, um Apps auf deinem Server zu deployen und zu verwalten. Bei weiteren Fragen oder Problemen steht dir unser Support-Team täglich zur Verfügung – zögere nicht, uns zu kontaktieren! + + \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/es/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..e7bded9cc --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: Instalador de Apps con Un Clic" +description: "Despliega apps con el Instalador de Apps con Un Clic para VPS, gestiona proyectos desde la interfaz web y usa Coolify para una gestión avanzada -> Aprende más ahora" +sidebar_label: Instalador de Apps con Un Clic +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introducción + +El Instalador de Apps con Un Clic te permite explorar un extenso catálogo de apps y desplegarlas directamente desde la interfaz web de tu VPS. En esta guía aprenderás cómo preparar tu servidor, elegir el tipo de instalación correcto, instalar y gestionar apps, y usar las configuraciones avanzadas y herramientas de solución de problemas cuando sea necesario. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## Preparación + +Antes de usar el Instalador de Apps con Un Clic, tu VPS debe cumplir con los requisitos mínimos y usar un sistema operativo soportado. + +:::info Requisitos Mínimos +La función de apps requiere que tu VPS esté en línea y configurado con suficientes recursos para ejecutar tanto los servicios de la plataforma como las apps instaladas de forma fiable. +::: + +| Requisito | Mínimo | Recomendado | +| --- | --- | --- | +| Estado del servidor | En línea | En línea | +| Almacenamiento | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2 núcleos | 4 núcleos | +| Sistema operativo | Debian o Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution Se Recomienda Sistema Operativo Nuevo +Se recomienda encarecidamente configurar la función de apps en una instalación fresca del sistema operativo. Esto ayuda a evitar conflictos con servicios existentes, puertos ocupados, configuraciones Docker o personalizaciones ya presentes en el servidor. +::: + +Si necesitas reinstalar tu VPS antes de continuar, usa una imagen fresca soportada de Debian o Ubuntu LTS desde la interfaz de gestión de tu VPS. + +## Accediendo al Instalador de Apps con Un Clic + +Abre tu VPS en la interfaz web de ZAP-Hosting y localiza la sección de Apps con Un Clic. Desde ahí puedes iniciar la configuración inicial y luego volver para gestionar todas las apps instaladas en el servidor. + +La primera vez que abras esta función, deberás elegir cómo se instalará la plataforma en tu VPS. + +## Elegir un Tipo de Instalación + +Puedes seleccionar entre una instalación completa o solo nodo. La opción correcta depende de si este VPS debe alojar tanto el panel de gestión como las apps, o solo actuar como un nodo vinculado para otro panel. + +### Instalación Completa + +Elige **Instalación Completa** si quieres configurar el servidor con el panel y el servidor como nodo. Esta es la opción recomendada para usuarios primerizos y para la mayoría de despliegues estándar. + +Con este método puedes: + +- desplegar apps desde el catálogo de apps +- gestionar proyectos y entornos +- organizar todas las apps en un solo lugar +- usar las herramientas integradas de gestión en la interfaz web +- acceder al panel avanzado más adelante si es necesario + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip Recomendado para la Mayoría de Usuarios +Si es la primera vez que usas la función de apps, selecciona la opción de instalación completa. Proporciona la configuración más sencilla y te da gestión completa directamente desde la interfaz web de ZAP-Hosting. +::: + +### Instalación Solo Nodo + +Elige **Instalación Solo Nodo** si quieres que este VPS actúe solo como nodo. Luego puedes vincularlo a otro servidor VPS o a una instancia de panel externa. + +Esta opción es útil si quieres: + +- escalar entre varios sistemas VPS +- centralizar la gestión en un solo panel +- vincular este servidor a un despliegue existente +- ampliar una configuración multi-nodo ya en uso + +:::note Opción Avanzada de Despliegue +La instalación solo nodo está pensada para usuarios que ya tienen otra instancia de panel disponible o que quieren conectar este servidor a un entorno externo. +::: + +## Instalando la Función de Apps + +Después de seleccionar el tipo de instalación, inicia la configuración desde la interfaz web. La instalación inicial suele tardar solo unos minutos. + +Durante este proceso, los servicios de plataforma necesarios para la función de Apps con Un Clic se despliegan en tu VPS. Una vez completado, el catálogo de apps y las secciones de gestión estarán disponibles en la interfaz web. + +:::info Comportamiento de la Instalación +Los detalles exactos del progreso de instalación pueden variar según el rendimiento de tu VPS, el estado del sistema operativo y las condiciones de red. Si la configuración no se completa con éxito, revisa la sección de solución de problemas más adelante en esta guía. +::: + +## Navegando el Catálogo de Apps + +Una vez finalizada la instalación, puedes abrir el catálogo de apps y explorar las apps disponibles. El catálogo contiene más de 300 apps listas para desplegar y soporta filtros para ayudarte a encontrar la app correcta rápidamente. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Buscar y Filtrar Apps + +En el catálogo puedes buscar apps por nombre y filtrar por categoría. Esto te ayuda a reducir todas las apps disponibles en la interfaz estilo tienda y encontrar el destino de despliegue correcto para tu proyecto. + +Acciones típicas incluyen: + +- buscar por nombre de app +- filtrar por categoría +- revisar las entradas disponibles de apps +- seleccionar una app para desplegar + +Este flujo de trabajo es especialmente útil si gestionas muchos destinos de descarga de apps o comparas varios servicios antes de la instalación. + +### Iniciar la Instalación de una App + +Después de seleccionar una app del catálogo, comienza la instalación desde la interfaz web. Dependiendo de la app, puede que necesites definir valores como: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +Estos marcadores representan valores específicos para tu despliegue. Por ejemplo, `[your_domain]` debe ser reemplazado por el dominio que quieres usar para la app. + +:::tip Proyectos y Entornos +Usa proyectos y entornos para mantener tu despliegue organizado. Esto es especialmente útil cuando alojas múltiples apps, pruebas versiones o separas servicios de producción y staging. +::: + +## Gestionando Apps Instaladas + +Después del despliegue, tus apps instaladas aparecen listadas en la sección de gestión de la interfaz web. Desde aquí puedes monitorear y controlar tus servicios sin trabajar manualmente con los contenedores subyacentes. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Acciones de Gestión Disponibles + +La sección de apps instaladas te permite realizar acciones comunes del ciclo de vida directamente desde la interfaz web. + +| Acción | Propósito | +| --- | --- | +| Iniciar | Inicia una app detenida | +| Detener | Detiene una app en ejecución | +| Ver logs | Abre los logs de la app para solución de problemas | +| Reinstalar | Vuelve a desplegar la app | + +Estas herramientas facilitan gestionar todas las apps desde un solo lugar, especialmente si prefieres control web simple en lugar de administración manual por línea de comandos. + +### Organizando Proyectos y Entornos + +Proyectos y entornos te ayudan a estructurar tus despliegues claramente. Puedes usarlos para separar: + +- apps personales y de producción +- entornos de prueba y en vivo +- múltiples despliegues para clientes o equipos +- diferentes stacks en el mismo VPS + +Esta organización se vuelve cada vez más importante a medida que crece tu colección de apps y gestionas más servicios en uno o varios nodos. + +## Dominios, Acceso Cloud y SSL + +La función de Apps con Un Clic soporta dominios personalizados e integración con ZAP Cloud. Esto te permite exponer apps de forma segura y provisionar certificados SSL para tus despliegues. + +:::info Soporte para Dominios y SSL +Puedes usar dominios personalizados para tus apps y beneficiarte del aprovisionamiento de certificados SSL donde la plataforma lo soporte. +::: + +Al asignar un dominio, asegúrate de que tus registros DNS apunten a `[your_server_ip]`. Si tu dominio no está configurado correctamente, la app puede no ser accesible desde internet. + +| Valor | Descripción | +| --- | --- | +| `[your_domain]` | El dominio o subdominio asignado a tu app | +| `[your_server_ip]` | La dirección IP pública de tu VPS | + +:::caution El DNS Debe Apuntar a Tu VPS +Si el DNS para `[your_domain]` no apunta a `[your_server_ip]`, la validación del dominio y el acceso a la app pueden fallar. +::: + +## Usando Configuraciones Avanzadas + +Los usuarios avanzados pueden acceder a funcionalidades adicionales a través del panel externo disponible en la sección de configuraciones avanzadas. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Esto puede ser útil si necesitas personalización más profunda, control ampliado del despliegue o acceso directo a funciones más allá de la interfaz web estándar. + +### Importante Limitación de Soporte + +:::caution Alcance del Soporte para Uso del Panel Avanzado +Los usuarios avanzados pueden usar el panel externo Coolify para personalización y funcionalidades adicionales. Sin embargo, el soporte está limitado a la interfaz web de ZAP-Hosting. Si haces cambios fuera de la interfaz web, puede que no haya asistencia para esas modificaciones personalizadas. +::: + +### Cuándo Usar el Panel Avanzado + +Puede que quieras usar el panel avanzado si necesitas: + +- personalización detallada del despliegue +- flujos de trabajo de vinculación directa de nodos +- configuración avanzada de apps +- gestión a nivel de panel más allá de la interfaz simplificada + +Si pierdes acceso o la integración deja de responder, usa las herramientas de solución de problemas descritas abajo antes de hacer cambios manuales. + +## Vinculando Nodos + +Si seleccionaste la instalación solo nodo, puedes vincular este VPS a otro servidor VPS o a una instancia de panel externa. Esto te permite escalar tu infraestructura y gestionar múltiples nodos desde un solo lugar. + +La vinculación de nodos es útil cuando quieres: + +- distribuir apps entre varios sistemas VPS +- centralizar la gestión +- ampliar capacidad sin crear despliegues aislados +- conectar a un entorno de panel externo + +:::note Vinculación a Panel Externo +Puedes vincular tu nodo a otro VPS o a una instancia de panel externa. Los detalles exactos de vinculación dependen del entorno destino ya en uso. +::: + +## Solución de Problemas con Estado Degradado + +Si la interfaz web muestra un estado degradado, significa que la plataforma no puede contactar o recuperar datos de la instancia que impulsa la función de Apps con Un Clic. Sigue los pasos de solución de problemas en orden cronológico. + +### Indicadores de Estado + +El popup de solución de problemas puede mostrar indicadores como los siguientes: + +| Estado | Significado | +| --- | --- | +| Estado Coolify: Activo | El servicio del panel parece estar funcionando | +| Estado API: Accesible | La API puede ser alcanzada actualmente | +| Estado Servicio: En línea | Tu VPS está en línea | + +Si una o más partes no funcionan correctamente, continúa con los pasos siguientes. + +### Paso 1: Confirma que el VPS Está En Línea + +Primero, asegúrate de que tu servicio VPS esté en línea en la interfaz web de ZAP-Hosting. Si el servidor está offline, la plataforma de apps no puede funcionar. + +### Paso 2: Refrescar el Estado + +Usa la acción **Refrescar Estado** para ejecutar la comprobación de salud nuevamente con los datos más recientes. Esto puede resolver problemas temporales e intermitentes. + +:::tip Problemas Temporales de Conectividad +Un estado degradado a veces puede ser causado por un problema de comunicación breve. Refrescar el estado es la primera comprobación más rápida. +::: + +### Paso 3: Reiniciar Docker + +Si el estado sigue degradado, usa la acción **Reiniciar Docker**. Esto fuerza a la instancia de la plataforma a reiniciarse. Tras una respuesta exitosa, espera `1-2 minutos` y refresca el estado otra vez. + +:::caution Reinicio del Servicio +Reiniciar Docker puede interrumpir temporalmente las apps en ejecución mientras los servicios se reinician. +::: + +### Paso 4: Refrescar Credenciales + +Como último paso, usa **Refrescar Credenciales**. Esto es especialmente importante si el estado aparece en línea pero funciones de la interfaz web como la instalación de apps no funcionan. + +Esta acción: + +- **no** borra tus datos +- refresca las credenciales del usuario root +- refresca el token API usado por la interfaz web +- actualiza automáticamente las credenciales del panel al tener éxito + +:::info Refresco Seguro de Credenciales +Refrescar credenciales no elimina tus apps instaladas ni datos de despliegue. Solo renueva las credenciales necesarias para acceso y comunicación. +::: + +### Cuándo Contactar Soporte + +Si el problema persiste después de completar todos los pasos de solución de problemas, crea un ticket de soporte a través del sitio web de ZAP-Hosting. + +## Buenas Prácticas + +Para mantener el Instalador de Apps con Un Clic estable y fácil de gestionar, sigue estas recomendaciones: + +| Buena práctica | Razón | +| --- | --- | +| Usa una instalación fresca del SO | Reduce conflictos con servicios y puertos existentes | +| Cumple con los recursos recomendados | Mejora rendimiento y fiabilidad | +| Organiza apps en proyectos y entornos | Mantiene los despliegues manejables | +| Configura DNS antes de asignar dominios | Evita problemas de acceso y SSL | +| Usa configuraciones avanzadas con cuidado | Evita cambios personalizados no soportados | + +:::tip Mantén tus Despliegues Organizados +Si planeas alojar muchas apps, crea un esquema claro de nombres para `[your_project_name]`, `[your_environment_name]` y `[your_app_name]` antes de desplegar tus primeros servicios. +::: + +## Conclusión + +¡Felicidades! Has configurado y usado con éxito el Instalador de Apps con Un Clic para VPS para desplegar y gestionar apps en tu servidor. Para más preguntas o ayuda, no dudes en contactar a nuestro equipo de soporte, disponible a diario para asistirte. + + \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/fr/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..e3c4576dd --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS : Installateur d’Apps en 1 Clic" +description: "Déployez des apps avec l’Installateur d’Apps en 1 Clic pour VPS, gérez vos projets via l’interface web, et utilisez Coolify pour une gestion avancée -> En savoir plus maintenant" +sidebar_label: Installateur d’Apps 1 Clic +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introduction + +L’Installateur d’Apps en 1 Clic te permet de parcourir un catalogue d’applications ultra complet et de déployer des apps directement depuis l’interface web de ton VPS. Dans ce guide, tu vas apprendre à préparer ton serveur, choisir le bon type d’installation, installer et gérer tes apps, et utiliser les réglages avancés ainsi que les outils de dépannage quand c’est nécessaire. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## Préparation + +Avant d’utiliser l’Installateur d’Apps en 1 Clic, ton VPS doit répondre aux exigences minimales et tourner sous un système d’exploitation supporté. + +:::info Exigences minimales +La fonctionnalité apps nécessite que ton VPS soit en ligne et configuré avec suffisamment de ressources pour faire tourner à la fois les services de la plateforme et tes apps installées de manière fiable. +::: + +| Exigence | Minimum | Recommandé | +| --- | --- | --- | +| État du serveur | En ligne | En ligne | +| Stockage | 30 Go | 50 Go | +| RAM | 2 Go | 4 Go | +| CPU | 2 cœurs | 4 cœurs | +| Système d’exploitation | Debian ou Ubuntu LTS | Debian 13 - FR - 64bit | + +:::caution Système d’exploitation frais recommandé +On recommande vivement d’installer la fonctionnalité apps sur une installation fraîche du système d’exploitation. Ça évite les conflits avec des services existants, des ports occupés, des configurations Docker ou des réglages personnalisés déjà présents sur le serveur. +::: + +Si tu dois réinstaller ton VPS avant de continuer, utilise une image fraîche supportée Debian ou Ubuntu LTS depuis ton interface de gestion VPS. + +## Accéder à l’Installateur d’Apps en 1 Clic + +Ouvre ton VPS dans l’interface web ZAP-Hosting et trouve la section One Click Apps. De là, tu peux lancer la configuration initiale et revenir plus tard pour gérer toutes les apps installées sur le serveur. + +La première fois que tu ouvres cette fonctionnalité, tu dois choisir comment la plateforme doit être installée sur ton VPS. + +## Choisir un type d’installation + +Tu peux choisir entre une installation complète et une installation uniquement nœud. Le bon choix dépend si ce VPS doit héberger à la fois le panneau de gestion et les apps, ou seulement agir comme un nœud lié à un autre panneau. + +### Installation complète + +Choisis **Installation complète** si tu veux configurer le serveur avec le panneau et le serveur lui-même comme nœud. C’est l’option recommandée pour les débutants et la plupart des déploiements standards. + +Avec cette méthode, tu peux : + +- déployer des apps depuis le catalogue +- gérer projets et environnements +- organiser toutes les apps au même endroit +- utiliser les outils de gestion intégrés à l’interface web +- accéder au panneau avancé plus tard si besoin + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip Recommandé pour la majorité des utilisateurs +Si c’est ta première fois avec la fonctionnalité apps, choisis l’installation complète. C’est la configuration la plus simple et elle te donne une gestion complète directement depuis l’interface web ZAP-Hosting. +::: + +### Installation uniquement nœud + +Choisis **Installation uniquement nœud** si tu veux que ce VPS serve uniquement de nœud. Tu pourras ensuite le lier à un autre serveur VPS ou à une instance de panneau externe. + +Cette option est utile si tu souhaites : + +- scaler sur plusieurs VPS +- centraliser la gestion sur un seul panneau +- lier ce serveur à un déploiement existant +- étendre une configuration multi-nœuds déjà en place + +:::note Option avancée de déploiement +L’installation uniquement nœud est destinée aux utilisateurs qui ont déjà une autre instance de panneau disponible ou qui veulent connecter ce serveur à un environnement externe. +::: + +## Installer la fonctionnalité Apps + +Après avoir choisi le type d’installation, lance la configuration depuis l’interface web. L’installation initiale prend généralement quelques minutes. + +Pendant ce processus, les services de la plateforme nécessaires à la fonctionnalité One Click Apps sont déployés sur ton VPS. Une fois terminé, le catalogue d’apps et les sections de gestion deviennent accessibles dans l’interface web. + +:::info Comportement de l’installation +Les détails précis de la progression peuvent varier selon les performances de ton VPS, l’état du système d’exploitation et les conditions réseau. Si l’installation ne se termine pas correctement, consulte la section dépannage plus bas dans ce guide. +::: + +## Parcourir le catalogue d’apps + +Une fois l’installation terminée, tu peux ouvrir le catalogue d’apps et parcourir les applications disponibles. Le catalogue contient plus de 300 apps prêtes à être déployées et propose des filtres pour t’aider à trouver rapidement l’app qu’il te faut. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Rechercher et filtrer les apps + +Dans le catalogue, tu peux chercher des apps par nom et filtrer par catégorie. Ça t’aide à réduire la liste dans cette interface façon store d’apps et à trouver la cible de déploiement idéale pour ton projet. + +Actions typiques : + +- chercher par nom d’app +- filtrer par catégorie +- consulter les fiches d’app disponibles +- sélectionner une app pour déploiement + +Ce workflow est super utile si tu gères beaucoup de cibles de téléchargement d’apps ou si tu compares plusieurs services avant d’installer. + +### Lancer une installation d’app + +Après avoir choisi une app dans le catalogue, commence l’installation via l’interface web. Selon l’app, tu devras peut-être définir des valeurs comme : + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +Ces placeholders représentent des valeurs spécifiques à ton déploiement. Par exemple, `[your_domain]` doit être remplacé par le domaine que tu veux utiliser pour l’app. + +:::tip Projets et environnements +Utilise projets et environnements pour garder ton déploiement organisé. C’est super pratique quand tu héberges plusieurs apps, testes des versions, ou sépares production et staging. +::: + +## Gérer les apps installées + +Après le déploiement, tes apps installées sont listées dans la section de gestion de l’interface web. De là, tu peux surveiller et contrôler tes services sans avoir à manipuler manuellement les conteneurs sous-jacents. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Actions de gestion disponibles + +La section apps installées te permet d’effectuer les actions courantes du cycle de vie directement depuis l’interface web. + +| Action | But | +| --- | --- | +| Démarrer | Démarre une app arrêtée | +| Arrêter | Arrête une app en cours | +| Consulter les logs | Ouvre les logs de l’app pour dépannage | +| Réinstaller | Redéploie l’app | + +Ces outils facilitent la gestion de toutes tes apps au même endroit, surtout si tu préfères un contrôle simple via web plutôt que la ligne de commande. + +### Organiser projets et environnements + +Projets et environnements t’aident à structurer clairement tes déploiements. Tu peux les utiliser pour séparer : + +- apps perso et production +- environnements test et live +- déploiements clients ou équipes multiples +- stacks différentes sur le même VPS + +Cette organisation devient de plus en plus importante à mesure que ta collection d’apps store grandit et que tu gères plus de services sur un ou plusieurs nœuds. + +## Domaines, accès Cloud et SSL + +La fonctionnalité One Click Apps supporte les domaines personnalisés et l’intégration ZAP Cloud. Ça te permet d’exposer tes apps en toute sécurité et de provisionner des certificats SSL pour tes déploiements. + +:::info Support domaine et SSL +Tu peux utiliser des domaines personnalisés pour tes apps et bénéficier du provisioning de certificats SSL là où la plateforme le supporte. +::: + +Quand tu assignes un domaine, assure-toi que tes enregistrements DNS pointent vers `[your_server_ip]`. Si ton domaine n’est pas configuré correctement, l’app risque de ne pas être accessible depuis Internet. + +| Valeur | Description | +| --- | --- | +| `[your_domain]` | Le domaine ou sous-domaine assigné à ton app | +| `[your_server_ip]` | L’adresse IP publique de ton VPS | + +:::caution Le DNS doit pointer vers ton VPS +Si le DNS de `[your_domain]` ne pointe pas vers `[your_server_ip]`, la validation du domaine et l’accès à l’app peuvent échouer. +::: + +## Utiliser les réglages avancés + +Les utilisateurs avancés peuvent accéder à des fonctionnalités supplémentaires via le panneau externe disponible dans la section réglages avancés. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +C’est utile si tu as besoin d’une personnalisation plus poussée, d’un contrôle étendu du déploiement, ou d’un accès direct à des fonctionnalités au-delà de l’interface web standard. + +### Limitation importante du support + +:::caution Portée du support pour l’usage du panneau avancé +Les utilisateurs avancés sont libres d’utiliser le panneau externe Coolify pour plus de personnalisation et fonctionnalités. Cependant, le support est limité à l’interface web ZAP-Hosting. Si tu fais des modifications hors de l’interface web, l’assistance peut ne pas être disponible pour ces changements personnalisés. +::: + +### Quand utiliser le panneau avancé + +Tu peux vouloir utiliser le panneau avancé si tu as besoin de : + +- personnalisation plus détaillée du déploiement +- workflows de liaison directe de nœuds +- configuration avancée d’apps +- gestion au niveau panneau au-delà de l’interface simplifiée + +Si tu perds l’accès ou si l’intégration ne répond plus, utilise les outils de dépannage décrits ci-dessous avant de faire des modifications manuelles. + +## Lier des nœuds + +Si tu as choisi l’installation uniquement nœud, tu peux lier ce VPS à un autre serveur VPS ou à une instance de panneau externe. Ça te permet de scaler ton infrastructure et gérer plusieurs nœuds depuis un seul endroit. + +La liaison de nœuds est utile quand tu veux : + +- distribuer des apps sur plusieurs VPS +- centraliser la gestion +- étendre la capacité sans créer des déploiements isolés +- connecter à un environnement panneau externe + +:::note Liaison panneau externe +Tu peux lier ton nœud à un autre VPS ou à une instance de panneau externe. Les détails exacts de la liaison dépendent de l’environnement cible déjà en place. +::: + +## Dépannage du statut dégradé + +Si l’interface web affiche un statut dégradé, cela signifie que la plateforme ne peut pas contacter ou récupérer les données de l’instance qui alimente la fonctionnalité One Click Apps. Suis les étapes de dépannage dans l’ordre chronologique. + +### Indicateurs de statut + +Le popup de dépannage peut afficher des indicateurs comme ceux-ci : + +| Statut | Signification | +| --- | --- | +| Statut Coolify : Actif | Le service panneau semble fonctionner | +| Statut API : Accessible | L’API est actuellement joignable | +| Statut Service : En ligne | Ton VPS est bien en ligne | + +Si une ou plusieurs parties ne fonctionnent pas correctement, continue avec les étapes ci-dessous. + +### Étape 1 : Confirmer que le VPS est en ligne + +D’abord, assure-toi que ton VPS est bien en ligne dans l’interface web ZAP-Hosting. Si le serveur est hors ligne, la plateforme apps ne peut pas fonctionner. + +### Étape 2 : Rafraîchir le statut + +Utilise l’action **Rafraîchir le statut** pour relancer la vérification de santé avec les données les plus récentes. Ça peut résoudre des problèmes temporaires intermittents. + +:::tip Problèmes de connectivité temporaires +Un état dégradé peut parfois être causé par un souci de communication de courte durée. Rafraîchir le statut est la première vérification la plus rapide. +::: + +### Étape 3 : Redémarrer Docker + +Si le statut reste dégradé, utilise l’action **Redémarrer Docker**. Ça force le redémarrage de l’instance plateforme. Après une réponse réussie, attends `1-2 minutes` puis rafraîchis à nouveau le statut. + +:::caution Redémarrage du service +Redémarrer Docker peut interrompre temporairement les apps en cours pendant que les services redémarrent. +::: + +### Étape 4 : Rafraîchir les identifiants + +En dernier recours, utilise **Rafraîchir les identifiants**. C’est particulièrement important si le statut semble en ligne mais que des fonctions de l’interface web comme l’installation d’apps ne fonctionnent pas. + +Cette action : + +- ne supprime **pas** tes données +- rafraîchit les identifiants utilisateur root +- rafraîchit le token API utilisé par l’interface web +- met à jour automatiquement les identifiants du panneau en cas de succès + +:::info Rafraîchissement sécurisé des identifiants +Rafraîchir les identifiants ne supprime pas tes apps installées ni les données de déploiement. Ça renouvelle juste les identifiants nécessaires à l’accès et à la communication. +::: + +### Quand contacter le support + +Si le problème persiste après avoir suivi toutes les étapes de dépannage, crée un ticket de support via le site ZAP-Hosting. + +## Bonnes pratiques + +Pour garder l’Installateur d’Apps en 1 Clic stable et facile à gérer, suis ces recommandations : + +| Bonne pratique | Raison | +| --- | --- | +| Utiliser une installation OS fraîche | Réduit les conflits avec services et ports existants | +| Respecter les ressources recommandées | Améliore performance et fiabilité | +| Organiser les apps en projets et environnements | Facilite la gestion des déploiements | +| Configurer le DNS avant d’assigner les domaines | Évite les problèmes d’accès et SSL | +| Utiliser les réglages avancés avec précaution | Évite les modifications personnalisées non supportées | + +:::tip Garde tes déploiements organisés +Si tu prévois d’héberger beaucoup d’apps, crée un schéma de nommage clair pour `[your_project_name]`, `[your_environment_name]` et `[your_app_name]` avant de déployer tes premiers services. +::: + +## Conclusion + +Bravo, tu as réussi à configurer et utiliser l’Installateur d’Apps en 1 Clic pour VPS afin de déployer et gérer des apps sur ton serveur. Pour toute question ou aide, n’hésite pas à contacter notre équipe support, disponible tous les jours pour t’assister ! + + \ No newline at end of file diff --git a/i18n/it/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/it/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..ee2c54de2 --- /dev/null +++ b/i18n/it/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: Installer One Click Apps" +description: "Distribuisci app con il VPS One Click Apps Installer, gestisci i progetti tramite l'interfaccia web e usa Coolify per una gestione avanzata delle app -> Scopri di più ora" +sidebar_label: Installer One Click Apps +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introduzione + +Il One Click Apps Installer ti permette di sfogliare un vasto catalogo di app e distribuirle direttamente dall'interfaccia web del tuo VPS. In questa guida imparerai come preparare il server, scegliere il tipo di installazione giusto, installare e gestire le app, e usare le impostazioni avanzate e gli strumenti di troubleshooting quando serve. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## Preparazione + +Prima di usare il One Click Apps Installer, il tuo VPS deve soddisfare i requisiti minimi e utilizzare un sistema operativo supportato. + +:::info Requisiti Minimi +La funzione app richiede che il tuo VPS sia online e configurato con risorse sufficienti per far girare sia i servizi della piattaforma che le app installate in modo affidabile. +::: + +| Requisito | Minimo | Consigliato | +| --- | --- | --- | +| Stato server | Online | Online | +| Storage | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2 core | 4 core | +| Sistema operativo | Debian o Ubuntu LTS | Debian 13 - IT - 64bit | + +:::caution Sistema Operativo Pulito Consigliato +È fortemente consigliato configurare la funzione app su un’installazione fresca del sistema operativo. Questo aiuta a evitare conflitti con servizi esistenti, porte occupate, configurazioni Docker o personalizzazioni già presenti sul server. +::: + +Se devi reinstallare il VPS prima di continuare, usa un’immagine fresca supportata di Debian o Ubuntu LTS dal pannello di gestione VPS. + +## Accesso al One Click Apps Installer + +Apri il tuo VPS nell’interfaccia web di ZAP-Hosting e trova la sezione One Click Apps. Da lì puoi avviare la configurazione iniziale e poi tornare a gestire tutte le app installate sul server. + +La prima volta che apri questa funzione, devi scegliere come installare la piattaforma sul tuo VPS. + +## Scelta del Tipo di Installazione + +Puoi scegliere tra un’installazione completa o solo nodo. L’opzione giusta dipende dal fatto che questo VPS debba ospitare sia il pannello di gestione che le app, oppure agire solo come nodo collegato a un altro pannello. + +### Installazione Completa + +Scegli **Installazione Completa** se vuoi configurare il server con il pannello e il server stesso come nodo. Questa è l’opzione consigliata per chi usa la funzione app per la prima volta e per la maggior parte delle installazioni standard. + +Con questo metodo puoi: + +- distribuire app dal catalogo app +- gestire progetti e ambienti +- organizzare tutte le app in un unico posto +- usare gli strumenti di gestione integrati nell’interfaccia web +- accedere al pannello avanzato in seguito se serve + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip Consigliato per la Maggior Parte degli Utenti +Se è la prima volta che usi la funzione app, scegli l’installazione completa. Offre la configurazione più semplice e ti dà il controllo totale direttamente dall’interfaccia web di ZAP-Hosting. +::: + +### Installazione Solo Nodo + +Scegli **Installazione Solo Nodo** se vuoi che questo VPS agisca solo come nodo. Potrai poi collegarlo a un altro server VPS o a un’istanza di pannello esterna. + +Questa opzione è utile se vuoi: + +- scalare su più VPS +- centralizzare la gestione su un unico pannello +- collegare questo server a un’installazione esistente +- espandere una configurazione multi-nodo già attiva + +:::note Opzione Avanzata di Deploy +L’installazione solo nodo è pensata per utenti che hanno già un’altra istanza di pannello o vogliono collegare questo server a un ambiente esterno. +::: + +## Installazione della Funzione App + +Dopo aver scelto il tipo di installazione, avvia la configurazione dall’interfaccia web. L’installazione iniziale di solito richiede solo pochi minuti. + +Durante questo processo, i servizi della piattaforma necessari per la funzione One Click Apps vengono distribuiti sul tuo VPS. Una volta completato, il catalogo app e le sezioni di gestione diventano disponibili nell’interfaccia web. + +:::info Comportamento dell’Installazione +I dettagli precisi del progresso dell’installazione possono variare in base alle prestazioni del VPS, allo stato del sistema operativo e alle condizioni di rete. Se la configurazione non va a buon fine, consulta la sezione troubleshooting più avanti in questa guida. +::: + +## Navigare nel Catalogo App + +Una volta completata l’installazione, puoi aprire il catalogo app e sfogliare le app disponibili. Il catalogo contiene più di 300 app pronte per il deploy e supporta filtri per aiutarti a trovare rapidamente l’app giusta. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Ricerca e Filtri App + +Nel catalogo puoi cercare app per nome e filtrare per categoria. Questo ti aiuta a restringere le app disponibili nell’interfaccia in stile app store e trovare il target di deploy giusto per il tuo progetto. + +Azioni tipiche includono: + +- ricerca per nome app +- filtro per categoria +- revisione delle app disponibili +- selezione di un’app per il deploy + +Questo flusso è particolarmente utile se gestisci molti target di app o confronti più servizi prima di installare. + +### Avviare l’Installazione di un’App + +Dopo aver selezionato un’app dal catalogo, avvia l’installazione tramite l’interfaccia web. A seconda dell’app, potresti dover definire valori come: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +Questi placeholder rappresentano valori specifici per il tuo deploy. Per esempio, `[your_domain]` va sostituito con il dominio che vuoi usare per l’app. + +:::tip Progetti e Ambienti +Usa progetti e ambienti per mantenere organizzato il deploy. È particolarmente utile se ospiti più app, versioni di test o separi servizi di produzione e staging. +::: + +## Gestione delle App Installate + +Dopo il deploy, le app installate sono elencate nella sezione di gestione dell’interfaccia web. Da qui puoi monitorare e controllare i tuoi servizi senza dover lavorare manualmente con i container sottostanti. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Azioni di Gestione Disponibili + +La sezione app installate ti permette di eseguire azioni comuni direttamente dall’interfaccia web. + +| Azione | Scopo | +| --- | --- | +| Avvia | Avvia un’app ferma | +| Ferma | Ferma un’app in esecuzione | +| Controlla log | Apre i log dell’app per il troubleshooting | +| Reinstalla | Ridistribuisce l’app | + +Questi strumenti rendono più semplice gestire tutte le app da un unico posto, soprattutto se preferisci un controllo web semplice invece di usare la linea di comando. + +### Organizzare Progetti e Ambienti + +Progetti e ambienti ti aiutano a strutturare chiaramente i tuoi deploy. Puoi usarli per separare: + +- app personali e di produzione +- ambienti di test e live +- deploy per clienti o team diversi +- stack differenti sullo stesso VPS + +Questa organizzazione diventa sempre più importante man mano che la tua collezione di app cresce e gestisci più servizi su uno o più nodi. + +## Domini, Accesso Cloud e SSL + +La funzione One Click Apps supporta domini personalizzati e l’integrazione con ZAP Cloud. Questo ti permette di esporre le app in modo sicuro e ottenere certificati SSL per i tuoi deploy. + +:::info Supporto Domini e SSL +Puoi usare domini personalizzati per le tue app e beneficiare del provisioning di certificati SSL dove supportato dalla configurazione della piattaforma. +::: + +Quando assegni un dominio, assicurati che i record DNS puntino a `[your_server_ip]`. Se il dominio non è configurato correttamente, l’app potrebbe non essere raggiungibile da internet. + +| Valore | Descrizione | +| --- | --- | +| `[your_domain]` | Il dominio o sottodominio assegnato all’app | +| `[your_server_ip]` | L’indirizzo IP pubblico del tuo VPS | + +:::caution Il DNS Deve Puntare al Tuo VPS +Se il DNS per `[your_domain]` non punta a `[your_server_ip]`, la validazione del dominio e l’accesso all’app potrebbero fallire. +::: + +## Uso delle Impostazioni Avanzate + +Gli utenti avanzati possono accedere a funzionalità extra tramite il pannello esterno disponibile nella sezione impostazioni avanzate. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Questo è utile se ti serve una personalizzazione più profonda, un controllo di deploy ampliato o accesso diretto a funzionalità oltre l’interfaccia web standard. + +### Limite Importante di Supporto + +:::caution Ambito Supporto per Uso Pannello Avanzato +Gli utenti avanzati sono liberi di usare il pannello esterno Coolify per personalizzazioni e funzionalità extra. Tuttavia, il supporto è limitato all’interfaccia web di ZAP-Hosting. Se fai modifiche fuori dall’interfaccia web, l’assistenza potrebbe non coprire quelle personalizzazioni. +::: + +### Quando Usare il Pannello Avanzato + +Potresti voler usare il pannello avanzato se ti servono: + +- personalizzazioni di deploy più dettagliate +- flussi di lavoro di collegamento nodo diretti +- configurazioni avanzate delle app +- gestione a livello di pannello oltre l’interfaccia semplificata + +Se perdi accesso o l’integrazione smette di rispondere, usa prima gli strumenti di troubleshooting descritti qui sotto prima di fare modifiche manuali. + +## Collegamento dei Nodi + +Se hai scelto l’installazione solo nodo, puoi collegare questo VPS a un altro server VPS o a un’istanza di pannello esterna. Questo ti permette di scalare l’infrastruttura e gestire più nodi da un unico punto. + +Il collegamento nodo è utile quando vuoi: + +- distribuire app su più VPS +- centralizzare la gestione +- espandere la capacità senza creare deploy isolati +- connetterti a un ambiente pannello esterno + +:::note Collegamento a Pannello Esterno +Puoi collegare il nodo a un altro VPS o a un’istanza di pannello esterna. I dettagli esatti del collegamento dipendono dall’ambiente di destinazione già in uso. +::: + +## Risoluzione Problemi di Stato Degradato + +Se l’interfaccia web mostra uno stato degradato, significa che la piattaforma non riesce a contattare o recuperare dati dall’istanza che gestisce la funzione One Click Apps. Segui i passaggi di troubleshooting in ordine cronologico. + +### Indicatori di Stato + +Il popup di troubleshooting può mostrare indicatori come i seguenti: + +| Stato | Significato | +| --- | --- | +| Stato Coolify: Attivo | Il servizio pannello sembra in esecuzione | +| Stato API: Accessibile | L’API è raggiungibile al momento | +| Stato Servizio: Online | Il tuo VPS è online | + +Se una o più parti non funzionano correttamente, continua con i passaggi seguenti. + +### Passo 1: Conferma che il VPS sia Online + +Prima di tutto, assicurati che il servizio VPS sia online nell’interfaccia web di ZAP-Hosting. Se il server è offline, la piattaforma app non può funzionare. + +### Passo 2: Aggiorna lo Stato + +Usa l’azione **Aggiorna Stato** per rifare il controllo di salute con i dati più recenti. Questo può risolvere problemi temporanei e intermittenti. + +:::tip Problemi di Connessione Temporanei +Uno stato degradato può essere causato da un problema di comunicazione breve. Aggiornare lo stato è il primo controllo più veloce. +::: + +### Passo 3: Riavvia Docker + +Se lo stato resta degradato, usa l’azione **Riavvia Docker**. Questo forza il riavvio dell’istanza della piattaforma. Dopo una risposta positiva, aspetta `1-2 minuti` e aggiorna di nuovo lo stato. + +:::caution Riavvio Servizio +Riavviare Docker può interrompere temporaneamente le app in esecuzione mentre i servizi si riavviano. +::: + +### Passo 4: Aggiorna le Credenziali + +Come ultimo passo, usa **Aggiorna Credenziali**. Questo è particolarmente importante se lo stato appare online ma funzioni dell’interfaccia web come l’installazione app non funzionano. + +Questa azione: + +- **non** cancella i tuoi dati +- aggiorna le credenziali utente root +- aggiorna il token API usato dall’interfaccia web +- aggiorna automaticamente le credenziali del pannello se ha successo + +:::info Aggiornamento Credenziali Sicuro +Aggiornare le credenziali non rimuove le app installate o i dati di deploy. Rinnova solo le credenziali necessarie per accesso e comunicazione. +::: + +### Quando Contattare il Supporto + +Se il problema persiste dopo aver completato tutti i passaggi di troubleshooting, apri un ticket di supporto tramite il sito ZAP-Hosting. + +## Best Practices + +Per mantenere stabile e facile da gestire il One Click Apps Installer, segui queste raccomandazioni: + +| Best practice | Motivo | +| --- | --- | +| Usa un’installazione OS fresca | Riduce conflitti con servizi e porte esistenti | +| Soddisfa le risorse consigliate | Migliora prestazioni e affidabilità | +| Organizza le app in progetti e ambienti | Mantiene i deploy gestibili | +| Configura il DNS prima di assegnare domini | Previene problemi di accesso e SSL | +| Usa le impostazioni avanzate con cautela | Evita modifiche personalizzate non supportate | + +:::tip Mantieni i Deploy Organizzati +Se prevedi di ospitare molte app, crea uno schema di naming chiaro per `[your_project_name]`, `[your_environment_name]` e `[your_app_name]` prima di distribuire i primi servizi. +::: + +## Conclusione + +Congratulazioni, hai configurato con successo e usato il VPS One Click Apps Installer per distribuire e gestire app sul tuo server. Per domande o assistenza, non esitare a contattare il nostro supporto, disponibile ogni giorno per aiutarti! + + \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/ja/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..9ce2931b1 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: ワンクリックアプリインストーラー" +description: "VPSのワンクリックアプリインストーラーでアプリを展開し、ウェブインターフェースでプロジェクトを管理。高度なアプリ管理にはCoolifyを活用しよう -> 今すぐ詳しく見る" +sidebar_label: ワンクリックアプリインストーラー +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## はじめに + +ワンクリックアプリインストーラーを使えば、豊富なアプリカタログをブラウズして、VPSのウェブインターフェースから直接アプリを展開できます。このガイドでは、サーバーの準備、適切なインストールタイプの選択、アプリのインストールと管理、必要に応じた高度な設定やトラブルシューティングツールの使い方を学べます。 + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## 準備 + +ワンクリックアプリインストーラーを使う前に、VPSが最低要件を満たし、対応OSを使用している必要があります。 + +:::info 最低要件 +アプリ機能を利用するには、VPSがオンラインで、プラットフォームサービスとインストールしたアプリを安定して動かせる十分なリソースが設定されている必要があります。 +::: + +| 要件 | 最低 | 推奨 | +| --- | --- | --- | +| サーバーステータス | オンライン | オンライン | +| ストレージ | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2コア | 4コア | +| OS | Debian または Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution 新規OSインストール推奨 +既存のサービスや使用中のポート、Docker設定、カスタム構成との競合を避けるため、アプリ機能は新規OSインストール上でセットアップすることを強く推奨します。 +::: + +続行前にVPSを再インストールする必要がある場合は、VPS管理画面から対応するDebianまたはUbuntu LTSの新規イメージを使ってください。 + +## ワンクリックアプリインストーラーへのアクセス + +ZAP-HostingのウェブインターフェースでVPSを開き、ワンクリックアプリセクションを探します。ここから初期セットアップを開始し、後でサーバーにインストールしたすべてのアプリを管理できます。 + +初回起動時は、プラットフォームのインストール方法を選択する必要があります。 + +## インストールタイプの選択 + +フルインストールかノードのみインストールかを選べます。どちらを選ぶかは、このVPSが管理パネルとアプリの両方をホストするか、他のパネルのリンクノードとしてのみ使うかによります。 + +### フルインストール + +管理パネルとノードとしてサーバーをセットアップしたい場合は、**フルインストール**を選択してください。初めての方や標準的な展開にはこちらが推奨です。 + +この方法でできること: + +- アプリカタログからアプリを展開 +- プロジェクトや環境を管理 +- すべてのアプリを一元管理 +- 統合されたウェブインターフェース管理ツールを利用 +- 必要に応じて高度なパネルにアクセス可能 + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip ほとんどのユーザーに推奨 +アプリ機能を初めて使うなら、フルインストールを選びましょう。最も簡単にセットアップでき、ZAP-Hostingのウェブインターフェースから完全に管理できます。 +::: + +### ノードのみインストール + +このVPSをノードとしてのみ使いたい場合は、**ノードのみインストール**を選択します。別のVPSや外部パネルにリンク可能です。 + +このオプションは以下の用途に便利です: + +- 複数VPSにまたがるスケールアウト +- 管理を一つのパネルに集中 +- 既存の展開にこのサーバーをリンク +- マルチノード構成の拡張 + +:::note 上級者向け展開オプション +ノードのみインストールは、すでに別のパネルがあるか、外部環境に接続したいユーザー向けです。 +::: + +## アプリ機能のインストール + +インストールタイプを選んだら、ウェブインターフェースからセットアップを開始します。初期インストールは通常数分で完了します。 + +この間、ワンクリックアプリ機能に必要なプラットフォームサービスがVPSに展開されます。完了すると、ウェブインターフェースにアプリカタログと管理セクションが表示されます。 + +:::info インストールの挙動 +インストールの進行状況はVPSの性能、OSの状態、ネットワーク環境によって異なる場合があります。セットアップがうまくいかない場合は、後述のトラブルシューティングを参照してください。 +::: + +## アプリカタログの閲覧 + +インストール完了後、アプリカタログを開いて利用可能なアプリをブラウズできます。300以上の即展開可能なアプリがあり、フィルター機能で目的のアプリを素早く見つけられます。 + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### アプリの検索とフィルター + +カタログ内ではアプリ名で検索したり、カテゴリで絞り込みが可能です。これにより、アプリストア風のインターフェースで目的の展開先を簡単に見つけられます。 + +よく使う操作: + +- アプリ名で検索 +- カテゴリでフィルター +- 利用可能なアプリの確認 +- 展開したいアプリの選択 + +多くのアプリを管理したり、複数サービスを比較検討する際に便利です。 + +### アプリのインストール開始 + +カタログからアプリを選んだら、ウェブインターフェースでインストールを開始します。アプリによっては以下のような値を設定する必要があります: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +これらは展開に合わせた固有の値に置き換えてください。例えば、`[your_domain]`はアプリで使いたいドメインに差し替えます。 + +:::tip プロジェクトと環境の活用 +複数のアプリをホストしたり、バージョンのテスト、運用とステージングの分離にプロジェクトと環境を使うと管理が楽になります。 +::: + +## インストール済みアプリの管理 + +展開後、インストール済みアプリはウェブインターフェースの管理セクションに一覧表示されます。ここから、基盤のコンテナを直接操作せずにサービスの監視や制御が可能です。 + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### 利用可能な管理操作 + +インストール済みアプリセクションでは、一般的なライフサイクル操作をウェブインターフェースから直接実行できます。 + +| 操作 | 内容 | +| --- | --- | +| 起動 | 停止中のアプリを起動 | +| 停止 | 実行中のアプリを停止 | +| ログ確認 | トラブルシューティング用にアプリログを開く | +| 再インストール | アプリを再展開 | + +これらのツールで、コマンドラインを使わずに簡単にアプリを管理できます。 + +### プロジェクトと環境の整理 + +プロジェクトと環境を使うと展開を明確に構造化できます。例えば: + +- 個人用と本番用アプリの分離 +- テスト環境とライブ環境の区別 +- 複数顧客やチームの展開管理 +- 同じVPS上の異なるスタック管理 + +アプリ数が増えたり複数ノードを管理する際に特に重要です。 + +## ドメイン、クラウドアクセス、SSL + +ワンクリックアプリ機能はカスタムドメインとZAP Cloud連携をサポート。アプリを安全に公開し、SSL証明書の発行も可能です。 + +:::info ドメインとSSL対応 +カスタムドメインを使い、プラットフォーム設定で対応していればSSL証明書の発行も利用できます。 +::: + +ドメインを割り当てる際は、DNSレコードが`[your_server_ip]`を指していることを必ず確認してください。正しく設定されていないと、アプリがインターネットからアクセスできません。 + +| 値 | 説明 | +| --- | --- | +| `[your_domain]` | アプリに割り当てるドメインまたはサブドメイン | +| `[your_server_ip]` | VPSのパブリックIPアドレス | + +:::caution DNSは必ずVPSを指すこと +`[your_domain]`のDNSが`[your_server_ip]`を指していないと、ドメイン認証やアプリアクセスに失敗します。 +::: + +## 高度な設定の利用 + +上級者は高度な設定セクションから外部パネルにアクセスして、さらに細かいカスタマイズや展開制御が可能です。 + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +標準のウェブインターフェース以上の機能に直接アクセスしたい場合に便利です。 + +### 重要なサポート制限 + +:::caution 高度なパネル利用時のサポート範囲 +外部Coolifyパネルの利用は自由ですが、サポートはZAP-Hostingのウェブインターフェースに限定されます。ウェブインターフェース外での変更にはサポートが提供されない場合があります。 +::: + +### 高度なパネルを使うタイミング + +以下のような場合に高度なパネルを使うと良いでしょう: + +- 詳細な展開カスタマイズが必要 +- ノードリンクの直接操作 +- 高度なアプリ設定 +- 簡易インターフェースを超えたパネル管理 + +アクセスできなくなったり連携が止まった場合は、手動変更前に下記のトラブルシューティングを試してください。 + +## ノードのリンク + +ノードのみインストールを選んだ場合、このVPSを別のVPSや外部パネルにリンクできます。これによりインフラをスケールし、複数ノードを一元管理可能です。 + +ノードリンクは以下の用途に便利です: + +- 複数VPSにアプリを分散 +- 管理を集中化 +- 孤立しない拡張 +- 外部パネル環境との接続 + +:::note 外部パネルリンク +ノードは別VPSや外部パネルにリンク可能。リンク方法は対象環境によって異なります。 +::: + +## 劣化ステータスのトラブルシューティング + +ウェブインターフェースで劣化ステータスが表示されたら、プラットフォームがOne Click Apps機能を動かすインスタンスに接続できていない状態です。以下の手順を順に試してください。 + +### ステータス指標 + +トラブルシューティングポップアップには以下のような指標が表示されます: + +| ステータス | 意味 | +| --- | --- | +| Coolifyステータス: アクティブ | パネルサービスが稼働中の可能性あり | +| APIステータス: アクセス可能 | APIに現在アクセス可能 | +| サービスステータス: オンライン | VPS自体はオンライン | + +いずれかが正常でない場合は次の手順へ進みます。 + +### ステップ1: VPSがオンラインか確認 + +まずZAP-HostingのウェブインターフェースでVPSがオンラインか確認してください。オフラインならアプリプラットフォームは動作しません。 + +### ステップ2: ステータスの更新 + +**ステータス更新**を使って最新データでヘルスチェックを再実行します。短時間の通信障害ならこれで解決することがあります。 + +:::tip 一時的な接続問題 +劣化状態は一時的な通信問題が原因のこともあります。ステータス更新が最速の初期対応です。 +::: + +### ステップ3: Dockerの再起動 + +劣化状態が続く場合は**Docker再起動**を実行してください。プラットフォームインスタンスが再起動されます。成功後は`1-2分`待ってから再度ステータスを更新しましょう。 + +:::caution サービス再起動の影響 +Docker再起動中はアプリが一時的に停止する可能性があります。 +::: + +### ステップ4: 認証情報の更新 + +最後に**認証情報の更新**を行います。ステータスがオンラインでもウェブインターフェースの機能が動かない場合に特に有効です。 + +この操作は: + +- データを削除しません +- rootユーザーの認証情報を更新 +- ウェブインターフェースが使うAPIトークンを更新 +- 成功時にパネル認証情報を自動更新 + +:::info 認証情報更新は安全 +認証情報の更新はインストール済みアプリや展開データを削除しません。アクセスと通信に必要な認証情報だけをリフレッシュします。 +::: + +### サポートに連絡するタイミング + +すべての手順を試しても問題が解決しない場合は、ZAP-Hostingのウェブサイトからサポートチケットを作成してください。 + +## ベストプラクティス + +ワンクリックアプリインストーラーを安定して管理しやすくするため、以下の推奨事項を守りましょう: + +| ベストプラクティス | 理由 | +| --- | --- | +| 新規OSインストールを使う | 既存サービスやポートとの競合を減らす | +| 推奨リソースを満たす | パフォーマンスと信頼性向上 | +| プロジェクトと環境で整理 | 展開管理を簡単に | +| ドメイン割り当て前にDNS設定 | アクセスやSSLの問題防止 | +| 高度な設定は慎重に使う | サポート対象外のカスタム変更を避ける | + +:::tip 展開は整理して管理 +多くのアプリをホストするなら、最初に`[your_project_name]`、`[your_environment_name]`、`[your_app_name]`の命名ルールを決めておくと管理が楽です。 +::: + +## まとめ + +おめでとうございます!VPSのワンクリックアプリインストーラーを使って、サーバー上でアプリを展開・管理する準備が整いました。質問やサポートが必要な場合は、毎日対応しているサポートチームまでお気軽にお問い合わせください! + + \ No newline at end of file diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/nl/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..9e2e6174c --- /dev/null +++ b/i18n/nl/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: One Click Apps Installer" +description: "Deploy apps met de VPS One Click Apps Installer, beheer projecten via de webinterface en gebruik Coolify voor geavanceerd appbeheer -> Leer nu meer" +sidebar_label: One Click App Installer +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introductie + +Met de One Click Apps Installer blader je door een uitgebreide app-catalogus en zet je apps direct vanuit je VPS-webinterface live. In deze gids leer je hoe je je server voorbereidt, het juiste installatie-type kiest, apps installeert en beheert, en geavanceerde instellingen en troubleshooting-tools gebruikt wanneer nodig. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## Voorbereiding + +Voordat je de One Click Apps Installer gebruikt, moet je VPS aan de minimale eisen voldoen en een ondersteund besturingssysteem draaien. + +:::info Minimale Vereisten +De apps-functie vereist dat je VPS online is en genoeg resources heeft om zowel de platformdiensten als je geïnstalleerde apps betrouwbaar te draaien. +::: + +| Vereiste | Minimaal | Aanbevolen | +| --- | --- | --- | +| Serverstatus | Online | Online | +| Opslag | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2 cores | 4 cores | +| Besturingssysteem | Debian of Ubuntu LTS | Debian 13 - NL - 64bit | + +:::caution Verse OS Installatie Aanbevolen +We raden sterk aan om de apps-functie op een verse OS-installatie te zetten. Zo voorkom je conflicten met bestaande services, bezette poorten, Docker-setup of custom configuraties die al op de server staan. +::: + +Moet je je VPS opnieuw installeren? Gebruik dan een verse, ondersteunde Debian- of Ubuntu LTS-image via je VPS-beheerinterface. + +## Toegang tot de One Click Apps Installer + +Open je VPS in de ZAP-Hosting webinterface en zoek de sectie One Click Apps. Vanaf daar start je de eerste setup en kun je later terugkomen om alle geïnstalleerde apps te beheren. + +De eerste keer dat je deze functie opent, kies je hoe het platform op je VPS geïnstalleerd moet worden. + +## Installatietype kiezen + +Je kunt kiezen tussen een volledige installatie en een node-only installatie. Welke optie je kiest, hangt af van of deze VPS zowel het managementpaneel als de apps moet hosten, of alleen als gekoppelde node voor een ander paneel fungeert. + +### Volledige Installatie + +Kies **Volledige Installatie** als je de server wilt opzetten met het paneel én de server zelf als node. Dit is de aanbevolen optie voor beginners en de meeste standaarddeployments. + +Met deze methode kun je: + +- apps uit de app-catalogus deployen +- projecten en omgevingen beheren +- alle apps op één plek organiseren +- gebruikmaken van geïntegreerde webinterface management tools +- later toegang krijgen tot het geavanceerde paneel indien nodig + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip Aanbevolen voor de meeste gebruikers +Als je voor het eerst met de apps-functie werkt, kies dan voor de volledige installatie. Dit is de makkelijkste setup en geeft je volledige controle direct vanuit de ZAP-Hosting webinterface. +::: + +### Node-only Installatie + +Kies **Node-only Installatie** als je wilt dat deze VPS alleen als node fungeert. Je kunt ‘m dan koppelen aan een andere VPS-server of een extern paneel. + +Deze optie is handig als je: + +- wilt schalen over meerdere VPS-systemen +- beheer wilt centraliseren op één paneel +- deze server wilt koppelen aan een bestaande deployment +- een multi-node setup wilt uitbreiden + +:::note Geavanceerde Deployment Optie +Node-only installatie is bedoeld voor gebruikers die al een ander paneel hebben of deze server willen koppelen aan een externe omgeving. +::: + +## De Apps-functie installeren + +Na het kiezen van het installatietype start je de setup via de webinterface. De initiële installatie duurt meestal maar een paar minuten. + +Tijdens dit proces worden de platformdiensten die nodig zijn voor de One Click Apps-functie op je VPS uitgerold. Zodra dit klaar is, zijn de app-catalogus en beheersecties beschikbaar in de webinterface. + +:::info Installatiegedrag +De exacte voortgang kan verschillen afhankelijk van je VPS-prestaties, de staat van het besturingssysteem en netwerkcondities. Als de setup niet succesvol is, check dan later de troubleshooting-sectie in deze gids. +::: + +## De app-catalogus verkennen + +Na de installatie kun je de app-catalogus openen en door de beschikbare apps bladeren. De catalogus bevat meer dan 300 direct inzetbare apps en ondersteunt filters om snel de juiste app te vinden. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Apps zoeken en filteren + +In de catalogus kun je zoeken op app-naam en filteren op categorie. Zo vind je snel de juiste app voor jouw project in deze app-store-achtige interface. + +Typische acties zijn: + +- zoeken op app-naam +- filteren op categorie +- beschikbare apps bekijken +- een app selecteren voor installatie + +Deze workflow is vooral handig als je veel apps beheert of verschillende services wilt vergelijken voor installatie. + +### Een app installeren starten + +Na het kiezen van een app uit de catalogus start je de installatie via de webinterface. Afhankelijk van de app moet je mogelijk waarden invullen zoals: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +Deze placeholders staan voor waarden die specifiek zijn voor jouw deployment. Bijvoorbeeld, `[your_domain]` vervang je door het domein dat je voor de app wilt gebruiken. + +:::tip Projecten en omgevingen +Gebruik projecten en omgevingen om je deployment overzichtelijk te houden. Dit is vooral handig als je meerdere apps host, versies test of productie en staging scheidt. +::: + +## Geïnstalleerde apps beheren + +Na deployment worden je geïnstalleerde apps weergegeven in het beheer gedeelte van de webinterface. Vanaf hier kun je je services monitoren en bedienen zonder handmatig met containers te werken. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Beschikbare beheeracties + +In het geïnstalleerde apps-gedeelte kun je veelvoorkomende lifecycle-acties direct vanuit de webinterface uitvoeren. + +| Actie | Doel | +| --- | --- | +| Start | Start een gestopte app | +| Stop | Stop een draaiende app | +| Logs bekijken | Open de app-logs voor troubleshooting | +| Herinstalleren | Zet de app opnieuw uit | + +Deze tools maken het makkelijker om al je apps vanaf één plek te beheren, vooral als je liever een simpele webinterface gebruikt dan command line. + +### Projecten en omgevingen organiseren + +Projecten en omgevingen helpen je om je deployments overzichtelijk te houden. Je kunt ze gebruiken om te scheiden: + +- persoonlijke en productie-apps +- test- en live-omgevingen +- meerdere klant- of teamdeployments +- verschillende stacks op dezelfde VPS + +Deze structuur wordt steeds belangrijker naarmate je app-collectie groeit en je meer services op één of meerdere nodes beheert. + +## Domeinen, Cloud-toegang en SSL + +De One Click Apps-functie ondersteunt custom domeinen en ZAP Cloud-integratie. Zo kun je apps veilig beschikbaar maken en SSL-certificaten regelen voor je deployments. + +:::info Domein- en SSL-ondersteuning +Je kunt custom domeinen gebruiken voor je apps en profiteren van SSL-certificaat provisioning waar het platform dat ondersteunt. +::: + +Zorg bij het toewijzen van een domein dat je DNS-records naar `[your_server_ip]` wijzen. Als je domein niet goed is ingesteld, is de app mogelijk niet bereikbaar via internet. + +| Waarde | Beschrijving | +| --- | --- | +| `[your_domain]` | Het domein of subdomein dat aan je app is toegewezen | +| `[your_server_ip]` | Het publieke IP-adres van je VPS | + +:::caution DNS Moet Naar Je VPS Wijzen +Als de DNS voor `[your_domain]` niet naar `[your_server_ip]` wijst, kan domeinvalidatie en app-toegang mislukken. +::: + +## Geavanceerde instellingen gebruiken + +Geavanceerde gebruikers kunnen extra functionaliteit bereiken via het externe paneel in de geavanceerde instellingen. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Dit is handig als je diepere aanpassingen wilt, uitgebreidere deploymentcontrole of directe toegang tot features buiten de standaard webinterface. + +### Belangrijke supportbeperking + +:::caution Supportscope voor geavanceerd paneelgebruik +Geavanceerde gebruikers mogen het externe Coolify-paneel gebruiken voor extra aanpassingen en functies. Support is echter beperkt tot de ZAP-Hosting webinterface. Wijzigingen buiten de webinterface kunnen mogelijk niet ondersteund worden. +::: + +### Wanneer het geavanceerde paneel gebruiken + +Gebruik het geavanceerde paneel als je: + +- meer gedetailleerde deployment-aanpassingen nodig hebt +- directe node-koppelingsworkflows wilt +- geavanceerde appconfiguratie wilt +- paneelbeheer wilt dat verder gaat dan de simpele interface + +Als je de toegang verliest of de integratie niet meer reageert, gebruik dan eerst de troubleshooting-tools hieronder voordat je handmatig aanpassingen maakt. + +## Nodes koppelen + +Als je voor node-only installatie hebt gekozen, kun je deze VPS koppelen aan een andere VPS-server of een extern paneel. Zo schaal je je infrastructuur en beheer je meerdere nodes vanuit één plek. + +Node-koppeling is handig als je: + +- apps over meerdere VPS-systemen wilt verdelen +- beheer wilt centraliseren +- capaciteit wilt uitbreiden zonder geïsoleerde deployments +- wilt koppelen aan een externe paneelomgeving + +:::note Externe paneelkoppeling +Je kunt je node koppelen aan een andere VPS of een extern paneel. De exacte koppeldetails hangen af van de gebruikte doelomgeving. +::: + +## Problemen oplossen bij een degraded status + +Als de webinterface een degraded status toont, betekent dit dat het platform geen contact kan maken met of data kan ophalen van de instantie die de One Click Apps-functie aandrijft. Volg de troubleshooting-stappen in chronologische volgorde. + +### Statusindicatoren + +De troubleshooting-popup kan indicatoren tonen zoals: + +| Status | Betekenis | +| --- | --- | +| Coolify Status: Actief | De panel-service draait naar verwachting | +| API Status: Bereikbaar | De API is momenteel bereikbaar | +| Service Status: Online | Je VPS zelf is online | + +Als één of meerdere onderdelen niet goed werken, ga dan verder met de onderstaande stappen. + +### Stap 1: Controleer of de VPS online is + +Zorg eerst dat je VPS online is in de ZAP-Hosting webinterface. Als de server offline is, werkt het apps-platform niet. + +### Stap 2: Vernieuw de status + +Gebruik de actie **Status Vernieuwen** om de healthcheck opnieuw uit te voeren met de nieuwste data. Dit kan tijdelijke problemen oplossen. + +:::tip Tijdelijke connectiviteitsproblemen +Een degraded status kan soms door een kortdurend communicatieprobleem komen. Vernieuwen is de snelste eerste check. +::: + +### Stap 3: Herstart Docker + +Blijft de status degraded? Gebruik dan **Docker Herstarten**. Dit forceert een herstart van de platforminstantie. Wacht na een succesvolle reactie `1-2 minuten` en vernieuw de status opnieuw. + +:::caution Service Herstart +Docker herstarten kan lopende apps tijdelijk onderbreken terwijl de services opnieuw opstarten. +::: + +### Stap 4: Vernieuw credentials + +Als laatste stap gebruik je **Credentials Vernieuwen**. Dit is vooral belangrijk als de status online lijkt, maar functies zoals app-installatie niet werken. + +Deze actie: + +- verwijdert **geen** data +- vernieuwt de root gebruikerscredentials +- vernieuwt het API-token dat de webinterface gebruikt +- werkt de panel-credentials automatisch bij bij succes + +:::info Veilige credential-vernieuwing +Credentials vernieuwen verwijdert je geïnstalleerde apps of deploymentdata niet. Het vernieuwt alleen de toegangs- en communicatiegegevens. +::: + +### Wanneer support contacteren + +Als het probleem na alle stappen blijft bestaan, maak dan een supportticket aan via de ZAP-Hosting website. + +## Best Practices + +Om de One Click Apps Installer stabiel en makkelijk te beheren te houden, volg je deze tips: + +| Best practice | Reden | +| --- | --- | +| Gebruik een verse OS-installatie | Voorkomt conflicten met bestaande services en poorten | +| Voldoe aan aanbevolen resources | Verbetert performance en betrouwbaarheid | +| Organiseer apps in projecten en omgevingen | Houdt deployments overzichtelijk | +| Configureer DNS vóór domeintoewijzing | Voorkomt toegang- en SSL-problemen | +| Gebruik geavanceerde instellingen met zorg | Voorkomt unsupported custom wijzigingen | + +:::tip Houd deployments georganiseerd +Als je veel apps wilt hosten, bedenk dan een duidelijke naamgeving voor `[your_project_name]`, `[your_environment_name]` en `[your_app_name]` voordat je je eerste services uitrolt. +::: + +## Conclusie + +Gefeliciteerd, je hebt de VPS One Click Apps Installer succesvol opgezet en gebruikt om apps op je server te deployen en beheren. Voor vragen of hulp kun je altijd contact opnemen met onze support, die dagelijks voor je klaarstaat! + + \ No newline at end of file diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/pl/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..287f7fcea --- /dev/null +++ b/i18n/pl/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: Instalator Aplikacji One Click" +description: "Wdrażaj aplikacje za pomocą Instalatora Aplikacji One Click na VPS, zarządzaj projektami przez interfejs webowy i korzystaj z Coolify do zaawansowanego zarządzania aplikacjami -> Dowiedz się więcej" +sidebar_label: Instalator Aplikacji One Click +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Wprowadzenie + +Instalator Aplikacji One Click pozwala przeglądać rozbudowany katalog aplikacji i wdrażać je bezpośrednio z panelu webowego Twojego VPS. W tym poradniku dowiesz się, jak przygotować serwer, wybrać odpowiedni typ instalacji, instalować i zarządzać aplikacjami oraz korzystać z zaawansowanych ustawień i narzędzi do rozwiązywania problemów, gdy zajdzie taka potrzeba. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## Przygotowanie + +Zanim użyjesz Instalatora Aplikacji One Click, Twój VPS musi spełniać minimalne wymagania i korzystać z obsługiwanego systemu operacyjnego. + +:::info Minimalne Wymagania +Funkcja aplikacji wymaga, aby Twój VPS był online i miał wystarczające zasoby do stabilnego działania zarówno usług platformy, jak i zainstalowanych aplikacji. +::: + +| Wymaganie | Minimum | Zalecane | +| --- | --- | --- | +| Status serwera | Online | Online | +| Pamięć dyskowa | 30 GB | 50 GB | +| Pamięć RAM | 2 GB | 4 GB | +| CPU | 2 rdzenie | 4 rdzenie | +| System operacyjny | Debian lub Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution Zalecany Świeży System Operacyjny +Zdecydowanie zalecamy instalację funkcji aplikacji na świeżo zainstalowanym systemie operacyjnym. Pomaga to uniknąć konfliktów z istniejącymi usługami, zajętymi portami, konfiguracjami Dockera lub niestandardowymi ustawieniami już obecnymi na serwerze. +::: + +Jeśli musisz przeinstalować VPS przed kontynuacją, użyj świeżego, obsługiwanego obrazu Debian lub Ubuntu LTS z panelu zarządzania VPS. + +## Dostęp do Instalatora Aplikacji One Click + +Otwórz swój VPS w panelu webowym ZAP-Hosting i znajdź sekcję One Click Apps. Stamtąd możesz rozpocząć wstępną konfigurację, a później wrócić, by zarządzać wszystkimi aplikacjami zainstalowanymi na serwerze. + +Przy pierwszym uruchomieniu tej funkcji musisz wybrać, jak platforma ma zostać zainstalowana na Twoim VPS. + +## Wybór Typu Instalacji + +Możesz wybrać pełną instalację lub instalację tylko węzła. Właściwa opcja zależy od tego, czy VPS ma hostować zarówno panel zarządzania, jak i aplikacje, czy tylko działać jako powiązany węzeł dla innego panelu. + +### Pełna Instalacja + +Wybierz **Pełną Instalację**, jeśli chcesz skonfigurować serwer z panelem i samym serwerem jako węzłem. To zalecana opcja dla początkujących i większości standardowych wdrożeń. + +Dzięki tej metodzie możesz: + +- wdrażać aplikacje z katalogu aplikacji +- zarządzać projektami i środowiskami +- organizować wszystkie aplikacje w jednym miejscu +- korzystać z zintegrowanych narzędzi zarządzania przez interfejs webowy +- mieć dostęp do zaawansowanego panelu w razie potrzeby + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip Zalecane dla Większości Użytkowników +Jeśli korzystasz z funkcji aplikacji po raz pierwszy, wybierz pełną instalację. To najprostsza konfiguracja i zapewnia pełne zarządzanie bezpośrednio z panelu webowego ZAP-Hosting. +::: + +### Instalacja Tylko Węzła + +Wybierz **Instalację Tylko Węzła**, jeśli chcesz, aby ten VPS działał wyłącznie jako węzeł. Możesz go wtedy połączyć z innym serwerem VPS lub zewnętrzną instancją panelu. + +Ta opcja jest przydatna, jeśli chcesz: + +- skalować infrastrukturę na wiele VPS-ów +- scentralizować zarządzanie na jednym panelu +- podłączyć ten serwer do istniejącego wdrożenia +- rozbudować istniejącą konfigurację multi-węzłową + +:::note Zaawansowana Opcja Wdrożenia +Instalacja tylko węzła jest przeznaczona dla użytkowników, którzy mają już inną instancję panelu lub chcą połączyć ten serwer z zewnętrznym środowiskiem. +::: + +## Instalacja Funkcji Aplikacji + +Po wybraniu typu instalacji rozpocznij konfigurację z poziomu panelu webowego. Początkowa instalacja zwykle trwa tylko kilka minut. + +W trakcie tego procesu na Twoim VPS zostaną wdrożone usługi platformy wymagane do działania funkcji One Click Apps. Po zakończeniu katalog aplikacji i sekcje zarządzania staną się dostępne w panelu webowym. + +:::info Przebieg Instalacji +Szczegóły postępu instalacji mogą się różnić w zależności od wydajności VPS, stanu systemu operacyjnego i warunków sieciowych. Jeśli instalacja nie zakończy się pomyślnie, sprawdź sekcję rozwiązywania problemów w dalszej części poradnika. +::: + +## Przeglądanie Katalogu Aplikacji + +Po zakończeniu instalacji możesz otworzyć katalog aplikacji i przeglądać dostępne aplikacje. Katalog zawiera ponad 300 gotowych do wdrożenia aplikacji i oferuje filtrowanie, które pomoże Ci szybko znaleźć właściwą aplikację. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Wyszukiwanie i Filtrowanie Aplikacji + +W katalogu możesz wyszukiwać aplikacje po nazwie i filtrować je według kategorii. To pomaga zawęzić listę dostępnych aplikacji w stylu sklepu i znaleźć odpowiedni cel wdrożenia dla Twojego projektu. + +Typowe działania to: + +- wyszukiwanie po nazwie aplikacji +- filtrowanie według kategorii +- przeglądanie dostępnych wpisów aplikacji +- wybór aplikacji do wdrożenia + +Ten sposób pracy jest szczególnie przydatny, gdy zarządzasz wieloma aplikacjami lub porównujesz różne usługi przed instalacją. + +### Rozpoczęcie Instalacji Aplikacji + +Po wybraniu aplikacji z katalogu rozpocznij instalację przez panel webowy. W zależności od aplikacji może być konieczne podanie wartości takich jak: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +Te symbole zastępcze oznaczają wartości specyficzne dla Twojego wdrożenia. Na przykład `[your_domain]` powinno zostać zastąpione domeną, której chcesz użyć dla aplikacji. + +:::tip Projekty i Środowiska +Używaj projektów i środowisk, aby utrzymać porządek w swoich wdrożeniach. Jest to szczególnie pomocne, gdy hostujesz wiele aplikacji, testujesz wersje lub oddzielasz środowiska produkcyjne od testowych. +::: + +## Zarządzanie Zainstalowanymi Aplikacjami + +Po wdrożeniu zainstalowane aplikacje są wyświetlane w sekcji zarządzania panelu webowego. Stąd możesz monitorować i kontrolować swoje usługi bez konieczności ręcznej pracy z kontenerami. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Dostępne Akcje Zarządzania + +Sekcja z zainstalowanymi aplikacjami pozwala wykonywać typowe operacje cyklu życia aplikacji bezpośrednio z panelu webowego. + +| Akcja | Cel | +| --- | --- | +| Start | Uruchamia zatrzymaną aplikację | +| Stop | Zatrzymuje działającą aplikację | +| Sprawdź logi | Otwiera logi aplikacji do diagnostyki | +| Reinstaluj | Ponownie wdraża aplikację | + +Te narzędzia ułatwiają zarządzanie wszystkimi aplikacjami z jednego miejsca, szczególnie jeśli chcesz prostą kontrolę przez web zamiast ręcznej administracji w terminalu. + +### Organizacja Projektów i Środowisk + +Projekty i środowiska pomagają jasno uporządkować Twoje wdrożenia. Możesz ich używać do rozdzielenia: + +- aplikacji prywatnych i produkcyjnych +- środowisk testowych i produkcyjnych +- wdrożeń dla różnych klientów lub zespołów +- różnych stacków na tym samym VPS + +Ta organizacja staje się coraz ważniejsza, gdy kolekcja aplikacji w sklepie rośnie, a Ty zarządzasz większą liczbą usług na jednym lub wielu węzłach. + +## Domeny, Dostęp w Chmurze i SSL + +Funkcja One Click Apps wspiera niestandardowe domeny i integrację z ZAP Cloud. Pozwala to na bezpieczne udostępnianie aplikacji i automatyczne wystawianie certyfikatów SSL dla Twoich wdrożeń. + +:::info Obsługa Domen i SSL +Możesz używać własnych domen dla aplikacji i korzystać z automatycznego wystawiania certyfikatów SSL tam, gdzie jest to wspierane przez konfigurację platformy. +::: + +Przy przypisywaniu domeny upewnij się, że Twoje rekordy DNS wskazują na `[your_server_ip]`. Jeśli domena nie jest poprawnie skonfigurowana, aplikacja może nie być dostępna z internetu. + +| Wartość | Opis | +| --- | --- | +| `[your_domain]` | Domena lub subdomena przypisana do aplikacji | +| `[your_server_ip]` | Publiczny adres IP Twojego VPS | + +:::caution DNS musi wskazywać na Twój VPS +Jeśli DNS dla `[your_domain]` nie wskazuje na `[your_server_ip]`, walidacja domeny i dostęp do aplikacji mogą się nie powieść. +::: + +## Korzystanie z Zaawansowanych Ustawień + +Zaawansowani użytkownicy mogą uzyskać dostęp do dodatkowych funkcji przez zewnętrzny panel dostępny w sekcji zaawansowanych ustawień. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +To przydatne, jeśli potrzebujesz głębszej personalizacji, rozszerzonej kontroli wdrożeń lub bezpośredniego dostępu do funkcji wykraczających poza standardowy interfejs webowy. + +### Ważne Ograniczenie Wsparcia + +:::caution Zakres wsparcia dla zaawansowanego panelu +Zaawansowani użytkownicy mogą korzystać z zewnętrznego panelu Coolify dla dodatkowej personalizacji i funkcji. Jednak wsparcie ogranicza się do panelu webowego ZAP-Hosting. Jeśli wprowadzisz zmiany poza panelem webowym, pomoc w zakresie tych modyfikacji może nie być dostępna. +::: + +### Kiedy Korzystać z Zaawansowanego Panelu + +Możesz chcieć użyć zaawansowanego panelu, jeśli potrzebujesz: + +- bardziej szczegółowej personalizacji wdrożeń +- bezpośrednich przepływów pracy łączenia węzłów +- zaawansowanej konfiguracji aplikacji +- zarządzania na poziomie panelu wykraczającego poza uproszczony interfejs + +Jeśli stracisz dostęp lub integracja przestanie odpowiadać, skorzystaj najpierw z narzędzi do rozwiązywania problemów opisanych poniżej, zanim zaczniesz ręczne zmiany. + +## Łączenie Węzłów + +Jeśli wybrałeś instalację tylko węzła, możesz połączyć ten VPS z innym serwerem VPS lub zewnętrzną instancją panelu. Pozwala to skalować infrastrukturę i zarządzać wieloma węzłami z jednego miejsca. + +Łączenie węzłów jest przydatne, gdy chcesz: + +- rozproszyć aplikacje na kilka VPS-ów +- scentralizować zarządzanie +- zwiększyć pojemność bez tworzenia izolowanych wdrożeń +- połączyć się z zewnętrznym środowiskiem panelu + +:::note Łączenie z zewnętrznym panelem +Możesz połączyć swój węzeł z innym VPS lub zewnętrzną instancją panelu. Szczegóły łączenia zależą od docelowego środowiska już używanego. +::: + +## Rozwiązywanie Problemów ze Stanem Degradacji + +Jeśli panel webowy pokazuje stan degradacji, oznacza to, że platforma nie może się połączyć lub pobrać danych z instancji obsługującej funkcję One Click Apps. Postępuj według kroków rozwiązywania problemów w kolejności chronologicznej. + +### Wskaźniki Statusu + +Popup rozwiązywania problemów może pokazywać takie wskaźniki jak: + +| Status | Znaczenie | +| --- | --- | +| Status Coolify: Aktywny | Usługa panelu działa | +| Status API: Dostępne | API jest aktualnie osiągalne | +| Status Usługi: Online | Twój VPS jest online | + +Jeśli jedna lub więcej części nie działa poprawnie, kontynuuj poniższe kroki. + +### Krok 1: Potwierdź, że VPS jest Online + +Najpierw upewnij się, że Twój VPS jest online w panelu webowym ZAP-Hosting. Jeśli serwer jest offline, platforma aplikacji nie będzie działać. + +### Krok 2: Odśwież Status + +Użyj akcji **Odśwież Status**, aby ponownie wykonać kontrolę stanu z najnowszymi danymi. Może to rozwiązać tymczasowe problemy z łącznością. + +:::tip Tymczasowe problemy z łącznością +Stan degradacji może być spowodowany krótkotrwałym problemem komunikacyjnym. Odświeżenie statusu to najszybszy pierwszy krok. +::: + +### Krok 3: Uruchom ponownie Dockera + +Jeśli status nadal jest zdegradowany, użyj akcji **Restart Docker**. To wymusi ponowne uruchomienie instancji platformy. Po pomyślnym restarcie odczekaj `1-2 minuty` i ponownie odśwież status. + +:::caution Restart usługi +Restart Dockera może chwilowo przerwać działanie uruchomionych aplikacji podczas ponownego uruchamiania usług. +::: + +### Krok 4: Odśwież Dane Logowania + +Na koniec użyj **Odśwież Dane Logowania**. Jest to szczególnie ważne, jeśli status jest online, ale funkcje panelu webowego, takie jak instalacja aplikacji, nie działają. + +Ta akcja: + +- **nie** usuwa Twoich danych +- odświeża dane logowania użytkownika root +- odświeża token API używany przez panel webowy +- automatycznie aktualizuje dane logowania panelu po sukcesie + +:::info Bezpieczne odświeżanie danych logowania +Odświeżanie danych logowania nie usuwa zainstalowanych aplikacji ani danych wdrożeniowych. Odnawia tylko dane potrzebne do dostępu i komunikacji. +::: + +### Kiedy Kontaktować się z Supportem + +Jeśli problem nadal występuje po wykonaniu wszystkich kroków, utwórz zgłoszenie do supportu przez stronę ZAP-Hosting. + +## Najlepsze Praktyki + +Aby utrzymać Instalator Aplikacji One Click stabilnym i łatwym w zarządzaniu, stosuj się do poniższych zaleceń: + +| Najlepsza praktyka | Powód | +| --- | --- | +| Używaj świeżej instalacji systemu | Zmniejsza konflikty z istniejącymi usługami i portami | +| Spełniaj zalecane wymagania zasobów | Poprawia wydajność i stabilność | +| Organizuj aplikacje w projekty i środowiska | Ułatwia zarządzanie wdrożeniami | +| Konfiguruj DNS przed przypisaniem domen | Zapobiega problemom z dostępem i SSL | +| Ostrożnie korzystaj z zaawansowanych ustawień | Unikasz nieobsługiwanych, niestandardowych zmian | + +:::tip Utrzymuj porządek w wdrożeniach +Jeśli planujesz hostować wiele aplikacji, stwórz jasny schemat nazewnictwa dla `[your_project_name]`, `[your_environment_name]` i `[your_app_name]` przed wdrożeniem pierwszych usług. +::: + +## Podsumowanie + +Gratulacje, pomyślnie skonfigurowałeś i użyłeś Instalatora Aplikacji One Click na VPS do wdrażania i zarządzania aplikacjami na swoim serwerze. W razie dalszych pytań lub potrzeby pomocy, nie wahaj się skontaktować z naszym zespołem supportu, który jest dostępny codziennie, by Ci pomóc! + + \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/pt/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..133ffebb1 --- /dev/null +++ b/i18n/pt/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: Instalador de Apps com Um Clique" +description: "Implemente apps com o Instalador de Apps com Um Clique do VPS, gerencie projetos pela interface web e use o Coolify para gerenciamento avançado -> Saiba mais agora" +sidebar_label: Instalador de Apps com Um Clique +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introdução + +O Instalador de Apps com Um Clique permite que você navegue por um catálogo extenso de apps e os implemente diretamente pela interface web do seu VPS. Neste guia, você vai aprender como preparar seu servidor, escolher o tipo de instalação correto, instalar e gerenciar apps, além de usar as configurações avançadas e ferramentas de solução de problemas quando necessário. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## Preparação + +Antes de usar o Instalador de Apps com Um Clique, seu VPS precisa atender aos requisitos mínimos e usar um sistema operacional suportado. + +:::info Requisitos Mínimos +O recurso de apps exige que seu VPS esteja online e configurado com recursos suficientes para rodar tanto os serviços da plataforma quanto os apps instalados de forma confiável. +::: + +| Requisito | Mínimo | Recomendado | +| --- | --- | --- | +| Status do servidor | Online | Online | +| Armazenamento | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2 núcleos | 4 núcleos | +| Sistema operacional | Debian ou Ubuntu LTS | Debian 13 - PT - 64bit | + +:::caution Recomendado Sistema Operacional Limpo +É altamente recomendado configurar o recurso de apps em uma instalação limpa do sistema operacional. Isso ajuda a evitar conflitos com serviços existentes, portas ocupadas, configurações Docker ou customizações já presentes no servidor. +::: + +Se precisar reinstalar seu VPS antes de continuar, use uma imagem limpa suportada do Debian ou Ubuntu LTS pelo painel de gerenciamento do VPS. + +## Acessando o Instalador de Apps com Um Clique + +Abra seu VPS na interface web da ZAP-Hosting e localize a seção One Click Apps. A partir daí, você pode iniciar a configuração inicial e depois voltar para gerenciar todos os apps instalados no servidor. + +Na primeira vez que abrir esse recurso, você precisará escolher como a plataforma deve ser instalada no seu VPS. + +## Escolhendo o Tipo de Instalação + +Você pode escolher entre uma instalação completa ou uma instalação apenas como nó. A opção correta depende se este VPS deve hospedar tanto o painel de gerenciamento quanto os apps, ou apenas atuar como um nó vinculado a outro painel. + +### Instalação Completa + +Escolha **Instalação Completa** se quiser configurar o servidor com o painel e o próprio servidor como nó. Essa é a opção recomendada para usuários iniciantes e para a maioria das implantações padrão. + +Com esse método, você pode: + +- implementar apps do catálogo +- gerenciar projetos e ambientes +- organizar todos os apps em um só lugar +- usar as ferramentas integradas de gerenciamento pela interface web +- acessar o painel avançado depois, se precisar + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip Recomendado para a Maioria dos Usuários +Se esta é sua primeira vez usando o recurso de apps, selecione a opção de instalação completa. Ela oferece a configuração mais simples e dá controle total direto pela interface web da ZAP-Hosting. +::: + +### Instalação Apenas como Nó + +Escolha **Instalação Apenas como Nó** se quiser que este VPS atue só como um nó. Você poderá vinculá-lo a outro servidor VPS ou a uma instância externa de painel. + +Essa opção é útil se você quiser: + +- escalar entre vários sistemas VPS +- centralizar o gerenciamento em um painel só +- vincular este servidor a uma implantação já existente +- expandir uma configuração multi-nó já em uso + +:::note Opção Avançada de Implantação +A instalação apenas como nó é destinada a usuários que já têm outra instância de painel disponível ou que querem conectar este servidor a um ambiente externo. +::: + +## Instalando o Recurso de Apps + +Depois de escolher o tipo de instalação, inicie a configuração pela interface web. A instalação inicial geralmente leva apenas alguns minutos. + +Durante esse processo, os serviços da plataforma necessários para o recurso One Click Apps são implantados no seu VPS. Quando concluído, o catálogo de apps e as seções de gerenciamento ficam disponíveis na interface web. + +:::info Comportamento da Instalação +Os detalhes exatos do progresso da instalação podem variar dependendo do desempenho do VPS, estado do sistema operacional e condições da rede. Se a configuração não for concluída com sucesso, confira a seção de solução de problemas mais abaixo neste guia. +::: + +## Navegando pelo Catálogo de Apps + +Quando a instalação terminar, você pode abrir o catálogo de apps e navegar pelas opções disponíveis. O catálogo contém mais de 300 apps prontos para deploy e suporta filtros para ajudar a encontrar o app certo rapidinho. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Buscando e Filtrando Apps + +No catálogo, você pode buscar apps pelo nome e filtrar por categoria. Isso ajuda a reduzir as opções disponíveis na interface estilo loja de apps e encontrar o alvo certo para seu projeto. + +Ações típicas incluem: + +- buscar pelo nome do app +- filtrar por categoria +- revisar as entradas disponíveis +- selecionar um app para instalar + +Esse fluxo é especialmente útil se você gerencia muitos apps ou compara vários serviços antes de instalar. + +### Iniciando a Instalação de um App + +Depois de escolher um app no catálogo, comece a instalação pela interface web. Dependendo do app, pode ser necessário definir valores como: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +Esses placeholders representam valores específicos da sua implantação. Por exemplo, `[your_domain]` deve ser substituído pelo domínio que você quer usar para o app. + +:::tip Projetos e Ambientes +Use projetos e ambientes para manter sua implantação organizada. Isso é especialmente útil quando você hospeda vários apps, testa versões ou separa serviços de produção e staging. +::: + +## Gerenciando Apps Instalados + +Depois do deploy, seus apps instalados aparecem na seção de gerenciamento da interface web. De lá, você pode monitorar e controlar seus serviços sem precisar mexer manualmente nos containers. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Ações de Gerenciamento Disponíveis + +A seção de apps instalados permite realizar ações comuns do ciclo de vida direto pela interface web. + +| Ação | Propósito | +| --- | --- | +| Iniciar | Inicia um app parado | +| Parar | Para um app em execução | +| Ver logs | Abre os logs do app para solução de problemas | +| Reinstalar | Reimplanta o app | + +Essas ferramentas facilitam gerenciar todos os apps num só lugar, especialmente se você quer controle simples via web em vez de administração manual por linha de comando. + +### Organizando Projetos e Ambientes + +Projetos e ambientes ajudam a estruturar suas implantações de forma clara. Você pode usá-los para separar: + +- apps pessoais e de produção +- ambientes de teste e produção +- múltiplos clientes ou equipes +- diferentes stacks no mesmo VPS + +Essa organização fica cada vez mais importante conforme sua coleção de apps cresce e você gerencia mais serviços em um ou vários nós. + +## Domínios, Acesso Cloud e SSL + +O recurso One Click Apps suporta domínios personalizados e integração com o ZAP Cloud. Isso permite expor apps de forma segura e provisionar certificados SSL para suas implantações. + +:::info Suporte a Domínio e SSL +Você pode usar domínios personalizados para seus apps e aproveitar o provisionamento de certificados SSL onde suportado pela configuração da plataforma. +::: + +Ao atribuir um domínio, certifique-se que seus registros DNS apontem para `[your_server_ip]`. Se o domínio não estiver configurado corretamente, o app pode não ficar acessível pela internet. + +| Valor | Descrição | +| --- | --- | +| `[your_domain]` | O domínio ou subdomínio atribuído ao seu app | +| `[your_server_ip]` | O endereço IP público do seu VPS | + +:::caution DNS Deve Apontar para Seu VPS +Se o DNS de `[your_domain]` não apontar para `[your_server_ip]`, a validação do domínio e o acesso ao app podem falhar. +::: + +## Usando Configurações Avançadas + +Usuários avançados podem acessar funcionalidades extras pelo painel externo disponível na seção de configurações avançadas. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Isso pode ser útil se você precisar de personalização mais profunda, controle expandido de deploy ou acesso direto a recursos além da interface web padrão. + +### Limitação Importante de Suporte + +:::caution Escopo de Suporte para Uso do Painel Avançado +Usuários avançados são bem-vindos para usar o painel externo Coolify para personalizações e funcionalidades extras. Porém, o suporte é limitado à interface web da ZAP-Hosting. Se fizer alterações fora da interface web, o suporte pode não estar disponível para essas customizações. +::: + +### Quando Usar o Painel Avançado + +Você pode querer usar o painel avançado se precisar de: + +- personalização detalhada do deploy +- fluxos diretos de vinculação de nós +- configuração avançada de apps +- gerenciamento no nível do painel além da interface simplificada + +Se perder acesso ou a integração parar de responder, use as ferramentas de solução de problemas descritas abaixo antes de fazer mudanças manuais. + +## Vinculando Nós + +Se escolheu a instalação apenas como nó, pode vincular este VPS a outro servidor VPS ou a uma instância externa de painel. Isso permite escalar sua infraestrutura e gerenciar múltiplos nós de um único lugar. + +A vinculação de nós é útil quando você quer: + +- distribuir apps entre vários sistemas VPS +- centralizar o gerenciamento +- expandir capacidade sem criar implantações isoladas +- conectar a um ambiente externo de painel + +:::note Vinculação a Painel Externo +Você pode vincular seu nó a outro VPS ou a uma instância externa de painel. Os detalhes exatos da vinculação dependem do ambiente alvo já em uso. +::: + +## Solução de Problemas de Status Degradado + +Se a interface web mostrar um status degradado, significa que a plataforma não consegue contatar ou obter dados da instância que roda o recurso One Click Apps. Siga os passos de solução de problemas na ordem. + +### Indicadores de Status + +O popup de solução de problemas pode mostrar indicadores como: + +| Status | Significado | +| --- | --- | +| Status Coolify: Ativo | O serviço do painel parece estar rodando | +| Status API: Acessível | A API está acessível no momento | +| Status Serviço: Online | Seu VPS está online | + +Se uma ou mais partes não estiverem funcionando direito, continue com os passos abaixo. + +### Passo 1: Confirme que o VPS Está Online + +Primeiro, confirme que seu VPS está online na interface web da ZAP-Hosting. Se o servidor estiver offline, a plataforma de apps não funciona. + +### Passo 2: Atualize o Status + +Use a ação **Atualizar Status** para rodar a checagem de saúde novamente com dados atualizados. Isso pode resolver problemas temporários e intermitentes. + +:::tip Problemas Temporários de Conectividade +Um estado degradado pode ser causado por uma falha rápida na comunicação. Atualizar o status é o primeiro passo mais rápido. +::: + +### Passo 3: Reinicie o Docker + +Se o status continuar degradado, use a ação **Reiniciar Docker**. Isso força a reinicialização da instância da plataforma. Após resposta bem-sucedida, espere `1-2 minutos` e atualize o status novamente. + +:::caution Reinício do Serviço +Reiniciar o Docker pode interromper temporariamente os apps em execução enquanto os serviços reiniciam. +::: + +### Passo 4: Atualize as Credenciais + +Como último passo, use **Atualizar Credenciais**. Isso é especialmente importante se o status parecer online, mas funções da interface web como instalação de apps não estiverem funcionando. + +Essa ação: + +- **não** apaga seus dados +- atualiza as credenciais do usuário root +- atualiza o token da API usado pela interface web +- atualiza automaticamente as credenciais do painel em caso de sucesso + +:::info Atualização Segura de Credenciais +Atualizar credenciais não remove seus apps instalados ou dados de implantação. Apenas renova as credenciais necessárias para acesso e comunicação. +::: + +### Quando Contatar o Suporte + +Se o problema persistir após todos os passos, abra um ticket de suporte pelo site da ZAP-Hosting. + +## Melhores Práticas + +Para manter o Instalador de Apps com Um Clique estável e fácil de gerenciar, siga essas recomendações: + +| Melhor prática | Motivo | +| --- | --- | +| Use uma instalação limpa do SO | Reduz conflitos com serviços e portas existentes | +| Atenda aos recursos recomendados | Melhora desempenho e confiabilidade | +| Organize apps em projetos e ambientes | Mantém implantações gerenciáveis | +| Configure DNS antes de atribuir domínios | Evita problemas de acesso e SSL | +| Use configurações avançadas com cuidado | Evita mudanças customizadas não suportadas | + +:::tip Mantenha Implantações Organizadas +Se planeja hospedar muitos apps, crie um esquema claro de nomes para `[your_project_name]`, `[your_environment_name]` e `[your_app_name]` antes de implantar seus primeiros serviços. +::: + +## Conclusão + +Parabéns, você configurou e usou com sucesso o Instalador de Apps com Um Clique do VPS para implementar e gerenciar apps no seu servidor. Para dúvidas ou ajuda, não hesite em contatar nosso time de suporte, disponível diariamente para te ajudar! + + \ No newline at end of file diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/sv/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..06578f1bf --- /dev/null +++ b/i18n/sv/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: One Click Apps Installer" +description: "Distribuera appar med VPS One Click Apps Installer, hantera projekt via webbgränssnittet och använd Coolify för avancerad apphantering -> Lär dig mer nu" +sidebar_label: One Click App Installer +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introduktion + +One Click Apps Installer låter dig bläddra i ett stort appkatalog och distribuera appar direkt från ditt VPS webbgränssnitt. I den här guiden lär du dig hur du förbereder din server, väljer rätt installationstyp, installerar och hanterar appar samt använder avancerade inställningar och felsökningsverktyg vid behov. + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## Förberedelser + +Innan du använder One Click Apps Installer måste din VPS uppfylla minimikraven och använda ett stödt operativsystem. + +:::info Minimala krav +App-funktionen kräver att din VPS är online och konfigurerad med tillräckliga resurser för att pålitligt köra både plattformstjänsterna och dina installerade appar. +::: + +| Krav | Minimum | Rekommenderat | +| --- | --- | --- | +| Serverstatus | Online | Online | +| Lagring | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2 kärnor | 4 kärnor | +| Operativsystem | Debian eller Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution Färskt operativsystem rekommenderas +Det rekommenderas starkt att sätta upp app-funktionen på en färsk installation av operativsystemet. Detta hjälper till att undvika konflikter med befintliga tjänster, upptagna portar, Docker-konfigurationer eller anpassade inställningar som redan finns på servern. +::: + +Om du behöver installera om din VPS innan du fortsätter, använd en färsk stödd Debian- eller Ubuntu LTS-image från ditt VPS-hanteringsgränssnitt. + +## Så öppnar du One Click Apps Installer + +Öppna din VPS i ZAP-Hostings webbgränssnitt och hitta sektionen One Click Apps. Därifrån kan du starta den initiala installationen och senare återvända för att hantera alla appar som är installerade på servern. + +Första gången du öppnar funktionen måste du välja hur plattformen ska installeras på din VPS. + +## Välja installationstyp + +Du kan välja mellan full installation och node-only installation. Rätt val beror på om denna VPS ska hosta både hanteringspanelen och appar, eller bara agera som en länkad nod för en annan panel. + +### Full installation + +Välj **Full installation** om du vill sätta upp servern med panelen och servern själv som en nod. Detta är det rekommenderade valet för nya användare och för de flesta standardinstallationer. + +Med denna metod kan du: + +- distribuera appar från appkatalogen +- hantera projekt och miljöer +- organisera alla appar på ett ställe +- använda de integrerade webbgränssnittets hanteringsverktyg +- få tillgång till den avancerade panelen senare om det behövs + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip Rekommenderas för de flesta användare +Om det är första gången du använder app-funktionen, välj full installation. Det ger den enklaste uppsättningen och fullständig hantering direkt från ZAP-Hostings webbgränssnitt. +::: + +### Node-only installation + +Välj **Node-only installation** om du vill att denna VPS bara ska agera som en nod. Du kan då länka den till en annan VPS-server eller till en extern panelinstans. + +Detta är användbart om du vill: + +- skala över flera VPS-system +- centralisera hanteringen på en panel +- länka denna server till en befintlig installation +- utöka en befintlig multi-nod setup + +:::note Avancerat distributionsalternativ +Node-only installation är avsedd för användare som redan har en annan panelinstans tillgänglig eller som vill koppla denna server till en extern miljö. +::: + +## Installera app-funktionen + +Efter att ha valt installationstyp, starta installationen från webbgränssnittet. Den initiala installationen tar vanligtvis bara några minuter. + +Under processen distribueras plattformstjänsterna som krävs för One Click Apps-funktionen till din VPS. När det är klart blir appkatalogen och hanteringssektionerna tillgängliga i webbgränssnittet. + +:::info Installationsbeteende +Exakta detaljer om installationsförloppet kan variera beroende på din VPS prestanda, operativsystemets tillstånd och nätverksförhållanden. Om installationen inte slutförs framgångsrikt, gå igenom felsökningsavsnittet senare i guiden. +::: + +## Bläddra i appkatalogen + +När installationen är klar kan du öppna appkatalogen och bläddra bland tillgängliga appar. Katalogen innehåller över 300 appar redo att distribueras och stödjer filtrering för att snabbt hitta rätt app. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Söka och filtrera appar + +I katalogen kan du söka efter appar med namn och filtrera efter kategori. Detta hjälper dig att begränsa alla appar i appbutiksstilens gränssnitt och hitta rätt distributionsmål för ditt projekt. + +Typiska åtgärder inkluderar: + +- söka efter appnamn +- filtrera efter kategori +- granska tillgängliga app-poster +- välja en app för distribution + +Detta arbetsflöde är särskilt användbart om du hanterar många appnedladdningsmål eller jämför flera tjänster innan installation. + +### Starta en appinstallation + +Efter att ha valt en app från katalogen, starta installationen via webbgränssnittet. Beroende på app kan du behöva ange värden som: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +Dessa platshållare representerar värden specifika för din distribution. Till exempel bör `[your_domain]` ersättas med den domän du vill använda för appen. + +:::tip Projekt och miljöer +Använd projekt och miljöer för att hålla din distribution organiserad. Detta är särskilt hjälpsamt när du hostar flera appar, testar versioner eller separerar produktion och staging-tjänster. +::: + +## Hantera installerade appar + +Efter distribution listas dina installerade appar i hanteringssektionen i webbgränssnittet. Därifrån kan du övervaka och styra dina tjänster utan att behöva jobba manuellt med underliggande containers. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Tillgängliga hanteringsåtgärder + +Sektionen för installerade appar låter dig utföra vanliga livscykelåtgärder direkt från webbgränssnittet. + +| Åtgärd | Syfte | +| --- | --- | +| Starta | Startar en stoppad app | +| Stoppa | Stoppar en körande app | +| Kontrollera loggar | Öppnar apploggar för felsökning | +| Installera om | Distribuerar om appen | + +Dessa verktyg gör det enklare att hantera alla appar från ett ställe, särskilt om du vill ha enkel webb-baserad kontroll istället för manuell kommandoradshantering. + +### Organisera projekt och miljöer + +Projekt och miljöer hjälper dig att strukturera dina distributioner tydligt. Du kan använda dem för att separera: + +- personliga och produktionsappar +- test- och live-miljöer +- flera kund- eller teamdistributioner +- olika stackar på samma VPS + +Denna organisation blir allt viktigare när din samling av appbutiksappar växer och du hanterar fler tjänster på en eller flera noder. + +## Domäner, Cloud Access och SSL + +One Click Apps-funktionen stödjer anpassade domäner och ZAP Cloud-integration. Detta låter dig exponera appar säkert och provisionera SSL-certifikat för dina distributioner. + +:::info Domän- och SSL-stöd +Du kan använda anpassade domäner för dina appar och dra nytta av SSL-certifikat där plattformsuppsättningen stödjer det. +::: + +När du tilldelar en domän, se till att dina DNS-poster pekar på `[your_server_ip]`. Om din domän inte är korrekt konfigurerad kan appen bli otillgänglig från internet. + +| Värde | Beskrivning | +| --- | --- | +| `[your_domain]` | Domänen eller subdomänen som tilldelats din app | +| `[your_server_ip]` | Den publika IP-adressen för din VPS | + +:::caution DNS måste peka på din VPS +Om DNS för `[your_domain]` inte pekar på `[your_server_ip]` kan domänvalidering och appåtkomst misslyckas. +::: + +## Använda avancerade inställningar + +Avancerade användare kan få tillgång till extra funktionalitet via den externa panelen som finns i avsnittet för avancerade inställningar. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Detta kan vara användbart om du behöver djupare anpassning, utökad distributionskontroll eller direkt tillgång till funktioner utöver standardwebbgränssnittet. + +### Viktig supportbegränsning + +:::caution Supportomfång för avancerad panelanvändning +Avancerade användare är välkomna att använda den externa Coolify-panelen för extra anpassning och funktionalitet. Supporten är dock begränsad till ZAP-Hostings webbgränssnitt. Om du gör ändringar utanför webbgränssnittet kan hjälp inte erbjudas för dessa anpassade modifieringar. +::: + +### När du ska använda den avancerade panelen + +Du kan vilja använda den avancerade panelen om du behöver: + +- mer detaljerad distributionsanpassning +- direkt nodlänkning +- avancerad appkonfiguration +- panelhantering utöver det förenklade gränssnittet + +Om du tappar åtkomst eller integrationen slutar svara, använd felsökningsverktygen nedan innan du gör manuella ändringar. + +## Länka noder + +Om du valde node-only installation kan du länka denna VPS till en annan VPS-server eller en extern panelinstans. Detta låter dig skala din infrastruktur och hantera flera noder från en enda plats. + +Nodlänkning är användbart när du vill: + +- distribuera appar över flera VPS-system +- centralisera hanteringen +- utöka kapaciteten utan att skapa isolerade distributioner +- koppla till en extern panelmiljö + +:::note Extern panellänkning +Du kan länka din nod till en annan VPS eller en extern panelinstans. Exakta länkdetaljer beror på den målmiljö som redan används. +::: + +## Felsöka degraderad status + +Om webbgränssnittet visar degraderad status betyder det att plattformen inte kan kontakta eller hämta data från instansen som driver One Click Apps-funktionen. Följ felsökningsstegen i kronologisk ordning. + +### Statusindikatorer + +Felsökningspopupen kan visa indikatorer som: + +| Status | Betydelse | +| --- | --- | +| Coolify Status: Aktiv | Paneltjänsten verkar vara igång | +| API Status: Tillgänglig | API:et kan nås just nu | +| Tjänststatus: Online | Din VPS är online | + +Om en eller flera delar inte fungerar korrekt, fortsätt med stegen nedan. + +### Steg 1: Bekräfta att VPS är online + +Först, se till att din VPS-tjänst är online i ZAP-Hostings webbgränssnitt. Om servern är offline kan inte app-plattformen fungera. + +### Steg 2: Uppdatera status + +Använd åtgärden **Uppdatera status** för att köra hälsokontrollen igen med senaste data. Detta kan lösa tillfälliga, intermittenta problem. + +:::tip Tillfälliga anslutningsproblem +En degraderad status kan ibland orsakas av ett kortvarigt kommunikationsproblem. Att uppdatera status är det snabbaste första steget. +::: + +### Steg 3: Starta om Docker + +Om status fortfarande är degraderad, använd åtgärden **Starta om Docker**. Detta tvingar plattformsinstansen att starta om. Efter ett lyckat svar, vänta `1-2 minuter` och uppdatera status igen. + +:::caution Tjänsteomstart +Att starta om Docker kan tillfälligt avbryta körande appar medan tjänsterna startar om. +::: + +### Steg 4: Uppdatera autentiseringsuppgifter + +Som sista steg, använd **Uppdatera autentiseringsuppgifter**. Detta är särskilt viktigt om status visas som online men funktioner i webbgränssnittet som appinstallation inte fungerar. + +Denna åtgärd: + +- tar **inte** bort dina data +- uppdaterar root-användarens autentiseringsuppgifter +- uppdaterar API-token som används av webbgränssnittet +- uppdaterar panelens autentiseringsuppgifter automatiskt vid lyckad åtgärd + +:::info Säker uppdatering av autentiseringsuppgifter +Att uppdatera autentiseringsuppgifter tar inte bort dina installerade appar eller distributionsdata. Det förnyar bara de uppgifter som krävs för åtkomst och kommunikation. +::: + +### När du ska kontakta support + +Om problemet kvarstår efter att ha följt alla felsökningssteg, skapa en supportticket via ZAP-Hostings webbplats. + +## Bästa praxis + +För att hålla One Click Apps Installer stabil och enkel att hantera, följ dessa rekommendationer: + +| Bästa praxis | Orsak | +| --- | --- | +| Använd en färsk OS-installation | Minskar konflikter med befintliga tjänster och portar | +| Uppfyll rekommenderade resurser | Förbättrar prestanda och pålitlighet | +| Organisera appar i projekt och miljöer | Håller distributionerna hanterbara | +| Konfigurera DNS innan du tilldelar domäner | Förhindrar åtkomst- och SSL-problem | +| Använd avancerade inställningar med försiktighet | Undviker icke-stödda anpassade ändringar | + +:::tip Håll distributionerna organiserade +Om du planerar att hosta många appar, skapa en tydlig namngivningsstruktur för `[your_project_name]`, `[your_environment_name]` och `[your_app_name]` innan du distribuerar dina första tjänster. +::: + +## Avslutning + +Grattis, du har nu framgångsrikt satt upp och använt VPS One Click Apps Installer för att distribuera och hantera appar på din server. För fler frågor eller hjälp, tveka inte att kontakta vårt supportteam som finns tillgängligt dagligen för att hjälpa dig! + + \ No newline at end of file diff --git a/i18n/th/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/th/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..0a1a857bb --- /dev/null +++ b/i18n/th/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS: ตัวติดตั้งแอปด้วยคลิกเดียว" +description: "ติดตั้งแอปด้วยตัวติดตั้งแอปคลิกเดียวบน VPS ของคุณ จัดการโปรเจกต์ผ่านเว็บอินเทอร์เฟซ และใช้ Coolify สำหรับการจัดการแอประดับสูง -> เรียนรู้เพิ่มเติมตอนนี้" +sidebar_label: ตัวติดตั้งแอปคลิกเดียว +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## แนะนำ + +ตัวติดตั้งแอปคลิกเดียวช่วยให้คุณเรียกดูแคตตาล็อกแอปขนาดใหญ่และติดตั้งแอปโดยตรงจากเว็บอินเทอร์เฟซของ VPS ในคู่มือนี้ คุณจะได้เรียนรู้วิธีเตรียมเซิร์ฟเวอร์ เลือกประเภทการติดตั้งที่ถูกต้อง ติดตั้งและจัดการแอป รวมถึงใช้การตั้งค่าขั้นสูงและเครื่องมือแก้ไขปัญหาเมื่อจำเป็น + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## การเตรียมตัว + +ก่อนใช้ตัวติดตั้งแอปคลิกเดียว VPS ของคุณต้องตรงตามข้อกำหนดขั้นต่ำและใช้ระบบปฏิบัติการที่รองรับ + +:::info ข้อกำหนดขั้นต่ำ +ฟีเจอร์แอปต้องการให้ VPS ของคุณออนไลน์และมีทรัพยากรเพียงพอสำหรับรันทั้งบริการแพลตฟอร์มและแอปที่ติดตั้งอย่างเสถียร +::: + +| ข้อกำหนด | ขั้นต่ำ | แนะนำ | +| --- | --- | --- | +| สถานะเซิร์ฟเวอร์ | ออนไลน์ | ออนไลน์ | +| พื้นที่จัดเก็บ | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2 คอร์ | 4 คอร์ | +| ระบบปฏิบัติการ | Debian หรือ Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution แนะนำให้ใช้ระบบปฏิบัติการใหม่ +แนะนำอย่างยิ่งให้ตั้งค่าฟีเจอร์แอปบนระบบปฏิบัติการที่ติดตั้งใหม่ เพื่อหลีกเลี่ยงความขัดแย้งกับบริการที่มีอยู่ พอร์ตที่ถูกใช้งาน การตั้งค่า Docker หรือการตั้งค่าที่ปรับแต่งไว้บนเซิร์ฟเวอร์ +::: + +ถ้าคุณต้องติดตั้ง VPS ใหม่ก่อนดำเนินการต่อ ให้ใช้ภาพระบบ Debian หรือ Ubuntu LTS ที่รองรับจากแผงควบคุม VPS ของคุณ + +## การเข้าถึงตัวติดตั้งแอปคลิกเดียว + +เปิด VPS ของคุณในเว็บอินเทอร์เฟซ ZAP-Hosting แล้วหาเมนู One Click Apps จากตรงนั้นคุณสามารถเริ่มการตั้งค่าเริ่มต้นและกลับมาจัดการแอปทั้งหมดที่ติดตั้งบนเซิร์ฟเวอร์ได้ภายหลัง + +ครั้งแรกที่เปิดฟีเจอร์นี้ คุณต้องเลือกวิธีติดตั้งแพลตฟอร์มบน VPS ของคุณ + +## การเลือกประเภทการติดตั้ง + +คุณสามารถเลือกได้ระหว่างการติดตั้งแบบเต็มและการติดตั้งแบบโหนดอย่างเดียว ตัวเลือกที่ถูกต้องขึ้นอยู่กับว่า VPS นี้จะโฮสต์ทั้งแผงควบคุมและแอป หรือทำหน้าที่เป็นโหนดที่เชื่อมต่อกับแผงควบคุมอื่นเท่านั้น + +### การติดตั้งแบบเต็ม + +เลือก **การติดตั้งแบบเต็ม** หากคุณต้องการตั้งค่าเซิร์ฟเวอร์พร้อมแผงควบคุมและเซิร์ฟเวอร์เองในฐานะโหนด นี่คือทางเลือกที่แนะนำสำหรับผู้ใช้ครั้งแรกและการใช้งานทั่วไปส่วนใหญ่ + +ด้วยวิธีนี้ คุณสามารถ: + +- ติดตั้งแอปจากแคตตาล็อกแอป +- จัดการโปรเจกต์และสภาพแวดล้อม +- รวมแอปทั้งหมดไว้ในที่เดียว +- ใช้เครื่องมือจัดการผ่านเว็บอินเทอร์เฟซที่รวมมาให้ +- เข้าถึงแผงควบคุมขั้นสูงได้ในภายหลังถ้าต้องการ + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip แนะนำสำหรับผู้ใช้ส่วนใหญ่ +ถ้านี่เป็นครั้งแรกที่คุณใช้ฟีเจอร์แอป ให้เลือกตัวเลือกการติดตั้งแบบเต็ม เพราะมันง่ายที่สุดและให้การจัดการครบถ้วนผ่านเว็บอินเทอร์เฟซของ ZAP-Hosting +::: + +### การติดตั้งแบบโหนดอย่างเดียว + +เลือก **การติดตั้งแบบโหนดอย่างเดียว** หากคุณต้องการให้ VPS นี้ทำหน้าที่เป็นโหนดเท่านั้น จากนั้นคุณสามารถเชื่อมต่อกับ VPS อื่นหรือแผงควบคุมภายนอกได้ + +ตัวเลือกนี้เหมาะสำหรับกรณีที่คุณต้องการ: + +- ขยายระบบผ่าน VPS หลายเครื่อง +- รวมศูนย์การจัดการบนแผงควบคุมเดียว +- เชื่อมต่อเซิร์ฟเวอร์นี้กับการติดตั้งที่มีอยู่แล้ว +- ขยายระบบมัลติโหนดที่มีอยู่ + +:::note ตัวเลือกการติดตั้งขั้นสูง +การติดตั้งแบบโหนดอย่างเดียวเหมาะสำหรับผู้ใช้ที่มีแผงควบคุมอื่นอยู่แล้ว หรืออยากเชื่อมต่อเซิร์ฟเวอร์นี้กับสภาพแวดล้อมภายนอก +::: + +## การติดตั้งฟีเจอร์แอป + +หลังเลือกประเภทการติดตั้ง ให้เริ่มการตั้งค่าจากเว็บอินเทอร์เฟซ การติดตั้งเริ่มต้นมักใช้เวลาไม่กี่นาที + +ในขั้นตอนนี้ บริการแพลตฟอร์มที่จำเป็นสำหรับฟีเจอร์ One Click Apps จะถูกติดตั้งบน VPS ของคุณ เมื่อเสร็จแล้ว แคตตาล็อกแอปและส่วนจัดการจะพร้อมใช้งานในเว็บอินเทอร์เฟซ + +:::info พฤติกรรมการติดตั้ง +รายละเอียดความคืบหน้าการติดตั้งอาจแตกต่างกันตามประสิทธิภาพ VPS สถานะระบบปฏิบัติการ และเงื่อนไขเครือข่าย หากการตั้งค่าไม่สำเร็จ ให้ตรวจสอบส่วนแก้ไขปัญหาในคู่มือนี้ +::: + +## การเรียกดูแคตตาล็อกแอป + +เมื่อการติดตั้งเสร็จสิ้น คุณสามารถเปิดแคตตาล็อกแอปและเรียกดูแอปที่มีให้เลือกได้ แคตตาล็อกมีแอปพร้อมติดตั้งมากกว่า 300 รายการ และรองรับการกรองเพื่อช่วยคุณหาตัวเลือกที่เหมาะสมได้เร็วขึ้น + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### การค้นหาและกรองแอป + +ในแคตตาล็อก คุณสามารถค้นหาแอปตามชื่อและกรองตามหมวดหมู่ ช่วยให้คุณจำกัดตัวเลือกแอปทั้งหมดในอินเทอร์เฟซสไตล์ร้านค้าแอปและหาจุดติดตั้งที่เหมาะกับโปรเจกต์ของคุณ + +การทำงานทั่วไปได้แก่: + +- ค้นหาตามชื่อแอป +- กรองตามหมวดหมู่ +- ตรวจสอบรายการแอปที่มี +- เลือกแอปเพื่อติดตั้ง + +เวิร์กโฟลว์นี้มีประโยชน์มากถ้าคุณจัดการเป้าหมายดาวน์โหลดแอปจำนวนมาก หรือเปรียบเทียบบริการหลายตัวก่อนติดตั้ง + +### เริ่มติดตั้งแอป + +หลังเลือกแอปจากแคตตาล็อก ให้เริ่มติดตั้งผ่านเว็บอินเทอร์เฟซ ขึ้นอยู่กับแอป คุณอาจต้องกำหนดค่าต่างๆ เช่น: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +ตัวแปรเหล่านี้แทนค่าที่เฉพาะเจาะจงสำหรับการติดตั้งของคุณ เช่น `[your_domain]` ควรถูกแทนที่ด้วยโดเมนที่คุณต้องการใช้กับแอป + +:::tip โปรเจกต์และสภาพแวดล้อม +ใช้โปรเจกต์และสภาพแวดล้อมเพื่อจัดระเบียบการติดตั้งของคุณ โดยเฉพาะเมื่อคุณโฮสต์แอปหลายตัว ทดสอบเวอร์ชัน หรือแยกบริการโปรดักชันกับสเตจจิ้ง +::: + +## การจัดการแอปที่ติดตั้งแล้ว + +หลังติดตั้ง แอปของคุณจะถูกแสดงในส่วนจัดการของเว็บอินเทอร์เฟซ จากตรงนี้คุณสามารถตรวจสอบและควบคุมบริการโดยไม่ต้องทำงานกับคอนเทนเนอร์โดยตรง + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### การจัดการที่มีให้ใช้งาน + +ส่วนแอปที่ติดตั้งแล้วช่วยให้คุณทำงานทั่วไปเกี่ยวกับวงจรชีวิตแอปได้โดยตรงจากเว็บอินเทอร์เฟซ + +| การกระทำ | จุดประสงค์ | +| --- | --- | +| เริ่ม | เริ่มแอปที่หยุดทำงาน | +| หยุด | หยุดแอปที่กำลังทำงาน | +| ตรวจสอบบันทึก | เปิดบันทึกแอปเพื่อแก้ไขปัญหา | +| ติดตั้งใหม่ | ติดตั้งแอปใหม่อีกครั้ง | + +เครื่องมือเหล่านี้ช่วยให้จัดการแอปทั้งหมดได้ง่ายขึ้น โดยเฉพาะถ้าคุณต้องการควบคุมผ่านเว็บแทนการใช้คำสั่งในคอนโซล + +### การจัดระเบียบโปรเจกต์และสภาพแวดล้อม + +โปรเจกต์และสภาพแวดล้อมช่วยให้คุณจัดโครงสร้างการติดตั้งได้ชัดเจน คุณสามารถใช้แยก: + +- แอปส่วนตัวและแอปโปรดักชัน +- สภาพแวดล้อมทดสอบและใช้งานจริง +- การติดตั้งลูกค้าหรือทีมหลายราย +- สแตกต่างๆ บน VPS เดียวกัน + +การจัดระเบียบนี้สำคัญมากขึ้นเมื่อคอลเลกชันแอปในร้านค้าแอปของคุณเติบโตและคุณจัดการบริการมากขึ้นบนโหนดหนึ่งหรือหลายโหนด + +## โดเมน, การเข้าถึงคลาวด์ และ SSL + +ฟีเจอร์ One Click Apps รองรับโดเมนที่กำหนดเองและการรวมกับ ZAP Cloud ช่วยให้คุณเปิดเผยแอปอย่างปลอดภัยและจัดเตรียมใบรับรอง SSL สำหรับการติดตั้งของคุณ + +:::info รองรับโดเมนและ SSL +คุณสามารถใช้โดเมนที่กำหนดเองสำหรับแอปและรับประโยชน์จากการจัดเตรียมใบรับรอง SSL เมื่อแพลตฟอร์มรองรับ +::: + +เมื่อกำหนดโดเมน ให้แน่ใจว่าระเบียน DNS ชี้ไปที่ `[your_server_ip]` หากโดเมนของคุณตั้งค่าไม่ถูกต้อง แอปอาจไม่สามารถเข้าถึงได้จากอินเทอร์เน็ต + +| ค่า | คำอธิบาย | +| --- | --- | +| `[your_domain]` | โดเมนหรือซับโดเมนที่กำหนดให้แอปของคุณ | +| `[your_server_ip]` | ที่อยู่ IP สาธารณะของ VPS คุณ | + +:::caution DNS ต้องชี้ไปที่ VPS ของคุณ +ถ้า DNS ของ `[your_domain]` ไม่ชี้ไปที่ `[your_server_ip]` การตรวจสอบโดเมนและการเข้าถึงแอปอาจล้มเหลว +::: + +## การใช้การตั้งค่าขั้นสูง + +ผู้ใช้ขั้นสูงสามารถเข้าถึงฟังก์ชันเพิ่มเติมผ่านแผงควบคุมภายนอกที่มีในส่วนการตั้งค่าขั้นสูง + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +สิ่งนี้มีประโยชน์ถ้าคุณต้องการปรับแต่งลึกขึ้น ควบคุมการติดตั้งขยาย หรือเข้าถึงฟีเจอร์ที่เกินกว่าเว็บอินเทอร์เฟซมาตรฐาน + +### ข้อจำกัดการสนับสนุนสำคัญ + +:::caution ขอบเขตการสนับสนุนสำหรับการใช้แผงควบคุมขั้นสูง +ผู้ใช้ขั้นสูงสามารถใช้แผง Coolify ภายนอกเพื่อปรับแต่งและฟังก์ชันเพิ่มเติมได้ แต่การสนับสนุนจำกัดเฉพาะเว็บอินเทอร์เฟซของ ZAP-Hosting หากคุณเปลี่ยนแปลงนอกเว็บอินเทอร์เฟซ อาจไม่ได้รับความช่วยเหลือสำหรับการปรับแต่งเหล่านั้น +::: + +### เมื่อไหร่ควรใช้แผงควบคุมขั้นสูง + +คุณอาจต้องใช้แผงขั้นสูงถ้าคุณต้องการ: + +- ปรับแต่งการติดตั้งอย่างละเอียด +- เวิร์กโฟลว์การเชื่อมต่อโหนดโดยตรง +- การตั้งค่าแอประดับสูง +- การจัดการแผงควบคุมเกินกว่าอินเทอร์เฟซง่ายๆ + +ถ้าคุณสูญเสียการเข้าถึงหรือการเชื่อมต่อหยุดตอบสนอง ให้ใช้เครื่องมือแก้ไขปัญหาที่อธิบายไว้ด้านล่างก่อนทำการเปลี่ยนแปลงด้วยตนเอง + +## การเชื่อมต่อโหนด + +ถ้าคุณเลือกการติดตั้งแบบโหนดอย่างเดียว คุณสามารถเชื่อมต่อ VPS นี้กับ VPS อื่นหรือแผงควบคุมภายนอกได้ ช่วยให้คุณขยายโครงสร้างพื้นฐานและจัดการโหนดหลายตัวจากที่เดียว + +การเชื่อมต่อโหนดเหมาะสำหรับกรณีที่คุณต้องการ: + +- กระจายแอปไปยัง VPS หลายเครื่อง +- รวมศูนย์การจัดการ +- ขยายความจุโดยไม่แยกการติดตั้ง +- เชื่อมต่อกับสภาพแวดล้อมแผงควบคุมภายนอก + +:::note การเชื่อมต่อแผงควบคุมภายนอก +คุณสามารถเชื่อมต่อโหนดกับ VPS อื่นหรือแผงควบคุมภายนอก รายละเอียดการเชื่อมต่อขึ้นอยู่กับสภาพแวดล้อมเป้าหมายที่ใช้งานอยู่ +::: + +## การแก้ไขปัญหาสถานะเสื่อม + +ถ้าเว็บอินเทอร์เฟซแสดงสถานะเสื่อม หมายความว่าแพลตฟอร์มไม่สามารถติดต่อหรือดึงข้อมูลจากอินสแตนซ์ที่ขับเคลื่อนฟีเจอร์ One Click Apps ได้ ให้ทำตามขั้นตอนแก้ไขปัญหาเรียงตามลำดับ + +### ตัวบ่งชี้สถานะ + +ป๊อปอัพแก้ไขปัญหาอาจแสดงตัวบ่งชี้ดังนี้: + +| สถานะ | ความหมาย | +| --- | --- | +| สถานะ Coolify: กำลังทำงาน | บริการแผงควบคุมดูเหมือนจะทำงาน | +| สถานะ API: เข้าถึงได้ | API สามารถเข้าถึงได้ในขณะนี้ | +| สถานะบริการ: ออนไลน์ | VPS ของคุณออนไลน์ | + +ถ้าส่วนใดส่วนหนึ่งไม่ทำงาน ให้ดำเนินการตามขั้นตอนด้านล่าง + +### ขั้นตอนที่ 1: ยืนยันว่า VPS ออนไลน์ + +ตรวจสอบให้แน่ใจว่า VPS ของคุณออนไลน์ในเว็บอินเทอร์เฟซ ZAP-Hosting หากเซิร์ฟเวอร์ออฟไลน์ แพลตฟอร์มแอปจะไม่ทำงาน + +### ขั้นตอนที่ 2: รีเฟรชสถานะ + +ใช้คำสั่ง **รีเฟรชสถานะ** เพื่อรันการตรวจสอบสุขภาพอีกครั้งด้วยข้อมูลล่าสุด วิธีนี้ช่วยแก้ไขปัญหาการเชื่อมต่อชั่วคราวได้ + +:::tip ปัญหาการเชื่อมต่อชั่วคราว +สถานะเสื่อมอาจเกิดจากปัญหาการสื่อสารชั่วคราว การรีเฟรชสถานะเป็นการตรวจสอบเบื้องต้นที่เร็วที่สุด +::: + +### ขั้นตอนที่ 3: รีสตาร์ท Docker + +ถ้าสถานะยังเสื่อมอยู่ ให้ใช้คำสั่ง **รีสตาร์ท Docker** เพื่อบังคับให้อินสแตนซ์แพลตฟอร์มรีสตาร์ท หลังจากตอบสนองสำเร็จ รอ `1-2 นาที` แล้วรีเฟรชสถานะอีกครั้ง + +:::caution การรีสตาร์ทบริการ +การรีสตาร์ท Docker อาจทำให้แอปที่กำลังรันหยุดชั่วคราวในระหว่างที่บริการกำลังรีสตาร์ท +::: + +### ขั้นตอนที่ 4: รีเฟรชข้อมูลรับรอง + +ขั้นตอนสุดท้าย ใช้คำสั่ง **รีเฟรชข้อมูลรับรอง** สำคัญมากถ้าสถานะแสดงออนไลน์แต่ฟังก์ชันเว็บอินเทอร์เฟซ เช่น การติดตั้งแอป ไม่ทำงาน + +คำสั่งนี้: + +- **ไม่** ลบข้อมูลของคุณ +- รีเฟรชข้อมูลรับรองผู้ใช้ root +- รีเฟรชโทเค็น API ที่เว็บอินเทอร์เฟซใช้ +- อัปเดตข้อมูลรับรองแผงควบคุมโดยอัตโนมัติเมื่อสำเร็จ + +:::info การรีเฟรชข้อมูลรับรองปลอดภัย +การรีเฟรชข้อมูลรับรองไม่ลบแอปที่ติดตั้งหรือข้อมูลการติดตั้งใดๆ มันแค่ต่ออายุข้อมูลรับรองที่จำเป็นสำหรับการเข้าถึงและการสื่อสาร +::: + +### เมื่อไหร่ควรติดต่อฝ่ายสนับสนุน + +ถ้าปัญหายังไม่หายหลังทำตามขั้นตอนทั้งหมดแล้ว ให้สร้างตั๋วสนับสนุนผ่านเว็บไซต์ ZAP-Hosting + +## แนวทางปฏิบัติที่ดีที่สุด + +เพื่อให้ตัวติดตั้งแอปคลิกเดียวเสถียรและง่ายต่อการจัดการ ให้ทำตามคำแนะนำเหล่านี้: + +| แนวทางปฏิบัติ | เหตุผล | +| --- | --- | +| ใช้การติดตั้งระบบปฏิบัติการใหม่ | ลดความขัดแย้งกับบริการและพอร์ตที่มีอยู่ | +| ตรงตามทรัพยากรที่แนะนำ | เพิ่มประสิทธิภาพและความเสถียร | +| จัดแอปเป็นโปรเจกต์และสภาพแวดล้อม | ทำให้การติดตั้งจัดการง่ายขึ้น | +| ตั้งค่า DNS ก่อนกำหนดโดเมน | ป้องกันปัญหาการเข้าถึงและ SSL | +| ใช้การตั้งค่าขั้นสูงอย่างระมัดระวัง | หลีกเลี่ยงการเปลี่ยนแปลงที่ไม่ได้รับการสนับสนุน | + +:::tip รักษาการติดตั้งให้เป็นระเบียบ +ถ้าคุณวางแผนโฮสต์แอปจำนวนมาก ให้สร้างระบบตั้งชื่อที่ชัดเจนสำหรับ `[your_project_name]`, `[your_environment_name]` และ `[your_app_name]` ก่อนติดตั้งบริการแรก +::: + +## สรุป + +ยินดีด้วย คุณได้ตั้งค่าและใช้ตัวติดตั้งแอปคลิกเดียวบน VPS สำเร็จเพื่อการติดตั้งและจัดการแอปบนเซิร์ฟเวอร์ของคุณแล้ว หากมีคำถามหรือขอความช่วยเหลือเพิ่มเติม อย่าลังเลที่จะติดต่อทีมสนับสนุนของเรา ซึ่งพร้อมให้บริการทุกวัน! + + \ No newline at end of file diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md b/i18n/zh/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md new file mode 100644 index 000000000..46d90b93e --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md @@ -0,0 +1,293 @@ +--- +id: vserver-one-click-apps-installer +title: "VPS:一键应用安装器" +description: "通过 VPS 一键应用安装器部署应用,使用网页界面管理项目,并利用 Coolify 进行高级应用管理 -> 立即了解更多" +sidebar_label: 一键应用安装器 +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## 介绍 + +一键应用安装器让你可以浏览丰富的应用目录,并直接从 VPS 网页界面部署应用。在本指南中,你将学习如何准备服务器、选择正确的安装类型、安装和管理应用,以及在需要时使用高级设置和故障排除工具。 + +![img](https://screensaver01.zap-hosting.com/index.php/s/GDwkwA8Mi4gHS7D/preview) + + + +## 准备工作 + +在使用一键应用安装器之前,你的 VPS 必须满足最低要求,并使用受支持的操作系统。 + +:::info 最低要求 +应用功能要求你的 VPS 在线,并配置有足够资源以稳定运行平台服务和已安装的应用。 +::: + +| 要求 | 最低配置 | 推荐配置 | +| --- | --- | --- | +| 服务器状态 | 在线 | 在线 | +| 存储空间 | 30 GB | 50 GB | +| 内存 | 2 GB | 4 GB | +| CPU | 2 核 | 4 核 | +| 操作系统 | Debian 或 Ubuntu LTS | Debian 13 - EN - 64位 | + +:::caution 建议使用全新操作系统 +强烈建议在全新操作系统安装环境下设置应用功能。这有助于避免与现有服务、占用端口、Docker 配置或服务器上的自定义设置发生冲突。 +::: + +如果需要重新安装 VPS,请从 VPS 管理界面选择全新支持的 Debian 或 Ubuntu LTS 镜像。 + +## 访问一键应用安装器 + +打开 ZAP-Hosting 网页界面中的 VPS,找到“一键应用”部分。从这里开始初始设置,之后可以返回管理服务器上安装的所有应用。 + +首次打开此功能时,需要选择平台在 VPS 上的安装方式。 + +## 选择安装类型 + +你可以选择完整安装或仅节点安装。正确选项取决于该 VPS 是否既托管管理面板和应用,还是仅作为另一个面板的关联节点。 + +### 完整安装 + +如果你想将服务器设置为面板和节点服务器,选择**完整安装**。这是首次使用者和大多数标准部署的推荐选项。 + +通过此方式,你可以: + +- 从应用目录部署应用 +- 管理项目和环境 +- 将所有应用集中管理 +- 使用集成的网页界面管理工具 +- 需要时访问高级面板 + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip 大多数用户推荐 +如果你是首次使用应用功能,选择完整安装选项。它提供最简单的设置,并让你直接通过 ZAP-Hosting 网页界面全面管理。 +::: + +### 仅节点安装 + +如果你希望该 VPS 仅作为节点使用,选择**仅节点安装**。之后可以将其链接到另一台 VPS 服务器或外部面板实例。 + +此选项适合: + +- 跨多个 VPS 系统扩展 +- 在一个面板集中管理 +- 将服务器链接到现有部署 +- 扩展已有的多节点架构 + +:::note 高级部署选项 +仅节点安装适用于已有其他面板实例或想将服务器连接到外部环境的用户。 +::: + +## 安装应用功能 + +选择安装类型后,从网页界面启动设置。初始安装通常只需几分钟。 + +安装过程中,支持一键应用功能的平台服务会部署到你的 VPS。完成后,网页界面将开放应用目录和管理部分。 + +:::info 安装行为 +具体安装进度可能因 VPS 性能、操作系统状态和网络状况而异。如果安装未成功完成,请稍后查看本指南的故障排除部分。 +::: + +## 浏览应用目录 + +安装完成后,你可以打开应用目录浏览可用应用。目录包含超过 300 个即装即用的应用,并支持筛选,帮助你快速找到合适的应用。 + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### 搜索与筛选应用 + +在目录中,你可以按名称搜索应用,按类别筛选。这有助于缩小应用范围,快速找到适合你项目的部署目标。 + +常用操作包括: + +- 按应用名称搜索 +- 按类别筛选 +- 查看应用条目详情 +- 选择应用进行部署 + +如果你管理多个应用下载目标或在安装前比较多个服务,这个流程特别有用。 + +### 开始安装应用 + +从目录选择应用后,通过网页界面开始安装。根据应用不同,你可能需要填写如下值: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +这些占位符代表你部署的具体值。例如,`[your_domain]` 应替换为你想用于该应用的域名。 + +:::tip 项目与环境 +使用项目和环境来保持部署有序。尤其当你托管多个应用、测试版本或区分生产与预发布服务时,这非常有帮助。 +::: + +## 管理已安装应用 + +部署完成后,已安装的应用会在网页界面的管理部分列出。你可以在这里监控和控制服务,无需手动操作底层容器。 + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### 可用管理操作 + +已安装应用部分允许你直接通过网页界面执行常用生命周期操作。 + +| 操作 | 作用 | +| --- | --- | +| 启动 | 启动已停止的应用 | +| 停止 | 停止正在运行的应用 | +| 查看日志 | 打开应用日志以便排查问题 | +| 重新安装 | 重新部署应用 | + +这些工具让你更轻松地集中管理所有应用,尤其适合想用简单网页控制而非命令行操作的用户。 + +### 组织项目与环境 + +项目和环境帮助你清晰结构化部署。你可以用它们区分: + +- 个人与生产应用 +- 测试与线上环境 +- 多客户或团队部署 +- 同一 VPS 上的不同技术栈 + +随着应用商店应用数量增长,管理更多服务时,这种组织方式尤为重要。 + +## 域名、云访问与 SSL + +一键应用功能支持自定义域名和 ZAP Cloud 集成,允许你安全地暴露应用并为部署申请 SSL 证书。 + +:::info 域名与 SSL 支持 +你可以为应用使用自定义域名,并在平台支持的情况下享受 SSL 证书自动申请。 +::: + +分配域名时,确保你的 DNS 记录指向 `[your_server_ip]`。如果域名配置不正确,应用可能无法从互联网访问。 + +| 值 | 说明 | +| --- | --- | +| `[your_domain]` | 分配给应用的域名或子域名 | +| `[your_server_ip]` | 你的 VPS 公网 IP 地址 | + +:::caution DNS 必须指向你的 VPS +如果 `[your_domain]` 的 DNS 未指向 `[your_server_ip]`,域名验证和应用访问可能失败。 +::: + +## 使用高级设置 + +高级用户可以通过高级设置部分访问外部面板,获得更多功能。 + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +当你需要更深度定制、扩展部署控制或访问标准网页界面之外的功能时,这非常有用。 + +### 重要支持限制 + +:::caution 高级面板使用支持范围 +欢迎高级用户使用外部 Coolify 面板进行更多定制和功能扩展。但支持仅限于 ZAP-Hosting 网页界面。如果你在网页界面外做出更改,可能无法获得针对这些自定义修改的帮助。 +::: + +### 何时使用高级面板 + +如果你需要: + +- 更详细的部署定制 +- 直接节点链接流程 +- 高级应用配置 +- 超出简化界面的面板级管理 + +可以使用高级面板。如果失去访问权限或集成停止响应,先使用下文的故障排除工具,再考虑手动修改。 + +## 链接节点 + +如果选择了仅节点安装类型,你可以将此 VPS 链接到另一台 VPS 或外部面板实例,实现基础设施扩展并从单一位置管理多个节点。 + +节点链接适合: + +- 在多个 VPS 系统间分布应用 +- 集中管理 +- 扩容而不创建孤立部署 +- 连接到外部面板环境 + +:::note 外部面板链接 +你可以将节点链接到另一台 VPS 或外部面板实例。具体链接细节取决于目标环境。 +::: + +## 故障排除降级状态 + +如果网页界面显示降级状态,说明平台无法联系或获取一键应用功能实例的数据。请按顺序执行以下故障排除步骤。 + +### 状态指示 + +故障排除弹窗可能显示如下指示: + +| 状态 | 含义 | +| --- | --- | +| Coolify 状态:活动 | 面板服务似乎正在运行 | +| API 状态:可访问 | 当前可访问 API | +| 服务状态:在线 | 你的 VPS 本身在线 | + +如果有部分功能异常,继续执行以下步骤。 + +### 步骤 1:确认 VPS 在线 + +首先确认你的 VPS 服务在 ZAP-Hosting 网页界面显示为在线。服务器离线时,应用平台无法运行。 + +### 步骤 2:刷新状态 + +使用**刷新状态**操作,重新运行健康检查,获取最新数据。这能解决临时的间歇性问题。 + +:::tip 临时连接问题 +降级状态有时由短暂通信故障引起。刷新状态是最快的初步检查。 +::: + +### 步骤 3:重启 Docker + +如果状态仍降级,使用**重启 Docker**操作。此操作会强制重启平台实例。成功后等待 `1-2 分钟`,再刷新状态。 + +:::caution 服务重启 +重启 Docker 可能会短暂中断正在运行的应用。 +::: + +### 步骤 4:刷新凭据 + +最后,使用**刷新凭据**。当状态显示在线但网页界面功能(如应用安装)异常时,这一步尤其重要。 + +此操作: + +- **不会**删除你的数据 +- 刷新 root 用户凭据 +- 刷新网页界面使用的 API 令牌 +- 成功后自动更新面板凭据 + +:::info 安全的凭据刷新 +刷新凭据不会移除已安装应用或部署数据,仅更新访问和通信所需的凭据。 +::: + +### 何时联系支持 + +完成所有故障排除步骤后问题依旧,请通过 ZAP-Hosting 网站提交支持工单。 + +## 最佳实践 + +为保持一键应用安装器稳定且易于管理,请遵循以下建议: + +| 最佳实践 | 原因 | +| --- | --- | +| 使用全新操作系统安装 | 减少与现有服务和端口冲突 | +| 满足推荐资源配置 | 提升性能和稳定性 | +| 将应用组织到项目和环境 | 保持部署可管理 | +| 分配域名前配置 DNS | 避免访问和 SSL 问题 | +| 谨慎使用高级设置 | 避免不受支持的自定义更改 | + +:::tip 保持部署有序 +如果计划托管大量应用,部署首批服务前,先制定清晰的 `[your_project_name]`、`[your_environment_name]` 和 `[your_app_name]` 命名方案。 +::: + +## 结语 + +恭喜你成功设置并使用 VPS 一键应用安装器,在服务器上部署和管理应用。如有更多问题或需要帮助,欢迎随时联系每日在线的支持团队! + + \ No newline at end of file diff --git a/sidebars.js b/sidebars.js index 01a4fa5bf..6f4eda766 100644 --- a/sidebars.js +++ b/sidebars.js @@ -5025,6 +5025,7 @@ const sidebars = { "vserver-rescue", "vserver-dedicated-comparison", "vserver-ballooning", + "verver-one-click-apps-installer", { type: "category", label: "Troubleshooting",