Перейти к основному содержимому

Запустите свой собственный Beancount.io в один клик

Опубликовано Обновлено 9 мин чтенияMike ThriftMike Thrift
Запустите свой собственный Beancount.io в один клик
Содержание страницы

Разверните весь стек Beancount.io — веб-приложение, API, MCP-сервер и ваши журналы на базе Git — в вашем собственном рабочем пространстве bex примерно за 30 минут. Ноль настроек, никаких ограничений тарифов, лицензия MIT и около $33 в месяц за хостинг.

Beancount даёт вам полное владение вашими финансами в виде простого текста. Но владеть программным обеспечением вокруг этих файлов .bean было сложнее: чтобы получить веб-интерфейс, CLI и конечную точку для AI-агента поверх вашего журнала, нужно было либо доверить свои книги нашему хостинговому сервису, либо вручную настроить шесть сервисов.

Начиная с сегодняшнего дня вы можете запустить свой собственный приватный экземпляр Beancount.io одним кликом.

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

Deploy to bex.co

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

Дополнительные интеграции остаются выключенными, пока они вам не понадобятся: собственный ключ модели для сканирования чеков, категоризации и ассистента; S3-хранилище для загрузки чеков; или почтовый ключ для сброса пароля. Пока вы их не добавите, каждая функция просто показывает, какая настройка ей нужна — всё остальное работает из коробки.

Что вы получаете и сколько это стоит​

Развёртывание предоставляет шесть сервисов, оплачиваемых напрямую через ваше рабочее пространство bex (цены из предварительного просмотра плана bex на 18.11.2026):

СервисЧто делаетСтоимость в месяц (USD)
Панель управленияВеб-приложение и единственный публичный адрес, который вы используете$4.90
APIGraphQL, REST, MCP-сервер и Git-прокси$4.90
Сервис журналаПроверяет и запрашивает ваши книги (приватный, без публичного адреса)$4.90
GiteaХранит каждый журнал как Git-репозиторий на диске 10 ГБ (приватный)$6.65
PostgresАккаунты, токены и настройки$4.41
Key ValueСессии входа и кэши$7.21
Итого$32.97

Любой внешний провайдер моделей, почтовый сервис или S3-хранилище, которые вы подключите, оплачиваются отдельно этими провайдерами.

Прежде чем всё удалить: Удаление ресурсов немедленно останавливает счёт, и вместе с ним удаляет ваши данные. Всегда сначала клонируйте свои Git-журналы.

Каждый аккаунт в самостоятельно размещённом стеке автоматически получает максимальный тариф — никаких искусственных ограничений:

Настройки, Billing в самостоятельно размещённом стеке: тариф Enterprise с неограниченными AI-токенами, журналами, директивами и участниками.

От одного клика до вашего первого журнала​

  1. Запустите стек. Нажмите Deploy to bex.co (выше или в README), выберите рабочее пространство, проверьте план и примените. Ничего не будет развёрнуто, пока вы не подтвердите.
  2. Дождитесь первоначальной сборки. Первая сборка занимает 27–30 минут в наших прогонах (дольше, если очередь сборки bex занята). Если какой-либо сервис показывает неудачное развёртывание, запустите повторное развёртывание из панели bex.
  3. Завладейте своим экземпляром. Откройте URL вашей панели управления и сразу зарегистрируйтесь — шага подтверждения по email нет.
  4. Создайте журнал. Начните с нуля с помощью стартового шаблона или загрузите пример журнала для ознакомления.

Примечание по безопасности: Пока не создан первый аккаунт, любой, кто обнаружит ваш URL, может завладеть им. Если кто-то опередил вас, вы можете удалить этот аккаунт с помощью администраторского токена стека, чтобы снова открыть регистрацию.

Регистрация в новом самостоятельно размещённом развёртывании. Рядом с формой на странице сказано, что этот экземпляр управляется его владельцем, а книги хранятся в виде простого текста в Git.

Направьте свои инструменты на собственный адрес​

CLI bea​

Установите или обновите 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-раннеры и скрипты)​

Если вы предпочитаете не устанавливать bea на машину или CI-раннер, аутентифицируйтесь с помощью персонального токена доступа — так же, как на GitHub:

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

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

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

Для скриптов и запланированных резервных копий держите токен вне URL удалённого репозитория (чтобы он не записывался в .git/config) и вне истории вашей оболочки, передав одноразовый помощник учётных данных:

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 и выполните push. Стек читает main.bean как точку входа, так что либо назовите свой корневой файл main.bean, либо используйте его для include ваших существующих файлов.

Что покидает ваше рабочее пространство​

Стек не отправляет аналитику или телеметрию в Beancount.io, а скрипт браузерной аналитики полностью удалён из сборки. Единственные исходящие запросы, о которых нам известно:

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

См. полную таблицу конфиденциальности для точных деталей о том, когда срабатывает каждый запрос.

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

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

Предпочитаете запускать на оборудовании, которое контролируете напрямую? Наше развёртывание в Docker запускает точно такой же стек на любом сервере, которым вы владеете.

Полезно знать​

  • Один пользователь по умолчанию, OIDC для команд или семьи. Регистрация закрывается после создания первого аккаунта. Чтобы добавить других, подключите провайдера OpenID Connect и перечислите разрешённые адреса в OIDC_ALLOWED_EMAILS (руководство по настройке). 2FA обрабатывается вашим провайдером идентификации.
  • Обновления по вашему графику. Ваш стек остаётся привязанным к версии, которую вы развернули, пока вы не решите синхронизировать Blueprint и повторно развернуть (как обновлять).
  • Простые резервные копии. Журналы — это просто Git-репозитории — git clone --mirror создаёт резервную копию всей вашей истории. Аккаунты, токены и настройки хранятся в управляемом Postgres с непрерывным резервным копированием и восстановлением на момент времени (руководство по резервному копированию).
  • Поддержка мобильного приложения. На экране приветствия мобильного приложения откройте настройки, укажите URL сервера — адрес вашей панели управления — и войдите.

Чтобы найти все шаги в одном месте, включая обновления, резервные копии, сброс паролей и удаление стека, см. руководство по самостоятельному размещению.

Столкнулись с проблемой? Откройте issue на GitHub или загляните в чат в Telegram.

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

Опубликовано: 18 ноября 2026 г.

Обновлено: 19 ноября 2026 г.