Към основното съдържание

Стартирайте своя Beancount.io с едно кликване

Публикувано Последно обновено 9 минути четенеMike ThriftMike Thrift
Стартирайте своя Beancount.io с едно кликване
На тази страница

Разположете целия стек на Beancount.io—уеб приложението, API, MCP сървъра и вашите водени в Git книги—във вашия собствен bex workspace за около 30 минути. Без конфигурация, без ограничения на плана, с MIT лиценз и приблизително $33/месец за хостинг.

Beancount ви дава пълна собственост върху финансите ви в обикновен текст. Собствеността върху софтуера около тези .bean файлове обаче беше по-трудна: да имате уеб интерфейс, CLI и endpoint за AI агент върху вашата книга означаваше или да се доверите на нашия хостван сервиз с вашите сметки, или да свържете шест услуги ръчно.

От днес можете да стартирате собствен екземпляр на Beancount.io с едно кликване.

Натиснете Deploy to bex.co, изберете workspace, който да притежава стека, и одобрете плана. Няма нищо за конфигуриране—всяка тайна се генерира автоматично във вашия workspace. Около 30 минути по-късно таблото ви е активно. Създайте своя акаунт и регистрацията се затваря след вас; никой друг не може да влезе, освен ако не го поканите чрез вашия собствен доставчик на идентичност.

Deploy to bex.co

Вашата книга се съхранява като стандартно Git хранилище на диск във вашия workspace. Всеки интерфейс сочи строго към вашия адрес, не към нашия: уеб таблото, bea CLI, агентите за програмиране чрез вградения MCP сървър или обикновен git (който bea удостоверява вместо вас). Няма ограничения на плана за книги, директиви или използване на AI, а стекът не изпраща никаква аналитика обратно към Beancount.io.

Опционалните интеграции остават изключени, докато не ви потрябват: използвайте собствен ключ за модел за сканиране на разписки, категоризация и асистента; S3 bucket за качване на разписки; или пощенски ключ за нулиране на пароли. Докато не ги добавите, всяка функция просто показва коя настройка ѝ е нужна—всичко останало работи веднага.

Какво получавате и колко струва​

Разгръщането осигурява шест услуги, таксувани директно към вашия bex workspace (цени от прегледа на плана на bex към 2026-11-18):

УслугаКакво правиМесечна цена (USD)
DashboardУеб приложението и единственият публичен адрес, който използвате$4.90
APIGraphQL, REST, MCP сървър и Git прокси$4.90
Ledger serviceВалидира и прави заявки към вашите книги (частна, без публичен адрес)$4.90
GiteaСъхранява всяка книга като Git хранилище на 10 GB диск (частна)$6.65
PostgresАкаунти, токени и настройки$4.41
Key ValueСесии за вход и кешове$7.21
Общо$32.97

Всеки външен доставчик на модели, пощенска услуга или S3 bucket, който свържете, се таксува отделно от тези доставчици.

Преди да го премахнете: Изтриването на ресурсите спира таксуването веднага, и изтрива данните ви с него. Винаги първо клонирайте вашите Git книги.

Всеки акаунт в самостоятелно хостван стек получава най-високото ниво автоматично—без изкуствени тавани:

Настройки, Billing в самостоятелно хостван стек: планът Enterprise, с неограничени AI токени, книги, директиви и сътрудници.

От едно кликване до първата ви книга​

  1. Стартирайте стека. Натиснете Deploy to bex.co (по-горе или в README), изберете вашия workspace, прегледайте плана и го приложете. Нищо не се осигурява, докато не го одобрите.
  2. Изчакайте първоначалното изграждане. Първото изграждане отнема 27–30 минути в нашите тестове (по-дълго, ако опашката за изграждане на bex е заета). Ако дадена услуга показва неуспешно разгръщане, задействайте повторно разгръщане от таблото на bex.
  3. Заявете своя екземпляр. Отворете URL адреса на таблото си и се регистрирайте веднага—няма стъпка за потвърждение по имейл.
  4. Създайте книга. Започнете отначало с началния шаблон или заредете примерната книга, за да разгледате.

