# Technical Documentation: 1Panel-dev/1Panel > ℹ️ **Provenance:** Multi-Tier Ingestion · [CodeWiki Reference](https://codewiki.google/github.com/1Panel-dev/1Panel) ### Overview (README.md)

Loved by a global community of 2.5M+ self-hosters.

--- ## What is 1Panel? 1Panel is a modern, open-source Linux server management panel and a lightweight AI management platform. Through an intuitive web interface, it provides users with comprehensive, one-stop server management capabilities: - **AI Management**: Offers a unified management platform from bare metal to agents (Metal-to-Agent). It integrates an AI gateway, and Skills Hub, while supporting centralized management of agents and models. - **Efficient Visual Operations**: Easily manage Linux servers through a web-based GUI, streamlining tasks such as host monitoring, file management, database management, and container management. - **Rapid Website Deployment**: Deeply integrates with popular website builders like WordPress and Halo. It enables one-click domain binding and SSL certificate configuration, significantly lowering the barrier to website creation. - **Curated App Store**: Features a built-in store of high-quality open-source applications, providing one-click installation and upgrade services to effortlessly extend server capabilities. - **Enterprise-Grade Security**: Deploys applications based on container technology to effectively minimize vulnerability exposure. It also provides security features such as WAF and log auditing to ensure comprehensive server protection. - **One-Click Data Backup**: Supports one-click backup and restoration, and integrates with various cloud storage solutions to ensure data security and prevent loss. ## Why 1Panel? | | 1Panel | cPanel / Plesk | aaPanel | Webmin | |--|--------|----------------|---------|--------| | Free & open source | ✅ | ❌ | Partial | ✅ | | AI management | ✅ | ❌ | ❌ | ❌ | | One-click app marketplace | ✅ 165+ apps | ❌ | ✅ | ❌ | | Modern UI (post-2020) | ✅ | ❌ | Partial | ❌ | | Docker / container management | ✅ | ❌ | ❌ | ❌ | | Active development | ✅ | ✅ | ✅ | Slow | ## Quick Start Prepare your Linux server and run the following script: ```bash bash -c "$(curl -sSL https://resource.1panel.pro/v2/quick_start.sh)" ``` After installation, open `http://:/` in your browser. Run `1pctl user-info` via SSH if you need to retrieve your access credentials. ## Screenshot ## Pro Edition 1Panel OSS is free forever. 1Panel Pro and Ent adds features built for teams and production workloads: | Feature | OSS | Pro | Ent | |---------|:---:|:---:|:---:| | One-click app installs | ✅ | ✅ | ✅ | | AI agents (OpenClaw) | 5 agent | Unlimited | ✅ | | WAF & advanced security | Basic | ✅ | ✅ | | Website tamper protection | ❌ | ✅ | ✅ | | Website uptime monitoring | ❌ | ✅ | ✅ | | Multi-node management | ❌ | ✅ | ✅ | | Custom logo & theme | ❌ | ✅ | ✅ | | KVM Web UI | ❌ | ❌ | ✅ | | AI Gateway | ❌ | ❌ | ✅ | | Priority support | ❌ | ❌ | ✅ | ## Community & Support - **Discord** — [Join the community](https://discord.gg/bUpUqWqdRr) for help, feature requests, and show-and-tell - **Docs** — [1panel.pro/docs](https://1panel.pro/docs) - **Issues** — [GitHub Issues](https://github.com/1Panel-dev/1Panel/issues) for bug reports ## Security Found a vulnerability? Please read [SECURITY.md](/SECURITY.md) before disclosing. ## License Licensed under the [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.html). --- ### README.Ar (`docs/README.ar.md`)

أفضل أداة إدارة خوادم لينكس عبر الويب بتقييم عالٍ

------------------------------

1Panel هي لوحة تحكم وتشغيل وتصيان خادمات Linux من الجيل الجديد. - **الإدارة الفعالة**: من خلال واجهة رسومية ويب مستخدمة بسهولة، يتيح 1Panel للمستخدمين إدارة خادمات Linux الخاصة بهم بلا عناء. وتشمل الميزات الرئيسية مراقبة المضيفات، وإدارة الملفات، وإدارة قواعد البيانات، وإدارة الحاويات. - **استعراض المواقع على الإنترنت بسرعة**: بفضل التكامل العميق مع برنامج WordPress الشهير لبناء المواقع عبر الإنترنت المفتوح المصدر، يعمل 1Panel على تبسيط عملية ربطドومين (المجال) وتكوين شهادات SSL، وكل ذلك يمكن تحقيقه بضغطة زر واحدة. - **مخزن التطبيقات**: يقوم 1Panel بترتيب مجموعة واسعة من الأدوات والتطبيقات المفتوحة المصدر عالية الجودة، مما يسهل عملية التثبيت والتحديثات لاستخدميه. - **الأمن والاستقرار**: من خلال الاستفادة من الحاويات وممارسات استقرارية لتوزيع التطبيقات الآمنة، يعمل 1Panel على تقليل تغيرات الحساسية. كما يعزز الأمن بشكل أكبر من خلال إمكانيات إدارة الحماية الحائط والتدقيق في السجلات. - **نسخ واحتياطي و استعادة بضغطة زر واحدة**: حماية البيانات أصبحت بسيطة بفضل وظيفة النسخ واحتياطي واستعادة بضغطة زر واحدة في 1Panel، والتي تدعم حلول تخزين سحابية مختلفة لضمان سلامة البيانات وسهولة الوصول إليها. ## بداية سريعة أعد تشغيل البرنامج النصي أدناه واتبع التعليمات التي تظهر لتثبيت 1Panel: ```bash curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` يرجى الرجوع إلى مستنداتنا [هنا](https://docs.1panel.pro/quick_start/) لمزيد من التفاصيل. ## مقاطع شاشة ## تاريخ النجوم [](https://star-history.com/#1Panel-dev/1Panel&Date) ## معلومات أمنية إذا اكتشفت أي مشاكل أمنية، يرجى الاتصال بنا عبر: wanghe@fit2cloud.com. ## رخصة مخول بموجب الرخصة العامة العامة لغنو GPLv3 (الرخصة العامة العامة لغنو GPLv3) (هذه "الرخصة")؛ لن تتمكن من استخدام هذا الملف إلا إذا اتبعت الرخصة. يمكنك الحصول على نسخة من الرخصة من ما لم يكن ذلك مطلوبًا بموجب القانون المعمول به أو لم يتم الاتفاق عليه كتابيًا، يتم توزيع البرنامج الموزع بموجب الرخصة على أساس "كما هو"، بلا أي نوع من الضمانات أو الشروط، سواء كانت صريحة أو ضمنية. راجع الرخصة للحصول على اللغة المحددة التي تحكم الصلاحيات والقيود بموجب الرخصة.

--- ### README.De (`docs/README.de.md`)

Hochbewertetes Web-basiertes Linux-Server-Management-Tool

------------------------------ 1Panel ist ein modernes und quelloffenes Web-basiertes Steuerungsfeld zur Verwaltung von Linux-Servern. - **Effiziente Verwaltung**: Über eine benutzerfreundliche grafische Web-Schnittstelle ermöglicht 1Panel es Benutzern, ihre Linux-Server mühelos zu verwalten. Zu seinen Hauptfunktionen gehören die Überwachung des Hosts, die Dateiverwaltung, die Datenbankadministration und die Containerverwaltung. - **Schnelle Website-Bereitstellung**: Durch die tiefe Integration des beliebten quelloffenen Website-Erstellungstools WordPress vereinfacht 1Panel den Prozess der Domainbindung und der SSL-Zertifikatskonfiguration, und alles kann mit nur einem Klick erreicht werden. - **App-Store**: 1Panel bietet eine Vielzahl hochwertiger quelloffener Tools und Anwendungen an und erleichtert die Installation und Aktualisierung für seine Benutzer. - **Sicherheit und Zuverlässigkeit**: Durch die Nutzung von Containerisierungstechnologie und sicheren Anwendungsbereitstellungspraktiken minimiert 1Panel die Angriffsfläche für Schwachstellen. Die Sicherheit wird durch integriertes Firewall-Management und Audit-Log-Funktionen weiter erhöht. - **Ein-Klick-Sicherung und -Wiederherstellung**: Der Datenschutz wird durch die Ein-Klick-Sicherungs- und -Wiederherstellungsfunktionen von 1Panel vereinfacht und unterstützt verschiedene Cloud-Speicherlösungen, um die Integrität und Verfügbarkeit der Daten zu gewährleisten. ## Schneller Startleitfaden Führen Sie das folgende Skript aus und befolgen Sie die Anweisungen, um 1Panel zu installieren: ```bash curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` Bitte verweisen Sie auf unsere [Dokumentation](https://docs.1panel.pro/quick_start/) für weitere Informationen. ## Bildschirmfoto ## Sternverlauf [](https://star-history.com/#1Panel-dev/1Panel&Date) ## Sicherheitsinformationen Wenn Sie irgendwelche Sicherheitsprobleme entdecken, kontaktieren Sie uns bitte über: wanghe@fit2cloud.com. ## Lizenz Lizenziert unter der GNU General Public License Version 3 (GPLv3) (die „Lizenz“); Sie dürfen diese Datei nur in Übereinstimmung mit der Lizenz verwenden. Sie können eine Kopie der Lizenz unter https://www.gnu.org/licenses/gpl-3.0.html erhalten. Sofern nicht durch anwendbares Recht vorgeschrieben oder schriftlich vereinbart, wird die unter der Lizenz verbreitete Software „AS IS“ ohne jegliche Arten von Garantien oder Bedingungen verteilt, sei es ausdrücklich oder stillschweigend. Siehe die Lizenz für die spezifische Sprache, die die Rechte und Einschränkungen unter der Lizenz regelt. --- ### README.Es Es (`docs/README.es-es.md`)

