How to Deploy Appwrite – Open-Source Backend Server
Appwrite را با استفاده از Docker برای ساخت برنامه های backend متن باز مقیاس پذیر مستقر کنید.
Appwrite یک پلتفرم Backend-as-a-Service (BaaS) متن باز است که مجموعه ای از APIهای اصلی REST و Realtime را برای توسعه دهندگان فراهم می کند تا برنامه ها را سریع تر بسازند. این پلتفرم، احراز هویت، پایگاه های داده، ذخیره سازی فایل، توابع بدون سرور و APIهای realtime را از طریق یک پلتفرم یکپارچه فراهم می کند. Appwrite به گونه ای طراحی شده است که خود میزبان باشد و روی هر سیستم عاملی که از Docker پشتیبانی می کند، اجرا می شود.
این مقاله، استقرار Appwrite روی یک سرور با استفاده از نصب کننده رسمی Docker را شرح می دهد. این مقاله نحوه استفاده از ابزار راه اندازی خودکار را برای پیکربندی محیط شما، تولید گواهینامه های SSL و راه اندازی پشته کانتینر نشان می دهد.
پیش نیاز #
قبل از شروع:
- به عنوان یک کاربر غیر ریشه با امتیازات sudo به یک سرور مجازی لینوکس (با حداقل ۲ هسته CPU و ۴ گیگابایت رم) دسترسی داشته باشید.
- مطمئن شوید که سرور حداقل ۲ گیگابایت حافظه swap پیکربندی شده دارد.
- داکر و داکر کامپوز را نصب کنید.
- یک نام دامنه، مانند
Appwrite.example.com، را طوری پیکربندی کنید که به آدرس IP عمومی سرور شما اشاره کند.
نصب و کانفیگ Appwrite #
ساده ترین راه برای نصب Appwrite استفاده از نصاب رسمی Docker است. این ابزار به صورت تعاملی اجرا می شود، تنظیمات پیکربندی شما را می پرسد و به طور خودکار متغیرهای محیطی و فایل Docker Compose را تنظیم می کند.
- حساب کاربری خود را به گروه کاربری docker اضافه کنید. این به شما امکان می دهد دستورات Docker را بدون
sudoاجرا کنید.console$ sudo usermod -aG docker $USER
- عضویت جدید گروه را اعمال کنید.console
$ newgrp docker - یک کلید مخفی هگزادسیمال ۳۲ کاراکتری امن ایجاد کنید. باید آن را در حین نصب وارد کنید.console
$ openssl rand -hex 32
خروجی را در کلیپ بورد خود کپی کنید.
- یک دایرکتوری برای Appwrite ایجاد کنید.console
$ mkdir ~/appwrite - به درون آن هدایت شوید.console
$ cd ~/appwrite
- نصب کننده ی Appwrite را اجرا کنید.console
$ docker run -it --rm --volume /var/run/docker.sock:/var/run/docker.sock --volume "$(pwd)":/usr/src/code/appwrite:rw --entrypoint="install" appwrite/appwrite:1.8.1
نصب کننده از شما جزئیات پیکربندی را می خواهد. مقادیر زیر را وارد کنید:
- Choose your server HTTP port: برای پذیرش پیش فرض (
80)، Enterرا فشار دهید. - Choose your server HTTPS port: برای پذیرش پیش فرض (
443)، Enterرا فشار دهید. - Choose a secret API key: کلید هگزادسیمالی که در مرحله ۳ ایجاد کردید را جایگذاری کنید.
- Enter your Appwrite hostname: نام دامنه خود را وارد کنید (مثلاً,
Appwrite.example.com). - Enter a DNS A record hostname: نام دامنه خود را دوباره وارد کنید (مثلاً,
Appwrite.example.com). - Enter an email: آدرس ایمیل خود را وارد کنید (برای تولید SSL در Let’s Encrypt استفاده می شود).
پس از وارد کردن این جزئیات، نصب کننده به طور خودکار تصاویر Docker لازم را دانلود می کند و با استفاده از
docker compose up -d، پشته Appwrite را آغاز می کند. - Choose your server HTTP port: برای پذیرش پیش فرض (
- تأیید کنید که کانتینرها در حال اجرا هستند.console
$ docker compose psشما باید لیستی از کانتینرها با وضعیت (
Up) را ببینید.
دسترسی و پیکربندی Appwrite #
- مرورگر وب خود را باز کنید و به دامنه خود بروید (مثلاً https://Appwrite.example.com).نکته
Appwrite به طور خودکار گواهی های TLS را از طریق Let’s Encrypt ارائه می دهد. ممکن است هنگام دسترسی اولیه، در حالی که گواهی در پس زمینه تولید می شود، با هشدار امنیتی مرورگر مواجه شوید. چند دقیقه صبر کنید و صفحه را رفرش کنید.
- صفحه Sign Up ظاهر می شود. ایمیل و رمز عبور خود را برای ایجاد حساب کاربری مدیر ریشه وارد کنید.
- کلیک کنید روی Sign Up.
- برای اولین پروژه خود نامی وارد کنید و روی Create Project کلیک کنید.
- داشبورد Appwrite Console ظاهر می شود. اکنون می توانید پلتفرم ها (وب، فلاتر، اندروید، iOS) را اضافه کنید و شروع به توسعه کنید.

نصب و کانفیگ Appwrite
نتیجه گیری #
شما با موفقیت Appwrite را با استفاده از Docker Compose روی سرور خود مستقر کردید. اکنون backend شما آماده مدیریت احراز هویت، پایگاه های داده و ذخیره سازی برای برنامه های شما است. برای جزئیات بیشتر در مورد استفاده از API و ادغام SDK، به مستندات رسمی Appwrite مراجعه کنید.