Бележка за сигурност: Докато не бъде създаден първият акаунт, всеки, който открие вашия URL адрес, може да го заяви. Ако някой ви изпревари, можете да премахнете този акаунт, използвайки администраторския токен на стека, за да отворите отново регистрацията.

Регистрация в ново самостоятелно хоствано разгръщане. До формуляра страницата казва, че това копие се управлява от собственика му и книгите са в обикновен текст в Git.

Насочете инструментите си към собствения си адрес​

bea CLI​

Инсталирайте или актуализирайте bea чрез uv tool install beancount-io или brew install bex-co/tap/bea, след което го насочете към вашето табло:

export BEA_API_URL=https://<your dashboard address>
export BEA_DASHBOARD_URL=https://<your dashboard address>
bea cloud login            # signs in through your browser
bea cloud ledger list

И двете променливи на средата използват същия URL адрес на таблото, който проксира API трафика вместо вас.

bea 0.4.1 срещу самостоятелно хоствано разгръщане: bea cloud login, bea cloud status на плана Enterprise и bea cloud ledger list.

Агенти за програмиране (MCP)​

Свържете Claude Code или всеки съвместим с MCP клиент директно към вашето разгръщане:

claude mcp add --transport http beancount \
  https://<your dashboard address>/api-gateway/mcp

Влезте чрез /mcp в Claude Code—екранът за съгласие на OAuth се обслужва от вашия собствен екземпляр. За клиенти, които се удостоверяват чрез хедъри вместо това, генерирайте токен под Settings → Personal access tokens и го предайте като Authorization: Bearer <token>. В нашия тестов стек MCP клиент веднага показа 47 инструмента и изпълни BQL заявки директно срещу книгата.

MCP клиент, насочен към собствения адрес на разгръщането с личен токен за достъп: 47 инструмента и BQL заявка върху книгата.

Обикновен Git​

Всяка книга е Git хранилище на адрес https://<your API address>/git/<owner>/<ledger>.git (можете да копирате точния URL от менюто Git Clone на книгата). Тъй като bex не маршрутизира SSH, Git работи през HTTPS—а bea се грижи за идентификационните данни вместо вас:

bea cloud login            # once, if you haven't already
bea cloud git setup        # configures Git to authenticate with your bea session
git clone https://<your API address>/git/<owner>/<ledger>.git

Оттам нататък git clone, git pull и git push работят без запитване на този хост, а bea cloud logout изчиства и идентификационните данни на Git. (Бележка: bea cloud ledger clone не клонира директно през HTTPS; на сървъри без SSH той отпечатва тези команди за вас.)

Менюто Git Clone на книга: HTTPS адресът на API с личен токен за достъп като парола.

Използване на Git без bea (CI runners и скриптове)​

Ако предпочитате да не инсталирате bea на машина или CI runner, удостоверете се с личен токен за достъп—точно както с GitHub:

  1. Създайте токен. Отидете на Settings → Personal access tokens → New token. Назовете го според средата му (laptop, nightly-backup), изберете ledger.read за клониране/изтегляне и добавете ledger.write, ако трябва да публикува. За автоматични скриптове ограничете обхвата му до една книга и задайте дата на изтичане. Копирайте токена bcio_... веднага—той се показва само веднъж.

    Настройки, Personal access tokens: токен с ledger.read и ledger.write, неговият префикс и кога е създаден и използван за последно.

  2. Клонирайте и кеширайте. При първото клониране въведете произволен непразен низ като потребителско име и поставете токена като парола. macOS (Keychain) и Windows (Git Credential Manager) го съхраняват автоматично. В Linux първо активирайте credential helper: git config --global credential.helper store (обикновен текст в ~/.git-credentials) или credential.helper 'cache --timeout=86400' (в паметта за 24 часа).