La herramienta de gestión más valorada para administrar servidores Linux.

------------------------------ 1Panel es un panel de control moderno y de código abierto basado en web para la gestión de servidores Linux. - **Gestión eficiente**: los usuarios pueden gestionar fácilmente servidores Linux a través de una interfaz web, como monitorización de hosts, gestión de archivos, gestión de bases de datos, gestión de contenedores, entre otros; - **Creación rápida de sitios web**: integración profunda con el software de creación de sitios web de código abierto WordPress y Halo, operaciones como vinculación de dominios y configuración de certificados SSL se realizan con un solo clic; - **Tienda de aplicaciones**: selección de diversas herramientas y software de código abierto de alta calidad, ayudando a los usuarios a instalar y actualizar fácilmente; - **Seguro y confiable**: basado en la gestión de contenedores y el despliegue de aplicaciones, se logra la mínima exposición a vulnerabilidades, al tiempo que se ofrecen funciones como protección contra virus, cortafuegos y auditoría de registros; - **Copia de seguridad con un clic**: soporta copias de seguridad y restauraciones con un clic, los usuarios pueden respaldar datos en diversos medios de almacenamiento en la nube, asegurando que nunca se pierdan. ## Inicio Rápido Ejecute el siguiente script y siga las indicaciones para instalar 1Panel: ```bash curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` Por favor, consulte nuestra [documentación](https://docs.1panel.pro/quick_start/) para más detalles. ## Captura de Pantalla ## Historial de Estrellas [](https://star-history.com/#1Panel-dev/1Panel&Date) ## Información de Seguridad Si descubre algún problema de seguridad, contáctenos a través de: wanghe@fit2cloud.com. ## Licencia Licenciado bajo la Licencia Pública General GNU versión 3 (GPLv3) (la "Licencia"); no puede usar este archivo excepto en cumplimiento con la Licencia. Puede obtener una copia de la Licencia en A menos que lo exija la ley aplicable o se acuerde por escrito, el software distribuido bajo la Licencia se distribuye en una BASE "TAL CUAL", SIN GARANTÍAS O CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas. Consulte la Licencia para el lenguaje específico que rige los permisos y limitaciones bajo la Licencia. --- ### README.Fa (`docs/README.fa.md`)

پنل کنترل سرور مجازی متن‌باز با پشتیبانی بومی از عامل‌های هوش مصنوعی

مورد اعتماد بیش از ۲,۰۰۰,۰۰۰ کاربر خودمیزبان در سراسر جهان

--- ## 1Panel چیست؟ 1Panel یک پنل کنترل سرور مجازی مدرن و متن‌باز است — و تنها پنلی که **پشتیبانی بومی از عامل‌های هوش مصنوعی** دارد. مدل‌های Ollama را اجرا کنید، عامل‌های شخصی OpenClaw را مستقر کنید و کل مجموعه سرور خود را از یک رابط وب تمیز مدیریت کنید. بدون نیاز به حفظ کردن دستورات CLI. 👉 ویدیوی [معرفی ۲ دقیقه‌ای](https://www.youtube.com/watch?v=Jl_wqp-XA08) را تماشا کنید ## چرا 1Panel؟ | | 1Panel | cPanel / Plesk | aaPanel | Webmin | |--|--------|----------------|---------|--------| | رایگان و متن‌باز | ✅ | ❌ | جزئی | ✅ | | محیط اجرای بومی عامل هوش مصنوعی | ✅ | ❌ | ❌ | ❌ | | بازارچه برنامه‌های یک‌کلیکی | ✅ ۱۶۵+ برنامه | ❌ | ✅ | ❌ | | رابط کاربری مدرن (پس از ۲۰۲۰) | ✅ | ❌ | جزئی | ❌ | | مدیریت Docker / کانتینر | ✅ | ❌ | ❌ | ❌ | | توسعه فعال | ✅ | ✅ | ✅ | کند | ## ویژگی‌های کلیدی - **محیط اجرای عامل هوش مصنوعی**: مدل‌های LLM Ollama را مستقر کنید، عامل‌های شخصی OpenClaw را راه‌اندازی کنید و مصرف GPU را نظارت کنید — همه از داخل داشبورد. بدون نیاز به مدیریت پشته هوش مصنوعی جداگانه. - **استقرار یک‌کلیکی وب‌سایت**: وب‌سایت‌های آماده تولید را با اتصال خودکار دامنه، تأمین گواهی SSL و پیکربندی Nginx راه‌اندازی کنید — بدون تنظیمات دستی. - **بازارچه برنامه**: ۱۶۵+ برنامه متن‌باز معتبر (Nextcloud، Bitwarden، Umami، NocoBase و موارد دیگر) که با یک کلیک نصب و به‌روزرسانی می‌شوند. - **مدیریت Docker و کانتینر**: کانتینرها، تصاویر، شبکه‌ها و حجم‌ها را از طریق رابط کاربری بصری ایجاد، شروع، متوقف و بررسی کنید — بدون نیاز به کار با CLI. - **امنیت از ابتدا**: قوانین دیواره آتش، fail2ban، ایزوله‌سازی کانتینر، WAF و لاگ‌های حسابرسی — از روز اول پیکربندی و فعال هستند. - **پشتیبان‌گیری و بازیابی**: پشتیبان‌گیری خودکار را به AWS S3، Cloudflare R2 یا ذخیره‌سازی محلی زمان‌بندی کنید. هر تصویر لحظه‌ای را با یک کلیک بازیابی کنید. ## شروع سریع > **نیازمندی‌ها:** سرور مجازی لینوکس (Debian / Ubuntu / CentOS / Rocky)، ۱ گیگابایت رم، دسترسی به اینترنت. > حدود ۶۰ ثانیه زمان می‌برد. ```bash bash -c "$(curl -sSL https://resource.1panel.pro/v2/quick_start.sh)" ``` پس از نصب، `http://:/` را در مرورگر خود باز کنید. در صورت نیاز به دریافت اطلاعات ورود، دستور `1pctl user-info` را از طریق SSH اجرا کنید. ## تصویر صفحه ## نسخه حرفه‌ای 1Panel OSS برای همیشه رایگان است. نسخه Pro ویژگی‌هایی را اضافه می‌کند که برای تیم‌ها و بارهای تولیدی طراحی شده‌اند: | ویژگی | OSS | Pro | |---------|:---:|:---:| | نصب یک‌کلیکی برنامه | ✅ | ✅ | | عامل‌های هوش مصنوعی (OpenClaw) | ۱ عامل | نامحدود | | WAF و امنیت پیشرفته | پایه | ✅ | | محافظت در برابر دستکاری وب‌سایت | ❌ | ✅ | | نظارت بر در دسترس بودن وب‌سایت | ❌ | ✅ | | مدیریت چند گره | ❌ | ✅ | | لوگو و تم سفارشی | ❌ | ✅ | | پشتیبانی اولویت‌دار | ❌ | ✅ | **از ۸۰ دلار در سال.** [مقایسه طرح‌ها و شروع دوره آزمایشی ۳۰ روزه رایگان →](https://1panel.pro/pricing) ## تاریخچه ستاره [](https://star-history.com/#1Panel-dev/1Panel&Date) ## انجمن و پشتیبانی - **Discord** — [به انجمن بپیوندید](https://discord.gg/bUpUqWqdRr) برای راهنمایی، درخواست ویژگی و نمایش و گفتگو - **مستندات** — [1panel.pro/docs](https://1panel.pro/docs) - **مشکلات** — [مشکلات گیت‌هاب](https://github.com/1Panel-dev/1Panel/issues) برای گزارش باگ ## امنیت آسیب‌پذیری پیدا کردید؟ لطفاً قبل از افشا، [SECURITY.md](/SECURITY.md) را مطالعه کنید. ## مجوز تحت مجوز [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.html) مجوز دارد. --- ### README.Fr (`docs/README.fr.md`)

