# نصب Beancount.io شخصی خود با یک کلیک

کل پشته Beancount.io—شامل اپلیکیشن وب، API، سرور MCP، و دفتر کل پشتیبانی شده توسط Git شما—را در عرض حدود ۳۰ دقیقه در فضای کاری bex خود مستقر (deploy) کنید. تنظیمات صفر، بدون محدودیت پلن، دارای مجوز MIT، و هزینه‌ای در حدود ۳۳$ در ماه برای میزبانی.



Beancount مالکیت کامل امور مالی شما را به صورت متن ساده به شما می‌دهد. مالکیت نرم‌افزار پیرامون این فایل‌های `.bean` دشوار بوده است: داشتن رابط کاربری وب، خط فرمان (CLI) و نقطه پایانی عامل هوش مصنوعی بر روی دفتر کل شما یا به اعتماد به سرویس میزبانی ما برای اسناد خود یا را به تنظیم دستی شش سرویس نیاز داشت.

از امروز، می‌توانید یک نمونه Beancount.io خصوصی خود را تنها با یک کلیک راه‌اندازی کنید.

**Deploy to bex.co** را فشار دهید، فضای کاری که قرار است این پشته متعلق به آن باشد را انتخاب کنید و پلن را تأیید نمایید. هیچ چیز برای پیکربندی وجود ندارد—هر رمز به طور خودکار در داخل فضای کاری شما تولید می‌شود. حدود ۳۰ دقیقه بعد، داشبورد شما فعال خواهد شد. حساب خود را ایجاد کنید و ثبت نام را پشت سر بگذارید؛ هیچ کس دیگری نمی‌تواند وارد شود مگر اینکه از طریق شناسه هویت خود به او دعوت کنید.

