From a5a431da079103aac0a1f0116702fdb8d16f6cf4 Mon Sep 17 00:00:00 2001 From: Florian Galz Date: Sun, 19 Apr 2026 12:59:34 +0200 Subject: [PATCH 1/6] new: VPS: One Click Apps Installer --- docs/verver-one-click-apps-installer.md | 291 ++++++++++++++++++++++++ 1 file changed, 291 insertions(+) create mode 100644 docs/verver-one-click-apps-installer.md diff --git a/docs/verver-one-click-apps-installer.md b/docs/verver-one-click-apps-installer.md new file mode 100644 index 000000000..c7c94fa2a --- /dev/null +++ b/docs/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-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. + + + +## 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 From 847acc23869237e8c2101cdbf9d6d36f5adfbc91 Mon Sep 17 00:00:00 2001 From: Florian Galz Date: Sun, 19 Apr 2026 12:59:36 +0200 Subject: [PATCH 2/6] translate: VPS: One Click Apps Installer --- .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ .../verver-one-click-apps-installer.md | 284 +++++++++++++++++ .../verver-one-click-apps-installer.md | 291 ++++++++++++++++++ 12 files changed, 3485 insertions(+) create mode 100644 i18n/ar/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/es/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/fr/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/it/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/ja/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/nl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/pl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/pt/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/sv/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/th/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md create mode 100644 i18n/zh/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md diff --git a/i18n/ar/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/ar/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..815a8d72d --- /dev/null +++ b/i18n/ar/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-one-click-apps-installer +title: "VPS: مثبت التطبيقات بنقرة واحدة" +description: "نشر التطبيقات باستخدام مثبت التطبيقات بنقرة واحدة على VPS، إدارة المشاريع عبر الواجهة الإلكترونية، واستخدام Coolify لإدارة التطبيقات المتقدمة -> تعلّم المزيد الآن" +sidebar_label: مثبت التطبيقات بنقرة واحدة +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introduction + +يتيح لك مثبت التطبيقات بنقرة واحدة تصفح كتالوج ضخم من التطبيقات ونشرها مباشرة من واجهة الويب الخاصة بـ VPS. في هذا الدليل، ستتعلم كيفية تحضير سيرفرك، اختيار نوع التثبيت الصحيح، تثبيت وإدارة التطبيقات، واستخدام الإعدادات المتقدمة وأدوات استكشاف الأخطاء عند الحاجة. + + + +## Preparation + +قبل استخدام مثبت التطبيقات بنقرة واحدة، يجب أن يفي VPS الخاص بك بالحد الأدنى من المتطلبات وأن يستخدم نظام تشغيل مدعوم. + +:::info الحد الأدنى من المتطلبات +تتطلب ميزة التطبيقات أن يكون VPS الخاص بك متصلًا بالإنترنت ومجهزًا بموارد كافية لتشغيل خدمات المنصة والتطبيقات المثبتة بشكل موثوق. +::: + +| المتطلب | الحد الأدنى | الموصى به | +| --- | --- | --- | +| حالة السيرفر | متصل | متصل | +| التخزين | 30 جيجابايت | 50 جيجابايت | +| RAM | 2 جيجابايت | 4 جيجابايت | +| CPU | نواتان | 4 أنوية | +| نظام التشغيل | Debian أو Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution يُنصح بنظام تشغيل جديد +ننصح بشدة بإعداد ميزة التطبيقات على تثبيت نظام تشغيل جديد. هذا يساعد على تجنب التعارضات مع الخدمات الحالية، المنافذ المشغولة، إعدادات Docker، أو التكوينات المخصصة الموجودة مسبقًا على السيرفر. +::: + +إذا كنت بحاجة لإعادة تثبيت VPS قبل المتابعة، استخدم صورة Debian أو Ubuntu LTS مدعومة وجديدة من واجهة إدارة VPS الخاصة بك. + +## Accessing the One Click Apps Installer + +افتح VPS الخاص بك في واجهة الويب الخاصة بـ ZAP-Hosting وابحث عن قسم التطبيقات بنقرة واحدة. من هناك، يمكنك بدء الإعداد الأولي والعودة لاحقًا لإدارة جميع التطبيقات المثبتة على السيرفر. + +عند فتح هذه الميزة لأول مرة، تحتاج إلى اختيار كيفية تثبيت المنصة على VPS الخاص بك. + +## Choosing an Installation Type + +يمكنك الاختيار بين التثبيت الكامل أو التثبيت كعقدة فقط. الخيار الصحيح يعتمد على ما إذا كان هذا VPS سيستضيف كل من لوحة الإدارة والتطبيقات، أو يعمل فقط كعقدة مرتبطة بلوحة أخرى. + +### Full Installation + +اختر **التثبيت الكامل** إذا كنت تريد إعداد السيرفر مع اللوحة والسيرفر نفسه كعقدة. هذا هو الخيار الموصى به للمستخدمين الجدد ولأغلب عمليات النشر القياسية. + +بهذه الطريقة، يمكنك: + +- نشر التطبيقات من كتالوج التطبيقات +- إدارة المشاريع والبيئات +- تنظيم جميع التطبيقات في مكان واحد +- استخدام أدوات إدارة الواجهة الإلكترونية المدمجة +- الوصول إلى اللوحة المتقدمة لاحقًا إذا لزم الأمر + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip موصى به لمعظم المستخدمين +إذا كانت هذه هي المرة الأولى التي تستخدم فيها ميزة التطبيقات، اختر خيار التثبيت الكامل. يوفر هذا أبسط إعداد ويمنحك إدارة كاملة مباشرة من واجهة الويب الخاصة بـ ZAP-Hosting. +::: + +### Node-only Installation + +اختر **التثبيت كعقدة فقط** إذا كنت تريد أن يعمل هذا VPS كعقدة فقط. يمكنك ربطه لاحقًا بسيرفر VPS آخر أو بنسخة لوحة خارجية. + +هذا الخيار مفيد إذا كنت تريد: + +- التوسع عبر عدة أنظمة VPS +- مركزية الإدارة على لوحة واحدة +- ربط هذا السيرفر بنشر موجود +- توسيع إعداد متعدد العقد موجود + +:::note خيار نشر متقدم +التثبيت كعقدة فقط موجه للمستخدمين الذين لديهم بالفعل نسخة لوحة أخرى متاحة أو يرغبون في ربط هذا السيرفر ببيئة خارجية. +::: + +## Installing the Apps Feature + +بعد اختيار نوع التثبيت، ابدأ الإعداد من واجهة الويب. عادةً ما يستغرق التثبيت الأولي بضع دقائق فقط. + +خلال هذه العملية، يتم نشر خدمات المنصة المطلوبة لميزة التطبيقات بنقرة واحدة على VPS الخاص بك. بمجرد الانتهاء، يصبح كتالوج التطبيقات وأقسام الإدارة متاحة في واجهة الويب. + +:::info سلوك التثبيت +قد تختلف تفاصيل تقدم التثبيت حسب أداء VPS، حالة نظام التشغيل، وظروف الشبكة. إذا لم يكتمل الإعداد بنجاح، راجع قسم استكشاف الأخطاء في هذا الدليل لاحقًا. +::: + +## Browsing the App Catalogue + +بمجرد اكتمال التثبيت، يمكنك فتح كتالوج التطبيقات وتصفح التطبيقات المتاحة. يحتوي الكتالوج على أكثر من 300 تطبيق جاهز للنشر ويدعم التصفية لمساعدتك في العثور على التطبيق المناسب بسرعة. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Searching and Filtering Apps + +في الكتالوج، يمكنك البحث عن التطبيقات بالاسم والتصفية حسب الفئة. هذا يساعدك على تضييق نطاق جميع التطبيقات المتاحة في واجهة متجر التطبيقات والعثور على الهدف المناسب لنشر مشروعك. + +تشمل الإجراءات النموذجية: + +- البحث باسم التطبيق +- التصفية حسب الفئة +- مراجعة إدخالات التطبيقات المتاحة +- اختيار تطبيق للنشر + +هذا التدفق مفيد بشكل خاص إذا كنت تدير العديد من أهداف تنزيل التطبيقات أو تقارن بين خدمات متعددة قبل التثبيت. + +### Starting an App Installation + +بعد اختيار تطبيق من الكتالوج، ابدأ التثبيت عبر واجهة الويب. حسب التطبيق، قد تحتاج إلى تحديد قيم مثل: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +تمثل هذه العناصر النائبة القيم الخاصة بنشرك. على سبيل المثال، يجب استبدال `[your_domain]` بالنطاق الذي تريد استخدامه للتطبيق. + +:::tip المشاريع والبيئات +استخدم المشاريع والبيئات للحفاظ على تنظيم نشراتك. هذا مفيد بشكل خاص عند استضافة عدة تطبيقات، اختبار الإصدارات، أو فصل خدمات الإنتاج والاختبار. +::: + +## Managing Installed Apps + +بعد النشر، تُدرج التطبيقات المثبتة في قسم الإدارة بواجهة الويب. من هنا، يمكنك مراقبة خدماتك والتحكم بها دون الحاجة للعمل يدويًا مع الحاويات الأساسية. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Available Management Actions + +يتيح قسم التطبيقات المثبتة تنفيذ إجراءات دورة حياة شائعة مباشرة من واجهة الويب. + +| الإجراء | الغرض | +| --- | --- | +| بدء | تشغيل تطبيق متوقف | +| إيقاف | إيقاف تطبيق يعمل | +| فحص السجلات | فتح سجلات التطبيق لاستكشاف الأخطاء | +| إعادة التثبيت | إعادة نشر التطبيق | + +تجعل هذه الأدوات إدارة جميع التطبيقات من مكان واحد أسهل، خاصة إذا كنت تريد تحكمًا بسيطًا عبر الويب بدلاً من الإدارة اليدوية عبر سطر الأوامر. + +### Organizing Projects and Environments + +تساعد المشاريع والبيئات في تنظيم نشراتك بوضوح. يمكنك استخدامها لفصل: + +- التطبيقات الشخصية والإنتاجية +- بيئات الاختبار والإنتاج الحي +- نشرات متعددة لعملاء أو فرق مختلفة +- حزم مختلفة على نفس VPS + +تصبح هذه التنظيمات أكثر أهمية مع نمو مجموعة تطبيقات متجر التطبيقات وإدارة المزيد من الخدمات على عقدة واحدة أو أكثر. + +## Domains, Cloud Access, and 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]`، فقد تفشل عملية التحقق من النطاق والوصول إلى التطبيق. +::: + +## Using Advanced Settings + +يمكن للمستخدمين المتقدمين الوصول إلى وظائف إضافية عبر اللوحة الخارجية المتاحة في قسم الإعدادات المتقدمة. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +هذا مفيد إذا كنت بحاجة إلى تخصيص أعمق، تحكم موسع في النشر، أو وصول مباشر إلى ميزات تتجاوز واجهة الويب القياسية. + +### Important Support Limitation + +:::caution نطاق الدعم لاستخدام اللوحة المتقدمة +يُرحب بالمستخدمين المتقدمين لاستخدام لوحة Coolify الخارجية لمزيد من التخصيص والوظائف. مع ذلك، الدعم يقتصر على واجهة الويب الخاصة بـ ZAP-Hosting. إذا أجريت تغييرات خارج واجهة الويب، قد لا يتوفر الدعم لتلك التعديلات المخصصة. +::: + +### When to Use the Advanced Panel + +قد ترغب في استخدام اللوحة المتقدمة إذا كنت تحتاج إلى: + +- تخصيص نشر أكثر تفصيلاً +- سير عمل ربط العقد مباشرة +- تكوين تطبيقات متقدم +- إدارة على مستوى اللوحة تتجاوز الواجهة المبسطة + +إذا فقدت الوصول أو توقف التكامل عن الاستجابة، استخدم أدوات استكشاف الأخطاء أدناه قبل إجراء تغييرات يدوية. + +## Linking Nodes + +إذا اخترت نوع التثبيت كعقدة فقط، يمكنك ربط هذا VPS بسيرفر VPS آخر أو نسخة لوحة خارجية. هذا يسمح لك بتوسيع البنية التحتية وإدارة عدة عقد من موقع واحد. + +رابط العقد مفيد عندما تريد: + +- توزيع التطبيقات عبر عدة أنظمة VPS +- مركزية الإدارة +- توسيع السعة دون إنشاء نشرات معزولة +- الاتصال ببيئة لوحة خارجية + +:::note ربط لوحة خارجية +يمكنك ربط عقدتك بسيرفر VPS آخر أو نسخة لوحة خارجية. تعتمد تفاصيل الربط الدقيقة على البيئة المستهدفة المستخدمة بالفعل. +::: + +## Troubleshooting Degraded Status + +إذا أظهرت واجهة الويب حالة متدهورة، فهذا يعني أن المنصة لا تستطيع الاتصال أو استرجاع البيانات من النسخة التي تشغل ميزة التطبيقات بنقرة واحدة. اتبع خطوات استكشاف الأخطاء بالترتيب الزمني. + +### Status Indicators + +قد يظهر مربع استكشاف الأخطاء مؤشرات مثل التالية: + +| الحالة | المعنى | +| --- | --- | +| حالة Coolify: نشط | يبدو أن خدمة اللوحة تعمل | +| حالة API: متاحة | يمكن الوصول إلى API حاليًا | +| حالة الخدمة: متصل | VPS الخاص بك متصل بالإنترنت | + +إذا لم تعمل جزء أو أكثر بشكل صحيح، تابع الخطوات أدناه. + +### Step 1: Confirm the VPS Is Online + +أولاً، تأكد من أن خدمة VPS الخاصة بك متصلة في واجهة الويب الخاصة بـ ZAP-Hosting. إذا كان السيرفر غير متصل، لا يمكن لمنصة التطبيقات العمل. + +### Step 2: Refresh the Status + +استخدم إجراء **تحديث الحالة** لإعادة فحص الصحة بأحدث البيانات. يمكن أن يحل هذا مشاكل مؤقتة متقطعة. + +:::tip مشاكل الاتصال المؤقتة +قد يكون السبب في الحالة المتدهورة أحيانًا مشكلة اتصال قصيرة الأمد. تحديث الحالة هو أسرع فحص أولي. +::: + +### Step 3: Restart Docker + +إذا استمرت الحالة المتدهورة، استخدم إجراء **إعادة تشغيل Docker**. هذا يجبر نسخة المنصة على إعادة التشغيل. بعد استجابة ناجحة، انتظر `1-2 دقيقة` ثم حدث الحالة مرة أخرى. + +:::caution إعادة تشغيل الخدمة +إعادة تشغيل Docker قد توقف التطبيقات قيد التشغيل مؤقتًا أثناء إعادة تشغيل الخدمات. +::: + +### Step 4: Refresh Credentials + +كخطوة أخيرة، استخدم **تحديث بيانات الاعتماد**. هذا مهم بشكل خاص إذا كانت الحالة تظهر متصلة لكن وظائف واجهة الويب مثل تثبيت التطبيقات لا تعمل. + +هذا الإجراء: + +- لا يحذف بياناتك +- يحدث بيانات اعتماد المستخدم root +- يحدث رمز API المستخدم من قبل واجهة الويب +- يحدث بيانات اعتماد اللوحة تلقائيًا عند النجاح + +:::info تحديث بيانات اعتماد آمن +تحديث بيانات الاعتماد لا يزيل التطبيقات المثبتة أو بيانات النشر. فقط يجدد بيانات الاعتماد المطلوبة للوصول والاتصال. +::: + +### When to Contact Support + +إذا استمرت المشكلة بعد إكمال جميع خطوات استكشاف الأخطاء، أنشئ تذكرة دعم عبر موقع ZAP-Hosting. + +## Best Practices + +للحفاظ على استقرار مثبت التطبيقات بنقرة واحدة وسهولة إدارته، اتبع هذه التوصيات: + +| أفضل الممارسات | السبب | +| --- | --- | +| استخدم تثبيت نظام تشغيل جديد | يقلل التعارضات مع الخدمات والمنافذ الحالية | +| استوفِ الموارد الموصى بها | يحسن الأداء والموثوقية | +| نظم التطبيقات في مشاريع وبيئات | يحافظ على قابلية إدارة النشر | +| قم بتكوين DNS قبل تعيين النطاقات | يمنع مشاكل الوصول وSSL | +| استخدم الإعدادات المتقدمة بحذر | يتجنب التغييرات المخصصة غير المدعومة | + +:::tip حافظ على تنظيم النشرات +إذا كنت تخطط لاستضافة العديد من التطبيقات، أنشئ نظام تسمية واضح لـ `[your_project_name]`، `[your_environment_name]`، و`[your_app_name]` قبل نشر خدماتك الأولى. +::: + +## Conclusion + +تهانينا، لقد قمت بإعداد واستخدام مثبت التطبيقات بنقرة واحدة على VPS بنجاح لنشر وإدارة التطبيقات على سيرفرك. لأي أسئلة أو مساعدة إضافية، لا تتردد في التواصل مع فريق الدعم لدينا، المتوفر يوميًا لمساعدتك! 🙂 + + \ No newline at end of file diff --git a/i18n/de/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/de/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..b9f6f2257 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-one-click-apps-installer +title: "VPS: One Click Apps Installer" +description: "Apps mit dem VPS One Click Apps Installer bereitstellen, Projekte über die Weboberfläche verwalten und Coolify für erweiterte App-Verwaltung nutzen -> 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, aus einem umfangreichen App-Katalog zu wählen und Apps direkt über die Weboberfläche deines VPS bereitzustellen. 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 nutzt. + + + +## 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 über ausreichend Ressourcen verfügt, 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 auf dem Server. +::: + +Falls du deinen VPS vor der Nutzung neu installieren musst, verwende ein frisches, unterstütztes Debian- oder Ubuntu-LTS-Image aus deinem VPS-Management. + +## 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 Erstinstallation starten und später alle installierten Apps 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 dein 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-Setups. + +Mit dieser Methode kannst du: + +- Apps aus dem App-Katalog bereitstellen +- 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 dein VPS nur als Node fungieren soll. Du kannst ihn dann mit einem anderen VPS oder einer externen Panel-Instanz verknüpfen. + +Diese Option ist sinnvoll, wenn du: + +- über mehrere VPS-Systeme skalieren möchtest +- das Management auf einem Panel zentralisieren willst +- diesen Server in eine bestehende Installation einbinden möchtest +- ein bestehendes Multi-Node-Setup erweitern willst + +:::note Erweiterte Deployment-Option +Die Node-only-Installation ist für Nutzer gedacht, die bereits ein anderes Panel nutzen oder den Server mit einer externen Umgebung verbinden wollen. +::: + +## Installation der Apps-Funktion + +Nach Auswahl des Installationstyps startest du die Einrichtung über das Webinterface. Die Erstinstallation dauert in der Regel nur wenige Minuten. + +Währenddessen 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 kann je nach VPS-Leistung, Betriebssystemzustand und Netzwerkbedingungen variieren. Falls die Einrichtung nicht erfolgreich ist, findest du weiter unten im Guide eine Fehlerbehebung. +::: + +## Durchsuchen 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 bietet Filterfunktionen, um schnell die passende App zu finden. + +![](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 findest du schnell den richtigen Deployment-Zielort für dein Projekt. + +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 hilfreich, wenn du viele Apps verwaltest oder mehrere Dienste vor der Installation vergleichst. + +### App-Installation starten + +Nach Auswahl einer App im Katalog startest du die Installation über das Webinterface. Je nach App musst du Werte wie diese definieren: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +Diese Platzhalter stehen für spezifische Werte deiner Bereitstellung. Zum Beispiel ersetzt du `[your_domain]` durch die Domain, die du für die App verwenden möchtest. + +:::tip Projekte und Umgebungen +Nutze Projekte und Umgebungen, um deine Bereitstellung übersichtlich zu halten. Das ist besonders praktisch, wenn du mehrere Apps hostest, Versionen testest oder Produktions- und Staging-Services trennst. +::: + +## Verwaltung installierter Apps + +Nach der Bereitstellung werden deine installierten Apps im Verwaltungsbereich des Webinterfaces aufgelistet. Von hier aus kannst du deine Dienste ü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 ermöglicht dir gängige Lifecycle-Aktionen direkt im Webinterface. + +| 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 eine einfache Websteuerung statt manueller Kommandozeilenarbeit bevorzugst. + +### Projekte und Umgebungen organisieren + +Projekte und Umgebungen helfen dir, deine Deployments klar zu strukturieren. Du kannst damit trennen: + +- persönliche und produktive Apps +- Test- und Live-Umgebungen +- mehrere Kunden- oder Team-Deployments +- verschiedene Stacks auf demselben VPS + +Diese Organisation wird wichtiger, je größer deine App-Sammlung wird und je mehr Dienste du auf einem oder mehreren Nodes verwaltest. + +## Domains, Cloud-Zugriff und SSL + +Die One Click Apps Funktion unterstützt benutzerdefinierte Domains und die ZAP Cloud-Integration. So kannst du Apps sicher bereitstellen und SSL-Zertifikate für deine Deployments ausstellen lassen. + +:::info Domain- und SSL-Unterstützung +Du kannst benutzerdefinierte Domains für deine Apps nutzen und von der automatischen SSL-Zertifikatsbereitstellung profitieren, sofern die Plattform das unterstützt. +::: + +Beim Zuweisen einer Domain stelle sicher, dass deine DNS-Einträge auf `[your_server_ip]` zeigen. Ist deine Domain nicht korrekt konfiguriert, ist die App möglicherweise nicht aus dem Internet erreichbar. + +| Wert | Beschreibung | +| --- | --- | +| `[your_domain]` | Die Domain oder Subdomain, die deiner App zugewiesen ist | +| `[your_server_ip]` | Die öffentliche IP-Adresse deines VPS | + +:::caution DNS muss auf deinen VPS zeigen +Wenn der DNS für `[your_domain]` nicht auf `[your_server_ip]` zeigt, kann die Domainvalidierung und der Zugriff auf die App 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 hilfreich, wenn du tiefere Anpassungen, erweiterte Deployment-Kontrolle oder direkten Zugriff auf Funktionen außerhalb der Standard-Weboberfläche benötigst. + +### Wichtige Support-Einschränkung + +:::caution Supportumfang bei Nutzung des erweiterten Panels +Fortgeschrittene Nutzer können das externe Coolify-Panel für mehr Anpassungen verwenden. Der Support beschränkt sich jedoch auf das ZAP-Hosting Webinterface. Änderungen außerhalb des Webinterfaces können nicht unterstützt werden. +::: + +### Wann das erweiterte Panel nutzen? + +Das erweiterte Panel ist sinnvoll, wenn du: + +- detailliertere Deployment-Anpassungen brauchst +- direkte Node-Verknüpfungen verwalten willst +- erweiterte App-Konfigurationen durchführen möchtest +- Panel-Management jenseits der vereinfachten Oberfläche benötigst + +Falls du den Zugriff verlierst oder die Integration nicht mehr reagiert, nutze zuerst 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 oder einer externen Panel-Instanz verknüpfen. So kannst du deine Infrastruktur skalieren und mehrere Nodes zentral verwalten. + +Node-Verknüpfungen sind 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 Zielumgebung ab. +::: + +## Fehlerbehebung bei verschlechtertem Status + +Wenn das Webinterface einen verschlechterten Status anzeigt, kann die Plattform keine Verbindung zur Instanz herstellen, die die One Click Apps Funktion betreibt. Folge den Troubleshooting-Schritten in der angegebenen Reihenfolge. + +### Statusanzeigen + +Das Troubleshooting-Popup zeigt möglicherweise folgende Statusanzeigen: + +| Status | Bedeutung | +| --- | --- | +| Coolify Status: Aktiv | Der Panel-Dienst läuft offenbar | +| API Status: Erreichbar | Die API ist aktuell erreichbar | +| Service Status: Online | Dein VPS ist online | + +Wenn eine oder mehrere Komponenten nicht 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. Ist der Server offline, kann die Apps-Plattform nicht funktionieren. + +### Schritt 2: Status aktualisieren + +Nutze die Aktion **Status aktualisieren**, um die Gesundheitsprüfung mit aktuellen Daten erneut auszuführen. Das kann temporäre Verbindungsprobleme beheben. + +:::tip Temporäre Verbindungsprobleme +Ein verschlechterter Zustand kann durch kurzzeitige Kommunikationsprobleme verursacht werden. Das Aktualisieren des Status ist der schnellste erste Check. +::: + +### Schritt 3: Docker neu starten + +Bleibt der Status verschlechtert, nutze die Aktion **Docker neu starten**. Dadurch wird die Plattforminstanz neu gestartet. War die Antwort erfolgreich, 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 wie App-Installation nicht funktionieren. + +Diese Aktion: + +- löscht **nicht** deine Daten +- aktualisiert die Root-Benutzer-Zugangsdaten +- erneuert den API-Token, den das Webinterface nutzt +- aktualisiert die Panel-Zugangsdaten automatisch bei Erfolg + +:::info Sichere Aktualisierung der Zugangsdaten +Das Aktualisieren der Zugangsdaten entfernt keine installierten Apps oder Deployment-Daten. Es erneuert nur die für Zugriff und Kommunikation benötigten Credentials. +::: + +### Wann Support kontaktieren + +Wenn das Problem nach allen 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 verwenden | Vermeidet Konflikte mit bestehenden Diensten und Ports | +| Empfohlene Ressourcen einhalten | Verbessert Leistung 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 Änderungen | + +:::tip Deployments organisiert halten +Wenn du viele Apps hosten möchtest, erstelle vor der ersten Bereitstellung ein klares Namensschema für `[your_project_name]`, `[your_environment_name]` und `[your_app_name]`. +::: + +## Fazit + +Glückwunsch, du hast den VPS One Click Apps Installer erfolgreich eingerichtet und genutzt, um Apps auf deinem Server bereitzustellen und zu verwalten. Für weitere Fragen oder Unterstützung steht dir unser Support-Team täglich zur Verfügung! + + \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/es/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..8ddb9b03e --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-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 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 a 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. + + + +## 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 compatible. + +:::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 Recomendado Sistema Operativo Nuevo +Se recomienda encarecidamente configurar la función de apps en una instalación nueva 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 nueva y compatible 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 +- gestionar proyectos y entornos +- organizar todas las apps en un solo lugar +- usar las herramientas integradas de gestión 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. +::: + +## Explorando el Catálogo de Apps + +Una vez finalizada la instalación, puedes abrir el catálogo de apps y explorar las 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 adecuado para tu proyecto. + +Acciones típicas incluyen: + +- buscar por nombre de app +- filtrar por categoría +- revisar las entradas disponibles +- seleccionar una app para desplegar + +Este flujo 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 reemplazarse 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, versiones de prueba o separas servicios de producción y staging. +::: + +## Gestionando Apps Instaladas + +Después del despliegue, tus apps instaladas se listan 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 +- despliegues para varios 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 aprovisionar certificados SSL para tus despliegues. + +:::info Soporte de Dominio 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. + +### Limitación Importante 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 dependen del entorno destino ya en uso. +::: + +## Solución de Problemas de 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 en ejecución | +| 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: Actualiza el Estado + +Usa la acción **Actualizar Estado** para ejecutar la comprobación de salud nuevamente con los datos más recientes. Esto puede resolver problemas intermitentes temporales. + +:::tip Problemas Temporales de Conectividad +Un estado degradado puede ser causado a veces por un problema de comunicación breve. Actualizar el estado es la primera comprobación más rápida. +::: + +### Paso 3: Reinicia Docker + +Si el estado sigue degradado, usa la acción **Reiniciar Docker**. Esto fuerza el reinicio de la instancia de la plataforma. Tras una respuesta exitosa, espera `1-2 minutos` y actualiza 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: Actualiza las Credenciales + +Como paso final, usa **Actualizar 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 elimina tus datos +- actualiza las credenciales del usuario root +- actualiza el token API usado por la interfaz web +- actualiza automáticamente las credenciales del panel al completarse con éxito + +:::info Actualización Segura de Credenciales +Actualizar 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 nueva 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 + +Felicitaciones, 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 asistencia, no dudes en contactar a nuestro equipo de soporte, que está disponible a diario para ayudarte! 🙂 + + \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/fr/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..64114e0a9 --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-one-click-apps-installer +title: "VPS : Installateur d’Apps en Un Clic" +description: "Déployez des apps avec l’installateur d’apps en un clic pour VPS, gérez vos projets via l’interface web, et utilisez Coolify pour une gestion avancée -> Découvrez tout ça maintenant" +sidebar_label: Installateur d’Apps en Un Clic +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introduction + +L’installateur d’apps en un clic vous permet de parcourir un catalogue d’applications complet et de déployer des apps directement depuis l’interface web de votre VPS. Dans ce guide, vous apprendrez à préparer votre serveur, choisir le type d’installation adapté, installer et gérer vos apps, et utiliser les réglages avancés ainsi que les outils de dépannage si besoin. + + + +## Preparation + +Avant d’utiliser l’installateur d’apps en un clic, votre VPS doit répondre aux exigences minimales et utiliser un système d’exploitation supporté. + +:::info Exigences minimales +La fonctionnalité apps nécessite que votre VPS soit en ligne et configuré avec suffisamment de ressources pour faire tourner à la fois les services de la plateforme et vos apps installées de manière fiable. +::: + +| Exigence | Minimum | Recommandé | +| --- | --- | --- | +| Statut 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 - EN - 64bit | + +:::caution Système d’exploitation frais recommandé +Il est fortement conseillé d’installer la fonctionnalité apps sur une installation fraîche du système d’exploitation. Cela évite les conflits avec des services existants, des ports occupés, des configurations Docker ou personnalisées déjà présentes sur le serveur. +::: + +Si vous devez réinstaller votre VPS avant de continuer, utilisez une image Debian ou Ubuntu LTS fraîche et supportée depuis votre interface de gestion VPS. + +## Accéder à l’Installateur d’Apps en Un Clic + +Ouvrez votre VPS dans l’interface web ZAP-Hosting et localisez la section One Click Apps. Vous pouvez lancer la configuration initiale depuis là, puis revenir gérer toutes les apps installées sur le serveur. + +La première fois que vous ouvrez cette fonctionnalité, vous devez choisir comment la plateforme doit être installée sur votre VPS. + +## Choisir un Type d’Installation + +Vous pouvez choisir entre une installation complète et une installation en mode nœud uniquement. Le 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 + +Choisissez **Installation complète** si vous souhaitez 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, vous pouvez : + +- 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 plupart des utilisateurs +Si c’est votre première utilisation de la fonctionnalité apps, sélectionnez l’installation complète. Elle offre la configuration la plus simple et vous donne une gestion complète directement depuis l’interface web ZAP-Hosting. +::: + +### Installation en mode nœud uniquement + +Choisissez **Installation en mode nœud uniquement** si vous voulez que ce VPS agisse uniquement comme un nœud. Vous pourrez alors le lier à un autre serveur VPS ou à une instance de panneau externe. + +Cette option est utile si vous souhaitez : + +- 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 de déploiement avancée +L’installation en mode nœud uniquement est destinée aux utilisateurs qui ont déjà un autre panneau disponible ou qui veulent connecter ce serveur à un environnement externe. +::: + +## Installer la Fonctionnalité Apps + +Après avoir choisi le type d’installation, lancez 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 votre 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 votre VPS, l’état du système d’exploitation et les conditions réseau. Si l’installation ne se termine pas correctement, consultez la section dépannage plus bas dans ce guide. +::: + +## Parcourir le Catalogue d’Apps + +Une fois l’installation terminée, vous pouvez 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 vous aider à trouver rapidement l’app adaptée. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Rechercher et filtrer les apps + +Dans le catalogue, vous pouvez chercher des apps par nom et filtrer par catégorie. Cela vous aide à réduire la liste dans cette interface façon store et à trouver la cible de déploiement idéale pour votre projet. + +Actions typiques : + +- rechercher par nom d’app +- filtrer par catégorie +- consulter les entrées disponibles +- sélectionner une app pour le déploiement + +Ce workflow est particulièrement utile si vous gérez beaucoup de cibles de téléchargement ou comparez plusieurs services avant installation. + +### Lancer une installation d’app + +Après avoir sélectionné une app dans le catalogue, commencez l’installation via l’interface web. Selon l’app, vous devrez peut-être définir des valeurs telles que : + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +Ces placeholders représentent des valeurs spécifiques à votre déploiement. Par exemple, `[your_domain]` doit être remplacé par le domaine que vous souhaitez utiliser pour l’app. + +:::tip Projets et environnements +Utilisez projets et environnements pour garder votre déploiement organisé. C’est particulièrement utile si vous hébergez plusieurs apps, testez des versions ou séparez production et staging. +::: + +## Gérer les Apps Installées + +Après déploiement, vos apps installées sont listées dans la section de gestion de l’interface web. Vous pouvez y surveiller et contrôler vos services sans 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 vous permet d’effectuer des actions courantes 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 vos apps au même endroit, surtout si vous préférez un contrôle simple via web plutôt qu’une administration en ligne de commande. + +### Organiser projets et environnements + +Projets et environnements vous aident à structurer clairement vos déploiements. Vous pouvez les utiliser pour séparer : + +- apps perso et production +- environnements test et live +- déploiements clients ou équipes multiples +- stacks différents sur un même VPS + +Cette organisation devient de plus en plus importante à mesure que votre collection d’apps store grandit et que vous gérez 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. Cela vous permet d’exposer vos apps en toute sécurité et de provisionner des certificats SSL pour vos déploiements. + +:::info Support domaines et SSL +Vous pouvez utiliser des domaines personnalisés pour vos apps et bénéficier du provisioning de certificats SSL lorsque la plateforme le supporte. +::: + +Lors de l’attribution d’un domaine, assurez-vous que vos enregistrements DNS pointent vers `[your_server_ip]`. Si votre 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é à votre app | +| `[your_server_ip]` | L’adresse IP publique de votre VPS | + +:::caution Le DNS doit pointer vers votre 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 Paramètres Avancés + +Les utilisateurs avancés peuvent accéder à des fonctionnalités supplémentaires via le panneau externe disponible dans la section paramètres avancés. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Cela peut être utile si vous avez 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 vous effectuez des modifications hors interface web, l’assistance peut ne pas être disponible pour ces changements personnalisés. +::: + +### Quand utiliser le panneau avancé + +Vous pouvez vouloir utiliser le panneau avancé si vous avez besoin de : + +- personnalisation détaillée du déploiement +- workflows de liaison de nœuds directs +- configuration avancée des apps +- gestion au niveau panneau au-delà de l’interface simplifiée + +Si vous perdez l’accès ou que l’intégration ne répond plus, utilisez d’abord les outils de dépannage décrits ci-dessous avant de faire des modifications manuelles. + +## Lier des Nœuds + +Si vous avez choisi l’installation en mode nœud uniquement, vous pouvez lier ce VPS à un autre serveur VPS ou à une instance de panneau externe. Cela vous permet de scaler votre infrastructure et gérer plusieurs nœuds depuis un seul endroit. + +La liaison de nœuds est utile quand vous voulez : + +- distribuer les apps sur plusieurs VPS +- centraliser la gestion +- étendre la capacité sans créer de déploiements isolés +- connecter à un environnement de panneau externe + +:::note Liaison à un panneau externe +Vous pouvez lier votre 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. Suivez 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 | Votre VPS est lui-même en ligne | + +Si une ou plusieurs parties ne fonctionnent pas correctement, continuez avec les étapes ci-dessous. + +### Étape 1 : Confirmer que le VPS est en ligne + +Assurez-vous d’abord que votre VPS est 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 + +Utilisez l’action **Rafraîchir le statut** pour relancer la vérification de santé avec les données les plus récentes. Cela peut résoudre des problèmes intermittents temporaires. + +:::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é, utilisez l’action **Redémarrer Docker**. Cela force le redémarrage de l’instance plateforme. Après une réponse réussie, attendez `1-2 minutes` puis rafraîchissez à 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, utilisez **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** vos 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 vos apps installées ni les données de déploiement. Cela renouvelle uniquement 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éez un ticket de support via le site ZAP-Hosting. + +## Bonnes Pratiques + +Pour garder l’installateur d’apps en un clic stable et facile à gérer, suivez 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 paramètres avancés avec précaution | Évite les modifications personnalisées non supportées | + +:::tip Gardez vos déploiements organisés +Si vous prévoyez d’héberger beaucoup d’apps, créez un schéma de nommage clair pour `[your_project_name]`, `[your_environment_name]` et `[your_app_name]` avant de déployer vos premiers services. +::: + +## Conclusion + +Félicitations, vous avez configuré et utilisé avec succès l’installateur d’apps en un clic pour VPS afin de déployer et gérer des apps sur votre serveur. Pour toute question ou assistance, n’hésitez pas à contacter notre équipe support, disponible tous les jours pour vous aider ! + + \ No newline at end of file diff --git a/i18n/it/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/it/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..8346b55f1 --- /dev/null +++ b/i18n/it/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-one-click-apps-installer +title: "VPS: One Click Apps Installer" +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: One Click App Installer +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introduzione + +Il One Click Apps Installer ti permette di sfogliare un ampio 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 corretto, installare e gestire le app, e utilizzare le impostazioni avanzate e gli strumenti di risoluzione problemi quando necessario. + + + +## 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 funzionalità app richiede che il tuo VPS sia online e configurato con risorse sufficienti per eseguire in modo affidabile sia i servizi della piattaforma che le app installate. +::: + +| Requisito | Minimo | Consigliato | +| --- | --- | --- | +| Stato server | Online | Online | +| Spazio di archiviazione | 30 GB | 50 GB | +| RAM | 2 GB | 4 GB | +| CPU | 2 core | 4 core | +| Sistema operativo | Debian o Ubuntu LTS | Debian 13 - EN - 64bit | + +:::caution Consigliata Installazione Pulita del Sistema Operativo +Si consiglia vivamente di configurare la funzionalità app su un’installazione pulita 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 procedere, usa un’immagine fresca e supportata di Debian o Ubuntu LTS dal pannello di gestione del 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 qui puoi avviare la configurazione iniziale e successivamente gestire tutte le app installate sul server. + +La prima volta che apri questa funzionalità, 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 corretta dipende dal fatto che il 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 funzionalità app per la prima volta e per la maggior parte delle installazioni standard. + +Con questo metodo puoi: + +- distribuire app dal catalogo +- 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 necessario + +![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 funzionalità app, seleziona l’installazione completa. Offre la configurazione più semplice e ti dà il controllo completo 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à in uso + +:::note Opzione Avanzata di Distribuzione +L’installazione solo nodo è pensata per utenti che hanno già un’altra istanza di pannello disponibile o che vogliono collegare questo server a un ambiente esterno. +::: + +## Installazione della Funzionalità 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 il One Click Apps vengono distribuiti sul tuo VPS. Al termine, 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 si completa con successo, consulta la sezione risoluzione problemi più avanti in questa guida. +::: + +## Navigazione 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 la distribuzione 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 la selezione in un’interfaccia in stile app store e a trovare il target di distribuzione più adatto al tuo progetto. + +Le azioni tipiche includono: + +- ricerca per nome app +- filtro per categoria +- revisione delle voci app disponibili +- selezione di un’app per la distribuzione + +Questo flusso di lavoro è particolarmente utile se gestisci molti target di app o confronti più servizi prima di installarli. + +### Avvio dell’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 segnaposto rappresentano valori specifici per la tua distribuzione. Per esempio, `[your_domain]` deve essere sostituito con il dominio che vuoi usare per l’app. + +:::tip Progetti e Ambienti +Usa progetti e ambienti per mantenere organizzata la tua distribuzione. È particolarmente utile se ospiti più app, versioni di test o separi servizi di produzione e staging. +::: + +## Gestione delle App Installate + +Dopo la distribuzione, 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 di ciclo di vita 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 la risoluzione problemi | +| Reinstalla | Ridistribuisce l’app | + +Questi strumenti facilitano la gestione di tutte le app da un unico posto, specialmente se preferisci un controllo semplice via web invece di amministrare manualmente da linea di comando. + +### Organizzazione di Progetti e Ambienti + +Progetti e ambienti ti aiutano a strutturare chiaramente le tue distribuzioni. Puoi usarli per separare: + +- app personali e di produzione +- ambienti di test e live +- distribuzioni 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 funzionalità 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 le tue distribuzioni. + +:::info Supporto per 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 alla tua 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à aggiuntive tramite il pannello esterno disponibile nella sezione impostazioni avanzate. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Questo può essere utile se hai bisogno di personalizzazioni più profonde, controllo esteso della distribuzione o accesso diretto a funzionalità oltre l’interfaccia web standard. + +### Importante Limitazione del Supporto + +:::caution Ambito del Supporto per l’Uso del Pannello Avanzato +Gli utenti avanzati sono liberi di utilizzare il pannello esterno Coolify per personalizzazioni e funzionalità aggiuntive. Tuttavia, il supporto è limitato all’interfaccia web di ZAP-Hosting. Se apporti modifiche fuori dall’interfaccia web, l’assistenza potrebbe non essere disponibile per quelle modifiche personalizzate. +::: + +### Quando Usare il Pannello Avanzato + +Potresti voler usare il pannello avanzato se ti servono: + +- personalizzazioni di distribuzione più dettagliate +- flussi di lavoro diretti per il collegamento dei nodi +- configurazioni avanzate delle app +- gestione a livello di pannello oltre l’interfaccia semplificata + +Se perdi l’accesso o l’integrazione smette di rispondere, usa prima gli strumenti di risoluzione problemi 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 dei nodi è utile quando vuoi: + +- distribuire app su più VPS +- centralizzare la gestione +- espandere la capacità senza creare distribuzioni isolate +- connetterti a un ambiente di pannello esterno + +:::note Collegamento a Pannello Esterno +Puoi collegare il tuo 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 alimenta la funzionalità One Click Apps. Segui i passaggi di risoluzione problemi in ordine cronologico. + +### Indicatori di Stato + +Il popup di risoluzione problemi può mostrare indicatori come i seguenti: + +| Stato | Significato | +| --- | --- | +| Stato Coolify: Attivo | Il servizio del pannello sembra essere in esecuzione | +| Stato API: Accessibile | L’API è attualmente raggiungibile | +| Stato Servizio: Online | Il VPS stesso è online | + +Se una o più parti non funzionano correttamente, continua con i passaggi seguenti. + +### Passo 1: Conferma che il VPS sia Online + +Per prima cosa, 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 eseguire nuovamente il controllo di integrità con i dati più recenti. Questo può risolvere problemi temporanei e intermittenti. + +:::tip Problemi Temporanei di Connessione +Uno stato degradato può a volte essere causato da un problema di comunicazione di breve durata. Aggiornare lo stato è il primo controllo più veloce. +::: + +### Passo 3: Riavvia Docker + +Se lo stato rimane degradato, usa l’azione **Riavvia Docker**. Questo forza il riavvio dell’istanza della piattaforma. Dopo una risposta positiva, attendi `1-2 minuti` e aggiorna di nuovo lo stato. + +:::caution Riavvio del 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 delle app non funzionano. + +Questa azione: + +- **non** cancella i tuoi dati +- aggiorna le credenziali dell’utente root +- aggiorna il token API usato dall’interfaccia web +- aggiorna automaticamente le credenziali del pannello in caso di successo + +:::info Aggiornamento Sicuro delle Credenziali +Aggiornare le credenziali non rimuove le app installate o i dati di distribuzione. Rinnova solo le credenziali necessarie per l’accesso e la comunicazione. +::: + +### Quando Contattare il Supporto + +Se il problema persiste dopo aver completato tutti i passaggi di risoluzione problemi, 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 pulita del sistema operativo | Riduce conflitti con servizi e porte esistenti | +| Soddisfa le risorse consigliate | Migliora prestazioni e affidabilità | +| Organizza le app in progetti e ambienti | Mantiene gestibili le distribuzioni | +| Configura il DNS prima di assegnare domini | Previene problemi di accesso e SSL | +| Usa con cautela le impostazioni avanzate | Evita modifiche personalizzate non supportate | + +:::tip Mantieni le Distribuzioni Organizzate +Se prevedi di ospitare molte app, crea uno schema di denominazione chiaro per `[your_project_name]`, `[your_environment_name]` e `[your_app_name]` prima di distribuire i primi servizi. +::: + +## Conclusione + +Congratulazioni, hai configurato e utilizzato con successo il VPS One Click Apps Installer per distribuire e gestire app sul tuo server. Per ulteriori domande o assistenza, non esitare a contattare il nostro team di supporto, disponibile ogni giorno per aiutarti! + + \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/ja/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..9877a1eaf --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-one-click-apps-installer +title: "VPS: ワンクリックアプリインストーラー" +description: "VPSのワンクリックアプリインストーラーでアプリを展開し、ウェブインターフェースでプロジェクトを管理し、Coolifyを使った高度なアプリ管理を行う方法を今すぐ学びましょう" +sidebar_label: ワンクリックアプリインストーラー +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introduction + +ワンクリックアプリインストーラーを使うと、豊富なアプリカタログから直接VPSのウェブインターフェースでアプリを展開できます。このガイドでは、サーバーの準備、適切なインストールタイプの選択、アプリのインストールと管理、必要に応じた高度な設定やトラブルシューティングツールの使い方を学びます。 + + + +## Preparation + +ワンクリックアプリインストーラーを使用する前に、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の新規イメージを使用してください。 + +## Accessing the One Click Apps Installer + +ZAP-HostingのウェブインターフェースでVPSを開き、ワンクリックアプリセクションを探します。ここから初期セットアップを開始し、後でサーバーにインストールされたすべてのアプリを管理できます。 + +初めてこの機能を開くと、プラットフォームのインストール方法を選択する必要があります。 + +## Choosing an Installation Type + +フルインストールとノードのみインストールのどちらかを選択できます。どちらを選ぶかは、このVPSが管理パネルとアプリの両方をホストするか、別のパネルのリンクノードとしてのみ機能するかによります。 + +### Full Installation + +管理パネルとノードとしてのサーバーをセットアップしたい場合は、**フルインストール**を選択してください。初めてのユーザーや標準的な展開に推奨されるオプションです。 + +この方法でできること： + +- アプリカタログからアプリを展開 +- プロジェクトと環境を管理 +- すべてのアプリを一元管理 +- 統合されたウェブインターフェース管理ツールを使用 +- 必要に応じて高度なパネルにアクセス可能 + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip ほとんどのユーザーに推奨 +アプリ機能を初めて使う場合はフルインストールを選択してください。最も簡単なセットアップで、ZAP-Hostingのウェブインターフェースから完全な管理が可能です。 +::: + +### Node-only Installation + +このVPSをノードとしてのみ使いたい場合は、**ノードのみインストール**を選択します。別のVPSサーバーや外部パネルインスタンスにリンクできます。 + +このオプションは以下の用途に便利です： + +- 複数のVPSにまたがるスケールアウト +- 管理を一つのパネルに集中 +- 既存の展開にこのサーバーをリンク +- マルチノード構成の拡張 + +:::note 上級者向け展開オプション +ノードのみインストールは、すでに別のパネルインスタンスを持っているか、外部環境に接続したいユーザー向けです。 +::: + +## Installing the Apps Feature + +インストールタイプを選択したら、ウェブインターフェースからセットアップを開始します。初期インストールは通常数分で完了します。 + +このプロセス中に、ワンクリックアプリ機能に必要なプラットフォームサービスがVPSに展開されます。完了すると、ウェブインターフェースにアプリカタログと管理セクションが表示されます。 + +:::info インストールの挙動 +インストールの進行状況はVPSの性能、OSの状態、ネットワーク状況によって異なる場合があります。セットアップが正常に完了しない場合は、このガイドのトラブルシューティングセクションを参照してください。 +::: + +## Browsing the App Catalogue + +インストール完了後、アプリカタログを開いて利用可能なアプリを閲覧できます。カタログには300以上の即展開可能なアプリがあり、フィルター機能で目的のアプリを素早く見つけられます。 + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Searching and Filtering Apps + +カタログ内ではアプリ名で検索したり、カテゴリで絞り込みができます。これにより、アプリストア風のインターフェースで展開対象を効率的に絞り込めます。 + +よく使う操作： + +- アプリ名で検索 +- カテゴリでフィルター +- 利用可能なアプリの確認 +- 展開したいアプリの選択 + +多くのアプリ展開先を管理したり、複数サービスを比較検討する際に特に便利です。 + +### Starting an App Installation + +カタログからアプリを選択したら、ウェブインターフェースでインストールを開始します。アプリによっては以下のような値を指定する必要があります： + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +これらは展開に特化した値で、例えば`[your_domain]`はアプリで使いたいドメインに置き換えてください。 + +:::tip プロジェクトと環境の活用 +複数のアプリをホストしたり、バージョンのテスト、運用とステージングの分離にプロジェクトと環境を使うと展開が整理しやすくなります。 +::: + +## Managing Installed Apps + +展開後、インストール済みアプリはウェブインターフェースの管理セクションに一覧表示されます。ここから、基盤のコンテナを直接操作せずにサービスの監視や制御が可能です。 + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Available Management Actions + +インストール済みアプリセクションでは、一般的なライフサイクル操作をウェブインターフェースから直接行えます。 + +| 操作 | 目的 | +| --- | --- | +| 起動 | 停止中のアプリを起動 | +| 停止 | 実行中のアプリを停止 | +| ログ確認 | トラブルシューティング用にアプリログを開く | +| 再インストール | アプリを再展開 | + +これらのツールにより、コマンドライン操作なしで一元的にアプリ管理が簡単になります。 + +### Organizing Projects and Environments + +プロジェクトと環境は展開を明確に構造化するのに役立ちます。以下のように分けて使えます： + +- 個人用と本番用アプリ +- テスト環境とライブ環境 +- 複数の顧客やチームの展開 +- 同一VPS上の異なるスタック + +アプリストアのアプリ数が増え、複数ノードで管理する際に特に重要になります。 + +## Domains, Cloud Access, and 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]`を指していない場合、ドメイン認証やアプリアクセスに失敗します。 +::: + +## Using Advanced Settings + +上級ユーザーは高度な設定セクションから外部パネルにアクセスして、より詳細なカスタマイズや展開制御が可能です。 + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +標準のウェブインターフェースを超えた機能や直接操作が必要な場合に便利です。 + +### Important Support Limitation + +:::caution 高度なパネル利用時のサポート範囲 +外部Coolifyパネルの利用は歓迎しますが、サポートはZAP-Hostingのウェブインターフェースに限定されます。ウェブインターフェース外での変更にはサポートが提供されない場合があります。 +::: + +### When to Use the Advanced Panel + +以下のような場合に高度なパネルを使うと良いでしょう： + +- 詳細な展開カスタマイズが必要 +- ノードリンクの直接操作 +- 高度なアプリ設定 +- 簡易インターフェースを超えたパネル管理 + +アクセスを失ったり連携が停止した場合は、手動変更前に下記のトラブルシューティングを試してください。 + +## Linking Nodes + +ノードのみインストールを選択した場合、このVPSを別のVPSや外部パネルにリンクできます。これによりインフラをスケールし、複数ノードを一元管理可能です。 + +ノードリンクは以下の用途に便利です： + +- 複数VPSにアプリを分散 +- 管理を集中化 +- 孤立展開を作らずに拡張 +- 外部パネル環境に接続 + +:::note 外部パネルリンク +ノードは別VPSや外部パネルにリンク可能です。リンクの詳細は既存の環境に依存します。 +::: + +## Troubleshooting Degraded Status + +ウェブインターフェースで状態が劣化している場合、プラットフォームがOne Click Apps機能を動かすインスタンスに接続できていません。以下の手順を順に実施してください。 + +### Status Indicators + +トラブルシューティングのポップアップには以下のような状態が表示されます： + +| ステータス | 意味 | +| --- | --- | +| Coolify Status: Active | パネルサービスが稼働中の可能性あり | +| API Status: Accessible | APIに現在アクセス可能 | +| Service Status: Online | VPS自体がオンライン | + +いずれかが正常でない場合は次の手順へ進みます。 + +### Step 1: Confirm the VPS Is Online + +まず、ZAP-HostingのウェブインターフェースでVPSがオンラインであることを確認してください。サーバーがオフラインの場合、アプリプラットフォームは機能しません。 + +### Step 2: Refresh the Status + +**ステータス更新**操作で最新データによるヘルスチェックを再実行します。これで一時的な通信障害が解消されることがあります。 + +:::tip 一時的な接続問題の可能性 +劣化状態は短時間の通信問題が原因の場合があります。まずはステータス更新を試すのが最速です。 +::: + +### Step 3: Restart Docker + +状態が改善しない場合は**Docker再起動**を実行してください。プラットフォームインスタンスが再起動されます。成功後は`1-2分`待ってから再度ステータスを更新します。 + +:::caution サービス再起動の注意 +Docker再起動中は実行中のアプリが一時的に停止する可能性があります。 +::: + +### Step 4: Refresh Credentials + +最後に**認証情報の更新**を行います。状態がオンラインでもアプリインストールなどの機能が動作しない場合に特に重要です。 + +この操作は： + +- データを削除しません +- rootユーザーの認証情報を更新 +- ウェブインターフェースが使うAPIトークンを更新 +- 成功時にパネル認証情報を自動更新 + +:::info 認証情報更新は安全 +認証情報の更新はインストール済みアプリや展開データを削除しません。アクセスと通信に必要な認証情報のみを更新します。 +::: + +### When to Contact Support + +すべてのトラブルシューティングを試しても問題が解決しない場合は、ZAP-Hostingのウェブサイトからサポートチケットを作成してください。 + +## Best Practices + +ワンクリックアプリインストーラーを安定して管理しやすく保つために、以下の推奨事項を守ってください： + +| ベストプラクティス | 理由 | +| --- | --- | +| 新規OSインストールを使う | 既存サービスやポートとの競合を減らすため | +| 推奨リソースを満たす | パフォーマンスと信頼性向上のため | +| アプリをプロジェクトと環境で整理 | 展開管理を簡単にするため | +| ドメイン割り当て前にDNS設定を済ませる | アクセスとSSL問題を防ぐため | +| 高度な設定は慎重に使う | サポート対象外のカスタム変更を避けるため | + +:::tip 展開を整理しよう +多くのアプリをホストする場合は、最初に`[your_project_name]`、`[your_environment_name]`、`[your_app_name]`の命名ルールを決めておくと便利です。 +::: + +## Conclusion + +おめでとうございます。VPSのワンクリックアプリインストーラーを使って、サーバー上でアプリを展開・管理することに成功しました。ご不明点やサポートが必要な場合は、毎日対応しているサポートチームまでお気軽にお問い合わせください！ + + \ No newline at end of file diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/nl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..34c8c52f5 --- /dev/null +++ b/i18n/nl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-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'; + +## Introductie + +De One Click Apps Installer laat je een uitgebreide app-catalogus doorzoeken en apps direct vanuit je VPS-webinterface uitrollen. 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. + + + +## Voorbereiding + +Voordat je de One Click Apps Installer gebruikt, moet je VPS aan de minimale eisen voldoen en een ondersteund besturingssysteem gebruiken. + +:::info Minimale Vereisten +De apps-functie vereist dat je VPS online is en voldoende 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 - EN - 64bit | + +:::caution Verse OS Installatie Aanbevolen +Het wordt sterk aanbevolen om de apps-functie op een verse besturingssysteeminstallatie op te zetten. Dit voorkomt conflicten met bestaande services, bezette poorten, Docker-omgevingen of aangepaste configuraties die al op de server aanwezig zijn. +::: + +Als je je VPS opnieuw moet installeren voordat je verdergaat, gebruik dan een verse ondersteunde Debian- of Ubuntu LTS-image vanuit 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 kun je de initiële setup starten en later terugkeren om alle geïnstalleerde apps op de server te beheren. + +De eerste keer dat je deze functie opent, moet je kiezen hoe het platform op je VPS geïnstalleerd moet worden. + +## Keuze van Installatietype + +Je kunt kiezen tussen een volledige installatie en een node-only installatie. De juiste optie hangt af van of deze VPS zowel het beheerpaneel als de apps moet hosten, of alleen als gekoppelde node voor een ander paneel moet fungeren. + +### Volledige Installatie + +Kies **Volledige Installatie** als je de server wilt opzetten met het paneel en 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 uitrollen +- projecten en omgevingen beheren +- alle apps op één plek organiseren +- gebruikmaken van geïntegreerde webinterface beheertools +- 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 dit je eerste keer is dat je de apps-functie gebruikt, kies dan voor de volledige installatie. Dit biedt de eenvoudigste setup en geeft je volledige beheer 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 deze dan koppelen aan een andere VPS-server of een externe paneelinstantie. + +Deze optie is handig als je wilt: + +- schalen over meerdere VPS-systemen +- beheer centraliseren op één paneel +- deze server koppelen aan een bestaande deployment +- een bestaand multi-node systeem uitbreiden + +:::note Geavanceerde Deployment Optie +Node-only installatie is bedoeld voor gebruikers die al een ander paneel beschikbaar hebben of deze server willen koppelen aan een externe omgeving. +::: + +## Installeren van de Apps-functie + +Na het kiezen van het installatietype start je de setup vanuit 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 voltooid is, worden de app-catalogus en beheersecties beschikbaar in de webinterface. + +:::info Installatiegedrag +De exacte voortgang van de installatie kan variëren afhankelijk van de prestaties van je VPS, de staat van het besturingssysteem en netwerkcondities. Als de setup niet succesvol voltooid wordt, bekijk dan later de troubleshooting-sectie in deze gids. +::: + +## De App-catalogus Doorzoeken + +Zodra de installatie voltooid is, kun je de app-catalogus openen en de beschikbare apps doorzoeken. De catalogus bevat meer dan 300 direct uitrolbare 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. Dit helpt je om alle apps in de app-store-achtige interface te beperken en de juiste deployment voor je project te vinden. + +Typische acties zijn: + +- zoeken op app-naam +- filteren op categorie +- beschikbare app-entries bekijken +- een app selecteren voor installatie + +Deze workflow is vooral handig als je veel apps beheert of meerdere services vergelijkt voor installatie. + +### Een App Installeren + +Na het selecteren van een app uit de catalogus, start je de installatie via de webinterface. Afhankelijk van de app moet je mogelijk waarden definiëren 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]` moet je vervangen door het domein dat je voor de app wilt gebruiken. + +:::tip Projecten en Omgevingen +Gebruik projecten en omgevingen om je deployment georganiseerd te houden. Dit is vooral handig als je meerdere apps host, versies test of productie- en staging-services scheidt. +::: + +## Beheren van Geïnstalleerde Apps + +Na deployment worden je geïnstalleerde apps weergegeven in de beheersectie van de webinterface. Vanaf hier kun je je services monitoren en beheren zonder handmatig met de onderliggende containers te werken. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Beschikbare Beheeracties + +De sectie voor geïnstalleerde apps laat je veelvoorkomende lifecycle-acties direct vanuit de webinterface uitvoeren. + +| Actie | Doel | +| --- | --- | +| Start | Start een gestopte app | +| Stop | Stopt een draaiende app | +| Logs bekijken | Opent de app-logs voor troubleshooting | +| Herinstalleren | Rol de app opnieuw uit | + +Deze tools maken het makkelijker om alle apps vanaf één plek te beheren, vooral als je eenvoudige webgebaseerde controle wilt in plaats van handmatige command line administratie. + +### Projecten en Omgevingen Organiseren + +Projecten en omgevingen helpen je om je deployments overzichtelijk te structureren. 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 organisatie wordt steeds belangrijker naarmate je app-store 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. Dit stelt je in staat om apps veilig bloot te stellen en SSL-certificaten voor je deployments te regelen. + +:::info Domein- en SSL-ondersteuning +Je kunt custom domeinen gebruiken voor je apps en profiteren van SSL-certificaat provisioning waar dit door de platformsetup wordt ondersteund. +::: + +Bij het toewijzen van een domein moet je ervoor zorgen dat je DNS-records naar `[your_server_ip]` wijzen. Als je domein niet correct is geconfigureerd, kan de app niet bereikbaar worden vanaf het 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 dat beschikbaar is in de geavanceerde instellingen. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Dit is handig als je diepere aanpassingen, uitgebreidere deploymentcontrole of directe toegang tot functies buiten de standaard webinterface nodig hebt. + +### Belangrijke Supportbeperking + +:::caution Supportbereik voor Geavanceerd Paneelgebruik +Geavanceerde gebruikers kunnen het externe Coolify-paneel gebruiken voor extra aanpassingen en functionaliteit. Support is echter beperkt tot de ZAP-Hosting webinterface. Als je wijzigingen buiten de webinterface maakt, is ondersteuning voor die aanpassingen mogelijk niet beschikbaar. +::: + +### Wanneer het Geavanceerde Paneel te Gebruiken + +Je wilt het geavanceerde paneel gebruiken als je: + +- meer gedetailleerde deployment-aanpassingen nodig hebt +- directe node-koppelingsworkflows wilt +- geavanceerde app-configuratie wilt +- paneelbeheer wilt dat verder gaat dan de vereenvoudigde interface + +Als je de toegang verliest of de integratie niet meer reageert, gebruik dan eerst de troubleshooting-tools hieronder voordat je handmatige wijzigingen maakt. + +## Nodes Koppelen + +Als je het node-only installatietype hebt gekozen, kun je deze VPS koppelen aan een andere VPS-server of een externe paneelinstantie. Dit stelt je in staat om je infrastructuur te schalen en meerdere nodes vanaf één locatie te beheren. + +Node-koppeling is handig als je wilt: + +- apps verspreiden over meerdere VPS-systemen +- beheer centraliseren +- capaciteit uitbreiden zonder geïsoleerde deployments te maken +- koppelen aan een externe paneelomgeving + +:::note Externe Paneelkoppeling +Je kunt je node koppelen aan een andere VPS of een externe paneelinstantie. De exacte koppelingsdetails hangen af van de reeds gebruikte doelomgeving. +::: + +## Troubleshooting bij Verlaagde Status + +Als de webinterface een verlaagde status toont, betekent dit dat het platform geen contact kan maken met of geen 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 lijkt te draaien | +| API Status: Toegankelijk | De API is momenteel bereikbaar | +| Service Status: Online | Je VPS zelf is online | + +Als één of meerdere onderdelen niet correct functioneren, ga dan verder met de onderstaande stappen. + +### Stap 1: Bevestig dat de VPS Online Is + +Controleer eerst of je VPS-service online is in de ZAP-Hosting webinterface. Als de server offline is, kan het apps-platform niet functioneren. + +### Stap 2: Vernieuw de Status + +Gebruik de actie **Status Vernieuwen** om de healthcheck opnieuw uit te voeren met de nieuwste data. Dit kan tijdelijke, intermitterende problemen oplossen. + +:::tip Tijdelijke Connectiviteitsproblemen +Een verlaagde status kan soms veroorzaakt worden door een kortdurend communicatieprobleem. Het vernieuwen van de status is de snelste eerste check. +::: + +### Stap 3: Herstart Docker + +Als de status nog steeds verlaagd is, gebruik dan de actie **Docker Herstarten**. Dit forceert een herstart van de platforminstantie. Wacht na een succesvolle respons `1-2 minuten` en vernieuw de status opnieuw. + +:::caution Service Herstart +Het herstarten van Docker kan lopende apps tijdelijk onderbreken terwijl de services opnieuw opstarten. +::: + +### Stap 4: Vernieuw Referenties + +Als laatste stap gebruik je **Referenties Vernieuwen**. Dit is vooral belangrijk als de status online lijkt, maar functies in de webinterface zoals app-installatie niet werken. + +Deze actie: + +- verwijdert je data **niet** +- vernieuwt de root-gebruikersreferenties +- vernieuwt het API-token dat door de webinterface wordt gebruikt +- werkt de panelreferenties automatisch bij bij succes + +:::info Veilige Referentie Vernieuwing +Het vernieuwen van referenties verwijdert je geïnstalleerde apps of deploymentdata niet. Het vernieuwt alleen de benodigde referenties voor toegang en communicatie. +::: + +### Wanneer Contact Opnemen met Support + +Als het probleem blijft bestaan nadat je alle troubleshooting-stappen hebt doorlopen, maak dan een supportticket aan via de ZAP-Hosting website. + +## Best Practices + +Om de One Click Apps Installer stabiel en makkelijk beheersbaar te houden, volg je deze aanbevelingen: + +| Best practice | Reden | +| --- | --- | +| Gebruik een verse OS-installatie | Vermindert conflicten met bestaande services en poorten | +| Voldoe aan aanbevolen resources | Verbetert prestaties en betrouwbaarheid | +| Organiseer apps in projecten en omgevingen | Houdt deployments beheersbaar | +| Configureer DNS vóór domeintoewijzing | Voorkomt toegang- en SSL-problemen | +| Gebruik geavanceerde instellingen voorzichtig | Voorkomt niet-ondersteunde aanpassingen | + +:::tip Houd Deployments Georganiseerd +Als je van plan bent veel apps te hosten, maak dan een duidelijke naamgevingsstructuur 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 uit te rollen en te beheren. Voor verdere vragen of hulp kun je altijd contact opnemen met onze supportafdeling, die dagelijks voor je klaarstaat! + + \ No newline at end of file diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/pl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..05a931a6f --- /dev/null +++ b/i18n/pl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-one-click-apps-installer +title: "VPS: Instalator aplikacji One Click" +description: "Wdrażaj aplikacje za pomocą instalatora One Click Apps na VPS, zarządzaj projektami przez interfejs webowy i korzystaj z Coolify do zaawansowanego zarządzania aplikacjami -> Dowiedz się więcej" +sidebar_label: Instalator One Click Apps +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Wprowadzenie + +Instalator One Click Apps pozwala przeglądać rozbudowany katalog aplikacji i wdrażać je bezpośrednio z panelu webowego VPS. W tym poradniku nauczysz 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. + + + +## Przygotowanie + +Przed użyciem instalatora One Click Apps 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 niezawodnego uruchomienia zarówno usług platformy, jak i zainstalowanych aplikacji. +::: + +| Wymaganie | Minimum | Zalecane | +| --- | --- | --- | +| Status serwera | Online | Online | +| Pamięć dyskowa | 30 GB | 50 GB | +| 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 +Zaleca się 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 One Click Apps + +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ć, aby 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 użytkowników po raz pierwszy 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 +- uzyskać 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ę. Zapewnia najprostszy setup i 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 +- połączyć ten serwer z istniejącym wdrożeniem +- 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ą podłączyć serwer do zewnętrznego środowiska. +::: + +## 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 VPS wdrażane są usługi platformy wymagane do działania funkcji One Click Apps. Po zakończeniu katalog aplikacji i sekcje zarządzania stają 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 powiedzie się, zapoznaj się z 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 umożliwia filtrowanie, aby szybko znaleźć odpowiednią 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ć według kategorii. Pomaga to zawęzić listę dostępnych aplikacji i znaleźć właściwy 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, jeśli 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 pola to 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 wdrożeniach. Jest to szczególnie pomocne, gdy hostujesz wiele aplikacji, testujesz wersje lub oddzielasz środowiska produkcyjne i testowe. +::: + +## 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 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 przeglądarkę zamiast ręcznej administracji w terminalu. + +### Organizacja projektów i środowisk + +Projekty i środowiska pomagają jasno uporządkować 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 i zarządzasz wieloma usługami na jednym lub kilku węzłach. + +## Domeny, dostęp do chmury i SSL + +Funkcja One Click Apps obsługuje własne domeny i integrację z ZAP Cloud. Pozwala to na bezpieczne udostępnianie aplikacji i automatyczne wystawianie certyfikatów SSL dla 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 platforma to wspiera. +::: + +Przy przypisywaniu domeny upewnij się, że rekordy DNS wskazują na `[your_server_ip]`. Jeśli domena nie jest poprawnie skonfigurowana, aplikacja może być niedostępna z internetu. + +| Wartość | Opis | +| --- | --- | +| `[your_domain]` | Domenę lub subdomenę przypisaną 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 dodatkowej funkcjonalności przez zewnętrzny panel dostępny w sekcji zaawansowanych ustawień. + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +Jest 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 dokonasz zmian poza panelem webowym, pomoc w zakresie tych modyfikacji może nie być dostępna. +::: + +### Kiedy używać zaawansowanego panelu + +Możesz chcieć użyć zaawansowanego panelu, jeśli potrzebujesz: + +- bardziej szczegółowej personalizacji wdrożenia +- 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 z narzędzi do rozwiązywania problemów opisanych poniżej, zanim wykonasz 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 środowiska docelowego już używanego. +::: + +## Rozwiązywanie problemów ze stanem obniżonej jakości + +Jeśli panel webowy pokazuje stan obniżonej jakości, oznacza to, że platforma nie może skontaktować się 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 + +Okno rozwiązywania problemów może pokazywać takie wskaźniki: + +| Status | Znaczenie | +| --- | --- | +| Stan Coolify: Aktywny | Usługa panelu działa | +| Stan API: Dostępne | API jest obecnie osiągalne | +| Stan 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 może 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 obniżonej jakości może być spowodowany krótkotrwałym problemem komunikacyjnym. Odświeżenie statusu to najszybsza pierwsza kontrola. +::: + +### Krok 3: Uruchom ponownie Dockera + +Jeśli status nadal jest obniżony, użyj akcji **Uruchom ponownie Dockera**. Wymusza to restart instancji platformy. Po pozytywnej odpowiedzi odczekaj `1-2 minuty` i ponownie odśwież status. + +:::caution Restart usługi +Restart Dockera może tymczasowo przerwać działanie uruchomionych aplikacji podczas restartu usług. +::: + +### Krok 4: Odśwież dane uwierzytelniające + +Na koniec użyj **Odśwież dane uwierzytelniające**. Jest to szczególnie ważne, jeśli status pokazuje online, ale funkcje panelu webowego, takie jak instalacja aplikacji, nie działają. + +Ta akcja: + +- **nie** usuwa Twoich danych +- odświeża dane uwierzytelniające użytkownika root +- odświeża token API używany przez panel webowy +- automatycznie aktualizuje dane uwierzytelniające panelu po sukcesie + +:::info Bezpieczne odświeżanie danych uwierzytelniających +Odświeżanie danych uwierzytelniających nie usuwa zainstalowanych aplikacji ani danych wdrożenia. 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ć stabilność i łatwość zarządzania instalatorem One Click Apps, 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 niezawodność | +| 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 zmian niestandardowych | + +:::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 One Click Apps 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 wsparcia, który jest dostępny codziennie, aby Ci pomóc! + + \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/pt/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..13151a88a --- /dev/null +++ b/i18n/pt/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-one-click-apps-installer +title: "VPS: Instalador de Apps One Click" +description: "Implemente apps com o Instalador de Apps One Click para VPS, gerencie projetos pela interface web e use o Coolify para gerenciamento avançado -> Saiba mais agora" +sidebar_label: Instalador One Click de Apps +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introdução + +O Instalador de Apps One Click permite que você navegue por um catálogo extenso de apps e implemente-os diretamente pela interface web do seu VPS. Neste guia, você vai aprender a preparar seu servidor, escolher o tipo correto de instalação, instalar e gerenciar apps, além de usar as configurações avançadas e ferramentas de solução de problemas quando necessário. + + + +## Preparação + +Antes de usar o Instalador de Apps One Click, seu VPS deve 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 - EN - 64bit | + +:::caution Recomendação de 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 personalizaçõ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 controle do seu VPS. + +## Acessando o Instalador de Apps One Click + +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 retornar para gerenciar todos os apps instalados no servidor. + +Na primeira vez que abrir esse recurso, será necessário 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 controle 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ó. Esta é a opção recomendada para usuários iniciantes e para a maioria das implantações padrão. + +Com este método, você pode: + +- implementar apps do catálogo de apps +- 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 posteriormente, se necessário + +![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 permite gerenciamento completo diretamente pela interface web da ZAP-Hosting. +::: + +### Instalação Apenas como Nó + +Escolha **Instalação Apenas como Nó** se quiser que este VPS atue somente como um nó. Você poderá vinculá-lo a outro servidor VPS ou a uma instância de painel externa. + +Esta opção é útil se você deseja: + +- escalar entre vários sistemas VPS +- centralizar o gerenciamento em um único painel +- vincular este servidor a uma implantação existente +- expandir uma configuração multi-nó já existente + +:::note Opção Avançada de Implantação +A instalação apenas como nó é destinada a usuários que já possuem outra instância de painel disponível ou que querem conectar este servidor a um ambiente externo. +::: + +## Instalando o Recurso de Apps + +Após selecionar 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 seu VPS, estado do sistema operacional e condições da rede. Se a configuração não for concluída com sucesso, consulte a seção de solução de problemas mais adiante neste guia. +::: + +## Navegando pelo Catálogo de Apps + +Quando a instalação estiver completa, 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 implantação e suporta filtros para ajudar a encontrar o app correto rapidamente. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Pesquisando e Filtrando Apps + +No catálogo, você pode buscar apps pelo nome e filtrar por categoria. Isso ajuda a restringir 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 de apps +- selecionar um app para implantação + +Esse fluxo é especialmente útil se você gerencia muitos apps ou compara vários serviços antes da instalação. + +### Iniciando a Instalação de um App + +Após selecionar um app no catálogo, inicie 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 espaços reservados 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 múltiplos apps, versões de teste ou separa serviços de produção e staging. +::: + +## Gerenciando Apps Instalados + +Após a implantação, seus apps instalados aparecem na seção de gerenciamento da interface web. A partir daí, você pode monitorar e controlar seus serviços sem precisar trabalhar manualmente com os containers subjacentes. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Ações de Gerenciamento Disponíveis + +A seção de apps instalados permite executar ações comuns do ciclo de vida diretamente 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 o gerenciamento de todos os apps em um 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 +- implantações para múltiplos clientes ou equipes +- diferentes stacks no mesmo VPS + +Essa organização se torna cada vez mais importante conforme sua coleção de apps cresce e você gerencia mais serviços em um ou mais nós. + +## Domínios, Acesso Cloud e SSL + +O recurso One Click Apps suporta domínios personalizados e integração com a 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 de que seus registros DNS apontem para `[your_server_ip]`. Se seu 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 adicionais 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 implantação 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 adicionais. Porém, o suporte é limitado à interface web da ZAP-Hosting. Se você fizer alterações fora da interface web, a assistência pode não estar disponível para essas modificações personalizadas. +::: + +### Quando Usar o Painel Avançado + +Você pode querer usar o painel avançado se precisar de: + +- personalização detalhada da implantação +- fluxos de trabalho diretos de vinculação de nós +- configuração avançada de apps +- gerenciamento em nível de 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 alterações manuais. + +## Vinculando Nós + +Se você escolheu o tipo de instalação apenas como nó, pode vincular este VPS a outro servidor VPS ou a uma instância de painel externa. Isso permite escalar sua infraestrutura e gerenciar múltiplos nós a partir de um único local. + +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 de painel externo + +:::note Vinculação a Painel Externo +Você pode vincular seu nó a outro VPS ou a uma instância de painel externa. 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 alimenta o recurso One Click Apps. Siga os passos de solução de problemas na ordem cronológica. + +### Indicadores de Status + +O popup de solução de problemas pode mostrar indicadores como os seguintes: + +| Status | Significado | +| --- | --- | +| Status Coolify: Ativo | O serviço do painel parece estar rodando | +| Status API: Acessível | A API pode ser alcançada atualmente | +| Status Serviço: Online | Seu VPS está online | + +Se uma ou mais partes não estiverem funcionando corretamente, continue com os passos abaixo. + +### Passo 1: Confirme que o VPS Está Online + +Primeiro, certifique-se de que seu serviço VPS está online na interface web da ZAP-Hosting. Se o servidor estiver offline, a plataforma de apps não pode funcionar. + +### Passo 2: Atualize o Status + +Use a ação **Atualizar Status** para rodar a verificação de saúde novamente com os dados mais recentes. Isso pode resolver problemas temporários e intermitentes. + +:::tip Problemas Temporários de Conectividade +Um estado degradado pode ser causado por uma falha de comunicação de curta duração. Atualizar o status é a verificação inicial mais rápida. +::: + +### 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 uma resposta bem-sucedida, aguarde `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. + +Esta 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 de solução de problemas, abra um ticket de suporte pelo site da ZAP-Hosting. + +## Melhores Práticas + +Para manter o Instalador de Apps One Click estável e fácil de gerenciar, siga estas 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 alterações personalizadas não suportadas | + +:::tip Mantenha as 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 One Click para VPS para implantar e gerenciar apps no seu servidor. Para dúvidas ou assistência, não hesite em contatar nossa equipe de suporte, que está disponível diariamente para ajudar você! 🙂 + + \ No newline at end of file diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/sv/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..17e74d5fe --- /dev/null +++ b/i18n/sv/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-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 + +One Click Apps Installer låter dig bläddra i ett omfattande appkatalog och distribuera appar direkt från din 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. + + + +## Preparation + +Innan du använder One Click Apps Installer måste din VPS uppfylla minimikraven och använda ett stöds operativsystem. + +:::info Minimala krav +Appfunktionen 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 Rekommenderat med färskt operativsystem +Det rekommenderas starkt att sätta upp appfunktionen 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 din VPS-hanteringspanel. + +## Accessing the One Click Apps Installer + +Öppna din VPS i ZAP-Hostings webbgränssnitt och hitta avsnittet One Click Apps. Där 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 den här funktionen måste du välja hur plattformen ska installeras på din VPS. + +## Choosing an Installation Type + +Du kan välja mellan en fullständig installation och en nod-endast installation. Rätt alternativ beror på om denna VPS ska vara värd för både hanteringspanelen och apparna, eller bara fungera 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 alternativet 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 vid behov + +![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 appfunktionen, 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 endast ska fungera som en nod. Du kan då länka den till en annan VPS-server eller till en extern panelinstans. + +Detta alternativ ä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 installationsalternativ +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ö. +::: + +## Installing the Apps Feature + +Efter att ha valt installationstypen startar du 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, se felsökningsavsnittet senare i guiden. +::: + +## Browsing the App Catalogue + +När installationen är klar kan du öppna appkatalogen och bläddra bland tillgängliga appar. Katalogen innehåller mer än 300 färdiga appar för distribution och stöder filtrering för att snabbt hitta rätt app. + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Searching and Filtering Apps + +I katalogen kan du söka efter appar med namn och filtrera efter kategori. Detta hjälper dig att begränsa alla appar som finns i appbutiksgränssnittet och hitta rätt distributionsmål för ditt projekt. + +Typiska åtgärder inkluderar: + +- söka efter appnamn +- filtrera efter kategori +- granska tillgängliga appposter +- 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. + +### Starting an App Installation + +Efter att ha valt en app från katalogen startar du installationen via webbgränssnittet. Beroende på appen 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 produktions- och stagingtjänster. +::: + +## Managing Installed Apps + +Efter distribution listas dina installerade appar i hanteringssektionen i webbgränssnittet. Härifrån kan du övervaka och kontrollera dina tjänster utan att behöva arbeta manuellt med de underliggande containrarna. + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Available Management Actions + +Sektionen för installerade appar låter dig utföra vanliga livscykelåtgärder direkt från webbgränssnittet. + +| Åtgärd | Syfte | +| --- | --- | +| Start | Startar en stoppad app | +| Stop | Stoppar en körande app | +| Check logs | Öppnar apploggar för felsökning | +| Reinstall | Installerar 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. + +### Organizing Projects and Environments + +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 organisering blir allt viktigare när din samling av appbutiksappar växer och du hanterar fler tjänster på en eller flera noder. + +## Domains, Cloud Access, and SSL + +One Click Apps-funktionen stöder anpassade domäner och ZAP Cloud-integration. Detta gör att du kan exponera appar säkert och tillhandahålla 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-certifikatutfärdande där plattformsuppsättningen stöder 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. +::: + +## Using Advanced Settings + +Avancerade användare kan få tillgång till ytterligare 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 åtkomst till funktioner utöver standardwebbgränssnittet. + +### Important Support Limitation + +:::caution Supportens omfattning för avancerad panelanvändning +Avancerade användare är välkomna att använda den externa Coolify-panelen för ytterligare 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 med dessa anpassningar vara otillgänglig. +::: + +### When to Use the Advanced Panel + +Du kan vilja använda den avancerade panelen om du behöver: + +- mer detaljerad anpassning av distributionen +- direkt nodlänkning +- avancerad appkonfiguration +- panelhantering utöver det förenklade gränssnittet + +Om du förlorar åtkomst eller integrationen slutar svara, använd felsökningsverktygen nedan innan du gör manuella ändringar. + +## Linking Nodes + +Om du valde nod-endast 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. +::: + +## Troubleshooting Degraded Status + +Om webbgränssnittet visar ett degraderat 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. + +### Status Indicators + +Felsökningspopupen kan visa indikatorer som följande: + +| Status | Betydelse | +| --- | --- | +| Coolify Status: Active | Paneltjänsten verkar vara igång | +| API Status: Accessible | API:et är för närvarande tillgängligt | +| Service Status: Online | Din VPS är online | + +Om en eller flera delar inte fungerar korrekt, fortsätt med stegen nedan. + +### Step 1: Confirm the VPS Is Online + +Först, kontrollera att din VPS-tjänst är online i ZAP-Hostings webbgränssnitt. Om servern är offline kan inte appplattformen fungera. + +### Step 2: Refresh the Status + +Använd åtgärden **Refresh Status** för att köra hälsokontrollen igen med den senaste datan. Detta kan lösa tillfälliga intermittentproblem. + +:::tip Tillfälliga anslutningsproblem +Ett degraderat tillstånd kan ibland orsakas av ett kortvarigt kommunikationsproblem. Att uppdatera status är den snabbaste första kontrollen. +::: + +### Step 3: Restart Docker + +Om status fortfarande är degraderad, använd åtgärden **Restart Docker**. Detta tvingar plattformsinstansen att starta om. Efter ett lyckat svar, vänta `1-2 minuter` och uppdatera status igen. + +:::caution Omstart av tjänst +Att starta om Docker kan tillfälligt avbryta körande appar medan tjänsterna startar om. +::: + +### Step 4: Refresh Credentials + +Som sista steg, använd **Refresh Credentials**. Detta är särskilt viktigt om status visas som online men webbgränssnittsfunktioner 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. +::: + +### When to Contact Support + +Om problemet kvarstår efter att ha genomfört alla felsökningssteg, skapa en supportticket via ZAP-Hostings webbplats. + +## Best Practices + +För att hålla One Click Apps Installer stabil och lätt 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 tillförlitlighet | +| 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. +::: + +## Conclusion + +Grattis, du har framgångsrikt satt upp och använt VPS One Click Apps Installer för att distribuera och hantera appar på din server. För ytterligare 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/verver-one-click-apps-installer.md b/i18n/th/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..8cbb4e206 --- /dev/null +++ b/i18n/th/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,284 @@ +--- +id: verver-one-click-apps-installer +title: "VPS: ตัวติดตั้งแอปด้วยคลิกเดียว" +description: "ติดตั้งแอปด้วยตัวติดตั้งแอปคลิกเดียวของ VPS จัดการโปรเจกต์ผ่านเว็บอินเทอร์เฟซ และใช้ Coolify สำหรับการจัดการแอประดับสูง -> เรียนรู้เพิ่มเติมตอนนี้" +sidebar_label: ตัวติดตั้งแอปคลิกเดียว +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## Introduction + +ตัวติดตั้งแอปคลิกเดียวช่วยให้คุณเรียกดูแคตตาล็อกแอปขนาดใหญ่และติดตั้งแอปโดยตรงจากเว็บอินเทอร์เฟซของ VPS ในคู่มือนี้ คุณจะได้เรียนรู้วิธีเตรียมเซิร์ฟเวอร์ เลือกประเภทการติดตั้งที่ถูกต้อง ติดตั้งและจัดการแอป รวมถึงใช้การตั้งค่าขั้นสูงและเครื่องมือแก้ไขปัญหาเมื่อจำเป็น + + + +## Preparation + +ก่อนใช้ตัวติดตั้งแอปคลิกเดียว 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 ของคุณ + +## Accessing the One Click Apps Installer + +เปิด VPS ของคุณในเว็บอินเทอร์เฟซ ZAP-Hosting แล้วค้นหาส่วน One Click Apps จากตรงนั้นคุณสามารถเริ่มการตั้งค่าเริ่มต้นและกลับมาจัดการแอปทั้งหมดที่ติดตั้งบนเซิร์ฟเวอร์ได้ภายหลัง + +ครั้งแรกที่เปิดฟีเจอร์นี้ คุณต้องเลือกวิธีติดตั้งแพลตฟอร์มบน VPS ของคุณ + +## Choosing an Installation Type + +คุณสามารถเลือกได้ระหว่างการติดตั้งแบบเต็มและการติดตั้งเฉพาะโหนด ตัวเลือกที่ถูกต้องขึ้นอยู่กับว่า VPS นี้จะโฮสต์ทั้งแผงควบคุมและแอป หรือทำหน้าที่เป็นโหนดที่เชื่อมต่อกับแผงควบคุมอื่นเท่านั้น + +### Full Installation + +เลือก **Full Installation** หากคุณต้องการตั้งค่าเซิร์ฟเวอร์พร้อมแผงควบคุมและเซิร์ฟเวอร์เองในฐานะโหนด นี่คือทางเลือกที่แนะนำสำหรับผู้ใช้ครั้งแรกและการติดตั้งมาตรฐานส่วนใหญ่ + +ด้วยวิธีนี้ คุณจะสามารถ: + +- ติดตั้งแอปจากแคตตาล็อกแอป +- จัดการโปรเจกต์และสภาพแวดล้อม +- จัดระเบียบแอปทั้งหมดในที่เดียว +- ใช้เครื่องมือจัดการผ่านเว็บอินเทอร์เฟซที่รวมมาให้ +- เข้าถึงแผงควบคุมขั้นสูงได้ในภายหลังหากต้องการ + +![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) + +:::tip แนะนำสำหรับผู้ใช้ส่วนใหญ่ +ถ้านี่เป็นครั้งแรกที่คุณใช้ฟีเจอร์แอป ให้เลือกตัวเลือกติดตั้งแบบเต็ม เพราะเป็นการตั้งค่าที่ง่ายที่สุดและให้การจัดการครบถ้วนโดยตรงจากเว็บอินเทอร์เฟซของ ZAP-Hosting +::: + +### Node-only Installation + +เลือก **Node-only Installation** หากคุณต้องการให้ VPS นี้ทำหน้าที่เป็นโหนดเท่านั้น จากนั้นคุณสามารถเชื่อมต่อกับ VPS อื่นหรือแผงควบคุมภายนอกได้ + +ตัวเลือกนี้เหมาะสำหรับกรณีที่คุณต้องการ: + +- ขยายระบบผ่าน VPS หลายเครื่อง +- รวมศูนย์การจัดการบนแผงควบคุมเดียว +- เชื่อมต่อเซิร์ฟเวอร์นี้กับการติดตั้งที่มีอยู่แล้ว +- ขยายระบบหลายโหนดที่มีอยู่ + +:::note ตัวเลือกการติดตั้งขั้นสูง +การติดตั้งแบบโหนดเท่านั้นเหมาะสำหรับผู้ใช้ที่มีแผงควบคุมอื่นอยู่แล้วหรือผู้ที่ต้องการเชื่อมต่อเซิร์ฟเวอร์นี้กับสภาพแวดล้อมภายนอก +::: + +## Installing the Apps Feature + +หลังเลือกประเภทการติดตั้ง ให้เริ่มการตั้งค่าจากเว็บอินเทอร์เฟซ การติดตั้งเริ่มต้นมักใช้เวลาไม่กี่นาที + +ในขั้นตอนนี้ บริการแพลตฟอร์มที่จำเป็นสำหรับฟีเจอร์ One Click Apps จะถูกติดตั้งบน VPS ของคุณ เมื่อเสร็จสิ้น แคตตาล็อกแอปและส่วนจัดการจะพร้อมใช้งานในเว็บอินเทอร์เฟซ + +:::info พฤติกรรมการติดตั้ง +รายละเอียดความคืบหน้าการติดตั้งอาจแตกต่างกันตามประสิทธิภาพ VPS สถานะระบบปฏิบัติการ และเงื่อนไขเครือข่าย หากการตั้งค่าไม่สำเร็จ ให้ตรวจสอบส่วนแก้ไขปัญหาภายหลังในคู่มือนี้ +::: + +## Browsing the App Catalogue + +เมื่อการติดตั้งเสร็จสิ้น คุณสามารถเปิดแคตตาล็อกแอปและเรียกดูแอปที่มีให้เลือกได้ แคตตาล็อกมีแอปพร้อมติดตั้งมากกว่า 300 รายการและรองรับการกรองเพื่อช่วยให้คุณค้นหาแอปที่ต้องการได้อย่างรวดเร็ว + +![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) + +### Searching and Filtering Apps + +ในแคตตาล็อก คุณสามารถค้นหาแอปตามชื่อและกรองตามหมวดหมู่ ช่วยให้จำกัดแอปทั้งหมดในอินเทอร์เฟซสไตล์สโตร์และหาจุดติดตั้งที่เหมาะสมสำหรับโปรเจกต์ของคุณ + +การทำงานทั่วไปได้แก่: + +- ค้นหาตามชื่อแอป +- กรองตามหมวดหมู่ +- ตรวจสอบรายการแอปที่มี +- เลือกแอปเพื่อติดตั้ง + +เวิร์กโฟลว์นี้มีประโยชน์มากหากคุณจัดการเป้าหมายดาวน์โหลดแอปจำนวนมากหรือเปรียบเทียบบริการหลายตัวก่อนติดตั้ง + +### Starting an App Installation + +หลังเลือกแอปจากแคตตาล็อก ให้เริ่มติดตั้งผ่านเว็บอินเทอร์เฟซ ขึ้นอยู่กับแอป คุณอาจต้องกำหนดค่าต่างๆ เช่น: + +- `[your_project_name]` +- `[your_environment_name]` +- `[your_domain]` +- `[your_app_name]` + +ตัวแปรเหล่านี้แทนค่าที่เฉพาะเจาะจงสำหรับการติดตั้งของคุณ เช่น `[your_domain]` ควรถูกแทนที่ด้วยโดเมนที่คุณต้องการใช้กับแอป + +:::tip โปรเจกต์และสภาพแวดล้อม +ใช้โปรเจกต์และสภาพแวดล้อมเพื่อจัดระเบียบการติดตั้งของคุณ โดยเฉพาะอย่างยิ่งเมื่อคุณโฮสต์แอปหลายตัว ทดสอบเวอร์ชัน หรือแยกบริการระหว่างโปรดักชันและสเตจจิ้ง +::: + +## Managing Installed Apps + +หลังติดตั้ง แอปที่ติดตั้งจะแสดงในส่วนจัดการของเว็บอินเทอร์เฟซ จากตรงนี้คุณสามารถตรวจสอบและควบคุมบริการโดยไม่ต้องจัดการคอนเทนเนอร์ด้วยตนเอง + +![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) + +### Available Management Actions + +ส่วนแอปที่ติดตั้งช่วยให้คุณทำงานวงจรชีวิตทั่วไปได้โดยตรงจากเว็บอินเทอร์เฟซ + +| การกระทำ | จุดประสงค์ | +| --- | --- | +| Start | เริ่มแอปที่หยุดทำงาน | +| Stop | หยุดแอปที่กำลังทำงาน | +| Check logs | เปิดบันทึกแอปเพื่อแก้ไขปัญหา | +| Reinstall | ติดตั้งแอปใหม่ | + +เครื่องมือเหล่านี้ช่วยให้จัดการแอปทั้งหมดได้ง่ายขึ้นจากที่เดียว โดยเฉพาะถ้าคุณต้องการควบคุมผ่านเว็บแทนการใช้คำสั่งด้วยตนเอง + +### Organizing Projects and Environments + +โปรเจกต์และสภาพแวดล้อมช่วยให้คุณจัดโครงสร้างการติดตั้งได้ชัดเจน คุณสามารถใช้แยก: + +- แอปส่วนตัวและแอปโปรดักชัน +- สภาพแวดล้อมทดสอบและใช้งานจริง +- การติดตั้งลูกค้าหรือทีมหลายราย +- สแตกต่างๆ บน VPS เดียวกัน + +การจัดระเบียบนี้สำคัญมากขึ้นเมื่อคอลเลกชันแอปในสโตร์ของคุณเพิ่มขึ้นและคุณจัดการบริการมากขึ้นบนโหนดหนึ่งหรือหลายโหนด + +## Domains, Cloud Access, and 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]` การตรวจสอบโดเมนและการเข้าถึงแอปอาจล้มเหลว +::: + +## Using Advanced Settings + +ผู้ใช้ขั้นสูงสามารถเข้าถึงฟังก์ชันเพิ่มเติมผ่านแผงควบคุมภายนอกที่มีในส่วนการตั้งค่าขั้นสูง + +![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) + +สิ่งนี้มีประโยชน์หากคุณต้องการปรับแต่งลึกขึ้น ควบคุมการติดตั้งขยาย หรือเข้าถึงฟีเจอร์ที่เกินกว่าเว็บอินเทอร์เฟซมาตรฐาน + +### Important Support Limitation + +:::caution ขอบเขตการสนับสนุนสำหรับการใช้แผงควบคุมขั้นสูง +ผู้ใช้ขั้นสูงสามารถใช้แผง Coolify ภายนอกเพื่อปรับแต่งและฟังก์ชันเพิ่มเติมได้ แต่การสนับสนุนจำกัดเฉพาะเว็บอินเทอร์เฟซของ ZAP-Hosting หากคุณเปลี่ยนแปลงนอกเว็บอินเทอร์เฟซ อาจไม่ได้รับความช่วยเหลือสำหรับการปรับแต่งเหล่านั้น +::: + +### When to Use the Advanced Panel + +คุณอาจต้องใช้แผงขั้นสูงหากต้องการ: + +- ปรับแต่งการติดตั้งอย่างละเอียด +- เวิร์กโฟลว์การเชื่อมต่อโหนดโดยตรง +- การตั้งค่าแอประดับสูง +- การจัดการแผงควบคุมที่เกินกว่าหน้าเว็บแบบง่าย + +หากคุณสูญเสียการเข้าถึงหรือการเชื่อมต่อหยุดตอบสนอง ให้ใช้เครื่องมือแก้ไขปัญหาที่อธิบายไว้ด้านล่างก่อนทำการเปลี่ยนแปลงด้วยตนเอง + +## Linking Nodes + +ถ้าคุณเลือกการติดตั้งแบบโหนดเท่านั้น คุณสามารถเชื่อมต่อ VPS นี้กับ VPS อื่นหรือแผงควบคุมภายนอกได้ ช่วยให้ขยายโครงสร้างพื้นฐานและจัดการโหนดหลายตัวจากที่เดียว + +การเชื่อมต่อโหนดเหมาะสำหรับกรณีที่คุณต้องการ: + +- กระจายแอปไปยัง VPS หลายเครื่อง +- รวมศูนย์การจัดการ +- ขยายความจุโดยไม่สร้างการติดตั้งแยก +- เชื่อมต่อกับสภาพแวดล้อมแผงควบคุมภายนอก + +:::note การเชื่อมต่อแผงควบคุมภายนอก +คุณสามารถเชื่อมต่อโหนดกับ VPS อื่นหรือแผงควบคุมภายนอก รายละเอียดการเชื่อมต่อขึ้นอยู่กับสภาพแวดล้อมเป้าหมายที่ใช้งานอยู่แล้ว +::: + +## Troubleshooting Degraded Status + +ถ้าเว็บอินเทอร์เฟซแสดงสถานะเสื่อม หมายความว่าแพลตฟอร์มไม่สามารถติดต่อหรือดึงข้อมูลจากอินสแตนซ์ที่รันฟีเจอร์ One Click Apps ได้ ให้ทำตามขั้นตอนแก้ไขปัญหาเรียงตามลำดับเวลา + +### Status Indicators + +ป๊อปอัปแก้ไขปัญหาอาจแสดงตัวชี้วัดดังนี้: + +| สถานะ | ความหมาย | +| --- | --- | +| Coolify Status: Active | บริการแผงควบคุมดูเหมือนกำลังทำงาน | +| API Status: Accessible | API สามารถเข้าถึงได้ในขณะนี้ | +| Service Status: Online | VPS ของคุณออนไลน์ | + +ถ้าส่วนใดส่วนหนึ่งไม่ทำงาน ให้ดำเนินการตามขั้นตอนด้านล่างต่อไป + +### Step 1: Confirm the VPS Is Online + +ตรวจสอบให้แน่ใจว่า VPS ของคุณออนไลน์ในเว็บอินเทอร์เฟซ ZAP-Hosting หากเซิร์ฟเวอร์ออฟไลน์ แพลตฟอร์มแอปจะไม่ทำงาน + +### Step 2: Refresh the Status + +ใช้คำสั่ง **Refresh Status** เพื่อตรวจสอบสุขภาพระบบอีกครั้งด้วยข้อมูลล่าสุด วิธีนี้ช่วยแก้ไขปัญหาชั่วคราวที่เกิดขึ้นเป็นบางครั้งได้ + +:::tip ปัญหาการเชื่อมต่อชั่วคราว +สถานะเสื่อมอาจเกิดจากปัญหาการสื่อสารชั่วคราว การรีเฟรชสถานะเป็นการตรวจสอบเบื้องต้นที่เร็วที่สุด +::: + +### Step 3: Restart Docker + +ถ้าสถานะยังเสื่อมอยู่ ให้ใช้คำสั่ง **Restart Docker** เพื่อบังคับให้อินสแตนซ์แพลตฟอร์มรีสตาร์ท หลังจากตอบสนองสำเร็จ รอ `1-2 นาที` แล้วรีเฟรชสถานะอีกครั้ง + +:::caution การรีสตาร์ทบริการ +การรีสตาร์ท Docker อาจทำให้แอปที่กำลังรันหยุดชั่วคราวในระหว่างที่บริการกำลังรีสตาร์ท +::: + +### Step 4: Refresh Credentials + +ขั้นตอนสุดท้าย ใช้คำสั่ง **Refresh Credentials** ซึ่งสำคัญมากถ้าสถานะดูออนไลน์แต่ฟังก์ชันในเว็บอินเทอร์เฟซ เช่น การติดตั้งแอป ไม่ทำงาน + +คำสั่งนี้: + +- **ไม่** ลบข้อมูลของคุณ +- รีเฟรชข้อมูลรับรองผู้ใช้ root +- รีเฟรชโทเค็น API ที่เว็บอินเทอร์เฟซใช้ +- อัปเดตข้อมูลรับรองแผงควบคุมโดยอัตโนมัติเมื่อสำเร็จ + +:::info การรีเฟรชข้อมูลรับรองอย่างปลอดภัย +การรีเฟรชข้อมูลรับรองไม่ลบแอปที่ติดตั้งหรือข้อมูลการติดตั้งใดๆ เพียงแค่ต่ออายุข้อมูลรับรองที่จำเป็นสำหรับการเข้าถึงและการสื่อสาร +::: + +### When to Contact Support + +ถ้าปัญหายังไม่หายหลังทำตามขั้นตอนแก้ไขปัญหาทั้งหมด ให้สร้างตั๋วซัพพอร์ตผ่านเว็บไซต์ ZAP-Hosting + +## Best Practices + +เพื่อให้ตัวติดตั้งแอปคลิกเดียวเสถียรและจัดการง่าย ให้ทำตามคำแนะนำเหล่านี้: + +| แนวทางปฏิบัติที่ดีที่สุด | เหตุผล | +| --- | --- | +| ใช้การติดตั้งระบบปฏิบัติการใหม่ | ลดความขัดแย้งกับบริการและพอร์ตที่มีอยู่ | +| ตรงตามทรัพยากรที่แนะนำ | เพิ่มประสิทธิภาพและความเสถียร | +| จัดระเบียบแอปเป็นโปรเจกต์และสภาพแวดล้อม | ทำให้การติดตั้งจัดการง่ายขึ้น | +| ตั้งค่า DNS ก่อนกำหนดโดเมน | ป้องกันปัญหาการเข้าถึงและ SSL | +| ใช้การตั้งค่าขั้นสูงอย่างระมัดระวัง | หลีกเลี่ยงการเปลี่ยนแปลงที่ไม่รองรับ | + +:::tip รักษาการติดตั้งให้เป็นระเบียบ +ถ้าคุณวางแผนโฮสต์แอปจำนวนมาก ให้สร้างระบบตั้งชื่อที่ชัดเจนสำหรับ `[your_project_name]`, `[your_environment_name]` \ No newline at end of file diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/zh/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md new file mode 100644 index 000000000..e3d8cdca8 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md @@ -0,0 +1,291 @@ +--- +id: verver-one-click-apps-installer +title: "VPS：一键应用安装器" +description: "通过 VPS 一键应用安装器部署应用，通过网页界面管理项目，并使用 Coolify 进行高级应用管理 -> 立即了解更多" +sidebar_label: 一键应用安装器 +services: + - vserver +--- + +import InlineVoucher from '@site/src/components/InlineVoucher'; + +## 介绍 + +一键应用安装器让你可以浏览丰富的应用目录，并直接从 VPS 网页界面部署应用。在本指南中，你将学习如何准备服务器、选择正确的安装类型、安装和管理应用，以及在需要时使用高级设置和故障排除工具。 + + + +## 准备工作 + +在使用一键应用安装器之前，你的 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 云集成。这样你可以安全地暴露应用，并为部署申请 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 From 5f3bf7f5a0942ba6e2533cd324a0115a8e657b62 Mon Sep 17 00:00:00 2001 From: fgalz Date: Tue, 21 Apr 2026 12:31:55 +0200 Subject: [PATCH 3/6] Merge branch 'master' into docs/verver-one-click-apps-installer From a5a7080af6b66a4eeef0d22fba4f6ff025a179c1 Mon Sep 17 00:00:00 2001 From: fgalz Date: Tue, 21 Apr 2026 13:11:39 +0200 Subject: [PATCH 4/6] Tweaks --- ...md => vserver-one-click-apps-installer.md} | 4 +- .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 291 ------------------ .../verver-one-click-apps-installer.md | 284 ----------------- .../verver-one-click-apps-installer.md | 291 ------------------ 13 files changed, 3 insertions(+), 3486 deletions(-) rename docs/{verver-one-click-apps-installer.md => vserver-one-click-apps-installer.md} (99%) delete mode 100644 i18n/ar/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/de/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/es/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/fr/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/it/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/ja/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/nl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/pl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/pt/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/sv/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/th/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md delete mode 100644 i18n/zh/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md diff --git a/docs/verver-one-click-apps-installer.md b/docs/vserver-one-click-apps-installer.md similarity index 99% rename from docs/verver-one-click-apps-installer.md rename to docs/vserver-one-click-apps-installer.md index c7c94fa2a..c10298bf8 100644 --- a/docs/verver-one-click-apps-installer.md +++ b/docs/vserver-one-click-apps-installer.md @@ -1,5 +1,5 @@ --- -id: verver-one-click-apps-installer +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 @@ -13,6 +13,8 @@ import InlineVoucher from '@site/src/components/InlineVoucher'; 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 diff --git a/i18n/ar/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/ar/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 815a8d72d..000000000 --- a/i18n/ar/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-one-click-apps-installer -title: "VPS: مثبت التطبيقات بنقرة واحدة" -description: "نشر التطبيقات باستخدام مثبت التطبيقات بنقرة واحدة على VPS، إدارة المشاريع عبر الواجهة الإلكترونية، واستخدام Coolify لإدارة التطبيقات المتقدمة -> تعلّم المزيد الآن" -sidebar_label: مثبت التطبيقات بنقرة واحدة -services: - - vserver ---- - -import InlineVoucher from '@site/src/components/InlineVoucher'; - -## Introduction - -يتيح لك مثبت التطبيقات بنقرة واحدة تصفح كتالوج ضخم من التطبيقات ونشرها مباشرة من واجهة الويب الخاصة بـ VPS. في هذا الدليل، ستتعلم كيفية تحضير سيرفرك، اختيار نوع التثبيت الصحيح، تثبيت وإدارة التطبيقات، واستخدام الإعدادات المتقدمة وأدوات استكشاف الأخطاء عند الحاجة. - - - -## Preparation - -قبل استخدام مثبت التطبيقات بنقرة واحدة، يجب أن يفي VPS الخاص بك بالحد الأدنى من المتطلبات وأن يستخدم نظام تشغيل مدعوم. - -:::info الحد الأدنى من المتطلبات -تتطلب ميزة التطبيقات أن يكون VPS الخاص بك متصلًا بالإنترنت ومجهزًا بموارد كافية لتشغيل خدمات المنصة والتطبيقات المثبتة بشكل موثوق. -::: - -| المتطلب | الحد الأدنى | الموصى به | -| --- | --- | --- | -| حالة السيرفر | متصل | متصل | -| التخزين | 30 جيجابايت | 50 جيجابايت | -| RAM | 2 جيجابايت | 4 جيجابايت | -| CPU | نواتان | 4 أنوية | -| نظام التشغيل | Debian أو Ubuntu LTS | Debian 13 - EN - 64bit | - -:::caution يُنصح بنظام تشغيل جديد -ننصح بشدة بإعداد ميزة التطبيقات على تثبيت نظام تشغيل جديد. هذا يساعد على تجنب التعارضات مع الخدمات الحالية، المنافذ المشغولة، إعدادات Docker، أو التكوينات المخصصة الموجودة مسبقًا على السيرفر. -::: - -إذا كنت بحاجة لإعادة تثبيت VPS قبل المتابعة، استخدم صورة Debian أو Ubuntu LTS مدعومة وجديدة من واجهة إدارة VPS الخاصة بك. - -## Accessing the One Click Apps Installer - -افتح VPS الخاص بك في واجهة الويب الخاصة بـ ZAP-Hosting وابحث عن قسم التطبيقات بنقرة واحدة. من هناك، يمكنك بدء الإعداد الأولي والعودة لاحقًا لإدارة جميع التطبيقات المثبتة على السيرفر. - -عند فتح هذه الميزة لأول مرة، تحتاج إلى اختيار كيفية تثبيت المنصة على VPS الخاص بك. - -## Choosing an Installation Type - -يمكنك الاختيار بين التثبيت الكامل أو التثبيت كعقدة فقط. الخيار الصحيح يعتمد على ما إذا كان هذا VPS سيستضيف كل من لوحة الإدارة والتطبيقات، أو يعمل فقط كعقدة مرتبطة بلوحة أخرى. - -### Full Installation - -اختر **التثبيت الكامل** إذا كنت تريد إعداد السيرفر مع اللوحة والسيرفر نفسه كعقدة. هذا هو الخيار الموصى به للمستخدمين الجدد ولأغلب عمليات النشر القياسية. - -بهذه الطريقة، يمكنك: - -- نشر التطبيقات من كتالوج التطبيقات -- إدارة المشاريع والبيئات -- تنظيم جميع التطبيقات في مكان واحد -- استخدام أدوات إدارة الواجهة الإلكترونية المدمجة -- الوصول إلى اللوحة المتقدمة لاحقًا إذا لزم الأمر - -![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) - -:::tip موصى به لمعظم المستخدمين -إذا كانت هذه هي المرة الأولى التي تستخدم فيها ميزة التطبيقات، اختر خيار التثبيت الكامل. يوفر هذا أبسط إعداد ويمنحك إدارة كاملة مباشرة من واجهة الويب الخاصة بـ ZAP-Hosting. -::: - -### Node-only Installation - -اختر **التثبيت كعقدة فقط** إذا كنت تريد أن يعمل هذا VPS كعقدة فقط. يمكنك ربطه لاحقًا بسيرفر VPS آخر أو بنسخة لوحة خارجية. - -هذا الخيار مفيد إذا كنت تريد: - -- التوسع عبر عدة أنظمة VPS -- مركزية الإدارة على لوحة واحدة -- ربط هذا السيرفر بنشر موجود -- توسيع إعداد متعدد العقد موجود - -:::note خيار نشر متقدم -التثبيت كعقدة فقط موجه للمستخدمين الذين لديهم بالفعل نسخة لوحة أخرى متاحة أو يرغبون في ربط هذا السيرفر ببيئة خارجية. -::: - -## Installing the Apps Feature - -بعد اختيار نوع التثبيت، ابدأ الإعداد من واجهة الويب. عادةً ما يستغرق التثبيت الأولي بضع دقائق فقط. - -خلال هذه العملية، يتم نشر خدمات المنصة المطلوبة لميزة التطبيقات بنقرة واحدة على VPS الخاص بك. بمجرد الانتهاء، يصبح كتالوج التطبيقات وأقسام الإدارة متاحة في واجهة الويب. - -:::info سلوك التثبيت -قد تختلف تفاصيل تقدم التثبيت حسب أداء VPS، حالة نظام التشغيل، وظروف الشبكة. إذا لم يكتمل الإعداد بنجاح، راجع قسم استكشاف الأخطاء في هذا الدليل لاحقًا. -::: - -## Browsing the App Catalogue - -بمجرد اكتمال التثبيت، يمكنك فتح كتالوج التطبيقات وتصفح التطبيقات المتاحة. يحتوي الكتالوج على أكثر من 300 تطبيق جاهز للنشر ويدعم التصفية لمساعدتك في العثور على التطبيق المناسب بسرعة. - -![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) - -### Searching and Filtering Apps - -في الكتالوج، يمكنك البحث عن التطبيقات بالاسم والتصفية حسب الفئة. هذا يساعدك على تضييق نطاق جميع التطبيقات المتاحة في واجهة متجر التطبيقات والعثور على الهدف المناسب لنشر مشروعك. - -تشمل الإجراءات النموذجية: - -- البحث باسم التطبيق -- التصفية حسب الفئة -- مراجعة إدخالات التطبيقات المتاحة -- اختيار تطبيق للنشر - -هذا التدفق مفيد بشكل خاص إذا كنت تدير العديد من أهداف تنزيل التطبيقات أو تقارن بين خدمات متعددة قبل التثبيت. - -### Starting an App Installation - -بعد اختيار تطبيق من الكتالوج، ابدأ التثبيت عبر واجهة الويب. حسب التطبيق، قد تحتاج إلى تحديد قيم مثل: - -- `[your_project_name]` -- `[your_environment_name]` -- `[your_domain]` -- `[your_app_name]` - -تمثل هذه العناصر النائبة القيم الخاصة بنشرك. على سبيل المثال، يجب استبدال `[your_domain]` بالنطاق الذي تريد استخدامه للتطبيق. - -:::tip المشاريع والبيئات -استخدم المشاريع والبيئات للحفاظ على تنظيم نشراتك. هذا مفيد بشكل خاص عند استضافة عدة تطبيقات، اختبار الإصدارات، أو فصل خدمات الإنتاج والاختبار. -::: - -## Managing Installed Apps - -بعد النشر، تُدرج التطبيقات المثبتة في قسم الإدارة بواجهة الويب. من هنا، يمكنك مراقبة خدماتك والتحكم بها دون الحاجة للعمل يدويًا مع الحاويات الأساسية. - -![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) - -### Available Management Actions - -يتيح قسم التطبيقات المثبتة تنفيذ إجراءات دورة حياة شائعة مباشرة من واجهة الويب. - -| الإجراء | الغرض | -| --- | --- | -| بدء | تشغيل تطبيق متوقف | -| إيقاف | إيقاف تطبيق يعمل | -| فحص السجلات | فتح سجلات التطبيق لاستكشاف الأخطاء | -| إعادة التثبيت | إعادة نشر التطبيق | - -تجعل هذه الأدوات إدارة جميع التطبيقات من مكان واحد أسهل، خاصة إذا كنت تريد تحكمًا بسيطًا عبر الويب بدلاً من الإدارة اليدوية عبر سطر الأوامر. - -### Organizing Projects and Environments - -تساعد المشاريع والبيئات في تنظيم نشراتك بوضوح. يمكنك استخدامها لفصل: - -- التطبيقات الشخصية والإنتاجية -- بيئات الاختبار والإنتاج الحي -- نشرات متعددة لعملاء أو فرق مختلفة -- حزم مختلفة على نفس VPS - -تصبح هذه التنظيمات أكثر أهمية مع نمو مجموعة تطبيقات متجر التطبيقات وإدارة المزيد من الخدمات على عقدة واحدة أو أكثر. - -## Domains, Cloud Access, and 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]`، فقد تفشل عملية التحقق من النطاق والوصول إلى التطبيق. -::: - -## Using Advanced Settings - -يمكن للمستخدمين المتقدمين الوصول إلى وظائف إضافية عبر اللوحة الخارجية المتاحة في قسم الإعدادات المتقدمة. - -![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) - -هذا مفيد إذا كنت بحاجة إلى تخصيص أعمق، تحكم موسع في النشر، أو وصول مباشر إلى ميزات تتجاوز واجهة الويب القياسية. - -### Important Support Limitation - -:::caution نطاق الدعم لاستخدام اللوحة المتقدمة -يُرحب بالمستخدمين المتقدمين لاستخدام لوحة Coolify الخارجية لمزيد من التخصيص والوظائف. مع ذلك، الدعم يقتصر على واجهة الويب الخاصة بـ ZAP-Hosting. إذا أجريت تغييرات خارج واجهة الويب، قد لا يتوفر الدعم لتلك التعديلات المخصصة. -::: - -### When to Use the Advanced Panel - -قد ترغب في استخدام اللوحة المتقدمة إذا كنت تحتاج إلى: - -- تخصيص نشر أكثر تفصيلاً -- سير عمل ربط العقد مباشرة -- تكوين تطبيقات متقدم -- إدارة على مستوى اللوحة تتجاوز الواجهة المبسطة - -إذا فقدت الوصول أو توقف التكامل عن الاستجابة، استخدم أدوات استكشاف الأخطاء أدناه قبل إجراء تغييرات يدوية. - -## Linking Nodes - -إذا اخترت نوع التثبيت كعقدة فقط، يمكنك ربط هذا VPS بسيرفر VPS آخر أو نسخة لوحة خارجية. هذا يسمح لك بتوسيع البنية التحتية وإدارة عدة عقد من موقع واحد. - -رابط العقد مفيد عندما تريد: - -- توزيع التطبيقات عبر عدة أنظمة VPS -- مركزية الإدارة -- توسيع السعة دون إنشاء نشرات معزولة -- الاتصال ببيئة لوحة خارجية - -:::note ربط لوحة خارجية -يمكنك ربط عقدتك بسيرفر VPS آخر أو نسخة لوحة خارجية. تعتمد تفاصيل الربط الدقيقة على البيئة المستهدفة المستخدمة بالفعل. -::: - -## Troubleshooting Degraded Status - -إذا أظهرت واجهة الويب حالة متدهورة، فهذا يعني أن المنصة لا تستطيع الاتصال أو استرجاع البيانات من النسخة التي تشغل ميزة التطبيقات بنقرة واحدة. اتبع خطوات استكشاف الأخطاء بالترتيب الزمني. - -### Status Indicators - -قد يظهر مربع استكشاف الأخطاء مؤشرات مثل التالية: - -| الحالة | المعنى | -| --- | --- | -| حالة Coolify: نشط | يبدو أن خدمة اللوحة تعمل | -| حالة API: متاحة | يمكن الوصول إلى API حاليًا | -| حالة الخدمة: متصل | VPS الخاص بك متصل بالإنترنت | - -إذا لم تعمل جزء أو أكثر بشكل صحيح، تابع الخطوات أدناه. - -### Step 1: Confirm the VPS Is Online - -أولاً، تأكد من أن خدمة VPS الخاصة بك متصلة في واجهة الويب الخاصة بـ ZAP-Hosting. إذا كان السيرفر غير متصل، لا يمكن لمنصة التطبيقات العمل. - -### Step 2: Refresh the Status - -استخدم إجراء **تحديث الحالة** لإعادة فحص الصحة بأحدث البيانات. يمكن أن يحل هذا مشاكل مؤقتة متقطعة. - -:::tip مشاكل الاتصال المؤقتة -قد يكون السبب في الحالة المتدهورة أحيانًا مشكلة اتصال قصيرة الأمد. تحديث الحالة هو أسرع فحص أولي. -::: - -### Step 3: Restart Docker - -إذا استمرت الحالة المتدهورة، استخدم إجراء **إعادة تشغيل Docker**. هذا يجبر نسخة المنصة على إعادة التشغيل. بعد استجابة ناجحة، انتظر `1-2 دقيقة` ثم حدث الحالة مرة أخرى. - -:::caution إعادة تشغيل الخدمة -إعادة تشغيل Docker قد توقف التطبيقات قيد التشغيل مؤقتًا أثناء إعادة تشغيل الخدمات. -::: - -### Step 4: Refresh Credentials - -كخطوة أخيرة، استخدم **تحديث بيانات الاعتماد**. هذا مهم بشكل خاص إذا كانت الحالة تظهر متصلة لكن وظائف واجهة الويب مثل تثبيت التطبيقات لا تعمل. - -هذا الإجراء: - -- لا يحذف بياناتك -- يحدث بيانات اعتماد المستخدم root -- يحدث رمز API المستخدم من قبل واجهة الويب -- يحدث بيانات اعتماد اللوحة تلقائيًا عند النجاح - -:::info تحديث بيانات اعتماد آمن -تحديث بيانات الاعتماد لا يزيل التطبيقات المثبتة أو بيانات النشر. فقط يجدد بيانات الاعتماد المطلوبة للوصول والاتصال. -::: - -### When to Contact Support - -إذا استمرت المشكلة بعد إكمال جميع خطوات استكشاف الأخطاء، أنشئ تذكرة دعم عبر موقع ZAP-Hosting. - -## Best Practices - -للحفاظ على استقرار مثبت التطبيقات بنقرة واحدة وسهولة إدارته، اتبع هذه التوصيات: - -| أفضل الممارسات | السبب | -| --- | --- | -| استخدم تثبيت نظام تشغيل جديد | يقلل التعارضات مع الخدمات والمنافذ الحالية | -| استوفِ الموارد الموصى بها | يحسن الأداء والموثوقية | -| نظم التطبيقات في مشاريع وبيئات | يحافظ على قابلية إدارة النشر | -| قم بتكوين DNS قبل تعيين النطاقات | يمنع مشاكل الوصول وSSL | -| استخدم الإعدادات المتقدمة بحذر | يتجنب التغييرات المخصصة غير المدعومة | - -:::tip حافظ على تنظيم النشرات -إذا كنت تخطط لاستضافة العديد من التطبيقات، أنشئ نظام تسمية واضح لـ `[your_project_name]`، `[your_environment_name]`، و`[your_app_name]` قبل نشر خدماتك الأولى. -::: - -## Conclusion - -تهانينا، لقد قمت بإعداد واستخدام مثبت التطبيقات بنقرة واحدة على VPS بنجاح لنشر وإدارة التطبيقات على سيرفرك. لأي أسئلة أو مساعدة إضافية، لا تتردد في التواصل مع فريق الدعم لدينا، المتوفر يوميًا لمساعدتك! 🙂 - - \ No newline at end of file diff --git a/i18n/de/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/de/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index b9f6f2257..000000000 --- a/i18n/de/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-one-click-apps-installer -title: "VPS: One Click Apps Installer" -description: "Apps mit dem VPS One Click Apps Installer bereitstellen, Projekte über die Weboberfläche verwalten und Coolify für erweiterte App-Verwaltung nutzen -> 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, aus einem umfangreichen App-Katalog zu wählen und Apps direkt über die Weboberfläche deines VPS bereitzustellen. 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 nutzt. - - - -## 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 über ausreichend Ressourcen verfügt, 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 auf dem Server. -::: - -Falls du deinen VPS vor der Nutzung neu installieren musst, verwende ein frisches, unterstütztes Debian- oder Ubuntu-LTS-Image aus deinem VPS-Management. - -## 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 Erstinstallation starten und später alle installierten Apps 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 dein 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-Setups. - -Mit dieser Methode kannst du: - -- Apps aus dem App-Katalog bereitstellen -- 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 dein VPS nur als Node fungieren soll. Du kannst ihn dann mit einem anderen VPS oder einer externen Panel-Instanz verknüpfen. - -Diese Option ist sinnvoll, wenn du: - -- über mehrere VPS-Systeme skalieren möchtest -- das Management auf einem Panel zentralisieren willst -- diesen Server in eine bestehende Installation einbinden möchtest -- ein bestehendes Multi-Node-Setup erweitern willst - -:::note Erweiterte Deployment-Option -Die Node-only-Installation ist für Nutzer gedacht, die bereits ein anderes Panel nutzen oder den Server mit einer externen Umgebung verbinden wollen. -::: - -## Installation der Apps-Funktion - -Nach Auswahl des Installationstyps startest du die Einrichtung über das Webinterface. Die Erstinstallation dauert in der Regel nur wenige Minuten. - -Währenddessen 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 kann je nach VPS-Leistung, Betriebssystemzustand und Netzwerkbedingungen variieren. Falls die Einrichtung nicht erfolgreich ist, findest du weiter unten im Guide eine Fehlerbehebung. -::: - -## Durchsuchen 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 bietet Filterfunktionen, um schnell die passende App zu finden. - -![](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 findest du schnell den richtigen Deployment-Zielort für dein Projekt. - -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 hilfreich, wenn du viele Apps verwaltest oder mehrere Dienste vor der Installation vergleichst. - -### App-Installation starten - -Nach Auswahl einer App im Katalog startest du die Installation über das Webinterface. Je nach App musst du Werte wie diese definieren: - -- `[your_project_name]` -- `[your_environment_name]` -- `[your_domain]` -- `[your_app_name]` - -Diese Platzhalter stehen für spezifische Werte deiner Bereitstellung. Zum Beispiel ersetzt du `[your_domain]` durch die Domain, die du für die App verwenden möchtest. - -:::tip Projekte und Umgebungen -Nutze Projekte und Umgebungen, um deine Bereitstellung übersichtlich zu halten. Das ist besonders praktisch, wenn du mehrere Apps hostest, Versionen testest oder Produktions- und Staging-Services trennst. -::: - -## Verwaltung installierter Apps - -Nach der Bereitstellung werden deine installierten Apps im Verwaltungsbereich des Webinterfaces aufgelistet. Von hier aus kannst du deine Dienste ü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 ermöglicht dir gängige Lifecycle-Aktionen direkt im Webinterface. - -| 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 eine einfache Websteuerung statt manueller Kommandozeilenarbeit bevorzugst. - -### Projekte und Umgebungen organisieren - -Projekte und Umgebungen helfen dir, deine Deployments klar zu strukturieren. Du kannst damit trennen: - -- persönliche und produktive Apps -- Test- und Live-Umgebungen -- mehrere Kunden- oder Team-Deployments -- verschiedene Stacks auf demselben VPS - -Diese Organisation wird wichtiger, je größer deine App-Sammlung wird und je mehr Dienste du auf einem oder mehreren Nodes verwaltest. - -## Domains, Cloud-Zugriff und SSL - -Die One Click Apps Funktion unterstützt benutzerdefinierte Domains und die ZAP Cloud-Integration. So kannst du Apps sicher bereitstellen und SSL-Zertifikate für deine Deployments ausstellen lassen. - -:::info Domain- und SSL-Unterstützung -Du kannst benutzerdefinierte Domains für deine Apps nutzen und von der automatischen SSL-Zertifikatsbereitstellung profitieren, sofern die Plattform das unterstützt. -::: - -Beim Zuweisen einer Domain stelle sicher, dass deine DNS-Einträge auf `[your_server_ip]` zeigen. Ist deine Domain nicht korrekt konfiguriert, ist die App möglicherweise nicht aus dem Internet erreichbar. - -| Wert | Beschreibung | -| --- | --- | -| `[your_domain]` | Die Domain oder Subdomain, die deiner App zugewiesen ist | -| `[your_server_ip]` | Die öffentliche IP-Adresse deines VPS | - -:::caution DNS muss auf deinen VPS zeigen -Wenn der DNS für `[your_domain]` nicht auf `[your_server_ip]` zeigt, kann die Domainvalidierung und der Zugriff auf die App 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 hilfreich, wenn du tiefere Anpassungen, erweiterte Deployment-Kontrolle oder direkten Zugriff auf Funktionen außerhalb der Standard-Weboberfläche benötigst. - -### Wichtige Support-Einschränkung - -:::caution Supportumfang bei Nutzung des erweiterten Panels -Fortgeschrittene Nutzer können das externe Coolify-Panel für mehr Anpassungen verwenden. Der Support beschränkt sich jedoch auf das ZAP-Hosting Webinterface. Änderungen außerhalb des Webinterfaces können nicht unterstützt werden. -::: - -### Wann das erweiterte Panel nutzen? - -Das erweiterte Panel ist sinnvoll, wenn du: - -- detailliertere Deployment-Anpassungen brauchst -- direkte Node-Verknüpfungen verwalten willst -- erweiterte App-Konfigurationen durchführen möchtest -- Panel-Management jenseits der vereinfachten Oberfläche benötigst - -Falls du den Zugriff verlierst oder die Integration nicht mehr reagiert, nutze zuerst 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 oder einer externen Panel-Instanz verknüpfen. So kannst du deine Infrastruktur skalieren und mehrere Nodes zentral verwalten. - -Node-Verknüpfungen sind 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 Zielumgebung ab. -::: - -## Fehlerbehebung bei verschlechtertem Status - -Wenn das Webinterface einen verschlechterten Status anzeigt, kann die Plattform keine Verbindung zur Instanz herstellen, die die One Click Apps Funktion betreibt. Folge den Troubleshooting-Schritten in der angegebenen Reihenfolge. - -### Statusanzeigen - -Das Troubleshooting-Popup zeigt möglicherweise folgende Statusanzeigen: - -| Status | Bedeutung | -| --- | --- | -| Coolify Status: Aktiv | Der Panel-Dienst läuft offenbar | -| API Status: Erreichbar | Die API ist aktuell erreichbar | -| Service Status: Online | Dein VPS ist online | - -Wenn eine oder mehrere Komponenten nicht 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. Ist der Server offline, kann die Apps-Plattform nicht funktionieren. - -### Schritt 2: Status aktualisieren - -Nutze die Aktion **Status aktualisieren**, um die Gesundheitsprüfung mit aktuellen Daten erneut auszuführen. Das kann temporäre Verbindungsprobleme beheben. - -:::tip Temporäre Verbindungsprobleme -Ein verschlechterter Zustand kann durch kurzzeitige Kommunikationsprobleme verursacht werden. Das Aktualisieren des Status ist der schnellste erste Check. -::: - -### Schritt 3: Docker neu starten - -Bleibt der Status verschlechtert, nutze die Aktion **Docker neu starten**. Dadurch wird die Plattforminstanz neu gestartet. War die Antwort erfolgreich, 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 wie App-Installation nicht funktionieren. - -Diese Aktion: - -- löscht **nicht** deine Daten -- aktualisiert die Root-Benutzer-Zugangsdaten -- erneuert den API-Token, den das Webinterface nutzt -- aktualisiert die Panel-Zugangsdaten automatisch bei Erfolg - -:::info Sichere Aktualisierung der Zugangsdaten -Das Aktualisieren der Zugangsdaten entfernt keine installierten Apps oder Deployment-Daten. Es erneuert nur die für Zugriff und Kommunikation benötigten Credentials. -::: - -### Wann Support kontaktieren - -Wenn das Problem nach allen 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 verwenden | Vermeidet Konflikte mit bestehenden Diensten und Ports | -| Empfohlene Ressourcen einhalten | Verbessert Leistung 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 Änderungen | - -:::tip Deployments organisiert halten -Wenn du viele Apps hosten möchtest, erstelle vor der ersten Bereitstellung ein klares Namensschema für `[your_project_name]`, `[your_environment_name]` und `[your_app_name]`. -::: - -## Fazit - -Glückwunsch, du hast den VPS One Click Apps Installer erfolgreich eingerichtet und genutzt, um Apps auf deinem Server bereitzustellen und zu verwalten. Für weitere Fragen oder Unterstützung steht dir unser Support-Team täglich zur Verfügung! - - \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/es/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 8ddb9b03e..000000000 --- a/i18n/es/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-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 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 a 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. - - - -## 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 compatible. - -:::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 Recomendado Sistema Operativo Nuevo -Se recomienda encarecidamente configurar la función de apps en una instalación nueva 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 nueva y compatible 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 -- gestionar proyectos y entornos -- organizar todas las apps en un solo lugar -- usar las herramientas integradas de gestión 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. -::: - -## Explorando el Catálogo de Apps - -Una vez finalizada la instalación, puedes abrir el catálogo de apps y explorar las 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 adecuado para tu proyecto. - -Acciones típicas incluyen: - -- buscar por nombre de app -- filtrar por categoría -- revisar las entradas disponibles -- seleccionar una app para desplegar - -Este flujo 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 reemplazarse 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, versiones de prueba o separas servicios de producción y staging. -::: - -## Gestionando Apps Instaladas - -Después del despliegue, tus apps instaladas se listan 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 -- despliegues para varios 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 aprovisionar certificados SSL para tus despliegues. - -:::info Soporte de Dominio 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. - -### Limitación Importante 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 dependen del entorno destino ya en uso. -::: - -## Solución de Problemas de 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 en ejecución | -| 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: Actualiza el Estado - -Usa la acción **Actualizar Estado** para ejecutar la comprobación de salud nuevamente con los datos más recientes. Esto puede resolver problemas intermitentes temporales. - -:::tip Problemas Temporales de Conectividad -Un estado degradado puede ser causado a veces por un problema de comunicación breve. Actualizar el estado es la primera comprobación más rápida. -::: - -### Paso 3: Reinicia Docker - -Si el estado sigue degradado, usa la acción **Reiniciar Docker**. Esto fuerza el reinicio de la instancia de la plataforma. Tras una respuesta exitosa, espera `1-2 minutos` y actualiza 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: Actualiza las Credenciales - -Como paso final, usa **Actualizar 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 elimina tus datos -- actualiza las credenciales del usuario root -- actualiza el token API usado por la interfaz web -- actualiza automáticamente las credenciales del panel al completarse con éxito - -:::info Actualización Segura de Credenciales -Actualizar 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 nueva 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 - -Felicitaciones, 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 asistencia, no dudes en contactar a nuestro equipo de soporte, que está disponible a diario para ayudarte! 🙂 - - \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/fr/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 64114e0a9..000000000 --- a/i18n/fr/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-one-click-apps-installer -title: "VPS : Installateur d’Apps en Un Clic" -description: "Déployez des apps avec l’installateur d’apps en un clic pour VPS, gérez vos projets via l’interface web, et utilisez Coolify pour une gestion avancée -> Découvrez tout ça maintenant" -sidebar_label: Installateur d’Apps en Un Clic -services: - - vserver ---- - -import InlineVoucher from '@site/src/components/InlineVoucher'; - -## Introduction - -L’installateur d’apps en un clic vous permet de parcourir un catalogue d’applications complet et de déployer des apps directement depuis l’interface web de votre VPS. Dans ce guide, vous apprendrez à préparer votre serveur, choisir le type d’installation adapté, installer et gérer vos apps, et utiliser les réglages avancés ainsi que les outils de dépannage si besoin. - - - -## Preparation - -Avant d’utiliser l’installateur d’apps en un clic, votre VPS doit répondre aux exigences minimales et utiliser un système d’exploitation supporté. - -:::info Exigences minimales -La fonctionnalité apps nécessite que votre VPS soit en ligne et configuré avec suffisamment de ressources pour faire tourner à la fois les services de la plateforme et vos apps installées de manière fiable. -::: - -| Exigence | Minimum | Recommandé | -| --- | --- | --- | -| Statut 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 - EN - 64bit | - -:::caution Système d’exploitation frais recommandé -Il est fortement conseillé d’installer la fonctionnalité apps sur une installation fraîche du système d’exploitation. Cela évite les conflits avec des services existants, des ports occupés, des configurations Docker ou personnalisées déjà présentes sur le serveur. -::: - -Si vous devez réinstaller votre VPS avant de continuer, utilisez une image Debian ou Ubuntu LTS fraîche et supportée depuis votre interface de gestion VPS. - -## Accéder à l’Installateur d’Apps en Un Clic - -Ouvrez votre VPS dans l’interface web ZAP-Hosting et localisez la section One Click Apps. Vous pouvez lancer la configuration initiale depuis là, puis revenir gérer toutes les apps installées sur le serveur. - -La première fois que vous ouvrez cette fonctionnalité, vous devez choisir comment la plateforme doit être installée sur votre VPS. - -## Choisir un Type d’Installation - -Vous pouvez choisir entre une installation complète et une installation en mode nœud uniquement. Le 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 - -Choisissez **Installation complète** si vous souhaitez 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, vous pouvez : - -- 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 plupart des utilisateurs -Si c’est votre première utilisation de la fonctionnalité apps, sélectionnez l’installation complète. Elle offre la configuration la plus simple et vous donne une gestion complète directement depuis l’interface web ZAP-Hosting. -::: - -### Installation en mode nœud uniquement - -Choisissez **Installation en mode nœud uniquement** si vous voulez que ce VPS agisse uniquement comme un nœud. Vous pourrez alors le lier à un autre serveur VPS ou à une instance de panneau externe. - -Cette option est utile si vous souhaitez : - -- 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 de déploiement avancée -L’installation en mode nœud uniquement est destinée aux utilisateurs qui ont déjà un autre panneau disponible ou qui veulent connecter ce serveur à un environnement externe. -::: - -## Installer la Fonctionnalité Apps - -Après avoir choisi le type d’installation, lancez 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 votre 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 votre VPS, l’état du système d’exploitation et les conditions réseau. Si l’installation ne se termine pas correctement, consultez la section dépannage plus bas dans ce guide. -::: - -## Parcourir le Catalogue d’Apps - -Une fois l’installation terminée, vous pouvez 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 vous aider à trouver rapidement l’app adaptée. - -![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) - -### Rechercher et filtrer les apps - -Dans le catalogue, vous pouvez chercher des apps par nom et filtrer par catégorie. Cela vous aide à réduire la liste dans cette interface façon store et à trouver la cible de déploiement idéale pour votre projet. - -Actions typiques : - -- rechercher par nom d’app -- filtrer par catégorie -- consulter les entrées disponibles -- sélectionner une app pour le déploiement - -Ce workflow est particulièrement utile si vous gérez beaucoup de cibles de téléchargement ou comparez plusieurs services avant installation. - -### Lancer une installation d’app - -Après avoir sélectionné une app dans le catalogue, commencez l’installation via l’interface web. Selon l’app, vous devrez peut-être définir des valeurs telles que : - -- `[your_project_name]` -- `[your_environment_name]` -- `[your_domain]` -- `[your_app_name]` - -Ces placeholders représentent des valeurs spécifiques à votre déploiement. Par exemple, `[your_domain]` doit être remplacé par le domaine que vous souhaitez utiliser pour l’app. - -:::tip Projets et environnements -Utilisez projets et environnements pour garder votre déploiement organisé. C’est particulièrement utile si vous hébergez plusieurs apps, testez des versions ou séparez production et staging. -::: - -## Gérer les Apps Installées - -Après déploiement, vos apps installées sont listées dans la section de gestion de l’interface web. Vous pouvez y surveiller et contrôler vos services sans 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 vous permet d’effectuer des actions courantes 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 vos apps au même endroit, surtout si vous préférez un contrôle simple via web plutôt qu’une administration en ligne de commande. - -### Organiser projets et environnements - -Projets et environnements vous aident à structurer clairement vos déploiements. Vous pouvez les utiliser pour séparer : - -- apps perso et production -- environnements test et live -- déploiements clients ou équipes multiples -- stacks différents sur un même VPS - -Cette organisation devient de plus en plus importante à mesure que votre collection d’apps store grandit et que vous gérez 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. Cela vous permet d’exposer vos apps en toute sécurité et de provisionner des certificats SSL pour vos déploiements. - -:::info Support domaines et SSL -Vous pouvez utiliser des domaines personnalisés pour vos apps et bénéficier du provisioning de certificats SSL lorsque la plateforme le supporte. -::: - -Lors de l’attribution d’un domaine, assurez-vous que vos enregistrements DNS pointent vers `[your_server_ip]`. Si votre 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é à votre app | -| `[your_server_ip]` | L’adresse IP publique de votre VPS | - -:::caution Le DNS doit pointer vers votre 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 Paramètres Avancés - -Les utilisateurs avancés peuvent accéder à des fonctionnalités supplémentaires via le panneau externe disponible dans la section paramètres avancés. - -![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) - -Cela peut être utile si vous avez 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 vous effectuez des modifications hors interface web, l’assistance peut ne pas être disponible pour ces changements personnalisés. -::: - -### Quand utiliser le panneau avancé - -Vous pouvez vouloir utiliser le panneau avancé si vous avez besoin de : - -- personnalisation détaillée du déploiement -- workflows de liaison de nœuds directs -- configuration avancée des apps -- gestion au niveau panneau au-delà de l’interface simplifiée - -Si vous perdez l’accès ou que l’intégration ne répond plus, utilisez d’abord les outils de dépannage décrits ci-dessous avant de faire des modifications manuelles. - -## Lier des Nœuds - -Si vous avez choisi l’installation en mode nœud uniquement, vous pouvez lier ce VPS à un autre serveur VPS ou à une instance de panneau externe. Cela vous permet de scaler votre infrastructure et gérer plusieurs nœuds depuis un seul endroit. - -La liaison de nœuds est utile quand vous voulez : - -- distribuer les apps sur plusieurs VPS -- centraliser la gestion -- étendre la capacité sans créer de déploiements isolés -- connecter à un environnement de panneau externe - -:::note Liaison à un panneau externe -Vous pouvez lier votre 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. Suivez 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 | Votre VPS est lui-même en ligne | - -Si une ou plusieurs parties ne fonctionnent pas correctement, continuez avec les étapes ci-dessous. - -### Étape 1 : Confirmer que le VPS est en ligne - -Assurez-vous d’abord que votre VPS est 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 - -Utilisez l’action **Rafraîchir le statut** pour relancer la vérification de santé avec les données les plus récentes. Cela peut résoudre des problèmes intermittents temporaires. - -:::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é, utilisez l’action **Redémarrer Docker**. Cela force le redémarrage de l’instance plateforme. Après une réponse réussie, attendez `1-2 minutes` puis rafraîchissez à 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, utilisez **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** vos 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 vos apps installées ni les données de déploiement. Cela renouvelle uniquement 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éez un ticket de support via le site ZAP-Hosting. - -## Bonnes Pratiques - -Pour garder l’installateur d’apps en un clic stable et facile à gérer, suivez 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 paramètres avancés avec précaution | Évite les modifications personnalisées non supportées | - -:::tip Gardez vos déploiements organisés -Si vous prévoyez d’héberger beaucoup d’apps, créez un schéma de nommage clair pour `[your_project_name]`, `[your_environment_name]` et `[your_app_name]` avant de déployer vos premiers services. -::: - -## Conclusion - -Félicitations, vous avez configuré et utilisé avec succès l’installateur d’apps en un clic pour VPS afin de déployer et gérer des apps sur votre serveur. Pour toute question ou assistance, n’hésitez pas à contacter notre équipe support, disponible tous les jours pour vous aider ! - - \ No newline at end of file diff --git a/i18n/it/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/it/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 8346b55f1..000000000 --- a/i18n/it/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-one-click-apps-installer -title: "VPS: One Click Apps Installer" -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: One Click App Installer -services: - - vserver ---- - -import InlineVoucher from '@site/src/components/InlineVoucher'; - -## Introduzione - -Il One Click Apps Installer ti permette di sfogliare un ampio 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 corretto, installare e gestire le app, e utilizzare le impostazioni avanzate e gli strumenti di risoluzione problemi quando necessario. - - - -## 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 funzionalità app richiede che il tuo VPS sia online e configurato con risorse sufficienti per eseguire in modo affidabile sia i servizi della piattaforma che le app installate. -::: - -| Requisito | Minimo | Consigliato | -| --- | --- | --- | -| Stato server | Online | Online | -| Spazio di archiviazione | 30 GB | 50 GB | -| RAM | 2 GB | 4 GB | -| CPU | 2 core | 4 core | -| Sistema operativo | Debian o Ubuntu LTS | Debian 13 - EN - 64bit | - -:::caution Consigliata Installazione Pulita del Sistema Operativo -Si consiglia vivamente di configurare la funzionalità app su un’installazione pulita 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 procedere, usa un’immagine fresca e supportata di Debian o Ubuntu LTS dal pannello di gestione del 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 qui puoi avviare la configurazione iniziale e successivamente gestire tutte le app installate sul server. - -La prima volta che apri questa funzionalità, 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 corretta dipende dal fatto che il 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 funzionalità app per la prima volta e per la maggior parte delle installazioni standard. - -Con questo metodo puoi: - -- distribuire app dal catalogo -- 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 necessario - -![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 funzionalità app, seleziona l’installazione completa. Offre la configurazione più semplice e ti dà il controllo completo 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à in uso - -:::note Opzione Avanzata di Distribuzione -L’installazione solo nodo è pensata per utenti che hanno già un’altra istanza di pannello disponibile o che vogliono collegare questo server a un ambiente esterno. -::: - -## Installazione della Funzionalità 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 il One Click Apps vengono distribuiti sul tuo VPS. Al termine, 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 si completa con successo, consulta la sezione risoluzione problemi più avanti in questa guida. -::: - -## Navigazione 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 la distribuzione 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 la selezione in un’interfaccia in stile app store e a trovare il target di distribuzione più adatto al tuo progetto. - -Le azioni tipiche includono: - -- ricerca per nome app -- filtro per categoria -- revisione delle voci app disponibili -- selezione di un’app per la distribuzione - -Questo flusso di lavoro è particolarmente utile se gestisci molti target di app o confronti più servizi prima di installarli. - -### Avvio dell’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 segnaposto rappresentano valori specifici per la tua distribuzione. Per esempio, `[your_domain]` deve essere sostituito con il dominio che vuoi usare per l’app. - -:::tip Progetti e Ambienti -Usa progetti e ambienti per mantenere organizzata la tua distribuzione. È particolarmente utile se ospiti più app, versioni di test o separi servizi di produzione e staging. -::: - -## Gestione delle App Installate - -Dopo la distribuzione, 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 di ciclo di vita 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 la risoluzione problemi | -| Reinstalla | Ridistribuisce l’app | - -Questi strumenti facilitano la gestione di tutte le app da un unico posto, specialmente se preferisci un controllo semplice via web invece di amministrare manualmente da linea di comando. - -### Organizzazione di Progetti e Ambienti - -Progetti e ambienti ti aiutano a strutturare chiaramente le tue distribuzioni. Puoi usarli per separare: - -- app personali e di produzione -- ambienti di test e live -- distribuzioni 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 funzionalità 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 le tue distribuzioni. - -:::info Supporto per 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 alla tua 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à aggiuntive tramite il pannello esterno disponibile nella sezione impostazioni avanzate. - -![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) - -Questo può essere utile se hai bisogno di personalizzazioni più profonde, controllo esteso della distribuzione o accesso diretto a funzionalità oltre l’interfaccia web standard. - -### Importante Limitazione del Supporto - -:::caution Ambito del Supporto per l’Uso del Pannello Avanzato -Gli utenti avanzati sono liberi di utilizzare il pannello esterno Coolify per personalizzazioni e funzionalità aggiuntive. Tuttavia, il supporto è limitato all’interfaccia web di ZAP-Hosting. Se apporti modifiche fuori dall’interfaccia web, l’assistenza potrebbe non essere disponibile per quelle modifiche personalizzate. -::: - -### Quando Usare il Pannello Avanzato - -Potresti voler usare il pannello avanzato se ti servono: - -- personalizzazioni di distribuzione più dettagliate -- flussi di lavoro diretti per il collegamento dei nodi -- configurazioni avanzate delle app -- gestione a livello di pannello oltre l’interfaccia semplificata - -Se perdi l’accesso o l’integrazione smette di rispondere, usa prima gli strumenti di risoluzione problemi 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 dei nodi è utile quando vuoi: - -- distribuire app su più VPS -- centralizzare la gestione -- espandere la capacità senza creare distribuzioni isolate -- connetterti a un ambiente di pannello esterno - -:::note Collegamento a Pannello Esterno -Puoi collegare il tuo 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 alimenta la funzionalità One Click Apps. Segui i passaggi di risoluzione problemi in ordine cronologico. - -### Indicatori di Stato - -Il popup di risoluzione problemi può mostrare indicatori come i seguenti: - -| Stato | Significato | -| --- | --- | -| Stato Coolify: Attivo | Il servizio del pannello sembra essere in esecuzione | -| Stato API: Accessibile | L’API è attualmente raggiungibile | -| Stato Servizio: Online | Il VPS stesso è online | - -Se una o più parti non funzionano correttamente, continua con i passaggi seguenti. - -### Passo 1: Conferma che il VPS sia Online - -Per prima cosa, 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 eseguire nuovamente il controllo di integrità con i dati più recenti. Questo può risolvere problemi temporanei e intermittenti. - -:::tip Problemi Temporanei di Connessione -Uno stato degradato può a volte essere causato da un problema di comunicazione di breve durata. Aggiornare lo stato è il primo controllo più veloce. -::: - -### Passo 3: Riavvia Docker - -Se lo stato rimane degradato, usa l’azione **Riavvia Docker**. Questo forza il riavvio dell’istanza della piattaforma. Dopo una risposta positiva, attendi `1-2 minuti` e aggiorna di nuovo lo stato. - -:::caution Riavvio del 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 delle app non funzionano. - -Questa azione: - -- **non** cancella i tuoi dati -- aggiorna le credenziali dell’utente root -- aggiorna il token API usato dall’interfaccia web -- aggiorna automaticamente le credenziali del pannello in caso di successo - -:::info Aggiornamento Sicuro delle Credenziali -Aggiornare le credenziali non rimuove le app installate o i dati di distribuzione. Rinnova solo le credenziali necessarie per l’accesso e la comunicazione. -::: - -### Quando Contattare il Supporto - -Se il problema persiste dopo aver completato tutti i passaggi di risoluzione problemi, 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 pulita del sistema operativo | Riduce conflitti con servizi e porte esistenti | -| Soddisfa le risorse consigliate | Migliora prestazioni e affidabilità | -| Organizza le app in progetti e ambienti | Mantiene gestibili le distribuzioni | -| Configura il DNS prima di assegnare domini | Previene problemi di accesso e SSL | -| Usa con cautela le impostazioni avanzate | Evita modifiche personalizzate non supportate | - -:::tip Mantieni le Distribuzioni Organizzate -Se prevedi di ospitare molte app, crea uno schema di denominazione chiaro per `[your_project_name]`, `[your_environment_name]` e `[your_app_name]` prima di distribuire i primi servizi. -::: - -## Conclusione - -Congratulazioni, hai configurato e utilizzato con successo il VPS One Click Apps Installer per distribuire e gestire app sul tuo server. Per ulteriori domande o assistenza, non esitare a contattare il nostro team di supporto, disponibile ogni giorno per aiutarti! - - \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/ja/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 9877a1eaf..000000000 --- a/i18n/ja/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-one-click-apps-installer -title: "VPS: ワンクリックアプリインストーラー" -description: "VPSのワンクリックアプリインストーラーでアプリを展開し、ウェブインターフェースでプロジェクトを管理し、Coolifyを使った高度なアプリ管理を行う方法を今すぐ学びましょう" -sidebar_label: ワンクリックアプリインストーラー -services: - - vserver ---- - -import InlineVoucher from '@site/src/components/InlineVoucher'; - -## Introduction - -ワンクリックアプリインストーラーを使うと、豊富なアプリカタログから直接VPSのウェブインターフェースでアプリを展開できます。このガイドでは、サーバーの準備、適切なインストールタイプの選択、アプリのインストールと管理、必要に応じた高度な設定やトラブルシューティングツールの使い方を学びます。 - - - -## Preparation - -ワンクリックアプリインストーラーを使用する前に、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の新規イメージを使用してください。 - -## Accessing the One Click Apps Installer - -ZAP-HostingのウェブインターフェースでVPSを開き、ワンクリックアプリセクションを探します。ここから初期セットアップを開始し、後でサーバーにインストールされたすべてのアプリを管理できます。 - -初めてこの機能を開くと、プラットフォームのインストール方法を選択する必要があります。 - -## Choosing an Installation Type - -フルインストールとノードのみインストールのどちらかを選択できます。どちらを選ぶかは、このVPSが管理パネルとアプリの両方をホストするか、別のパネルのリンクノードとしてのみ機能するかによります。 - -### Full Installation - -管理パネルとノードとしてのサーバーをセットアップしたい場合は、**フルインストール**を選択してください。初めてのユーザーや標準的な展開に推奨されるオプションです。 - -この方法でできること： - -- アプリカタログからアプリを展開 -- プロジェクトと環境を管理 -- すべてのアプリを一元管理 -- 統合されたウェブインターフェース管理ツールを使用 -- 必要に応じて高度なパネルにアクセス可能 - -![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) - -:::tip ほとんどのユーザーに推奨 -アプリ機能を初めて使う場合はフルインストールを選択してください。最も簡単なセットアップで、ZAP-Hostingのウェブインターフェースから完全な管理が可能です。 -::: - -### Node-only Installation - -このVPSをノードとしてのみ使いたい場合は、**ノードのみインストール**を選択します。別のVPSサーバーや外部パネルインスタンスにリンクできます。 - -このオプションは以下の用途に便利です： - -- 複数のVPSにまたがるスケールアウト -- 管理を一つのパネルに集中 -- 既存の展開にこのサーバーをリンク -- マルチノード構成の拡張 - -:::note 上級者向け展開オプション -ノードのみインストールは、すでに別のパネルインスタンスを持っているか、外部環境に接続したいユーザー向けです。 -::: - -## Installing the Apps Feature - -インストールタイプを選択したら、ウェブインターフェースからセットアップを開始します。初期インストールは通常数分で完了します。 - -このプロセス中に、ワンクリックアプリ機能に必要なプラットフォームサービスがVPSに展開されます。完了すると、ウェブインターフェースにアプリカタログと管理セクションが表示されます。 - -:::info インストールの挙動 -インストールの進行状況はVPSの性能、OSの状態、ネットワーク状況によって異なる場合があります。セットアップが正常に完了しない場合は、このガイドのトラブルシューティングセクションを参照してください。 -::: - -## Browsing the App Catalogue - -インストール完了後、アプリカタログを開いて利用可能なアプリを閲覧できます。カタログには300以上の即展開可能なアプリがあり、フィルター機能で目的のアプリを素早く見つけられます。 - -![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) - -### Searching and Filtering Apps - -カタログ内ではアプリ名で検索したり、カテゴリで絞り込みができます。これにより、アプリストア風のインターフェースで展開対象を効率的に絞り込めます。 - -よく使う操作： - -- アプリ名で検索 -- カテゴリでフィルター -- 利用可能なアプリの確認 -- 展開したいアプリの選択 - -多くのアプリ展開先を管理したり、複数サービスを比較検討する際に特に便利です。 - -### Starting an App Installation - -カタログからアプリを選択したら、ウェブインターフェースでインストールを開始します。アプリによっては以下のような値を指定する必要があります： - -- `[your_project_name]` -- `[your_environment_name]` -- `[your_domain]` -- `[your_app_name]` - -これらは展開に特化した値で、例えば`[your_domain]`はアプリで使いたいドメインに置き換えてください。 - -:::tip プロジェクトと環境の活用 -複数のアプリをホストしたり、バージョンのテスト、運用とステージングの分離にプロジェクトと環境を使うと展開が整理しやすくなります。 -::: - -## Managing Installed Apps - -展開後、インストール済みアプリはウェブインターフェースの管理セクションに一覧表示されます。ここから、基盤のコンテナを直接操作せずにサービスの監視や制御が可能です。 - -![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) - -### Available Management Actions - -インストール済みアプリセクションでは、一般的なライフサイクル操作をウェブインターフェースから直接行えます。 - -| 操作 | 目的 | -| --- | --- | -| 起動 | 停止中のアプリを起動 | -| 停止 | 実行中のアプリを停止 | -| ログ確認 | トラブルシューティング用にアプリログを開く | -| 再インストール | アプリを再展開 | - -これらのツールにより、コマンドライン操作なしで一元的にアプリ管理が簡単になります。 - -### Organizing Projects and Environments - -プロジェクトと環境は展開を明確に構造化するのに役立ちます。以下のように分けて使えます： - -- 個人用と本番用アプリ -- テスト環境とライブ環境 -- 複数の顧客やチームの展開 -- 同一VPS上の異なるスタック - -アプリストアのアプリ数が増え、複数ノードで管理する際に特に重要になります。 - -## Domains, Cloud Access, and 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]`を指していない場合、ドメイン認証やアプリアクセスに失敗します。 -::: - -## Using Advanced Settings - -上級ユーザーは高度な設定セクションから外部パネルにアクセスして、より詳細なカスタマイズや展開制御が可能です。 - -![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) - -標準のウェブインターフェースを超えた機能や直接操作が必要な場合に便利です。 - -### Important Support Limitation - -:::caution 高度なパネル利用時のサポート範囲 -外部Coolifyパネルの利用は歓迎しますが、サポートはZAP-Hostingのウェブインターフェースに限定されます。ウェブインターフェース外での変更にはサポートが提供されない場合があります。 -::: - -### When to Use the Advanced Panel - -以下のような場合に高度なパネルを使うと良いでしょう： - -- 詳細な展開カスタマイズが必要 -- ノードリンクの直接操作 -- 高度なアプリ設定 -- 簡易インターフェースを超えたパネル管理 - -アクセスを失ったり連携が停止した場合は、手動変更前に下記のトラブルシューティングを試してください。 - -## Linking Nodes - -ノードのみインストールを選択した場合、このVPSを別のVPSや外部パネルにリンクできます。これによりインフラをスケールし、複数ノードを一元管理可能です。 - -ノードリンクは以下の用途に便利です： - -- 複数VPSにアプリを分散 -- 管理を集中化 -- 孤立展開を作らずに拡張 -- 外部パネル環境に接続 - -:::note 外部パネルリンク -ノードは別VPSや外部パネルにリンク可能です。リンクの詳細は既存の環境に依存します。 -::: - -## Troubleshooting Degraded Status - -ウェブインターフェースで状態が劣化している場合、プラットフォームがOne Click Apps機能を動かすインスタンスに接続できていません。以下の手順を順に実施してください。 - -### Status Indicators - -トラブルシューティングのポップアップには以下のような状態が表示されます： - -| ステータス | 意味 | -| --- | --- | -| Coolify Status: Active | パネルサービスが稼働中の可能性あり | -| API Status: Accessible | APIに現在アクセス可能 | -| Service Status: Online | VPS自体がオンライン | - -いずれかが正常でない場合は次の手順へ進みます。 - -### Step 1: Confirm the VPS Is Online - -まず、ZAP-HostingのウェブインターフェースでVPSがオンラインであることを確認してください。サーバーがオフラインの場合、アプリプラットフォームは機能しません。 - -### Step 2: Refresh the Status - -**ステータス更新**操作で最新データによるヘルスチェックを再実行します。これで一時的な通信障害が解消されることがあります。 - -:::tip 一時的な接続問題の可能性 -劣化状態は短時間の通信問題が原因の場合があります。まずはステータス更新を試すのが最速です。 -::: - -### Step 3: Restart Docker - -状態が改善しない場合は**Docker再起動**を実行してください。プラットフォームインスタンスが再起動されます。成功後は`1-2分`待ってから再度ステータスを更新します。 - -:::caution サービス再起動の注意 -Docker再起動中は実行中のアプリが一時的に停止する可能性があります。 -::: - -### Step 4: Refresh Credentials - -最後に**認証情報の更新**を行います。状態がオンラインでもアプリインストールなどの機能が動作しない場合に特に重要です。 - -この操作は： - -- データを削除しません -- rootユーザーの認証情報を更新 -- ウェブインターフェースが使うAPIトークンを更新 -- 成功時にパネル認証情報を自動更新 - -:::info 認証情報更新は安全 -認証情報の更新はインストール済みアプリや展開データを削除しません。アクセスと通信に必要な認証情報のみを更新します。 -::: - -### When to Contact Support - -すべてのトラブルシューティングを試しても問題が解決しない場合は、ZAP-Hostingのウェブサイトからサポートチケットを作成してください。 - -## Best Practices - -ワンクリックアプリインストーラーを安定して管理しやすく保つために、以下の推奨事項を守ってください： - -| ベストプラクティス | 理由 | -| --- | --- | -| 新規OSインストールを使う | 既存サービスやポートとの競合を減らすため | -| 推奨リソースを満たす | パフォーマンスと信頼性向上のため | -| アプリをプロジェクトと環境で整理 | 展開管理を簡単にするため | -| ドメイン割り当て前にDNS設定を済ませる | アクセスとSSL問題を防ぐため | -| 高度な設定は慎重に使う | サポート対象外のカスタム変更を避けるため | - -:::tip 展開を整理しよう -多くのアプリをホストする場合は、最初に`[your_project_name]`、`[your_environment_name]`、`[your_app_name]`の命名ルールを決めておくと便利です。 -::: - -## Conclusion - -おめでとうございます。VPSのワンクリックアプリインストーラーを使って、サーバー上でアプリを展開・管理することに成功しました。ご不明点やサポートが必要な場合は、毎日対応しているサポートチームまでお気軽にお問い合わせください！ - - \ No newline at end of file diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/nl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 34c8c52f5..000000000 --- a/i18n/nl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-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'; - -## Introductie - -De One Click Apps Installer laat je een uitgebreide app-catalogus doorzoeken en apps direct vanuit je VPS-webinterface uitrollen. 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. - - - -## Voorbereiding - -Voordat je de One Click Apps Installer gebruikt, moet je VPS aan de minimale eisen voldoen en een ondersteund besturingssysteem gebruiken. - -:::info Minimale Vereisten -De apps-functie vereist dat je VPS online is en voldoende 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 - EN - 64bit | - -:::caution Verse OS Installatie Aanbevolen -Het wordt sterk aanbevolen om de apps-functie op een verse besturingssysteeminstallatie op te zetten. Dit voorkomt conflicten met bestaande services, bezette poorten, Docker-omgevingen of aangepaste configuraties die al op de server aanwezig zijn. -::: - -Als je je VPS opnieuw moet installeren voordat je verdergaat, gebruik dan een verse ondersteunde Debian- of Ubuntu LTS-image vanuit 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 kun je de initiële setup starten en later terugkeren om alle geïnstalleerde apps op de server te beheren. - -De eerste keer dat je deze functie opent, moet je kiezen hoe het platform op je VPS geïnstalleerd moet worden. - -## Keuze van Installatietype - -Je kunt kiezen tussen een volledige installatie en een node-only installatie. De juiste optie hangt af van of deze VPS zowel het beheerpaneel als de apps moet hosten, of alleen als gekoppelde node voor een ander paneel moet fungeren. - -### Volledige Installatie - -Kies **Volledige Installatie** als je de server wilt opzetten met het paneel en 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 uitrollen -- projecten en omgevingen beheren -- alle apps op één plek organiseren -- gebruikmaken van geïntegreerde webinterface beheertools -- 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 dit je eerste keer is dat je de apps-functie gebruikt, kies dan voor de volledige installatie. Dit biedt de eenvoudigste setup en geeft je volledige beheer 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 deze dan koppelen aan een andere VPS-server of een externe paneelinstantie. - -Deze optie is handig als je wilt: - -- schalen over meerdere VPS-systemen -- beheer centraliseren op één paneel -- deze server koppelen aan een bestaande deployment -- een bestaand multi-node systeem uitbreiden - -:::note Geavanceerde Deployment Optie -Node-only installatie is bedoeld voor gebruikers die al een ander paneel beschikbaar hebben of deze server willen koppelen aan een externe omgeving. -::: - -## Installeren van de Apps-functie - -Na het kiezen van het installatietype start je de setup vanuit 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 voltooid is, worden de app-catalogus en beheersecties beschikbaar in de webinterface. - -:::info Installatiegedrag -De exacte voortgang van de installatie kan variëren afhankelijk van de prestaties van je VPS, de staat van het besturingssysteem en netwerkcondities. Als de setup niet succesvol voltooid wordt, bekijk dan later de troubleshooting-sectie in deze gids. -::: - -## De App-catalogus Doorzoeken - -Zodra de installatie voltooid is, kun je de app-catalogus openen en de beschikbare apps doorzoeken. De catalogus bevat meer dan 300 direct uitrolbare 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. Dit helpt je om alle apps in de app-store-achtige interface te beperken en de juiste deployment voor je project te vinden. - -Typische acties zijn: - -- zoeken op app-naam -- filteren op categorie -- beschikbare app-entries bekijken -- een app selecteren voor installatie - -Deze workflow is vooral handig als je veel apps beheert of meerdere services vergelijkt voor installatie. - -### Een App Installeren - -Na het selecteren van een app uit de catalogus, start je de installatie via de webinterface. Afhankelijk van de app moet je mogelijk waarden definiëren 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]` moet je vervangen door het domein dat je voor de app wilt gebruiken. - -:::tip Projecten en Omgevingen -Gebruik projecten en omgevingen om je deployment georganiseerd te houden. Dit is vooral handig als je meerdere apps host, versies test of productie- en staging-services scheidt. -::: - -## Beheren van Geïnstalleerde Apps - -Na deployment worden je geïnstalleerde apps weergegeven in de beheersectie van de webinterface. Vanaf hier kun je je services monitoren en beheren zonder handmatig met de onderliggende containers te werken. - -![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) - -### Beschikbare Beheeracties - -De sectie voor geïnstalleerde apps laat je veelvoorkomende lifecycle-acties direct vanuit de webinterface uitvoeren. - -| Actie | Doel | -| --- | --- | -| Start | Start een gestopte app | -| Stop | Stopt een draaiende app | -| Logs bekijken | Opent de app-logs voor troubleshooting | -| Herinstalleren | Rol de app opnieuw uit | - -Deze tools maken het makkelijker om alle apps vanaf één plek te beheren, vooral als je eenvoudige webgebaseerde controle wilt in plaats van handmatige command line administratie. - -### Projecten en Omgevingen Organiseren - -Projecten en omgevingen helpen je om je deployments overzichtelijk te structureren. 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 organisatie wordt steeds belangrijker naarmate je app-store 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. Dit stelt je in staat om apps veilig bloot te stellen en SSL-certificaten voor je deployments te regelen. - -:::info Domein- en SSL-ondersteuning -Je kunt custom domeinen gebruiken voor je apps en profiteren van SSL-certificaat provisioning waar dit door de platformsetup wordt ondersteund. -::: - -Bij het toewijzen van een domein moet je ervoor zorgen dat je DNS-records naar `[your_server_ip]` wijzen. Als je domein niet correct is geconfigureerd, kan de app niet bereikbaar worden vanaf het 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 dat beschikbaar is in de geavanceerde instellingen. - -![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) - -Dit is handig als je diepere aanpassingen, uitgebreidere deploymentcontrole of directe toegang tot functies buiten de standaard webinterface nodig hebt. - -### Belangrijke Supportbeperking - -:::caution Supportbereik voor Geavanceerd Paneelgebruik -Geavanceerde gebruikers kunnen het externe Coolify-paneel gebruiken voor extra aanpassingen en functionaliteit. Support is echter beperkt tot de ZAP-Hosting webinterface. Als je wijzigingen buiten de webinterface maakt, is ondersteuning voor die aanpassingen mogelijk niet beschikbaar. -::: - -### Wanneer het Geavanceerde Paneel te Gebruiken - -Je wilt het geavanceerde paneel gebruiken als je: - -- meer gedetailleerde deployment-aanpassingen nodig hebt -- directe node-koppelingsworkflows wilt -- geavanceerde app-configuratie wilt -- paneelbeheer wilt dat verder gaat dan de vereenvoudigde interface - -Als je de toegang verliest of de integratie niet meer reageert, gebruik dan eerst de troubleshooting-tools hieronder voordat je handmatige wijzigingen maakt. - -## Nodes Koppelen - -Als je het node-only installatietype hebt gekozen, kun je deze VPS koppelen aan een andere VPS-server of een externe paneelinstantie. Dit stelt je in staat om je infrastructuur te schalen en meerdere nodes vanaf één locatie te beheren. - -Node-koppeling is handig als je wilt: - -- apps verspreiden over meerdere VPS-systemen -- beheer centraliseren -- capaciteit uitbreiden zonder geïsoleerde deployments te maken -- koppelen aan een externe paneelomgeving - -:::note Externe Paneelkoppeling -Je kunt je node koppelen aan een andere VPS of een externe paneelinstantie. De exacte koppelingsdetails hangen af van de reeds gebruikte doelomgeving. -::: - -## Troubleshooting bij Verlaagde Status - -Als de webinterface een verlaagde status toont, betekent dit dat het platform geen contact kan maken met of geen 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 lijkt te draaien | -| API Status: Toegankelijk | De API is momenteel bereikbaar | -| Service Status: Online | Je VPS zelf is online | - -Als één of meerdere onderdelen niet correct functioneren, ga dan verder met de onderstaande stappen. - -### Stap 1: Bevestig dat de VPS Online Is - -Controleer eerst of je VPS-service online is in de ZAP-Hosting webinterface. Als de server offline is, kan het apps-platform niet functioneren. - -### Stap 2: Vernieuw de Status - -Gebruik de actie **Status Vernieuwen** om de healthcheck opnieuw uit te voeren met de nieuwste data. Dit kan tijdelijke, intermitterende problemen oplossen. - -:::tip Tijdelijke Connectiviteitsproblemen -Een verlaagde status kan soms veroorzaakt worden door een kortdurend communicatieprobleem. Het vernieuwen van de status is de snelste eerste check. -::: - -### Stap 3: Herstart Docker - -Als de status nog steeds verlaagd is, gebruik dan de actie **Docker Herstarten**. Dit forceert een herstart van de platforminstantie. Wacht na een succesvolle respons `1-2 minuten` en vernieuw de status opnieuw. - -:::caution Service Herstart -Het herstarten van Docker kan lopende apps tijdelijk onderbreken terwijl de services opnieuw opstarten. -::: - -### Stap 4: Vernieuw Referenties - -Als laatste stap gebruik je **Referenties Vernieuwen**. Dit is vooral belangrijk als de status online lijkt, maar functies in de webinterface zoals app-installatie niet werken. - -Deze actie: - -- verwijdert je data **niet** -- vernieuwt de root-gebruikersreferenties -- vernieuwt het API-token dat door de webinterface wordt gebruikt -- werkt de panelreferenties automatisch bij bij succes - -:::info Veilige Referentie Vernieuwing -Het vernieuwen van referenties verwijdert je geïnstalleerde apps of deploymentdata niet. Het vernieuwt alleen de benodigde referenties voor toegang en communicatie. -::: - -### Wanneer Contact Opnemen met Support - -Als het probleem blijft bestaan nadat je alle troubleshooting-stappen hebt doorlopen, maak dan een supportticket aan via de ZAP-Hosting website. - -## Best Practices - -Om de One Click Apps Installer stabiel en makkelijk beheersbaar te houden, volg je deze aanbevelingen: - -| Best practice | Reden | -| --- | --- | -| Gebruik een verse OS-installatie | Vermindert conflicten met bestaande services en poorten | -| Voldoe aan aanbevolen resources | Verbetert prestaties en betrouwbaarheid | -| Organiseer apps in projecten en omgevingen | Houdt deployments beheersbaar | -| Configureer DNS vóór domeintoewijzing | Voorkomt toegang- en SSL-problemen | -| Gebruik geavanceerde instellingen voorzichtig | Voorkomt niet-ondersteunde aanpassingen | - -:::tip Houd Deployments Georganiseerd -Als je van plan bent veel apps te hosten, maak dan een duidelijke naamgevingsstructuur 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 uit te rollen en te beheren. Voor verdere vragen of hulp kun je altijd contact opnemen met onze supportafdeling, die dagelijks voor je klaarstaat! - - \ No newline at end of file diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/pl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 05a931a6f..000000000 --- a/i18n/pl/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-one-click-apps-installer -title: "VPS: Instalator aplikacji One Click" -description: "Wdrażaj aplikacje za pomocą instalatora One Click Apps na VPS, zarządzaj projektami przez interfejs webowy i korzystaj z Coolify do zaawansowanego zarządzania aplikacjami -> Dowiedz się więcej" -sidebar_label: Instalator One Click Apps -services: - - vserver ---- - -import InlineVoucher from '@site/src/components/InlineVoucher'; - -## Wprowadzenie - -Instalator One Click Apps pozwala przeglądać rozbudowany katalog aplikacji i wdrażać je bezpośrednio z panelu webowego VPS. W tym poradniku nauczysz 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. - - - -## Przygotowanie - -Przed użyciem instalatora One Click Apps 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 niezawodnego uruchomienia zarówno usług platformy, jak i zainstalowanych aplikacji. -::: - -| Wymaganie | Minimum | Zalecane | -| --- | --- | --- | -| Status serwera | Online | Online | -| Pamięć dyskowa | 30 GB | 50 GB | -| 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 -Zaleca się 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 One Click Apps - -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ć, aby 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 użytkowników po raz pierwszy 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 -- uzyskać 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ę. Zapewnia najprostszy setup i 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 -- połączyć ten serwer z istniejącym wdrożeniem -- 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ą podłączyć serwer do zewnętrznego środowiska. -::: - -## 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 VPS wdrażane są usługi platformy wymagane do działania funkcji One Click Apps. Po zakończeniu katalog aplikacji i sekcje zarządzania stają 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 powiedzie się, zapoznaj się z 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 umożliwia filtrowanie, aby szybko znaleźć odpowiednią 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ć według kategorii. Pomaga to zawęzić listę dostępnych aplikacji i znaleźć właściwy 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, jeśli 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 pola to 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 wdrożeniach. Jest to szczególnie pomocne, gdy hostujesz wiele aplikacji, testujesz wersje lub oddzielasz środowiska produkcyjne i testowe. -::: - -## 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 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 przeglądarkę zamiast ręcznej administracji w terminalu. - -### Organizacja projektów i środowisk - -Projekty i środowiska pomagają jasno uporządkować 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 i zarządzasz wieloma usługami na jednym lub kilku węzłach. - -## Domeny, dostęp do chmury i SSL - -Funkcja One Click Apps obsługuje własne domeny i integrację z ZAP Cloud. Pozwala to na bezpieczne udostępnianie aplikacji i automatyczne wystawianie certyfikatów SSL dla 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 platforma to wspiera. -::: - -Przy przypisywaniu domeny upewnij się, że rekordy DNS wskazują na `[your_server_ip]`. Jeśli domena nie jest poprawnie skonfigurowana, aplikacja może być niedostępna z internetu. - -| Wartość | Opis | -| --- | --- | -| `[your_domain]` | Domenę lub subdomenę przypisaną 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 dodatkowej funkcjonalności przez zewnętrzny panel dostępny w sekcji zaawansowanych ustawień. - -![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) - -Jest 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 dokonasz zmian poza panelem webowym, pomoc w zakresie tych modyfikacji może nie być dostępna. -::: - -### Kiedy używać zaawansowanego panelu - -Możesz chcieć użyć zaawansowanego panelu, jeśli potrzebujesz: - -- bardziej szczegółowej personalizacji wdrożenia -- 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 z narzędzi do rozwiązywania problemów opisanych poniżej, zanim wykonasz 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 środowiska docelowego już używanego. -::: - -## Rozwiązywanie problemów ze stanem obniżonej jakości - -Jeśli panel webowy pokazuje stan obniżonej jakości, oznacza to, że platforma nie może skontaktować się 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 - -Okno rozwiązywania problemów może pokazywać takie wskaźniki: - -| Status | Znaczenie | -| --- | --- | -| Stan Coolify: Aktywny | Usługa panelu działa | -| Stan API: Dostępne | API jest obecnie osiągalne | -| Stan 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 może 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 obniżonej jakości może być spowodowany krótkotrwałym problemem komunikacyjnym. Odświeżenie statusu to najszybsza pierwsza kontrola. -::: - -### Krok 3: Uruchom ponownie Dockera - -Jeśli status nadal jest obniżony, użyj akcji **Uruchom ponownie Dockera**. Wymusza to restart instancji platformy. Po pozytywnej odpowiedzi odczekaj `1-2 minuty` i ponownie odśwież status. - -:::caution Restart usługi -Restart Dockera może tymczasowo przerwać działanie uruchomionych aplikacji podczas restartu usług. -::: - -### Krok 4: Odśwież dane uwierzytelniające - -Na koniec użyj **Odśwież dane uwierzytelniające**. Jest to szczególnie ważne, jeśli status pokazuje online, ale funkcje panelu webowego, takie jak instalacja aplikacji, nie działają. - -Ta akcja: - -- **nie** usuwa Twoich danych -- odświeża dane uwierzytelniające użytkownika root -- odświeża token API używany przez panel webowy -- automatycznie aktualizuje dane uwierzytelniające panelu po sukcesie - -:::info Bezpieczne odświeżanie danych uwierzytelniających -Odświeżanie danych uwierzytelniających nie usuwa zainstalowanych aplikacji ani danych wdrożenia. 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ć stabilność i łatwość zarządzania instalatorem One Click Apps, 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 niezawodność | -| 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 zmian niestandardowych | - -:::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 One Click Apps 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 wsparcia, który jest dostępny codziennie, aby Ci pomóc! - - \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/pt/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 13151a88a..000000000 --- a/i18n/pt/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-one-click-apps-installer -title: "VPS: Instalador de Apps One Click" -description: "Implemente apps com o Instalador de Apps One Click para VPS, gerencie projetos pela interface web e use o Coolify para gerenciamento avançado -> Saiba mais agora" -sidebar_label: Instalador One Click de Apps -services: - - vserver ---- - -import InlineVoucher from '@site/src/components/InlineVoucher'; - -## Introdução - -O Instalador de Apps One Click permite que você navegue por um catálogo extenso de apps e implemente-os diretamente pela interface web do seu VPS. Neste guia, você vai aprender a preparar seu servidor, escolher o tipo correto de instalação, instalar e gerenciar apps, além de usar as configurações avançadas e ferramentas de solução de problemas quando necessário. - - - -## Preparação - -Antes de usar o Instalador de Apps One Click, seu VPS deve 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 - EN - 64bit | - -:::caution Recomendação de 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 personalizaçõ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 controle do seu VPS. - -## Acessando o Instalador de Apps One Click - -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 retornar para gerenciar todos os apps instalados no servidor. - -Na primeira vez que abrir esse recurso, será necessário 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 controle 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ó. Esta é a opção recomendada para usuários iniciantes e para a maioria das implantações padrão. - -Com este método, você pode: - -- implementar apps do catálogo de apps -- 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 posteriormente, se necessário - -![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 permite gerenciamento completo diretamente pela interface web da ZAP-Hosting. -::: - -### Instalação Apenas como Nó - -Escolha **Instalação Apenas como Nó** se quiser que este VPS atue somente como um nó. Você poderá vinculá-lo a outro servidor VPS ou a uma instância de painel externa. - -Esta opção é útil se você deseja: - -- escalar entre vários sistemas VPS -- centralizar o gerenciamento em um único painel -- vincular este servidor a uma implantação existente -- expandir uma configuração multi-nó já existente - -:::note Opção Avançada de Implantação -A instalação apenas como nó é destinada a usuários que já possuem outra instância de painel disponível ou que querem conectar este servidor a um ambiente externo. -::: - -## Instalando o Recurso de Apps - -Após selecionar 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 seu VPS, estado do sistema operacional e condições da rede. Se a configuração não for concluída com sucesso, consulte a seção de solução de problemas mais adiante neste guia. -::: - -## Navegando pelo Catálogo de Apps - -Quando a instalação estiver completa, 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 implantação e suporta filtros para ajudar a encontrar o app correto rapidamente. - -![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) - -### Pesquisando e Filtrando Apps - -No catálogo, você pode buscar apps pelo nome e filtrar por categoria. Isso ajuda a restringir 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 de apps -- selecionar um app para implantação - -Esse fluxo é especialmente útil se você gerencia muitos apps ou compara vários serviços antes da instalação. - -### Iniciando a Instalação de um App - -Após selecionar um app no catálogo, inicie 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 espaços reservados 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 múltiplos apps, versões de teste ou separa serviços de produção e staging. -::: - -## Gerenciando Apps Instalados - -Após a implantação, seus apps instalados aparecem na seção de gerenciamento da interface web. A partir daí, você pode monitorar e controlar seus serviços sem precisar trabalhar manualmente com os containers subjacentes. - -![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) - -### Ações de Gerenciamento Disponíveis - -A seção de apps instalados permite executar ações comuns do ciclo de vida diretamente 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 o gerenciamento de todos os apps em um 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 -- implantações para múltiplos clientes ou equipes -- diferentes stacks no mesmo VPS - -Essa organização se torna cada vez mais importante conforme sua coleção de apps cresce e você gerencia mais serviços em um ou mais nós. - -## Domínios, Acesso Cloud e SSL - -O recurso One Click Apps suporta domínios personalizados e integração com a 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 de que seus registros DNS apontem para `[your_server_ip]`. Se seu 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 adicionais 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 implantação 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 adicionais. Porém, o suporte é limitado à interface web da ZAP-Hosting. Se você fizer alterações fora da interface web, a assistência pode não estar disponível para essas modificações personalizadas. -::: - -### Quando Usar o Painel Avançado - -Você pode querer usar o painel avançado se precisar de: - -- personalização detalhada da implantação -- fluxos de trabalho diretos de vinculação de nós -- configuração avançada de apps -- gerenciamento em nível de 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 alterações manuais. - -## Vinculando Nós - -Se você escolheu o tipo de instalação apenas como nó, pode vincular este VPS a outro servidor VPS ou a uma instância de painel externa. Isso permite escalar sua infraestrutura e gerenciar múltiplos nós a partir de um único local. - -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 de painel externo - -:::note Vinculação a Painel Externo -Você pode vincular seu nó a outro VPS ou a uma instância de painel externa. 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 alimenta o recurso One Click Apps. Siga os passos de solução de problemas na ordem cronológica. - -### Indicadores de Status - -O popup de solução de problemas pode mostrar indicadores como os seguintes: - -| Status | Significado | -| --- | --- | -| Status Coolify: Ativo | O serviço do painel parece estar rodando | -| Status API: Acessível | A API pode ser alcançada atualmente | -| Status Serviço: Online | Seu VPS está online | - -Se uma ou mais partes não estiverem funcionando corretamente, continue com os passos abaixo. - -### Passo 1: Confirme que o VPS Está Online - -Primeiro, certifique-se de que seu serviço VPS está online na interface web da ZAP-Hosting. Se o servidor estiver offline, a plataforma de apps não pode funcionar. - -### Passo 2: Atualize o Status - -Use a ação **Atualizar Status** para rodar a verificação de saúde novamente com os dados mais recentes. Isso pode resolver problemas temporários e intermitentes. - -:::tip Problemas Temporários de Conectividade -Um estado degradado pode ser causado por uma falha de comunicação de curta duração. Atualizar o status é a verificação inicial mais rápida. -::: - -### 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 uma resposta bem-sucedida, aguarde `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. - -Esta 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 de solução de problemas, abra um ticket de suporte pelo site da ZAP-Hosting. - -## Melhores Práticas - -Para manter o Instalador de Apps One Click estável e fácil de gerenciar, siga estas 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 alterações personalizadas não suportadas | - -:::tip Mantenha as 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 One Click para VPS para implantar e gerenciar apps no seu servidor. Para dúvidas ou assistência, não hesite em contatar nossa equipe de suporte, que está disponível diariamente para ajudar você! 🙂 - - \ No newline at end of file diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/sv/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 17e74d5fe..000000000 --- a/i18n/sv/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-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 - -One Click Apps Installer låter dig bläddra i ett omfattande appkatalog och distribuera appar direkt från din 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. - - - -## Preparation - -Innan du använder One Click Apps Installer måste din VPS uppfylla minimikraven och använda ett stöds operativsystem. - -:::info Minimala krav -Appfunktionen 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 Rekommenderat med färskt operativsystem -Det rekommenderas starkt att sätta upp appfunktionen 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 din VPS-hanteringspanel. - -## Accessing the One Click Apps Installer - -Öppna din VPS i ZAP-Hostings webbgränssnitt och hitta avsnittet One Click Apps. Där 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 den här funktionen måste du välja hur plattformen ska installeras på din VPS. - -## Choosing an Installation Type - -Du kan välja mellan en fullständig installation och en nod-endast installation. Rätt alternativ beror på om denna VPS ska vara värd för både hanteringspanelen och apparna, eller bara fungera 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 alternativet 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 vid behov - -![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 appfunktionen, 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 endast ska fungera som en nod. Du kan då länka den till en annan VPS-server eller till en extern panelinstans. - -Detta alternativ ä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 installationsalternativ -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ö. -::: - -## Installing the Apps Feature - -Efter att ha valt installationstypen startar du 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, se felsökningsavsnittet senare i guiden. -::: - -## Browsing the App Catalogue - -När installationen är klar kan du öppna appkatalogen och bläddra bland tillgängliga appar. Katalogen innehåller mer än 300 färdiga appar för distribution och stöder filtrering för att snabbt hitta rätt app. - -![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) - -### Searching and Filtering Apps - -I katalogen kan du söka efter appar med namn och filtrera efter kategori. Detta hjälper dig att begränsa alla appar som finns i appbutiksgränssnittet och hitta rätt distributionsmål för ditt projekt. - -Typiska åtgärder inkluderar: - -- söka efter appnamn -- filtrera efter kategori -- granska tillgängliga appposter -- 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. - -### Starting an App Installation - -Efter att ha valt en app från katalogen startar du installationen via webbgränssnittet. Beroende på appen 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 produktions- och stagingtjänster. -::: - -## Managing Installed Apps - -Efter distribution listas dina installerade appar i hanteringssektionen i webbgränssnittet. Härifrån kan du övervaka och kontrollera dina tjänster utan att behöva arbeta manuellt med de underliggande containrarna. - -![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) - -### Available Management Actions - -Sektionen för installerade appar låter dig utföra vanliga livscykelåtgärder direkt från webbgränssnittet. - -| Åtgärd | Syfte | -| --- | --- | -| Start | Startar en stoppad app | -| Stop | Stoppar en körande app | -| Check logs | Öppnar apploggar för felsökning | -| Reinstall | Installerar 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. - -### Organizing Projects and Environments - -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 organisering blir allt viktigare när din samling av appbutiksappar växer och du hanterar fler tjänster på en eller flera noder. - -## Domains, Cloud Access, and SSL - -One Click Apps-funktionen stöder anpassade domäner och ZAP Cloud-integration. Detta gör att du kan exponera appar säkert och tillhandahålla 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-certifikatutfärdande där plattformsuppsättningen stöder 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. -::: - -## Using Advanced Settings - -Avancerade användare kan få tillgång till ytterligare 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 åtkomst till funktioner utöver standardwebbgränssnittet. - -### Important Support Limitation - -:::caution Supportens omfattning för avancerad panelanvändning -Avancerade användare är välkomna att använda den externa Coolify-panelen för ytterligare 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 med dessa anpassningar vara otillgänglig. -::: - -### When to Use the Advanced Panel - -Du kan vilja använda den avancerade panelen om du behöver: - -- mer detaljerad anpassning av distributionen -- direkt nodlänkning -- avancerad appkonfiguration -- panelhantering utöver det förenklade gränssnittet - -Om du förlorar åtkomst eller integrationen slutar svara, använd felsökningsverktygen nedan innan du gör manuella ändringar. - -## Linking Nodes - -Om du valde nod-endast 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. -::: - -## Troubleshooting Degraded Status - -Om webbgränssnittet visar ett degraderat 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. - -### Status Indicators - -Felsökningspopupen kan visa indikatorer som följande: - -| Status | Betydelse | -| --- | --- | -| Coolify Status: Active | Paneltjänsten verkar vara igång | -| API Status: Accessible | API:et är för närvarande tillgängligt | -| Service Status: Online | Din VPS är online | - -Om en eller flera delar inte fungerar korrekt, fortsätt med stegen nedan. - -### Step 1: Confirm the VPS Is Online - -Först, kontrollera att din VPS-tjänst är online i ZAP-Hostings webbgränssnitt. Om servern är offline kan inte appplattformen fungera. - -### Step 2: Refresh the Status - -Använd åtgärden **Refresh Status** för att köra hälsokontrollen igen med den senaste datan. Detta kan lösa tillfälliga intermittentproblem. - -:::tip Tillfälliga anslutningsproblem -Ett degraderat tillstånd kan ibland orsakas av ett kortvarigt kommunikationsproblem. Att uppdatera status är den snabbaste första kontrollen. -::: - -### Step 3: Restart Docker - -Om status fortfarande är degraderad, använd åtgärden **Restart Docker**. Detta tvingar plattformsinstansen att starta om. Efter ett lyckat svar, vänta `1-2 minuter` och uppdatera status igen. - -:::caution Omstart av tjänst -Att starta om Docker kan tillfälligt avbryta körande appar medan tjänsterna startar om. -::: - -### Step 4: Refresh Credentials - -Som sista steg, använd **Refresh Credentials**. Detta är särskilt viktigt om status visas som online men webbgränssnittsfunktioner 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. -::: - -### When to Contact Support - -Om problemet kvarstår efter att ha genomfört alla felsökningssteg, skapa en supportticket via ZAP-Hostings webbplats. - -## Best Practices - -För att hålla One Click Apps Installer stabil och lätt 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 tillförlitlighet | -| 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. -::: - -## Conclusion - -Grattis, du har framgångsrikt satt upp och använt VPS One Click Apps Installer för att distribuera och hantera appar på din server. För ytterligare 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/verver-one-click-apps-installer.md b/i18n/th/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index 8cbb4e206..000000000 --- a/i18n/th/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,284 +0,0 @@ ---- -id: verver-one-click-apps-installer -title: "VPS: ตัวติดตั้งแอปด้วยคลิกเดียว" -description: "ติดตั้งแอปด้วยตัวติดตั้งแอปคลิกเดียวของ VPS จัดการโปรเจกต์ผ่านเว็บอินเทอร์เฟซ และใช้ Coolify สำหรับการจัดการแอประดับสูง -> เรียนรู้เพิ่มเติมตอนนี้" -sidebar_label: ตัวติดตั้งแอปคลิกเดียว -services: - - vserver ---- - -import InlineVoucher from '@site/src/components/InlineVoucher'; - -## Introduction - -ตัวติดตั้งแอปคลิกเดียวช่วยให้คุณเรียกดูแคตตาล็อกแอปขนาดใหญ่และติดตั้งแอปโดยตรงจากเว็บอินเทอร์เฟซของ VPS ในคู่มือนี้ คุณจะได้เรียนรู้วิธีเตรียมเซิร์ฟเวอร์ เลือกประเภทการติดตั้งที่ถูกต้อง ติดตั้งและจัดการแอป รวมถึงใช้การตั้งค่าขั้นสูงและเครื่องมือแก้ไขปัญหาเมื่อจำเป็น - - - -## Preparation - -ก่อนใช้ตัวติดตั้งแอปคลิกเดียว 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 ของคุณ - -## Accessing the One Click Apps Installer - -เปิด VPS ของคุณในเว็บอินเทอร์เฟซ ZAP-Hosting แล้วค้นหาส่วน One Click Apps จากตรงนั้นคุณสามารถเริ่มการตั้งค่าเริ่มต้นและกลับมาจัดการแอปทั้งหมดที่ติดตั้งบนเซิร์ฟเวอร์ได้ภายหลัง - -ครั้งแรกที่เปิดฟีเจอร์นี้ คุณต้องเลือกวิธีติดตั้งแพลตฟอร์มบน VPS ของคุณ - -## Choosing an Installation Type - -คุณสามารถเลือกได้ระหว่างการติดตั้งแบบเต็มและการติดตั้งเฉพาะโหนด ตัวเลือกที่ถูกต้องขึ้นอยู่กับว่า VPS นี้จะโฮสต์ทั้งแผงควบคุมและแอป หรือทำหน้าที่เป็นโหนดที่เชื่อมต่อกับแผงควบคุมอื่นเท่านั้น - -### Full Installation - -เลือก **Full Installation** หากคุณต้องการตั้งค่าเซิร์ฟเวอร์พร้อมแผงควบคุมและเซิร์ฟเวอร์เองในฐานะโหนด นี่คือทางเลือกที่แนะนำสำหรับผู้ใช้ครั้งแรกและการติดตั้งมาตรฐานส่วนใหญ่ - -ด้วยวิธีนี้ คุณจะสามารถ: - -- ติดตั้งแอปจากแคตตาล็อกแอป -- จัดการโปรเจกต์และสภาพแวดล้อม -- จัดระเบียบแอปทั้งหมดในที่เดียว -- ใช้เครื่องมือจัดการผ่านเว็บอินเทอร์เฟซที่รวมมาให้ -- เข้าถึงแผงควบคุมขั้นสูงได้ในภายหลังหากต้องการ - -![img](https://screensaver01.zap-hosting.com/index.php/s/nqGL3PFPicTArY9/preview) - -:::tip แนะนำสำหรับผู้ใช้ส่วนใหญ่ -ถ้านี่เป็นครั้งแรกที่คุณใช้ฟีเจอร์แอป ให้เลือกตัวเลือกติดตั้งแบบเต็ม เพราะเป็นการตั้งค่าที่ง่ายที่สุดและให้การจัดการครบถ้วนโดยตรงจากเว็บอินเทอร์เฟซของ ZAP-Hosting -::: - -### Node-only Installation - -เลือก **Node-only Installation** หากคุณต้องการให้ VPS นี้ทำหน้าที่เป็นโหนดเท่านั้น จากนั้นคุณสามารถเชื่อมต่อกับ VPS อื่นหรือแผงควบคุมภายนอกได้ - -ตัวเลือกนี้เหมาะสำหรับกรณีที่คุณต้องการ: - -- ขยายระบบผ่าน VPS หลายเครื่อง -- รวมศูนย์การจัดการบนแผงควบคุมเดียว -- เชื่อมต่อเซิร์ฟเวอร์นี้กับการติดตั้งที่มีอยู่แล้ว -- ขยายระบบหลายโหนดที่มีอยู่ - -:::note ตัวเลือกการติดตั้งขั้นสูง -การติดตั้งแบบโหนดเท่านั้นเหมาะสำหรับผู้ใช้ที่มีแผงควบคุมอื่นอยู่แล้วหรือผู้ที่ต้องการเชื่อมต่อเซิร์ฟเวอร์นี้กับสภาพแวดล้อมภายนอก -::: - -## Installing the Apps Feature - -หลังเลือกประเภทการติดตั้ง ให้เริ่มการตั้งค่าจากเว็บอินเทอร์เฟซ การติดตั้งเริ่มต้นมักใช้เวลาไม่กี่นาที - -ในขั้นตอนนี้ บริการแพลตฟอร์มที่จำเป็นสำหรับฟีเจอร์ One Click Apps จะถูกติดตั้งบน VPS ของคุณ เมื่อเสร็จสิ้น แคตตาล็อกแอปและส่วนจัดการจะพร้อมใช้งานในเว็บอินเทอร์เฟซ - -:::info พฤติกรรมการติดตั้ง -รายละเอียดความคืบหน้าการติดตั้งอาจแตกต่างกันตามประสิทธิภาพ VPS สถานะระบบปฏิบัติการ และเงื่อนไขเครือข่าย หากการตั้งค่าไม่สำเร็จ ให้ตรวจสอบส่วนแก้ไขปัญหาภายหลังในคู่มือนี้ -::: - -## Browsing the App Catalogue - -เมื่อการติดตั้งเสร็จสิ้น คุณสามารถเปิดแคตตาล็อกแอปและเรียกดูแอปที่มีให้เลือกได้ แคตตาล็อกมีแอปพร้อมติดตั้งมากกว่า 300 รายการและรองรับการกรองเพื่อช่วยให้คุณค้นหาแอปที่ต้องการได้อย่างรวดเร็ว - -![](https://screensaver01.zap-hosting.com/index.php/s/fBwcCiNJTZooqnB/preview) - -### Searching and Filtering Apps - -ในแคตตาล็อก คุณสามารถค้นหาแอปตามชื่อและกรองตามหมวดหมู่ ช่วยให้จำกัดแอปทั้งหมดในอินเทอร์เฟซสไตล์สโตร์และหาจุดติดตั้งที่เหมาะสมสำหรับโปรเจกต์ของคุณ - -การทำงานทั่วไปได้แก่: - -- ค้นหาตามชื่อแอป -- กรองตามหมวดหมู่ -- ตรวจสอบรายการแอปที่มี -- เลือกแอปเพื่อติดตั้ง - -เวิร์กโฟลว์นี้มีประโยชน์มากหากคุณจัดการเป้าหมายดาวน์โหลดแอปจำนวนมากหรือเปรียบเทียบบริการหลายตัวก่อนติดตั้ง - -### Starting an App Installation - -หลังเลือกแอปจากแคตตาล็อก ให้เริ่มติดตั้งผ่านเว็บอินเทอร์เฟซ ขึ้นอยู่กับแอป คุณอาจต้องกำหนดค่าต่างๆ เช่น: - -- `[your_project_name]` -- `[your_environment_name]` -- `[your_domain]` -- `[your_app_name]` - -ตัวแปรเหล่านี้แทนค่าที่เฉพาะเจาะจงสำหรับการติดตั้งของคุณ เช่น `[your_domain]` ควรถูกแทนที่ด้วยโดเมนที่คุณต้องการใช้กับแอป - -:::tip โปรเจกต์และสภาพแวดล้อม -ใช้โปรเจกต์และสภาพแวดล้อมเพื่อจัดระเบียบการติดตั้งของคุณ โดยเฉพาะอย่างยิ่งเมื่อคุณโฮสต์แอปหลายตัว ทดสอบเวอร์ชัน หรือแยกบริการระหว่างโปรดักชันและสเตจจิ้ง -::: - -## Managing Installed Apps - -หลังติดตั้ง แอปที่ติดตั้งจะแสดงในส่วนจัดการของเว็บอินเทอร์เฟซ จากตรงนี้คุณสามารถตรวจสอบและควบคุมบริการโดยไม่ต้องจัดการคอนเทนเนอร์ด้วยตนเอง - -![](https://screensaver01.zap-hosting.com/index.php/s/WTMSqkJ5zPKWjmn/preview) - -### Available Management Actions - -ส่วนแอปที่ติดตั้งช่วยให้คุณทำงานวงจรชีวิตทั่วไปได้โดยตรงจากเว็บอินเทอร์เฟซ - -| การกระทำ | จุดประสงค์ | -| --- | --- | -| Start | เริ่มแอปที่หยุดทำงาน | -| Stop | หยุดแอปที่กำลังทำงาน | -| Check logs | เปิดบันทึกแอปเพื่อแก้ไขปัญหา | -| Reinstall | ติดตั้งแอปใหม่ | - -เครื่องมือเหล่านี้ช่วยให้จัดการแอปทั้งหมดได้ง่ายขึ้นจากที่เดียว โดยเฉพาะถ้าคุณต้องการควบคุมผ่านเว็บแทนการใช้คำสั่งด้วยตนเอง - -### Organizing Projects and Environments - -โปรเจกต์และสภาพแวดล้อมช่วยให้คุณจัดโครงสร้างการติดตั้งได้ชัดเจน คุณสามารถใช้แยก: - -- แอปส่วนตัวและแอปโปรดักชัน -- สภาพแวดล้อมทดสอบและใช้งานจริง -- การติดตั้งลูกค้าหรือทีมหลายราย -- สแตกต่างๆ บน VPS เดียวกัน - -การจัดระเบียบนี้สำคัญมากขึ้นเมื่อคอลเลกชันแอปในสโตร์ของคุณเพิ่มขึ้นและคุณจัดการบริการมากขึ้นบนโหนดหนึ่งหรือหลายโหนด - -## Domains, Cloud Access, and 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]` การตรวจสอบโดเมนและการเข้าถึงแอปอาจล้มเหลว -::: - -## Using Advanced Settings - -ผู้ใช้ขั้นสูงสามารถเข้าถึงฟังก์ชันเพิ่มเติมผ่านแผงควบคุมภายนอกที่มีในส่วนการตั้งค่าขั้นสูง - -![](https://screensaver01.zap-hosting.com/index.php/s/BHnZWBGAzgo5myp/preview) - -สิ่งนี้มีประโยชน์หากคุณต้องการปรับแต่งลึกขึ้น ควบคุมการติดตั้งขยาย หรือเข้าถึงฟีเจอร์ที่เกินกว่าเว็บอินเทอร์เฟซมาตรฐาน - -### Important Support Limitation - -:::caution ขอบเขตการสนับสนุนสำหรับการใช้แผงควบคุมขั้นสูง -ผู้ใช้ขั้นสูงสามารถใช้แผง Coolify ภายนอกเพื่อปรับแต่งและฟังก์ชันเพิ่มเติมได้ แต่การสนับสนุนจำกัดเฉพาะเว็บอินเทอร์เฟซของ ZAP-Hosting หากคุณเปลี่ยนแปลงนอกเว็บอินเทอร์เฟซ อาจไม่ได้รับความช่วยเหลือสำหรับการปรับแต่งเหล่านั้น -::: - -### When to Use the Advanced Panel - -คุณอาจต้องใช้แผงขั้นสูงหากต้องการ: - -- ปรับแต่งการติดตั้งอย่างละเอียด -- เวิร์กโฟลว์การเชื่อมต่อโหนดโดยตรง -- การตั้งค่าแอประดับสูง -- การจัดการแผงควบคุมที่เกินกว่าหน้าเว็บแบบง่าย - -หากคุณสูญเสียการเข้าถึงหรือการเชื่อมต่อหยุดตอบสนอง ให้ใช้เครื่องมือแก้ไขปัญหาที่อธิบายไว้ด้านล่างก่อนทำการเปลี่ยนแปลงด้วยตนเอง - -## Linking Nodes - -ถ้าคุณเลือกการติดตั้งแบบโหนดเท่านั้น คุณสามารถเชื่อมต่อ VPS นี้กับ VPS อื่นหรือแผงควบคุมภายนอกได้ ช่วยให้ขยายโครงสร้างพื้นฐานและจัดการโหนดหลายตัวจากที่เดียว - -การเชื่อมต่อโหนดเหมาะสำหรับกรณีที่คุณต้องการ: - -- กระจายแอปไปยัง VPS หลายเครื่อง -- รวมศูนย์การจัดการ -- ขยายความจุโดยไม่สร้างการติดตั้งแยก -- เชื่อมต่อกับสภาพแวดล้อมแผงควบคุมภายนอก - -:::note การเชื่อมต่อแผงควบคุมภายนอก -คุณสามารถเชื่อมต่อโหนดกับ VPS อื่นหรือแผงควบคุมภายนอก รายละเอียดการเชื่อมต่อขึ้นอยู่กับสภาพแวดล้อมเป้าหมายที่ใช้งานอยู่แล้ว -::: - -## Troubleshooting Degraded Status - -ถ้าเว็บอินเทอร์เฟซแสดงสถานะเสื่อม หมายความว่าแพลตฟอร์มไม่สามารถติดต่อหรือดึงข้อมูลจากอินสแตนซ์ที่รันฟีเจอร์ One Click Apps ได้ ให้ทำตามขั้นตอนแก้ไขปัญหาเรียงตามลำดับเวลา - -### Status Indicators - -ป๊อปอัปแก้ไขปัญหาอาจแสดงตัวชี้วัดดังนี้: - -| สถานะ | ความหมาย | -| --- | --- | -| Coolify Status: Active | บริการแผงควบคุมดูเหมือนกำลังทำงาน | -| API Status: Accessible | API สามารถเข้าถึงได้ในขณะนี้ | -| Service Status: Online | VPS ของคุณออนไลน์ | - -ถ้าส่วนใดส่วนหนึ่งไม่ทำงาน ให้ดำเนินการตามขั้นตอนด้านล่างต่อไป - -### Step 1: Confirm the VPS Is Online - -ตรวจสอบให้แน่ใจว่า VPS ของคุณออนไลน์ในเว็บอินเทอร์เฟซ ZAP-Hosting หากเซิร์ฟเวอร์ออฟไลน์ แพลตฟอร์มแอปจะไม่ทำงาน - -### Step 2: Refresh the Status - -ใช้คำสั่ง **Refresh Status** เพื่อตรวจสอบสุขภาพระบบอีกครั้งด้วยข้อมูลล่าสุด วิธีนี้ช่วยแก้ไขปัญหาชั่วคราวที่เกิดขึ้นเป็นบางครั้งได้ - -:::tip ปัญหาการเชื่อมต่อชั่วคราว -สถานะเสื่อมอาจเกิดจากปัญหาการสื่อสารชั่วคราว การรีเฟรชสถานะเป็นการตรวจสอบเบื้องต้นที่เร็วที่สุด -::: - -### Step 3: Restart Docker - -ถ้าสถานะยังเสื่อมอยู่ ให้ใช้คำสั่ง **Restart Docker** เพื่อบังคับให้อินสแตนซ์แพลตฟอร์มรีสตาร์ท หลังจากตอบสนองสำเร็จ รอ `1-2 นาที` แล้วรีเฟรชสถานะอีกครั้ง - -:::caution การรีสตาร์ทบริการ -การรีสตาร์ท Docker อาจทำให้แอปที่กำลังรันหยุดชั่วคราวในระหว่างที่บริการกำลังรีสตาร์ท -::: - -### Step 4: Refresh Credentials - -ขั้นตอนสุดท้าย ใช้คำสั่ง **Refresh Credentials** ซึ่งสำคัญมากถ้าสถานะดูออนไลน์แต่ฟังก์ชันในเว็บอินเทอร์เฟซ เช่น การติดตั้งแอป ไม่ทำงาน - -คำสั่งนี้: - -- **ไม่** ลบข้อมูลของคุณ -- รีเฟรชข้อมูลรับรองผู้ใช้ root -- รีเฟรชโทเค็น API ที่เว็บอินเทอร์เฟซใช้ -- อัปเดตข้อมูลรับรองแผงควบคุมโดยอัตโนมัติเมื่อสำเร็จ - -:::info การรีเฟรชข้อมูลรับรองอย่างปลอดภัย -การรีเฟรชข้อมูลรับรองไม่ลบแอปที่ติดตั้งหรือข้อมูลการติดตั้งใดๆ เพียงแค่ต่ออายุข้อมูลรับรองที่จำเป็นสำหรับการเข้าถึงและการสื่อสาร -::: - -### When to Contact Support - -ถ้าปัญหายังไม่หายหลังทำตามขั้นตอนแก้ไขปัญหาทั้งหมด ให้สร้างตั๋วซัพพอร์ตผ่านเว็บไซต์ ZAP-Hosting - -## Best Practices - -เพื่อให้ตัวติดตั้งแอปคลิกเดียวเสถียรและจัดการง่าย ให้ทำตามคำแนะนำเหล่านี้: - -| แนวทางปฏิบัติที่ดีที่สุด | เหตุผล | -| --- | --- | -| ใช้การติดตั้งระบบปฏิบัติการใหม่ | ลดความขัดแย้งกับบริการและพอร์ตที่มีอยู่ | -| ตรงตามทรัพยากรที่แนะนำ | เพิ่มประสิทธิภาพและความเสถียร | -| จัดระเบียบแอปเป็นโปรเจกต์และสภาพแวดล้อม | ทำให้การติดตั้งจัดการง่ายขึ้น | -| ตั้งค่า DNS ก่อนกำหนดโดเมน | ป้องกันปัญหาการเข้าถึงและ SSL | -| ใช้การตั้งค่าขั้นสูงอย่างระมัดระวัง | หลีกเลี่ยงการเปลี่ยนแปลงที่ไม่รองรับ | - -:::tip รักษาการติดตั้งให้เป็นระเบียบ -ถ้าคุณวางแผนโฮสต์แอปจำนวนมาก ให้สร้างระบบตั้งชื่อที่ชัดเจนสำหรับ `[your_project_name]`, `[your_environment_name]` \ No newline at end of file diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md b/i18n/zh/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md deleted file mode 100644 index e3d8cdca8..000000000 --- a/i18n/zh/docusaurus-plugin-content-docs/current/verver-one-click-apps-installer.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -id: verver-one-click-apps-installer -title: "VPS：一键应用安装器" -description: "通过 VPS 一键应用安装器部署应用，通过网页界面管理项目，并使用 Coolify 进行高级应用管理 -> 立即了解更多" -sidebar_label: 一键应用安装器 -services: - - vserver ---- - -import InlineVoucher from '@site/src/components/InlineVoucher'; - -## 介绍 - -一键应用安装器让你可以浏览丰富的应用目录，并直接从 VPS 网页界面部署应用。在本指南中，你将学习如何准备服务器、选择正确的安装类型、安装和管理应用，以及在需要时使用高级设置和故障排除工具。 - - - -## 准备工作 - -在使用一键应用安装器之前，你的 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 云集成。这样你可以安全地暴露应用，并为部署申请 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 From 160852ff02e0411dcdbfa2b6e18c9dd2182d2b43 Mon Sep 17 00:00:00 2001 From: fgalz Date: Tue, 21 Apr 2026 13:11:48 +0200 Subject: [PATCH 5/6] Sidebar --- sidebars.js | 1 + 1 file changed, 1 insertion(+) 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", From bc07869a736470ed8ce3bd36708ba74abe931747 Mon Sep 17 00:00:00 2001 From: github-actions Date: Tue, 21 Apr 2026 13:16:23 +0200 Subject: [PATCH 6/6] Auto-translate docs --- .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ .../vserver-one-click-apps-installer.md | 293 ++++++++++++++++++ 12 files changed, 3516 insertions(+) create mode 100644 i18n/ar/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/es/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/fr/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/it/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/ja/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/nl/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/pl/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/pt/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/sv/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/th/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md create mode 100644 i18n/zh/docusaurus-plugin-content-docs/current/vserver-one-click-apps-installer.md 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