Outil de gestion de serveurs Linux basé sur le web le mieux noté

------------------------------ 1Panel est un panneau de contrôle basé sur le web, moderne et open source, destiné à la gestion de serveurs Linux. - **Gestion efficace**: Grâce à une interface graphique web conviviale, 1Panel permet aux utilisateurs de gérer facilement leurs serveurs Linux. Ses principales fonctionnalités comprennent la surveillance des hôtes, la gestion des fichiers, l'administration des bases de données et la gestion des conteneurs. - **Déploiement rapide de sites web**: Avec une intégration approfondie du logiciel de création de sites Web open-source populaire WordPress, 1Panel simplifie le processus de liaison de domaine et de configuration du certificat SSL, tout cela pouvant être réalisé en un seul clic. - **Boutique d'applications**: 1Panel propose une variété d'outils et d'applications open-source de haute qualité, facilitant l'installation et la mise à jour pour les utilisateurs. - **Sécurité et fiabilité**: En tirant parti de la technologie de conteneurisation et des pratiques de déploiement d'applications sécurisées, 1Panel minimise l'exposition aux vulnérabilités. La sécurité est davantage renforcée via la gestion du pare-feu intégré et la capacité d'audit des journaux. - **Sauvegarde et restauration en un clic**: La protection des données est simplifiée grâce à la fonction de sauvegarde et de restauration en un clic de 1Panel, qui prend en charge diverses solutions de stockage cloud pour garantir l'intégrité et la disponibilité des données. ## Guide de démarrage rapide Exécutez le script ci-dessous et suivez les instructions pour installer 1Panel : ```bash curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` Veuillez vous référer à notre [documentation](https://docs.1panel.pro/quick_start/) pour plus d'informations. ## Capture d'écran ## Histoire des étoiles [](https://star-history.com/#1Panel-dev/1Panel&Date) ## Informations de sécurité Si vous découvrez un quelconque problème de sécurité, veuillez nous contacter via : wanghe@fit2cloud.com. ## Licence Ce logiciel est sous licence GNU General Public License version 3 (GPLv3) (la « Licence ») ; vous ne pouvez utiliser ce fichier que conformément à la Licence. Vous pouvez obtenir une copie de la Licence à l'adresse suivante : Sauf si exigé par la loi en vigueur ou convenu par écrit, le logiciel distribué sous la Licence est distribué « tel quel », SANS GARANTIE D'AUCUNE SORTE, expresse ou implicite, et sans aucune condition. Consultez la Licence pour les termes spécifiques régissant les autorisations et les limitations prévues par la Licence. --- ### README.Id (`docs/README.id.md`)

Alat Manajemen Server Linux Berbasis Web dengan Peringkat Teratas

------------------------------ 1Panel adalah panel kontrol berbasis web yang modern dan open-source untuk manajemen server Linux. - **Manajemen Efisien**: Melalui antarmuka grafis web yang ramah pengguna, 1Panel memungkinkan pengguna mengelola server Linux mereka dengan mudah. Fitur utamanya mencakup pemantauan host, manajemen file, administrasi database, dan manajemen kontainer. - **Penyebaran Situs Web Cepat**: Dengan integrasi mendalam perangkat lunak pembuatan situs web open-source populer WordPress, 1Panel menyederhanakan proses pengikatan domain dan konfigurasi sertifikat SSL, semuanya dapat dicapai hanya dengan satu klik. - **Toko Aplikasi**: 1Panel menyediakan berbagai macam alat dan aplikasi open-source berkualitas tinggi, memudahkan instalasi dan pembaruan bagi penggunanya. - **Keamanan dan Keandalan**: Dengan memanfaatkan teknologi kontainerisasi dan praktik penyebaran aplikasi aman, 1Panel meminimalkan paparan kerentanan. Keamanan lebih ditingkatkan melalui manajemen firewall terintegrasi dan kemampuan audit log. - **Cadangan & Pulih Satu Klik**: Perlindungan data menjadi sederhana dengan fungsi cadangan dan pulih satu klik dari 1Panel, mendukung berbagai solusi penyimpanan cloud untuk memastikan integritas dan ketersediaan data. ## Panduan Cepat Memulai Jalankan skrip di bawah ini dan ikuti petunjuk untuk menginstal 1Panel: ```bash curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` Silakan merujuk ke [dokumentasi](https://docs.1panel.pro/quick_start/) kami untuk informasi lebih lanjut. ## Tangkapan Layar ## Star History [](https://star-history.com/#1Panel-dev/1Panel&Date) ## Informasi Keamanan Jika Anda menemukan masalah keamanan apa pun, silakan hubungi kami melalui: wanghe@fit2cloud.com. ## License Dilindungi di bawah Lisensi GNU General Public License versi 3 (GPLv3) (selanjutnya disebut “Lisensi”); Anda tidak diperbolehkan menggunakan file ini kecuali sesuai dengan ketentuan Lisensi. Anda dapat memperoleh salinan Lisensi di https://www.gnu.org/licenses/gpl-3.0.html Kecuali diwajibkan oleh hukum yang berlaku atau disetujui secara tertulis, perangkat lunak yang didistribusikan berdasarkan Lisensi ini disediakan “APA ADANYA” TANPA JAMINAN APAPUN, baik tersurat maupun tersirat. Lihat Lisensi untuk informasi lebih lanjut mengenai hak dan batasan dalam Lisensi ini. --- ### README.Ja (`docs/README.ja.md`)

最高評価のWebベースのLinuxサーバー管理ツール