[![Deploy to bex.co](/img/blog/run-your-own-beancount-io-from-one-button/deploy-to-bex.svg)](https://dashboard.bex.co/deploy?repo=https://github.com/bex-co/beancount-io&path=bex.yaml)

دفتر کل شما به عنوان یک مخزن Git استاندارد بر روی یک دیسک در فضای کاری شما زندگی می‌کند. هر رابط اکیداً به آدرس شما اشاره دارد، نه به آدرس ما: داشبورد وب، `bea` CLI، عامل‌های کدنویسی از طریق سرور MCP داخلی، یا `git` ساده (که `bea` برای شما احراز هویت می‌کند). هیچ محدودیتی در تعداد دفتر کل‌ها، دستورالعمل‌ها یا استفاده از هوش مصنوعی وجود ندارد، و این پشته هیچ تحلیل داده‌ای را به Beancount.io ارسال نمی‌کند.

ادغام‌های اختیاری تا زمانی که به آنها نیاز ندارید خاموش می‌مانند: کلید مدل خود را برای اسکن رسید، دسته‌بندی، و دستیار بیاورید؛ یک سطل S3 برای بارگذاری رسید؛ یا یک کلید ایمیل برای تنظیم مجدد رمز عبور. تا زمانی که آنها را اضافه نکنید، هر ویژگی به سادگی نشان می‌دهد که به چه تنظیماتی نیاز دارد—هر چیز دیگری بدون هیچ تنظیم اضافی کار می‌کند.

## آنچه دریافت می‌کنید و هزینه آن

این استقرار شش سرویس را فراهم می‌کند که مستقیماً به فضای کاری bex شما صورت‌حساب می‌شوند (قیمت‌ها از پیش‌نمایش پلن bex در تاریخ ۲۰۲۶-۱۱-۱۸):

| سرویس | وظیفه آن | هزینه ماهانه (USD) |
| --- | --- | --- |
| Dashboard | اپلیکیشن وب و آدرس عمومی واحدی که استفاده می‌کنید | $4.90 |
| API | GraphQL، REST، سرور MCP و پروکسی Git | $4.90 |
| Ledger service | اعتبارسنجی و کوئری دفتر کل شما (خصوصی، بدون آدرس عمومی) | $4.90 |
| Gitea | ذخیره هر دفتر کل به عنوان یک مخزن Git در هارد ۱۰ گیگابایتی (خصوصی) | $6.65 |
| Postgres | حساب‌ها، توکن‌ها و تنظیمات | $4.41 |
| Key Value | نشست‌های ورود و کش‌ها | $7.21 |
| **جمع** | | **$32.97** |

هر ارائه‌دهنده مدل خارجی، سرویس ایمیل، یا سطل S3 که متصل می‌کنید به صورت جداگانه توسط آن ارائه‌دهندگان صورت‌حساب می‌شود.

> **قبل از حذف آن:** حذف منابع فوراً صورت‌حساب را متوقف می‌کند، **و داده‌های شما را نیز با آن حذف می‌کند.** همیشه ابتدا دفتر کل‌های Git خود را کلون (clone) کنید.

هر حساب در یک پشته خودمیزبان به طور خودکار سطح بالایی را دریافت می‌کند—هیچ سقف مصنوعی وجود ندارد:

![تنظیمات، صورت‌حساب در یک پشته خودمیزبان: پلن Enterprise، با توکن‌های هوش مصنوعی، دفتر کل‌ها، دستورالعمل‌ها و همکاران نامحدود.](/img/blog/run-your-own-beancount-io-from-one-button/no-plan-limits.webp)

## از یک کلیک تا اولین دفتر کل شما

۱. **پشته را اجرا کنید.** روی **Deploy to bex.co** کلیک کنید (بالا یا در [README](https://github.com/bex-co/beancount-io#self-host))، فضای کاری خود را انتخاب کنید، پلن را بررسی کرده و اعمال نمایید. تا زمانی که آن را تأیید نمی‌کنید، هیچ چیز مستقر نمی‌شود.
۲. **صبر کنید تا ساخت اولیه انجام شود.** اولین ساخت ۲۷ تا ۳۰ دقیقه طول می‌کشد در سرورهای ما (اگر صف ساخت bex شلوغ باشد طولانی‌تر است). اگر سرویسی نقض rollout نشان داد، یک استقرار مجدد (redeploy) از داشبورد bex انجام دهید.
۳. **نمونه خود را فعال کنید.** آدرس داشبورد خود را باز کنید و بلافاصله ثبت نام کنید—هیچ مرحله تأیید ایمیلی وجود ندارد.
۴. **یک دفتر کل ایجاد کنید.** با قالب آغازین شروع کنید یا دفتر کل نمونه را بارگذاری کنید تا کاوش کنید.

> **نکته امنیتی:** تا زمانی که اولین حساب ساخته نشود، هر کسی که آدرس شما را کشف کند می‌تواند آن را ادعا کند. اگر کسی زودتر از شما آن را فعال کرد، می‌توانید با استفاده از توکن ادمین پشته، [آن حساب را حذف کنید](https://github.com/bex-co/beancount-io/blob/main/docs/prfaqs/PRFAQ006-self-host-on-bex.md#13-someone-signed-up-before-me-what-now) تا ثبت نام مجددا باز شود.

![ثبت نام در یک استقرار جدید خودمیزبان. در کنار فرم، متن "این صفحه توسط مالک آن اجرا می‌شود و اسناد به صورت متن ساده در Git ذخیره می‌شوند" دیده می‌شود.](/img/blog/run-your-own-beancount-io-from-one-button/sign-up.webp)

## ابزارهای خود را به آدرس خود متصل کنید

### خط فرمان `bea`

[`bea`](/docs/Basics/bea-cli) را از طریق `uv tool install beancount-io` یا `brew install bex-co/tap/bea` نصب یا به‌روزرسانی کنید، سپس آن را به داشبورد خود متصل کنید:

```zsh
export BEA_API_URL=https://<آدرس داشبورد شما>
export BEA_DASHBOARD_URL=https://<آدرس داشبورد شما>
bea cloud login            # از طریق مرورگر شما وارد می‌شود
bea cloud ledger list
```

هر دو متغیر محیطی از یک آدرس داشبورد استفاده می‌کنند که ترافیک API را برای شما پروکسی می‌کند.

![bea 0.4.1 در مقابل یک استقرار خودمیزبان: bea cloud login، bea cloud status در پلن Enterprise، و bea cloud ledger list.](/img/blog/run-your-own-beancount-io-from-one-button/bea-login.webp)

### عامل‌های کدنویسی (MCP)

Claude Code یا هر کلاینت سازگار با MCP را مستقیماً به استقرار خود متصل کنید:

```zsh
claude mcp add --transport http beancount \
  https://<آدرس داشبورد شما>/api-gateway/mcp
```

وارد `/mcp` در Claude Code شوید—صف تأیید OAuth توسط نمونه خود شما ارائه می‌شود. برای کلاینت‌هایی که از هدرها برای احراز هویت استفاده می‌کنند، یک توکن در **Settings → Personal access tokens** ایجاد کرده و آن را به عنوان `Authorization: Bearer <توکن>` ارسال کنید. در پشته تست ما، یک کلاینت MCP بلافاصله ۴۷ ابزار را در دسترس قرار داد و کوئری‌های BQL را مستقیماً روی دفتر کل اجرا کرد.

![یک کلاینت MCP که به آدرس خود استقرار اشاره دارد با توکن دسترسی شخصی: ۴۷ ابزار و یک کوئری BQL روی دفتر کل.](/img/blog/run-your-own-beancount-io-from-one-button/mcp-client.webp)

### Git ساده

هر دفتر کل یک مخزن Git در آدرس `https://<آدرس API شما>/git/<صاحب>/<دفترکل>.git` است (می‌توانید URL دقیق را از منوی **Git Clone** دفتر کل کپی کنید). از آنجایی که bex SSH را مسیریابی نمی‌کند، Git از طریق HTTPS اجرا می‌شود—و `bea` اعتبار شما را مدیریت می‌کند:

```zsh
bea cloud login            # یک بار، اگر قبلاً انجام نداده‌اید
bea cloud git setup        # Git را برای احراز هویت با نشست bea شما تنظیم می‌کند
git clone https://<آدرس API شما>/git/<صاحب>/<دفترکل>.git
```

از آن پس، `git clone`، `git pull` و `git push` بدون درخواست روی آن هاست کار می‌کنند، و `bea cloud logout` اعتبار Git را نیز پاک می‌کند. *(توجه: `bea cloud ledger clone` مستقیماً از طریق HTTPS کلون نمی‌شود؛ در سرورهایی که SSH ندارند، این دستورات را برای شما چاپ می‌کند.)*

![منوی Git Clone یک دفتر کل: آدرس HTTPS API، با یک توکن دسترسی شخصی به عنوان رمز عبور.](/img/blog/run-your-own-beancount-io-from-one-button/git-clone-menu.webp)

#### استفاده از Git بدون `bea` (رانرهای CI و اسکریپت‌ها)

اگر ترجیح می‌دهید `bea` را روی یک ماشین یا رانر CI نصب نکنید، با یک توکن دسترسی شخصی—مشابه GitHub—احراز هویت کنید:

۱. **یک توکن ایجاد کنید.** به **Settings → Personal access tokens → New token** بروید. نام آن را برای محیط خود قرار دهید (`laptop`، `nightly-backup`)، برای کلون/pull، `ledger.read` را انتخاب کرده و اگر نیاز به push دارد `ledger.write` را اضافه کنید. برای اسکریپت‌های خودکار، محدوده آن را به یک دفتر کل واحد محدود کرده و تاریخ انقضا بگذارید. توکن `bcio_...` را بلافاصله کپی کنید—تنها یک بار نمایش داده می‌شود.

![تنظیمات، توکن‌های دسترسی شخصی: توکنی با ledger.read و ledger.write، پیشوند آن، و زمان ایجاد و آخرین استفاده.](/img/blog/run-your-own-beancount-io-from-one-button/access-tokens.webp)

۲. **کلون و کش (cache).** در اولین کلون، هر رشته خالی غیر خالی را به عنوان نام کاربری وارد کرده و توکن را به عنوان رمز عبور بچسبانید. macOS (Keychain) و Windows (Git Credential Manager) آن را به طور خودکار ذخیره می‌کنند. در لینوکس، ابتدا یک کمکی برای اعتبار فعال کنید: `git config --global credential.helper store` (در متن ساده در `~/.git-credentials`) یا `credential.helper 'cache --timeout=86400'` (در حافظه برای ۲۴ ساعت).

برای اسکریپت‌ها و پشتیبان‌گیری زمان‌بندی شده، توکن را از URL راه دور (تا در `.git/config` نوشته نشود) و از تاریخچه شل خود خارج نگه دارید:

```zsh
read -rs BEANCOUNT_TOKEN; export BEANCOUNT_TOKEN
helper='!f() { echo username=token; echo "password=$BEANCOUNT_TOKEN"; }; f'
git -c credential.helper= -c credential.helper="$helper" \
  clone --mirror https://<آدرس API شما>/git/<صاحب>/<دفترکل>.git
```

وجود `-c credential.helper=` خالی از ذخیره توکن در Keychain محلی یا `~/.git-credentials` جلوگیری می‌کند. هر دو پرچم `-c` را به هر `git fetch` یا `git push` بعدی در اسکریپت خود ارسال کنید.

> **عیب‌یابی اعتبار:** اگر Git مدام در حال تلاش برای یک رمز عبور قدیمی یا توکن لغو شده است، آن را با `printf 'protocol=https\nhost=<آدرس API شما>\n\n' | git credential reject` پاک کنید. احراز هویت Git مبتنی بر رمز عبور در حال حاضر کار می‌کند، اما در حال حذف است.

**آیا دفاتر موجود دارید؟** یک دفتر کل جدید ایجاد کنید، فایل‌های خود یا تاریخچه Git خود را در آن ادغام کرده و Push کنید. پشته `main.bean` را به عنوان نقطه ورود می‌خواند، بنابراین یا نام فایل اصلی خود را `main.bean` بگذارید یا از آن برای `include` کردن فایل‌های موجود استفاده کنید.

## آنچه از فضای کاری شما خارج می‌شود

پشته هیچ تحلیل داده‌ای یا داده‌های سفره‌ای به Beancount.io نمی‌فرستد، و اسکریپت تحلیل مرورگر به طور کامل از ساخت حذف می‌شود. تنها درخواست‌های خروجی که ما می‌دانیم عبارتند از:

- **بررسی‌های نقض رمز عبور:** ۵ کاراکتر اول هش SHA-1 رمز عبور جدید از طریق ناشناس‌سازی k (نه رمز عبور شما و نه حساب شما فاش می‌شود) بررسی می‌شوند.
- **تصاویر پروفایل:** درخواست‌های مرورگر به Gravatar با استفاده از هش آدرس ایمیل کاربر.
- **فیدها:** درخواست‌های برای فیدهای بلاگ و تغییرات Beancount.io (فقط ترجیح زبان ارسال می‌شود، هیچ داده کاربری ارسال نمی‌شود).
- **فیدهای قیمت:** درخواست‌ها به beancount.io *فقط* در صورتی که دفتر کل شما صراحتاً یک URL قیمت مدیریت شده را شامل شود.
- **یکپارچه‌سازی‌های خودتان:** داده‌های ارسال شده به سرویس‌هایی که انتخاب کرده‌اید (ارائه‌دهندگان LLM، SendGrid، S3، Plaid، یا ارائه‌دهنده OIDC شما).

برای جزئیات دقیق در مورد زمان فعال شدن هر درخواست، [جدول کامل حریم خصوصی](https://github.com/bex-co/beancount-io/blob/main/docs/prfaqs/PRFAQ006-self-host-on-bex.md#12-is-my-data-private) را ببینید.

## چه کسانی ماشین‌ها را اجرا می‌کنند

سرویس‌ها، دیسک و پایگاه داده شما روی زیرساخت bex اجرا می‌شوند، در داخل فضای کاری شما و تحت صورت‌حساب شما. شفافیت کامل: bex توسط Stargately, Inc. ساخته شده است—هم همان شرکتی که پشت Beancount.io است—و میزبانی توسط [سیاست حفظ حریم خصوصی](https://bex.co/privacy-policy) و [شرایط خدمات](https://bex.co/terms-of-service) bex اداره می‌شود. سرویس Beancount.io میزبانی شده کاملاً از پشته شما جدا است و هیچ یک از اسرار آن را نگه‌دارنده نیست.

آیا ترجیح می‌دهید روی سخت‌افزاری که مستقیماً کنترل می‌کنید اجرا کنید؟ [استقرار Docker](https://github.com/bex-co/beancount-io/tree/main/deploy/docker) ما دقیقاً همان پشته را بر روی هر سروری که خودتان مالک آن هستید اجرا می‌کند.

## نکات خوب برای دانستن

- **پیش‌فرض تک-کاربر، OIDC برای تیم یا خانواده.** ثبت نام پس از ایجاد اولین حساب بسته می‌شود. برای افزودن دیگران، یک ارائه‌دهنده OpenID Connect متصل کرده و آدرس‌های مجاز را در `OIDC_ALLOWED_EMAILS` لیست کنید ([راهنمای تنظیم](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#more-accounts-your-own-identity-provider)). احراز هویت دو عاملی توسط ارائه‌دهنده هویت شما انجام می‌شود.
- **به زمان خود به‌روزرسانی کنید.** پشته شما تا زمانی که تصمیم به همگام‌سازی Blueprint و استقرار مجدد بگیرید، در نسخه استقرار شده قفل می‌ماند ([نحوه به‌روزرسانی](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#rolling-out-a-change)).
- **پشتیبان‌گیری ساده.** دفتر کل‌ها فقط مخازن Git هستند—`git clone --mirror` کل تاریخچه شما را پشتیبان می‌گیرد. حساب‌ها، توکن‌ها و تنظیمات در Postgres مدیریت شده با پشتیبان‌گیری مداوم و بازیابی در لحظه نگهداری می‌شوند ([راهنمای پشتیبان‌گیری](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#back-up-and-restore)).
- **پشتیبانی از اپلیکیشن موبایل.** در صفحه خوش‌آمدگویی اپلیکیشن موبایل، تنظیمات را باز کنید، آدرس سرور را به آدرس داشبورد خود هدایت کنید و وارد شوید.

برای همه مراحل در یک مکان، از جمله به‌روزرسانی‌ها، پشتیبان‌گیری، تنظیم مجدد رمز عبور و حذف پشته، [راهنمای خودمیزبانی](/docs/self-host-beancount-io) را ببینید.

مشکلی پیش آمد؟ یک [بخش GitHub](https://github.com/bex-co/beancount-io/issues) باز کنید یا در [گفتگوی تلگرام](https://t.me/beancount) شرکت کنید.