За скриптове и планирани архивирания дръжте токена извън отдалечения URL (за да не се записва в .git/config) и извън историята на shell-а, като предадете еднократен credential helper:

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://<your API address>/git/<owner>/<ledger>.git

Празният -c credential.helper= пречи на локалния Keychain или ~/.git-credentials да кешират токена. Предайте и двата флага -c на всяко следващо git fetch или git push в скрипта си.

Отстраняване на проблеми с идентификационни данни: Ако Git продължава да опитва стара парола или отменен токен, изчистете го с printf 'protocol=https\nhost=<your API address>\n\n' | git credential reject. Удостоверяването в Git с парола все още работи засега, но постепенно се премахва.

Мигрирате съществуващи книги? Създайте нова книга, обединете файловете или Git историята си в нея и публикувайте. Стекът чете main.bean като входна точка, така че или назовете основния си файл main.bean, или го използвайте, за да include съществуващите си файлове.

Какво напуска вашия workspace​

Стекът не изпраща аналитика или телеметрия към Beancount.io, а скриптът за аналитика в браузъра е напълно премахнат от изграждането. Единствените изходящи заявки, за които знаем, са:

  • Проверки за изтекли пароли: Първите 5 символа от SHA-1 хеша на нова парола се проверяват чрез k-анонимност (нито паролата ви, нито акаунтът ви се разкриват).
  • Аватари: Заявки от браузъра към Gravatar, използващи хеш на имейл адреса на потребителя.
  • Емисии: Заявки за емисиите на блога и changelog на Beancount.io (изпраща се само езикова предпочитание, без потребителски данни).
  • Емисии с цени: Заявки към beancount.io само ако вашата книга изрично включва управляван URL за цени.
  • Вашите собствени интеграции: Данни, изпращани до услуги, които сами изберете (доставчици на LLM, SendGrid, S3, Plaid или вашият OIDC доставчик).

Вижте пълната таблица за поверителност за точни подробности кога се задейства всяка заявка.

Кой управлява машините​

Вашите услуги, диск и база данни работят на инфраструктурата на bex, във вашия workspace и на вашата сметка. Пълна прозрачност: bex е създаден от Stargately, Inc.—същата компания зад Beancount.io—и хостингът се урежда от политиката за поверителност и условията за ползване на bex. Хостваната услуга Beancount.io е напълно отделна от вашия стек и не съдържа нито една от неговите тайни.

Предпочитате да работите на хардуер, който контролирате директно? Нашето Docker разгръщане пуска абсолютно същия стек на всеки сървър, който притежавате.

Добре е да знаете​

  • Един потребител по подразбиране, OIDC за екипи или семейство. Регистрацията се затваря след създаването на първия акаунт. За да добавите други, свържете OpenID Connect доставчик и изброете разрешените адреси в OIDC_ALLOWED_EMAILS (ръководство за настройка). 2FA се обработва от вашия доставчик на идентичност.
  • Актуализации по ваш график. Вашият стек остава фиксиран към версията, която сте разположили, докато не изберете да синхронизирате Blueprint и да разположите отново (как да актуализирате).
  • Прави резервни копия. Книгите са просто Git хранилища—git clone --mirror архивира цялата ви история. Акаунтите, токените и настройките се намират в управляван Postgres с непрекъснати резервни копия и възстановяване към точка във времето (ръководство за архивиране).
  • Поддръжка на мобилното приложение. На екрана за добре дошли на мобилното приложение отворете настройките, насочете URL адреса на сървъра към адреса на таблото си и влезте.

За всяка стъпка на едно място, включително актуализации, архивирания, нулиране на пароли и премахване на стека, вижте ръководството за самостоятелно хостване.

Сблъскахте се с проблем? Отворете GitHub issue или се присъединете към Telegram чата.

Източник: https://beancount.io/bg/blog/2026/11/18/run-your-own-beancount-io-from-one-button

Публикувано: 18 ноември 2026 г.

Последно обновено: 19 ноември 2026 г.