راه‌اندازی یک جامعه
هر جامعه روی نود اختصاصی خود اجرا می‌شود: یک سرور کوچک که اعضا، پست‌ها و دفتر کل آن جامعه را در خود نگه می‌دارد. فردی محلی آن را اداره می‌کند. اگر شهر یا منطقه شما هنوز نودی ندارد، آن فرد می‌تواند شما باشید.
اداره کردن یک جامعه چه چیزهایی دارد
حدود نیم ساعت زمان می‌برد، اگر بتوانید یک دستورالعمل ساده را دنبال کنید. ابتدا شش نکته‌ای که باید بدانید:
- هزینه آن چقدر است. نرم‌افزار رایگان است. روی یک رایانه یدکی که در خانه روشن بماند (یک Mini PC، یک NAS یا یک رزبری پای با سیستم ۶۴ بیتی)، یا روی یک سرور اجاره‌ای کوچک با هزینه چند دلار در ماه (حدود ۶ دلار آمریکا) اجرا می‌شود.
- چه کسی آن را میزبانی می‌کند. شما، روی دستگاه خودتان یا دستگاهی که اجاره می‌کنید. هرگز نیازی به beanpool.org نیست: آدرس وب اختصاصی خودتان کار می‌کند.
- مسئولیت‌هایی که بر عهده می‌گیرید. گزارش‌های اعضا به شما می‌رسد. پوشه داده‌ها در اختیار شماست تا با یک کد بازیابی از آن نسخه پشتیبان تهیه کنید. دو مالک داشته باشید. سرور را روشن و به‌روز نگه دارید.
- آنچه هرگز نمی‌بینید. پیام‌های مستقیم اعضای شما.
- ابتدا داکر (Docker). پیش از اجرای بلوک زیر، دستگاه باید داکر نصب شده داشته باشد؛ یک سرور تازه اجاره‌شده داکر ندارد.
- آدرسی که گوشی‌ها بتوانند به آن متصل شوند. گوشی‌ها فقط از طریق https در اینترنت به یک جامعه متصل می‌شوند. در یک سرور اجاره‌ای با آدرس IP عمومی و پورت‌های باز ۸۰ و ۴۴۳، همان آدرس IP کافی است: سرور شما گواهی اختصاصی خود را بدون نیاز به حساب Cloudflare برای آن دریافت می‌کند، و همین امر برای دامنه اختصاصی شما نیز صدق می‌کند. در خانه یا بدون پورت‌های باز، فرایند ثبت به شما یک نام رایگان با پسوند .beanpool.org از طریق تونلی که خود سرور اجرا می‌کند می‌دهد. آدرس معمولی http:// فقط روی یک شبکه خانگی کار می‌کند.
مسئولیت‌های شما چیست
شما و مدیرانی که منصوب می‌کنید ناظران جامعه خود هستید: گزارش‌ها به دست شما می‌رسد. داده‌های اعضای شما روی دستگاه شما ذخیره می‌شود، بنابراین شما نسخه پشتیبان آن را نگه می‌دارید. شما می‌توانید گفتگوهای طرح تجاری و چت‌های رویداد را بخوانید؛ نمی‌توانید پیام‌های مستقیم را بخوانید. شما اولین اعضا را دعوت می‌کنید و آن‌ها بقیه را دعوت می‌نمایند.
برنامه تنظیمات
نود شما همراه با برنامه تنظیمات اختصاصی خود در مرورگر ارائه می‌شود. از طریق آن، جامعه خود را نام‌گذاری می‌کنید، یک مالک و مدیرانی را منصوب می‌کنید که با کلیدهای خود وارد می‌شوند، دعوت‌نامه‌های QR را چاپ می‌کنید، سلامت دیسک را زیر نظر می‌گیرید، آدرس وب عمومی یا تونل را انتخاب می‌کنید، و به عضوی که هم گوشی و هم ۱۲ کلمه خود را گم کرده کمک می‌کنید تا با یک کد یک‌بارمصرف که شخصاً تأیید می‌کنید، به حساب خود در یک گوشی جدید بازگردد.
از اولین راه‌اندازی خصوصی است
فهرست‌ها، نقشه، پیام‌ها و موجودی‌های یک جامعه از لحظه شروع نود، فقط برای اعضای آن است؛ چیزی برای روشن کردن وجود ندارد. اگر فردی بدون داشتن حساب، آدرس آن را باز کند، به جامعه جهانی هدایت می‌شود که در آن می‌توانند ببینند چه مواردی در نزدیکی آن‌ها وجود دارد و درخواست عضویت دهند.
پیوند با یک جامعه همسایه
دو جامعه می‌توانند برای ایجاد پیوند توافق کنند تا اعضای آن‌ها بتوانند با یکدیگر معامله کنند. لوبیاها هرگز محل خود را ترک نمی‌کنند: هر جفت حساب جاری از آنچه یک جامعه به جامعه دیگر بدهکار است را نگه می‌دارد و هر طرف سقف مشخصی برای خود تعیین می‌کند. پیوند غیرفعال است مگر اینکه گردانندگان هر دو طرف آن را فعال کنند، و هنوز در مراحل اولیه است: این ویژگی همراه با صفحه‌های آن در برنامه تحت وب ساخته شده است و فقط بین دو جامعه آزمایشی خودمان آزمایش شده است، نه میان جوامع فعال واقعی.
آدرس شما
پیش از چسباندن کد، آن را انتخاب کنید و خط آخر را متناسب با آن تغییر دهید. اگر قبلاً چسبانده‌اید، در پاسخ به سؤالات Enter را بزنید، سپس خط آخر را دوباره اجرا کنید: کد مالکیت منتظر یک گوشی می‌ماند. یک سرور اجاره‌ای با آدرس IP عمومی و پورت‌های باز ۸۰ و ۴۴۳: عبارت --ip و آدرس IP آن را اضافه کنید، مانند beanpool claim --ip 203.0.113.7. سرور شما گواهی اختصاصی خود را برای آن آدرس از طریق Let's Encrypt روی پورت ۸۰ دریافت می‌کند و گوشی‌ها در نشانی https://203.0.113.7 به آن متصل می‌شوند. یک رایانه در خانه، یا بدون پورت‌های باز: آن را همان‌طور که هست بگذارید. این دستور بخش اول نام رایگان را می‌پرسد (فقط عبارت yourtown را برای yourtown.beanpool.org تایپ کنید؛ زدن Enter از آن رد می‌شود)، که از طریق تونلی که خود سرور اجرا می‌کند در دسترس قرار می‌گیرد و تا سه دقیقه منتظر فعال شدن آن می‌ماند. دامنه اختصاصی شما: یک رکورد A برای آن به سمت آدرس IP سرور تنظیم کنید، پورت‌های ۸۰ و ۴۴۳ را باز بگذارید و عبارت --address https://your.domain را اضافه کنید. یک نام پس از تغییر سرور باقی می‌ماند؛ یک عدد IP باقی نمی‌ماند: می‌توانید بعداً در تنظیمات نامی اضافه کنید و اعضایی که از آدرس IP استفاده می‌کنند همچنان متصل می‌مانند. برای انتخاب در آینده از طریق تنظیمات، عبارت --no-name را اضافه کنید. یک آدرس معمولی http:// فقط روی شبکه خانگی کار می‌کند: گوشی‌ها در اینترنت آن را رد می‌کنند و دستور ثبت به شما هشدار می‌دهد. اگر سرویس آدرس پروژه BeanPool قطع باشد، دستور ثبت همچنان کار می‌کند.
نصب
سپس، در آن رایانه‌ای که داکر روی آن نصب است، این یک بلوک را جای‌گذاری کنید. این دستور فایل compose را دریافت می‌کند، شبکه‌ای را که نود استفاده می‌کند می‌سازد، تصویر منتشرشده را دریافت می‌کند (Intel/AMD یا ARM64)، آن را اجرا می‌کند، منتظر می‌ماند تا سرور کد مالکیت یک‌بارمصرف خود را بسازد (تا پنج دقیقه، برای اولین راه‌اندازی کند در رزبری پای)، و آن را ثبت می‌کند. قبل از شروع هیچ چیزی برای پیکربندی وجود ندارد.
git clone https://github.com/beanpool-org/beanpool.git && cd beanpool
docker network create beanpool-shared
docker compose pull
docker compose up -d
echo "Waiting for the server to make its claim code (up to 5 minutes)..."
for i in $(seq 60); do docker compose exec -T beanpool-node test -f /data/claim-code.txt </dev/null 2>/dev/null && break; sleep 5; done
docker compose exec -T beanpool-node test -f /data/claim-code.txt </dev/null 2>/dev/null || echo "No claim code after 5 minutes. The server's log says why: docker compose logs beanpool-node"
docker compose exec beanpool-node beanpool claim
خط آخر: beanpool claim
- کد و QR. یک کد مالکیت یک‌بارمصرف و یک کد QR نشان می‌دهد. کد QR را با دوربین گوشی خود اسکن کنید، یا BeanPool را باز کنید، آدرس سرور را در بخش جامعه خود را پیدا کنید تایپ کنید و روی ثبت (Claim) ضربه بزنید. آن گوشی مالک جامعه می‌شود.
- تنظیمات. آدرس خود (یا آدرس سرور) را به همراه /settings در انتها باز کنید. راهنمای راه‌اندازی جامعه شما را نام‌گذاری می‌کند، از شما می‌خواهد مالک دومی اضافه کنید و سه دعوت‌نامه اولیه می‌سازد. مکان خود را روی نقشه زیر هویت نود تنظیم کنید تا افراد نزدیک بتوانند شما را پیدا کنند.
اگر در بلوک متن No claim code after 5 minutes نمایش داده شد، یا دستور beanpool claim اعلام کرد This community has no claim code waiting، سرور هنوز مراحل راه‌اندازی را به پایان نرسانده است: دستور docker compose logs beanpool-node نشان می‌دهد در چه مرحله‌ای قرار دارد. هنگامی که در گزارش ثبت شد جامعه هنوز مالکی ندارد و کد مالکیت آماده است، خط آخر را دوباره اجرا کنید. مراحل کامل در بخش راه‌اندازی اولیه از راهنمای گردانندگان آمده است.
توصیه‌شده: هنگام به‌روزرسانی Docker جامعه‌تان را روشن نگه دارید
این گام در صفحهٔ «Updates and health» راهنمای گردانندگان آمده است. دستیار هوش مصنوعی‌ای که نصب را انجام می‌دهد همیشه این گام را اجرا می‌کند (راه‌اندازی سرور شما با دستیار هوش مصنوعی).
مشاهده در GitHub ←