------------------------------ 1Panel はモダンでオープンソースの Linux サーバー操作と管理パネルです: - **効率的管理**：ユーザーは、Web グラフィカルインターフェースを使用して、Linux サーバーを簡単に管理し、ホストの監視、ファイル管理、データベース管理、コンテナ管理などの機能を実現できます。 - **迅速なウェブサイト構築**：オープンソースのウェブサイト構築ソフトウェアであるWordPressと[Halo](https://github.com/halo-dev/halo/)を深く統合し、ドメインのバインディング、SSL 証明書の設定などをワンクリックで完了します。 - **アプリストア**：さまざまな高品質のオープンソースツールやアプリケーションソフトウェアを厳選して提供し、ユーザーが簡単にインストールおよびアップグレードできるよう支援します。 - **安全性と信頼性**：コンテナの管理とアプリケーションのデプロイに基づいて、最小限の脆弱性露出面を実現し、同時にファイアウォールやログ監査などの機能を提供します。 - **ワンクリックバックアップ**：ワンクリックでバックアップと復元をサポートし、ユーザーはデータをさまざまなクラウドストレージメディアにバックアップし、永久に失うことはありません。 ## クイックスタートワンクリックで 1Panel をインストールするには、次のコマンドを実行します: ```sh curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` ## UI ディスプレイ ## Star History [](https://star-history.com/#1Panel-dev/1Panel&Date) ## セキュリティ情報セキュリティの問題を発見した場合は、以下の方法でご連絡ください：wanghe@fit2cloud.com。 ## License このファイルは、GNU General Public License バージョン 3 (GPLv3)（以下「ライセンス」）の下でライセンスされています。ライセンスに従わない限り、このファイルを使用することはできません。ライセンスのコピーは以下で取得できます。適用法により要求される場合、または書面で同意される場合を除き、ライセンスの下で配布されるソフトウェアは「現状のまま（AS IS）」で提供され、いかなる種類の保証もありません。ライセンスにおける特定の権利および制限については、ライセンスを参照してください。 --- ### README.Ko (`docs/README.ko.md`)

최고 평점의 웹 기반 리눅스 서버 관리 도구

------------------------------ 1Panel은 리눅스 서버 관리를 위한 오픈 소스 현대 웹 기반 제어판입니다. - **효율적인 관리**: 사용자 친화적인 웹 그래픽 인터페이스를 통해 1Panel은 사용자가 리눅스 서버를 손쉽게 관리할 수 있도록 합니다. 주요 기능으로는 호스트 모니터링, 파일 관리, 데이터베이스 관리 및 컨테이너 관리가 포함됩니다. - **신속한 웹사이트 배포**: 인기 있는 오픈 소스 웹사이트 빌딩 소프트웨어인 WordPress와의 깊은 통합을 통해 1Panel은 도메인 바인딩 및 SSL 인증서 구성을 단 한 번의 클릭으로 간소화합니다. - **애플리케이션 스토어**: 1Panel은 다양한 고품질 오픈 소스 도구 및 애플리케이션을 선별하여 사용자가 쉽게 설치하고 업데이트할 수 있도록 합니다. - **보안 및 신뢰성**: 컨테이너화 및 안전한 애플리케이션 배포 관행을 활용하여 1Panel은 취약점 노출을 최소화합니다. 또한 통합 방화벽 관리 및 로그 감사 기능을 통해 보안을 강화합니다. - **원클릭 백업 및 복원**: 1Panel의 원클릭 백업 및 복원 기능을 통해 데이터 보호가 간편해지며, 다양한 클라우드 스토리지 솔루션을 지원하여 데이터 무결성과 가용성을 보장합니다. ## 빠른 시작 아래 스크립트를 실행하고 프롬프트에 따라 1Panel을 설치하세요: ```bash curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` 자세한 내용은 [문서](https://docs.1panel.pro/quick_start/)를 참조하세요. ## 스크린샷 ## 스타 히스토리 [](https://star-history.com/#1Panel-dev/1Panel&Date) ## 보안 정보 보안 문제를 발견하신 경우, 다음을 통해 저희에게 연락해 주시기 바랍니다: wanghe@fit2cloud.com. ## 라이센스 GNU 일반 공공 라이센스 버전 3(GPLv3) (이하 "라이센스")에 따라 이 파일을 사용할 수 있으며, 라이센스를 준수하지 않는 한 이 파일을 사용할 수 없습니다. 라이센스의 사본은 다음에서 얻을 수 있습니다. 적용 가능한 법률에 따라 요구되거나 서면으로 동의하지 않는 한, 라이센스에 따라 배포된 소프트웨어는 "있는 그대로" 제공되며, 명시적이거나 묵시적인 보증이나 조건이 없습니다. 라이센스에 따라 권한 및 제한 사항을 규정하는 특정 언어를 참조하십시오. --- ### README.Lo (`docs/README.lo.md`)

ແຜງຄວບຄຸມ VPS ແບບໂອເພນຊອດ ພ້ອມການຮອງຮັບເອເຈນ AI ໃນຕົວ

ໄດ້ຮັບຄວາມໄວ້ວາງໃຈຈາກຜູ້ໃຊ້ໂຮສເອງຫຼາຍກວ່າ 2,000,000 ຄົນທົ່ວໂລກ

--- ## 1Panel ແມ່ນຫຍັງ? 1Panel ແມ່ນແຜງຄວບຄຸມ VPS ທີ່ທັນສະໄໝ ແລະ ເປັນໂອເພນຊອດ — ພ້ອມທັງເປັນແຜງດຽວທີ່ມີ **ການຮອງຮັບເອເຈນ AI ໃນຕົວ**. ທ່ານສາມາດໃຊ້ງານໂມເດວ Ollama, ນຳໃຊ້ເອເຈນສ່ວນຕົວ OpenClaw ແລະ ຈັດການລະບົບເຊີບເວີທັງໝົດຜ່ານໜ້າເວັບທີ່ສະອາດຕາ. ບໍ່ຕ້ອງຈື່ຄຳສັ່ງ CLI. 👉 ເບິ່ງ [ວິດີໂອແນະນຳ 2 ນາທີ](https://www.youtube.com/watch?v=Jl_wqp-XA08) ## ເປັນຫຍັງຕ້ອງເລືອກ 1Panel? | | 1Panel | cPanel / Plesk | aaPanel | Webmin | |--|--------|----------------|---------|--------| | ຟຣີ ແລະ ເປັນໂອເພນຊອດ | ✅ | ❌ | ບາງສ່ວນ | ✅ | | ຮັນໄທມ໌ເອເຈນ AI ໃນຕົວ | ✅ | ❌ | ❌ | ❌ | | ຕະຫຼາດແອັບແບບຄລິກດຽວ | ✅ 165+ ແອັບ | ❌ | ✅ | ❌ | | UI ທັນສະໄໝ (ຫຼັງປີ 2020) | ✅ | ❌ | ບາງສ່ວນ | ❌ | | ການຈັດການ Docker / ຄອນເທນເນີ | ✅ | ❌ | ❌ | ❌ | | ພັດທະນາຢ່າງຕໍ່ເນື່ອງ | ✅ | ✅ | ✅ | ຊ້າ | ## ຄຸນສົມບັດຫຼັກ - **ຮັນໄທມ໌ເອເຈນ AI**: ນຳໃຊ້ໂມເດວ LLM ຂອງ Ollama, ເປີດໃຊ້ເອເຈນສ່ວນຕົວ OpenClaw ແລະ ຕິດຕາມການໃຊ້ GPU — ທັງໝົດເຮັດໄດ້ຈາກແດຊບອດ. ບໍ່ຕ້ອງຈັດການສະແຕັກ AI ແຍກຕ່າງຫາກ. - **ນຳໃຊ້ເວັບໄຊດ້ວຍຄລິກດຽວ**: ເປີດໃຊ້ເວັບໄຊທີ່ພ້ອມສຳລັບການຜະລິດ ພ້ອມການຜູກໂດເມນອັດຕະໂນມັດ, ການອອກໃບຮັບຮອງ SSL ແລະ ການຕັ້ງຄ່າ Nginx — ບໍ່ຕ້ອງຕັ້ງຄ່າດ້ວຍຕົນເອງ. - **ຕະຫຼາດແອັບ**: ມີແອັບໂອເພນຊອດທີ່ໜ້າເຊື່ອຖືຫຼາຍກວ່າ 165 ແອັບ (Nextcloud, Bitwarden, Umami, NocoBase ແລະ ອື່ນໆ) ທີ່ສາມາດຕິດຕັ້ງ ແລະ ອັບເດດໄດ້ດ້ວຍຄລິກດຽວ. - **ການຈັດການ Docker ແລະ ຄອນເທນເນີ**: ສ້າງ, ເລີ່ມ, ຢຸດ ແລະ ກວດສອບຄອນເທນເນີ, ອິມເມຈ, ເຄືອຂ່າຍ ແລະ ໂວລຸມ ຜ່ານ UI ແບບກຣາຟິກ — ບໍ່ຕ້ອງສະຫຼັບໄປມາໃນ CLI. - **ຄວາມປອດໄພພ້ອມໃຊ້ງານ**: ກົດໄຟຣ໌ວໍ, fail2ban, ການແຍກຄອນເທນເນີ, WAF ແລະ ບັນທຶກການກວດສອບ — ທຸກຢ່າງຖືກຕັ້ງຄ່າ ແລະ ເຮັດວຽກຕັ້ງແຕ່ມື້ທຳອິດ. - **ສຳຮອງ ແລະ ກູ້ຄືນ**: ກຳນົດເວລາສຳຮອງອັດຕະໂນມັດໄປຫາ AWS S3, Cloudflare R2 ຫຼື ບ່ອນຈັດເກັບພາຍໃນເຄື່ອງ. ກູ້ຄືນສະແນັບຊັອດໃດກໍໄດ້ດ້ວຍຄລິກດຽວ. ## ເລີ່ມຕົ້ນຢ່າງໄວ > **ຄວາມຕ້ອງການ:** Linux VPS (Debian / Ubuntu / CentOS / Rocky), RAM 1 GB ແລະ ການເຊື່ອມຕໍ່ອິນເຕີເນັດ. > ໃຊ້ເວລາປະມານ 60 ວິນາທີ. ```bash bash -c "$(curl -sSL https://resource.1panel.pro/v2/quick_start.sh)" ``` ຫຼັງຈາກຕິດຕັ້ງແລ້ວ, ເປີດ `http://:/` ໃນເບຣົາເຊີ. ໃຊ້ຄຳສັ່ງ `1pctl user-info` ຜ່ານ SSH ຫາກຕ້ອງການເບິ່ງຂໍ້ມູນສຳລັບເຂົ້າລະບົບ. ## ພາບໜ້າຈໍ ## ຮຸ່ນ Pro 1Panel OSS ໃຊ້ງານໄດ້ຟຣີຕະຫຼອດໄປ. ຮຸ່ນ Pro ເພີ່ມຄຸນສົມບັດທີ່ອອກແບບສຳລັບທີມ ແລະ ວຽກລະດັບການຜະລິດ: | ຄຸນສົມບັດ | OSS | Pro | |---------|:---:|:---:| | ຕິດຕັ້ງແອັບດ້ວຍຄລິກດຽວ | ✅ | ✅ | | ເອເຈນ AI (OpenClaw) | 1 ເອເຈນ | ບໍ່ຈຳກັດ | | WAF ແລະ ຄວາມປອດໄພຂັ້ນສູງ | ພື້ນຖານ | ✅ | | ປ້ອງກັນການດັດແປງເວັບໄຊ | ❌ | ✅ | | ຕິດຕາມເວລາພ້ອມໃຊ້ງານຂອງເວັບໄຊ | ❌ | ✅ | | ການຈັດການຫຼາຍໂນດ | ❌ | ✅ | | ໂລໂກ້ ແລະ ຮູບແບບການສະແດງຜົນກຳນົດເອງ | ❌ | ✅ | | ການຊ່ວຍເຫຼືອລຳດັບຕົ້ນ | ❌ | ✅ | **ເລີ່ມຕົ້ນທີ່ $80/ປີ.** [ປຽບທຽບແຜນ ແລະ ເລີ່ມທົດລອງຟຣີ 30 ມື້ →](https://1panel.pro/pricing) ## ປະຫວັດດາວ [](https://star-history.com/#1Panel-dev/1Panel&Date) ## ຊຸມຊົນ ແລະ ການຊ່ວຍເຫຼືອ - **Discord** — [ເຂົ້າຮ່ວມຊຸມຊົນ](https://discord.gg/bUpUqWqdRr) ເພື່ອຂໍຄວາມຊ່ວຍເຫຼືອ, ສະເໜີຄຸນສົມບັດ ແລະ ແບ່ງປັນຜົນງານ - **ເອກະສານ** — [1panel.pro/docs](https://1panel.pro/docs) - **ບັນຫາ** — [GitHub Issues](https://github.com/1Panel-dev/1Panel/issues) ສຳລັບລາຍງານບັກ ## ຄວາມປອດໄພ ພົບຊ່ອງໂຫວ່ບໍ? ກະລຸນາອ່ານ [SECURITY.md](/SECURITY.md) ກ່ອນເຜີຍແຜ່ຂໍ້ມູນ. ## ໃບອະນຸຍາດ ໂຄງການນີ້ໃຊ້ [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.html). --- ### README.Ms (`docs/README.ms.md`)

Alat Pengurusan Pelayan Linux Berasaskan Web Terbaik

------------------------------ 1Panel ialah panel kawalan moden sumber terbuka berasaskan web untuk pengurusan pelayan Linux. - **Pengurusan yang Cekap**: Melalui antara muka grafik web yang mesra pengguna, 1Panel membolehkan pengguna menguruskan pelayan Linux mereka dengan mudah. Ciri utama termasuk pemantauan hos, pengurusan fail, pentadbiran pangkalan data, dan pengurusan kontena. - **Penggunaan Laman Web yang Pantas**: Dengan integrasi mendalam perisian pembinaan laman web sumber terbuka popular seperti WordPress, 1Panel mempermudah proses pengikatan domain dan konfigurasi sijil SSL, semuanya boleh dicapai dengan hanya satu klik. - **Gedung Aplikasi**: 1Panel menyediakan pelbagai alat dan aplikasi sumber terbuka berkualiti tinggi, memudahkan pemasangan dan kemas kini untuk penggunanya. - **Keselamatan dan Kebolehpercayaan**: Dengan memanfaatkan penggunaan kontena dan amalan penyebaran aplikasi yang selamat, 1Panel meminimumkan pendedahan terhadap kerentanan. Ia turut meningkatkan keselamatan melalui pengurusan firewall yang terintegrasi dan keupayaan pengauditan log. - **Sandaran & Pemulihan Satu Klik**: Perlindungan data menjadi mudah dengan fungsi sandaran dan pemulihan satu klik 1Panel, yang menyokong pelbagai penyelesaian storan awan untuk memastikan integriti dan ketersediaan data. ## Permulaan Pantas Jalankan skrip di bawah dan ikuti arahan untuk memasang 1Panel: ```bash curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` Sila rujuk [dokumentasi](https://docs.1panel.pro/quick_start/) untuk maklumat lanjut. ## Tangkap Layar ## Sejarah Bintang [](https://star-history.com/#1Panel-dev/1Panel&Date) ## Maklumat Keselamatan Jika anda menemui sebarang isu keselamatan, sila hubungi kami melalui: wanghe@fit2cloud.com. ## Lesen Dilesenkan di bawah Lesen Awam Am GNU versi 3 (GPLv3) (selepas ini disebut sebagai "Lesen"); anda tidak boleh menggunakan fail ini kecuali mematuhi terma-terma Lesen. Anda boleh mendapatkan salinan Lesen di: Kecuali dikehendaki oleh undang-undang yang berkuat kuasa atau dipersetujui secara bertulis, perisian yang diedarkan di bawah Lesen ini diedarkan "SEBAGAIMANA ADANYA", TANPA SEBARANG JAMINAN ATAU SYARAT, sama ada tersurat atau tersirat. Sila rujuk Lesen untuk bahasa khusus yang mengawal hak dan batasan di bawah Lesen ini. --- ### README.Pt Br (`docs/README.pt-br.md`)

Ferramenta de Gerenciamento de Servidores Linux Baseada na Web Mais Avaliada

------------------------------ 1Panel é um painel de controle open-source, moderno e baseado na web para gerenciamento de servidores Linux. - **Gerenciamento Eficiente**: Por meio de uma interface gráfica web amigável, o 1Panel permite que os usuários gerenciem seus servidores Linux com facilidade. As principais funcionalidades incluem monitoramento de hosts, gerenciamento de arquivos, administração de bancos de dados e gerenciamento de containers. - **Implantação Rápida de Sites**: Com integração profunda com o popular software open-source WordPress, o 1Panel simplifica o processo de vinculação de domínios e configuração de certificados SSL, tudo realizável com um único clique. - **Loja de Aplicativos**: O 1Panel seleciona uma ampla gama de ferramentas e aplicativos open-source de alta qualidade, facilitando a instalação e atualização para seus usuários. - **Segurança e Confiabilidade**: Ao utilizar práticas de containerização e implantação segura de aplicativos, o 1Panel minimiza a exposição a vulnerabilidades. A segurança é ainda aprimorada por meio da gestão integrada de firewall e auditoria de logs. - **Backup e Restauração com um Clique**: A proteção de dados é simplificada com a funcionalidade de backup e restauração com um clique do 1Panel, que suporta várias soluções de armazenamento em nuvem para garantir a integridade e disponibilidade dos dados. ## Início Rápido Execute o script abaixo e siga as instruções para instalar o 1Panel: ```bash curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` Por favor, consulte nossa [documentação](https://docs.1panel.pro/quick_start/) para mais detalhes. ## Captura de Tela ## Histórico de Estrelas [](https://star-history.com/#1Panel-dev/1Panel&Date) ## Informações de Segurança Se você descobrir algum problema de segurança, por favor, entre em contato conosco através do e-mail: wanghe@fit2cloud.com. ## Licença Licenciado sob a Licença Pública Geral GNU versão 3 (GPLv3) (a "Licença"); você não pode usar este arquivo exceto em conformidade com a Licença. Você pode obter uma cópia da Licença em Exceto quando exigido por lei aplicável ou acordado por escrito, o software distribuído sob a Licença é distribuído "COMO ESTÁ", SEM GARANTIAS OU CONDIÇÕES DE QUALQUER TIPO, expressas ou implícitas. Consulte a Licença para ver as permissões e limitações específicas sob a Licença. --- ### README.Ru (`docs/README.ru.md`)

Высококлассная веб-панель управления Linux-серверами

------------------------------ 1Panel - это современная веб-панель управления Linux-серверами с открытым исходным кодом. - **Эффективное управление**: Благодаря удобному веб-интерфейсу, 1Panel позволяет пользователям легко управлять своими Linux-серверами. Основные функции включают мониторинг хоста, управление файлами, администрирование баз данных и управление контейнерами. - **Быстрое развертывание сайтов**: Благодаря глубокой интеграции с популярной системой создания сайтов WordPress, 1Panel упрощает процесс привязки домена и настройки SSL-сертификатов, все это достигается одним кликом. - **Магазин приложений**: 1Panel предлагает широкий выбор качественных инструментов и приложений с открытым исходным кодом, обеспечивая простую установку и обновление для пользователей. - **Безопасность и надежность**: Используя контейнеризацию и безопасные практики развертывания приложений, 1Panel минимизирует уязвимости. Безопасность дополнительно усиливается благодаря встроенному управлению межсетевым экраном и возможностям аудита логов. - **Резервное копирование и восстановление в один клик**: Защита данных упрощается благодаря функции резервного копирования и восстановления в один клик, с поддержкой различных облачных хранилищ для обеспечения целостности и доступности данных. ## Быстрый старт Выполните скрипт ниже и следуйте инструкциям для установки 1Panel: ```bash curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` Для получения дополнительной информации обратитесь к нашей [документации](https://docs.1panel.pro/quick_start/). ## Скриншот ## История звезд [](https://star-history.com/#1Panel-dev/1Panel&Date) ## Информация о безопасности Если вы обнаружите проблемы безопасности, пожалуйста, свяжитесь с нами по адресу: wanghe@fit2cloud.com. ## Лицензия Лицензировано под GNU General Public License версии 3 (GPLv3) ("Лицензия"); вы не можете использовать этот файл, кроме как в соответствии с Лицензией. Вы можете получить копию Лицензии по адресу Если иное не предусмотрено применимым законодательством или не согласовано в письменной форме, программное обеспечение, распространяемое по Лицензии, распространяется на условиях "КАК ЕСТЬ", БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ ИЛИ УСЛОВИЙ, явных или подразумеваемых. См. текст Лицензии для получения информации о разрешениях и ограничениях по Лицензии. --- ### README.Tr (`docs/README.tr.md`)

En Yüksek Puanlı Web Tabanlı Linux Sunucu Yönetim Aracı

------------------------------ 1Panel, Linux sunucu yönetimi için modern, açık kaynaklı bir web tabanlı kontrol panelidir. - **Verimli Yönetim**: Kullanıcı dostu bir web grafik arayüzü aracılığıyla, 1Panel kullanıcıların Linux sunucularını zahmetsizce yönetmelerini sağlar. Ana özellikler arasında ana bilgisayar izleme, dosya yönetimi, veritabanı yönetimi ve konteyner yönetimi yer alır. - **Hızlı Web Sitesi Dağıtımı**: Popüler açık kaynaklı web sitesi oluşturma yazılımı WordPress ile derin entegrasyon sayesinde, 1Panel alan adı bağlama ve SSL sertifikası yapılandırma işlemlerini basitleştirir, hepsi sadece bir tıkla yapılabilir. - **Uygulama Mağazası**: 1Panel, yüksek kaliteli açık kaynaklı araçlar ve uygulamalar sunar, kullanıcıların kolayca kurulum yapmalarını ve güncellemelerini sağlar. - **Güvenlik ve Güvenilirlik**: Konteynerleştirme ve güvenli uygulama dağıtımı yöntemlerini kullanarak 1Panel, güvenlik açıklarını en aza indirir. Ayrıca, entegre güvenlik duvarı yönetimi ve günlük denetleme özellikleri ile güvenliği artırır. - **Tek Tıkla Yedekleme ve Geri Yükleme**: 1Panel’in tek tıkla yedekleme ve geri yükleme işlevi, veri korumasını basitleştirir ve çeşitli bulut depolama çözümleriyle veri bütünlüğü ve erişilebilirliğini sağlar. ## Hızlı Başlangıç **Tek Tuşlu Yükleme** Aşağıdaki komutu çalıştırın ve 1Panel’i kurmak için yönergeleri takip edin: ```sh curl -sSL https://resource.1panel.pro/quick_start.sh -o quick_start.sh && bash quick_start.sh ``` Daha fazla detay için [dokümantasyonumuza](https://docs.1panel.pro/quick_start/) göz atın. ## Ekran Görüntüsü ## Yıldız Geçmişi [](https://star-history.com/#1Panel-dev/1Panel&Date) ## Güvenlik Bilgileri Herhangi bir güvenlik sorunu keşfettiğinizde, lütfen bizimle şu adres üzerinden iletişime geçin: wanghe@fit2cloud.com. ## Lisans Bu yazılım, GNU Genel Kamu Lisansı sürüm 3 (GPLv3) ile lisanslanmıştır (bu "Lisans" olarak anılacaktır); bu dosyayı yalnızca Lisans ile uyumlu olarak kullanabilirsiniz. Lisansı şu adresten edinebilirsiniz: Uygulanan yasalar gereği veya yazılı olarak kabul edilmedikçe, Lisans altında dağıtılan yazılım, HERHANGİ BİR GARANTİ VEYA ŞART olmaksızın "OLDUĞU GİBİ" sunulmaktadır. Lisans, izinler ve sınırlamalar ile ilgili özel dil için Lisans’a bakın. --- ### README.Zh Hans (`docs/README.zh-Hans.md`)

现代化、开源的 Linux 服务器运维管理面板

[](https://www.bilibili.com/video/BV1Mt421n7LZ/) ------------------------------ ## 什么是 1Panel？ 1Panel 是一款现代化的开源 Linux 服务器运维管理面板，同时也是轻量级的 AI 管理平台。通过直观易用的 Web 界面，1Panel 帮助用户轻松掌控服务器全局：无论是 AI 智能体与本地大模型，还是网站、数据库、容器、文件及计划任务，所有核心运维场景均能一站式高效管理。 - **全栈 AI 管理**：提供从底层硬件到智能体（Metal-to-Agent）的统一管理平台，集成 AI 门户、AI 网关、Skills Hub，并支持对智能体与模型的集中化管理。 - **高效可视化运维**：通过 Web 图形界面，轻松实现主机监控、文件管理、数据库管理、容器管理等功能，让 Linux 服务器管理化繁为简。 - **快速建站部署**：深度集成 WordPress 与 Halo 等主流建站程序，一键完成域名绑定、SSL 证书配置，大幅降低建站门槛。 - **精选应用商店**：内置高质量开源应用商店，提供一键安装与升级服务，轻松扩展服务器功能。 - **企业级安全**：基于容器技术部署应用，有效减少漏洞暴露面。同时提供防火墙、日志审计等安全功能，全方位保障服务器安全。 - **一键数据备份**：支持一键备份与恢复，并可对接多种云端存储，确保数据安全，永不丢失。 ## 快速开始 **一键安装** 执行如下命令一键安装 1Panel: $ bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)" 如果是用于离线环境，推荐使用 [安装包方式](https://docs.fit2cloud.com/1panel/installation/enterprise-installation/) 进行安装部署。 **学习资料** - [在线文档](https://docs.fit2cloud.com/1panel/) - [社区论坛](https://bbs.fit2cloud.com/c/1p/7) ## 版本对比 https://1panel.cn/versions.html ## 飞致云的其他明星项目 - [MaxKB](https://github.com/1Panel-dev/MaxKB/) - 强大易用的企业级智能体平台 - [Cordys](https://github.com/1Panel-dev/CordysCRM) - 新一代的开源 AI CRM 系统 - [JumpServer](https://github.com/jumpserver/jumpserver/) - 广受欢迎的开源堡垒机 - [Halo](https://github.com/halo-dev/halo/) - 强大易用的开源建站工具 - [DataEase](https://github.com/dataease/dataease/) - 人人可用的开源数据可视化分析工具 - [MeterSphere](https://github.com/metersphere/metersphere/) - 开源持续测试工具 - [KubePi](https://github.com/1Panel-dev/KubePi/) - 现代化、开源的 K8s 面板 ## License Copyright (c) 2014-2026 [FIT2CLOUD 飞致云](https://fit2cloud.com/), All rights reserved. Licensed under The GNU General Public License version 3 (GPLv3) (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --- ### README.Zh Hant (`docs/README.zh-Hant.md`)

Top-Rated Web-based Linux Server Management Tool

現代化、開源的 Linux 伺服器運維管理面板

[](https://www.bilibili.com/video/BV1Mt421n7LZ/) ------------------------------ ## 什麼是 1Panel？ 1Panel 是新一代的 Linux 伺服器運維管理面板。 - **高效管理**：使用者可以透過 Web 介面輕鬆管理 Linux 伺服器，如主機監控、文件管理、資料庫管理、容器管理等； - **快速建站**：深度整合開源建站軟體 WordPress 和 [Halo](https://github.com/halo-dev/halo/)，域名綁定、SSL 證書配置等操作一鍵搞定； - **應用商店**：精選上架各類高品質的開源工具和應用軟體，協助使用者輕鬆安裝並升級； - **安全可靠**：基於容器管理並部署應用，實現最小的漏洞暴露面，同時提供病毒防護、防火牆和日誌審計等功能； - **一鍵備份**：支援一鍵備份和復原，使用者可以將資料備份到各類雲端儲存介質，永不遺失。 ## 快速開始 **一鍵安裝** 執行如下指令一鍵安裝 1Panel: ```sh curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh ``` 如果是用於離線環境，推薦使用 [安裝包方式](https://docs.fit2cloud.com/1panel/installation/enterprise-installation/) 進行安裝部署。 **學習資料** - [線上文件](https://docs.fit2cloud.com/1panel/) - [社區論壇](https://bbs.fit2cloud.com/c/1p/7) - [如何加入微信交流群?](https://bbs.fit2cloud.com/t/topic/2147) ## 專業版相比於社區版，1Panel 專業版為使用者提供了大量增強功能及技術支援服務，增強功能包括 WAF 增強、網站防篡改、網站監控、GPU 監控、黑金主題及自訂介面等。 [點擊查看專業版詳細介紹](https://www.lxware.cn/1panel)。 ## 飛致雲的其他明星項目 - [MaxKB](https://github.com/1Panel-dev/MaxKB/) - 基於 LLM 大語言模型的開源知識庫問答系統 - [JumpServer](https://github.com/jumpserver/jumpserver/) - 廣受歡迎的開源堡壘機 - [Halo](https://github.com/halo-dev/halo/) - 強大易用的開源建站工具 - [DataEase](https://github.com/dataease/dataease/) - 人人可用的開源資料可視化分析工具 - [MeterSphere](https://github.com/metersphere/metersphere/) - 開源持續測試工具 - [KubePi](https://github.com/1Panel-dev/KubePi/) - 現代化、開源的 K8s 面板 ## License Copyright (c) 2014-2026 [FIT2CLOUD 飞致云](https://fit2cloud.com/), All rights reserved. Licensed under The GNU General Public License version 3 (GPLv3) (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --- ### TRANSLATION (`docs/TRANSLATION.md`) # Translation Contribution Guide Thank you for helping translate 1Panel! A complete locale touches the frontend, the Core service, the Agent service, application-store metadata, and the project README files. This guide lists the repository changes and validation required before opening a pull request. > **Reference pull requests** > > - [WIP: Dev v2 spanish (#10352)](https://github.com/1Panel-dev/1Panel/pull/10352) > is a full-locale example for Spanish (`es-ES`). > - [docs: add Persian README (#13132)](https://github.com/1Panel-dev/1Panel/pull/13132) > is a localized-README example. --- ## Scope 1Panel has several independent translation surfaces: | Surface | Technology | Repository format | |---|---|---| | Frontend | Vue 3, `vue-i18n`, Element Plus | TypeScript (`.ts`) | | Core service | Go i18n | YAML (`.yaml`) | | Agent service | Go i18n | YAML (`.yaml`) | | Application store | API models and frontend types | Go and TypeScript | | Project introduction | GitHub README files | Markdown (`.md`) | Adding only a frontend module does not provide complete locale support. Follow all applicable steps below and state explicitly in the pull request if a surface is intentionally out of scope. ## Step 0 – Define locale identifiers Choose the canonical runtime locale first. Use a [BCP 47](https://www.ietf.org/rfc/bcp/bcp47.txt) language tag and preserve its casing wherever the runtime locale is used. File names and third-party locale packs do not always use the same casing. | Language | Runtime locale | Frontend module | Element Plus pack | Backend YAML | App-store key | README | |---|---|---|---|---|---|---| | Simplified Chinese | `zh` | `zh.ts` | `zh-cn` | `zh.yaml` | `zh` | `README.zh-Hans.md` | | Traditional Chinese | `zh-Hant` | `zh-Hant.ts` | `zh-tw` | `zh-Hant.yaml` | `zh-hant` | `README.zh-Hant.md` | | English | `en` | `en.ts` | `en` | `en.yaml` | `en` | `README.md` | | Brazilian Portuguese | `pt-BR` | `pt-br.ts` | `pt-br` | `pt-BR.yaml` | `pt-br` | `README.pt-br.md` | | Spanish (Spain) | `es-ES` | `es-es.ts` | `es` | `es-ES.yaml` | `es-es` | `README.es-es.md` | | Lao | `lo` | `lo.ts` | `lo` | `lo.yaml` | `lo` | `README.lo.md` | Use lowercase for simple runtime codes (`ja`, `ko`, `lo`) and standard BCP 47 casing for variants (`pt-BR`, `es-ES`, `zh-Hant`). Do not infer a file name from the runtime locale: add an explicit mapping when the casing or code differs. Before editing, search for hard-coded locale collections so a newly introduced selector, whitelist, or compatibility map is not missed: ```bash rg "zh-Hant|pt-BR|es-ES" frontend core agent ``` ## Step 1 – Add the frontend translation module Copy the English module and translate its values: ```text frontend/src/lang/modules/en.ts -> frontend/src/lang/modules/.ts ``` Keep the following unchanged unless the English source changed structurally: - object keys, nesting, and TypeScript syntax; - interpolation placeholders such as `{0}`, `${name}`, and `{{ .detail }}`; - HTML tags, Markdown, URLs, product names, commands, and configuration keys; - the `getFuLocaleMessage` merge at the end of the file. Pass the canonical runtime locale to `getFuLocaleMessage`, even when the module file name uses different casing: ```ts import { getFuLocaleMessage } from '@/lang/fu'; const message = { commons: { // Translated values. }, }; export default { ...getFuLocaleMessage(''), ...message, }; ``` The English module evolves continuously. Copy it from the same branch as your change instead of relying on a fixed key count or line count. Machine translation can be used for a first pass, but every string must be reviewed in its UI context. ## Step 2 – Register the frontend loader and FU messages Add the canonical runtime locale and its module file to `LOCALE_LOADERS` in `frontend/src/lang/index.ts`: ```ts const LOCALE_LOADERS: Record = { // Existing entries. '': () => import('./modules/'), }; ``` Then add the locale to `fuLocales` in `frontend/src/lang/fu.ts`. These messages belong to the shared FU table and steps components and are not supplied by the main module: ```ts const fuLocales: Record = { // Existing entries. '': { fu: { table: { more: '...', custom_table_rows: '...', }, steps: { cancel: '...', prev: '...', next: '...', finish: '...', }, }, }, }; ``` ## Step 3 – Register the Element Plus locale Element Plus provides its own translations for date pickers, pagination, popovers, and other components. Import the matching pack in `frontend/src/App.vue`: ```ts import localePack from 'element-plus/es/locale/lang/'; ``` Map the canonical runtime locale in the `i18nLocale` computed property: ```ts const i18nLocale = computed(() => { // Existing mappings. if (globalStore.language === '') return localePack; return zhCn; }); ``` Confirm the pack exists in `frontend/node_modules/element-plus/es/locale/lang/`. If Element Plus does not provide the language, document the chosen fallback in the pull request rather than importing a nonexistent module. ## Step 4 – Expose the locale in every frontend entry point ### Login page `frontend/src/views/login/components/login-form.vue` currently renders two language menus for different login layouts. Add the new locale to **both menu blocks**, then add its native display name to `languageLabelMap`: ```ts const languageLabelMap: Record = { // Existing entries. '': '', }; ``` Verify both login layouts manually. Updating only `languageLabelMap` changes the selected label but does not add a selectable menu item. ### Panel settings Add the locale to `languageOptions` in `frontend/src/views/setting/panel/index.vue`: ```ts const languageOptions = ref([ // Existing entries. { value: '', label: '' }, ]); ``` ### Public share page Add the locale to `supportedLocales` in `frontend/src/views/share/index.vue`. This list controls browser-language recognition and the `Accept-Language` header used by public share requests. ```ts const supportedLocales = [ // Existing entries. '', ]; ``` ### Locale-sensitive fallbacks Review locale comparisons that select language-specific API fields. For example, operation records currently provide Chinese and English detail fields in `frontend/src/views/log/operation/index.vue`. Chinese runtime locales should use `detailZH`; every other locale should retain a visible `detailEN` fallback. Prefer one shared fallback branch instead of adding every non-Chinese locale to another hard-coded list. ## Step 5 – Allow the locale in the login API The backend validates the language sent by the login request. Add the canonical runtime locale to the `Language` field's `oneof` validation tag in `core/app/dto/auth.go`: ```go Language string `json:"language" validate:"oneof=zh en ... "` ``` Without this change, the new language can appear on the login page but the login request will be rejected as an invalid parameter. Run `gofmt` on the Go file after editing it. ## Step 6 – Add and register Core translations Copy the current English catalog and translate only its values: ```text core/i18n/lang/en.yaml -> core/i18n/lang/.yaml ``` Preserve every YAML key and placeholder: ```yaml ErrInvalidParams: "Translated text: {{ .detail }}" ErrRecordExist: "Translated text" ``` Register the catalog in `core/i18n/i18n.go`: ```go var langFiles = map[string]string{ // Existing entries. "": "lang/.yaml", } ``` ## Step 7 – Add and register Agent translations Core and Agent are independent Go modules and have independent catalogs. Copy and translate the Agent catalog separately: ```text agent/i18n/lang/en.yaml -> agent/i18n/lang/.yaml ``` Register it in `agent/i18n/i18n.go`: ```go var langFiles = map[string]string{ // Existing entries. "": "lang/.yaml", } ``` Do not copy the Core YAML file into Agent: their key sets are different. ## Step 8 – Extend application-store locale models Application-store names and descriptions use their own locale fields. Add the new field to both repository-side schemas. In `agent/app/dto/app.go`, extend `Locale`: ```go type Locale struct { // Existing fields. NewLanguage string `json:""` } ``` In `frontend/src/api/interface/app.ts`, extend `Locale` with the same JSON key: ```ts interface Locale { // Existing fields. '': string; } ``` Add the app-store key to the `description` example in `core/cmd/server/app/app_config.yml` as well. This embedded template is written when the server command scaffolds a new local application configuration. Review `frontend/src/utils/app-store.ts` as well. Simple codes that lowercase to the same value normally need no special handling; regional or script variants may need an explicit runtime-locale-to-app-store-key mapping. These schema changes make the repository capable of reading the locale. The translated application names and descriptions are maintained in the external application-store data source and must be coordinated separately. Until that data exists, the application store falls back to English. ## Step 9 – Add a localized README Copy the root README to the documentation directory: ```text README.md -> docs/README..md ``` Translate prose while preserving Markdown structure, HTML, images, links, commands, badges, and code samples. Check every relative link from its new location under `docs/`; a link that works from the repository root may need a different relative path in the localized file. Then keep the language navigation synchronized: 1. Add the new README link to the language badge row in `README.md`. 2. Add the same link to every existing `docs/README.*.md` language badge row. 3. Add the locale to the table in this guide's [Locale code reference](#locale-code-reference). Use the native language name for the badge label. The README locale suffix may follow an existing documentation convention (`zh-Hans`, `pt-br`, `es-es`) and does not have to match the runtime locale casing. ## Step 10 – Format code and regenerate API documentation Format every changed Go source file: ```bash gofmt -w core/app/dto/auth.go core/i18n/i18n.go gofmt -w agent/app/dto/app.go agent/i18n/i18n.go ``` The login-language enum and application-store locale model are represented in generated Swagger files. Install the repository-compatible `swag` command, then run the generator test from the Core module: ```bash cd core go test ./cmd/server/docs -run TestGenerateSwaggerDoc ``` This updates generated files under `core/cmd/server/docs/`. Do not edit the generated Swagger output by hand. If the generator is unavailable, call that out explicitly in the pull request instead of committing stale manual changes. ## Step 11 – Validate the locale ### Automated checks Run checks from the repository root unless a command changes directory: ```bash # Frontend type checking. cd frontend npm run type-check # Lint only the frontend files changed by the locale contribution. ./node_modules/.bin/eslint \ src/lang/modules/.ts \ src/lang/index.ts \ src/lang/fu.ts \ src/App.vue \ src/views/login/components/login-form.vue \ src/views/setting/panel/index.vue \ src/views/share/index.vue \ src/views/log/operation/index.vue \ src/api/interface/app.ts \ src/utils/app-store.ts # Compile and test the directly affected Go packages. cd ../core go test ./i18n ./app/dto cd ../agent go test ./i18n ./app/dto # Check whitespace errors in all changed files. cd .. git diff --check ``` Also compare each translated catalog with its English source: - the frontend module has the same translation keys and nesting; - each Core and Agent YAML file has exactly the same keys as its corresponding English file; - placeholders, formatting tokens, HTML tags, URLs, and commands are preserved; - YAML files parse successfully, with no duplicate keys; - all README links and badges resolve to the intended files. ### Manual checks - [ ] Both login layouts show the native language name and can select it. - [ ] Login succeeds with the locale in the request; validation does not reject it. - [ ] **Settings -> Panel -> Language** can switch to the locale and retains it after reload. - [ ] Element Plus date, pagination, select, and confirmation components use the expected language. - [ ] A representative Core API error is translated. - [ ] A representative Agent task/error message is translated. - [ ] A public share page recognizes the browser locale and sends the expected `Accept-Language` value. - [ ] Operation-log details remain visible through the correct Chinese or English fallback. - [ ] Application-store metadata uses the locale when available and falls back to English when absent. - [ ] The localized README renders correctly and every README language badge links to it. - [ ] Layout, punctuation, truncation, and text direction are correct at common screen sizes. For right-to-left languages, verify the login page, navigation, forms, tables, dialogs, and mixed-direction values such as IP addresses. RTL layout support may require a separate frontend change beyond translating strings. ## External translation resources Some runtime assets are not maintained in this repository: - application-store names and descriptions come from the external application-store data source; - the language shell resources downloaded as `language/lang.tar.gz` are published through the 1Panel resource service. Repository locale support does not automatically update either resource. If the new language needs them, coordinate publication with the relevant maintainer and record the status in the pull request. Do not add generated or downloaded archives to this repository unless a maintainer requests it. ## Complete pull-request checklist - [ ] Canonical runtime, module, Element Plus, app-store, and README codes are documented. - [ ] `frontend/src/lang/modules/.ts` is complete and reviewed. - [ ] `frontend/src/lang/index.ts` contains the locale loader. - [ ] `frontend/src/lang/fu.ts` contains the FU messages. - [ ] `frontend/src/App.vue` maps an existing Element Plus locale pack or documents a fallback. - [ ] Both language menus and `languageLabelMap` are updated in `frontend/src/views/login/components/login-form.vue`. - [ ] `languageOptions` is updated in `frontend/src/views/setting/panel/index.vue`. - [ ] `supportedLocales` is updated in `frontend/src/views/share/index.vue`. - [ ] Locale-sensitive API-field fallbacks, including operation-log details, remain visible. - [ ] The login validator is updated in `core/app/dto/auth.go`. - [ ] `core/i18n/lang/.yaml` exists and is registered in `core/i18n/i18n.go`. - [ ] `agent/i18n/lang/.yaml` exists and is registered in `agent/i18n/i18n.go`. - [ ] Application-store locale fields are updated in `agent/app/dto/app.go`, `frontend/src/api/interface/app.ts`, and `core/cmd/server/app/app_config.yml`. - [ ] Regional or script variants are normalized in `frontend/src/utils/app-store.ts` when needed. - [ ] `docs/README..md` exists and every README language badge is synchronized. - [ ] Changed Go files are formatted and Swagger output is regenerated. - [ ] Frontend, Core, Agent, catalog-parity, placeholder, and Markdown checks pass. - [ ] All applicable manual checks pass. - [ ] External application-store and language-resource work is completed or clearly tracked. ## Locale code reference | Language | Runtime locale | |---|---| | Simplified Chinese | `zh` | | Traditional Chinese | `zh-Hant` | | English | `en` | | Japanese | `ja` | | Korean | `ko` | | Russian | `ru` | | Malay | `ms` | | Turkish | `tr` | | Brazilian Portuguese | `pt-BR` | | Spanish (Spain) | `es-ES` | | Persian | `fa` | | Lao | `lo` | ## Pull-request title convention ```text feat(i18n): add () locale support ``` Example: `feat(i18n): add German (de-DE) locale support` --- --- METRICS --- - Files Extracted: 17 - Estimated Token Budget: ~28483 tokens - Canonical Reference: https://codewiki.google/github.com/1Panel-dev/1Panel