elestio/bigcapital-server

Bigcapital Docker镜像（由Elestio验证和打包）

镜像概述和主要用途

Bigcapital 是一款在线会计软件，旨在自动化企业财务流程。本镜像由Elestio验证和打包，提供了便捷的Docker化部署方案，适用于需要快速搭建财务自动化系统的用户。

!https://github.com/elestio-examples/bigcapital/raw/main/bigcapital.png

核心功能和特性

Bigcapital核心功能

• 企业财务流程自动化
• 在线会计管理
• 财务数据处理与分析

Elestio镜像优势

• 同步更新：Elestio与原始代码库保持同步，通过自动化流程快速发布新版本镜像。
• 及时修复与特性：提供对最新bug修复和功能的及时访问。
• 质量控制：Elestio团队执行质量检查，确保发布的产品符合高标准。

使用场景和适用范围

• 企业财务自动化：适用于需要简化财务流程（如记账、报表生成）的中小企业。
• 团队协作管理：支持多人协作处理财务数据，提升团队效率。
• 快速部署需求：需要通过Docker快速搭建会计系统，避免复杂环境配置的场景。

使用方法和配置说明

1. Git克隆部署

通过以下步骤快速部署：

克隆仓库

bash
git clone https://github.com/elestio-examples/bigcapital.git

复制环境变量文件

bash
cp ./tests/.env ./.env

编辑环境变量

根据实际需求修改.env文件中的配置值（详见下方环境变量说明）。

启动服务

bash
docker-compose up -d

访问Web界面

服务启动后，通过 http://your-domain:6534 访问Web UI。

2. Docker Compose配置

以下是完整的docker-compose.yml示例：

yaml
version: "3.3"
services:
    nginx:
        image: elestio/bigcapital-nginx:latest
        restart: always
        volumes:
            - ./storage/data/logs/nginx/:/var/log/nginx
        ports:
            - "172.17.0.1:6534:80"
        tty: true
        depends_on:
            - server
            - webapp

    webapp:
        image: elestio/bigcapital-webapp:latest
        restart: always

    server:
        image: elestio/bigcapital-server:latest
        restart: always
        links:
            - mariadb
            - mongo
            - redis
        depends_on:
            - mariadb
            - mongo
            - redis
        environment:
            # 邮件配置
            - MAIL_HOST=${MAIL_HOST}
            - MAIL_USERNAME=${MAIL_USERNAME}
            - MAIL_PASSWORD=${MAIL_PASSWORD}
            - MAIL_PORT=${MAIL_PORT}
            - MAIL_SECURE=${MAIL_SECURE}
            - MAIL_FROM_NAME=${FROM_EMAIL}
            - MAIL_FROM_ADDRESS=${FROM_EMAIL}
            # 数据库配置
            - DB_HOST=mariadb
            - DB_USER=${DB_USER}
            - DB_PASSWORD=${DB_PASSWORD}
            - DB_CHARSET=${DB_CHARSET}
            - SYSTEM_DB_NAME=${SYSTEM_DB_NAME}
            - TENANT_DB_NAME_PERFIX=${TENANT_DB_NAME_PERFIX}
            # 认证配置
            - JWT_SECRET=${JWT_SECRET}
            # MongoDB配置
            - MONGODB_DATABASE_URL=mongodb://mongo/bigcapital
            # 应用配置
            - BASE_URL=${BASE_URL}
            # Agendash配置
            - AGENDASH_AUTH_USER=${AGENDASH_AUTH_USER}
            - AGENDASH_AUTH_PASSWORD=${AGENDASH_AUTH_PASSWORD}
            # 注册限制
            - SIGNUP_DISABLED=${SIGNUP_DISABLED}
            - SIGNUP_ALLOWED_DOMAINS=${SIGNUP_ALLOWED_DOMAINS}
            - SIGNUP_ALLOWED_EMAILS=${SIGNUP_ALLOWED_EMAILS}

    database_migration:
        image: elestio/bigcapital-migration:latest
        restart: always
        environment:
            - DB_HOST=mariadb
            - DB_USER=${DB_USER}
            - DB_PASSWORD=${DB_PASSWORD}
            - DB_CHARSET=${DB_CHARSET}
            - SYSTEM_DB_NAME=${SYSTEM_DB_NAME}
            - TENANT_DB_NAME_PERFIX=${TENANT_DB_NAME_PERFIX}
        depends_on:
            - mariadb

    mariadb:
        image: elestio/bigcapital-mariadb:latest
        restart: always
        environment:
            - MARIADB_DATABASE=${SYSTEM_DB_NAME}
            - MARIADB_USER=${DB_USER}
            - MARIADB_PASSWORD=${DB_PASSWORD}
            - MARIADB_ROOT_PASSWORD=${DB_ROOT_PASSWORD}
        volumes:
            - ./storage/mariadb:/var/lib/mariadb
        expose:
            - "3306"

    mongo:
        image: elestio/bigcapital-mongo:latest
        restart: always
        expose:
            - "27017"
        volumes:
            - ./storage/mongo:/var/lib/mongodb

    redis:
        image: elestio/bigcapital-redis:latest
        restart: always
        expose:
            - "6379"
        volumes:
            - ./storage/redis:/data

3. 环境变量说明

维护

日志查看

容器日志输出到stdout，可通过以下命令查看：

bash
docker-compose logs -f

停止服务：

bash
docker-compose down

备份与恢复

通过文件夹卷挂载实现数据持久化，备份和恢复步骤如下：

创建备份归档

进入docker-compose.yml所在目录，执行：

bash
zip -r myarchive.zip .

恢复备份

将归档解压到原始目录：

bash
unzip myarchive.zip -d /path/to/original/folder

启动服务

恢复后启动服务：

bash
docker-compose up -d

相关链接

• https://github.com/bigcapitalhq/bigcapital
• Bigcapital官方文档
• https://github.com/elestio-examples/bigcapital