本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
!Build !Docker Hub !Docker Build !Technical Debt
Fineract是一个成熟的开放API平台,提供可靠、健壮且经济实惠的核心银行解决方案,专为向全球30亿未被充分服务和无银行账户人群提供服务的金融机构设计。该平台支持金融机构高效管理账户、交易和客户数据,通过开放API实现与第三方系统的集成,满足小额金融和普惠金融的业务需求。
# 启动MariaDB容器 docker run --name mariadb-11.5 -p 3306:3306 -e MARIADB_ROOT_PASSWORD=mysql -d mariadb:11.5.2 # 停止并删除容器(数据将丢失,仅用于开发环境) docker rm -f mariadb-11.5
注意:默认容器数据存储在容器内部,删除容器后数据将丢失。生产环境需配置持久化存储,详见MariaDB容器文档。
# Linux/macOS git clone [***] && cd fineract # Windows git clone [***] --config core.autocrlf=input && cd fineract
./gradlew :fineract-provider:jibDockerBuild -x test
docker plugin install grafana/loki-docker-driver:latest --alias loki --grant-all-permissions
docker compose -f docker-compose-development.yml up -d
mifos,密码password注意:首次访问需在浏览器中接受API的自签名SSL证书,否则UI可能显示误导性错误。
PROJECT_ROOT/build/fineract/logs.jfr文件可通过IntelliJ或Azul Mission Control分析若遇到Docker Compose文件权限问题,需修改PROJECT_ROOT/config/docker/env/fineract-common.env中的FINERACT_USER和FINERACT_GROUP:
# 获取当前用户ID和组ID id -u ${USER} id -g ${USER}
./gradlew createDB -PdbName=fineract_tenants ./gradlew createDB -PdbName=fineract_default
./gradlew devRun
./gradlew clean bootJar
生成的JAR文件位于:fineract-provider/build/libs
wget [***]
java -Dloader.path=. -jar fineract-provider/build/libs/fineract-provider.jar
export FINERACT_HIKARI_PASSWORD=verysecret export FINERACT_HIKARI_JDBC_URL=jdbc:mariadb://localhost:3306/fineract_tenants?serverTimezone=UTC&useLegacyDatetimeCode=false&sessionVariables=time_zone='-00:00' # 其他环境变量... java -jar fineract-provider.jar
Fineract 1.7.0+版本采用UTC时间存储,需确保:
serverTimezone=UTC&useLegacyDatetimeCode=false&sessionVariables=time_zone='-00:00'
迁移注意:若从非UTC时区环境迁移,需调整历史数据时区偏移,避免数据读取错误。
通过环境变量配置Hikari连接池,前缀为FINERACT_HIKARI_*,主要参数包括:
FINERACT_HIKARI_JDBC_URL:JDBC连接URLFINERACT_HIKARI_USERNAME:数据库用户名FINERACT_HIKARI_PASSWORD:数据库密码FINERACT_HIKARI_MAXIMUM_POOL_SIZE:最大连接数(默认10)FINERACT_HIKARI_CONNECTION_TIMEOUT:连接超时时间(默认30000ms)完整配置参数见HikariCP文档
详见官方文档:HTTPS配置
通过环境变量调整Tomcat性能参数,主要包括:
FINERACT_SERVER_TOMCAT_MAX_HTTP_FORM_POST_SIZE:最大POST大小(默认2MB)完整配置参考Spring Boot文档
git clone [***] && cd fineract/kubernetes ./kubectl-startup.sh
# 启动Minikube minikube start # 部署Fineract cd fineract/kubernetes && ./kubectl-startup.sh # 获取访问URL minikube service fineract-server --url --https # 健康检查 http --verify=no --timeout 240 --check-status get $(minikube service fineract-server --url --https)/fineract-provider/actuator/health # 查看日志 kubectl logs deployment/fineract-server # 停止并清理 ./kubectl-shutdown.sh minikube ssh sudo rm -rf /mnt/data/
支持ActiveMQ(JMS)和Kafka,用于外部业务事件通知和Spring Batch远程分区作业。
# docker-compose示例片段 environment: FINERACT_REMOTE_JOB_MESSAGE_HANDLER_JMS_ENABLED: "true" FINERACT_REMOTE_JOB_MESSAGE_HANDLER_SPRING_EVENTS_ENABLED: "false" FINERACT_REMOTE_JOB_MESSAGE_HANDLER_JMS_BROKER_URL: "tcp://activemq:61616"
支持PLAINTEXT无认证模式及AWS MSK IAM认证,完整配置见官方文档
config/checkstyle/checkstyle.xml定义代码规范./gradlew spotlessApply修复格式问题./gradlew clean build jacocoTestReport生成覆盖率报告,位于build/code-coverage./gradlew doc
依赖工具:Ghostscript、Graphviz(详见.github/workflows/build-documentation.yml)
/fineract-provider/legacy-docs/apiLive.htm(运行时访问)/fineract-provider/swagger-ui/index.html(在线演示)免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429