什么是 Fleetbase？

Fleetbase 是一款模块化物流与供应链操作系统，旨在简化供应链行业各领域的管理、规划、优化及运营控制流程。

🎯 Fleetbase 适用人群

Fleetbase 专为需要强大物流和供应链管理功能的组织打造：

• 电商与零售 - 管理配送、追踪订单并优化最后一公里物流
• 食品饮料 - 协调餐厅配送、管理司机并追踪实时订单
• 快递服务 - 调度司机、优化路线并提供客户追踪功能
• 现场服务 - 安排技术人员、管理服务区域并追踪工作完成情况
• 企业物流 - 通过完整 API 访问构建定制化供应链解决方案
• 开发人员 - 借助模块化架构和全面 API 进行扩展与定制

可视化功能展示

功能	截图	描述
订单看板		通过动态看板直观管理订单。
订单配置		创建包含逻辑、规则、自动化、活动流程和自定义字段的定制化订单配置。
订单追踪		在交互式地图上实时追踪单个订单。
实时车队地图		通过实时地图全面掌握车队和活跃订单情况。
服务区域		定义和管理车队的服务区域与范围。

快速入门

npm install -g @fleetbase/cli
flb install-fleetbase

📖 目录

• 功能特性
  • 安装
  • 扩展
  • 应用程序
  • 路线图
  • 部署选项
  • 漏洞与功能请求
  • 文档
  • 贡献指南
  • 社区
  • 创建者
  • 许可与版权

📦 功能特性

特性	描述
🔌 可扩展	通过模块化架构，直接在系统内构建可安装的扩展和附加功能。
👨‍💻 开发者友好	RESTful API、Socket 和 Webhook，可无缝集成外部系统或开发自定义应用。
📱 原生应用	一系列开源及原生应用，专为运营管理和客户交互设计。
🤝 协作功能	专用聊天和评论系统，支持跨组织协作。
🔒 安全性	安全数据加密，遵循行业标准安全实践，以及全面的动态身份与访问管理（IAM）系统。
📡 远程信息处理	集成并连接硬件设备和传感器，提供更多运营反馈和可见性。
🌐 国际化	支持多语言翻译，满足多样化用户群体和全球业务需求。
⚙️ 框架	基于物流和供应链抽象构建的 PHP 核心，简化扩展开发流程。
🔄 动态配置	可配置的规则、流程和逻辑，支持自动化和自定义。
🎨 用户界面/体验	简洁、响应式且用户友好的界面，便于通过桌面或移动设备高效管理和运营。
📊 数据仪表盘	创建自定义仪表盘和小部件，全面掌握运营状况。
📈 可扩展性	具备可扩展的基础设施和设计，支持业务持续增长，能够处理不断增加的数据量和用户需求。
🔄 持续改进	致力于持续优化，定期提供更新，无缝引入性能优化、新功能及整体系统增强。
🌍 开源	可根据组织需求和偏好，选择本地部署或云端部署。

💾 安装

开始使用 Fleetbase 最简单的方法是使用 Fleetbase CLI，它可以自动完成整个基于 Docker 的安装过程。有关本地设置选项，请阅读 Fleetbase 文档中的本地运行快速入门。

先决条件

• Node.js v22
• Docker 和 Docker Compose
• Git

使用 CLI 快速安装

# Install the Fleetbase CLI globally
npm install -g @fleetbase/cli

# Run the interactive installer
flb install-fleetbase

备选安装脚本

您也可以直接使用安装脚本：

git clone git@github.com:fleetbase/fleetbase.git  
cd fleetbase && ./scripts/docker-install.sh

访问 Fleetbase

成功安装并运行后，您可以通过端口 4200 访问 Fleetbase 控制台，API 可通过端口 8000 访问。

Fleetbase 控制台：http://localhost:4200 Fleetbase API：http://localhost:8000

其他配置

跨域资源共享（CORS）： 如果您直接在服务器上安装，需要将环境变量配置到应用容器中：

CONSOLE_HOST=http://{yourhost}:4200

如果您有其他应用程序或前端，可以使用环境变量 FRONTEND_HOSTS 添加一个以逗号分隔的其他前端主机列表。

应用程序密钥 如果您遇到有关缺少应用程序密钥的问题，只需运行：

docker compose exec application bash -c "php artisan key:generate --show"

接下来，将此值复制到应用容器的 APP_KEY 环境变量中并重启。

路由： Fleetbase 附带由 router.project-osrm.org 托管的默认 OSRM 服务器，但您也可以使用自己的或任何其他兼容 OSRM 的服务器。您可以在 console/environments 目录中修改要部署环境的 .env 文件，将 OSRM_HOST 设置为 Fleetbase 要使用的 OSRM 服务器。

服务： 要使 Fleetbase 具备完整功能，需要设置一些环境变量。如果您使用 docker 进行部署，最简单的方法是创建一个 docker-compose.override.yml 文件，并在此文件中提供环境变量。

version: "3.8"
services:  
  application:  
    environment:  
      CONSOLE_HOST: http://localhost:4200
      MAIL_MAILER: (ses, smtp, mailgun, postmark, sendgrid)
      OSRM_HOST: https://router.project-osrm.org
      IPINFO_API_KEY:
      GOOGLE_MAPS_API_KEY:  
      GOOGLE_MAPS_LOCALE: us
      TWILIO_SID:  
      TWILIO_TOKEN:
      TWILIO_FROM:

  socket:
    environment:
      # IMPORTANT: Configure WebSocket origins for security
      # Development (localhost only - include WebSocket protocols):
      SOCKETCLUSTER_OPTIONS: '{"origins":"http://localhost:*,https://localhost:*,ws://localhost:*,wss://localhost:*"}'
      # Production (replace with your actual domain):
      # SOCKETCLUSTER_OPTIONS: '{"origins":"https://yourdomain.com:*,wss://yourdomain.com:*"}'

WebSocket 安全： SOCKETCLUSTER_OPTIONS 环境变量控制哪些域可以连接到 WebSocket 服务器。在生产环境中，务必将源限制为您的特定域，以防止安全漏洞。

您可以在 官方文档 中了解有关本地安装和配置的更多信息。

⌨️ Fleetbase CLI

Fleetbase CLI 是用于管理您的 Fleetbase 实例的强大工具。它简化了安装、扩展管理、身份验证和开发工作流程。

使用 npm 全局安装 CLI：

npm install -g @fleetbase/cli

可用命令

命令	描述
flb install-fleetbase	使用 Docker 以交互式设置安装 Fleetbase
flb set-auth <token>	设置用于安装扩展的仓库身份验证令牌
flb search [query]	搜索和浏览可用扩展
flb install <extension>	向您的 Fleetbase 实例安装扩展
flb uninstall <extension>	从您的实例中卸载扩展
flb register	注册仓库开发者账户
flb verify	验证您的开发者账户邮箱
flb login	向仓库进行身份验证（用于发布扩展）
flb scaffold	搭建新扩展的开发框架
flb publish	将扩展发布到仓库
flb generate-token	生成或重新生成您的仓库身份验证令牌

🧩 扩展

扩展是模块化组件，可增强您的 Fleetbase 实例功能。它们允许您添加新功能、自定义现有行为或与外部系统集成。

浏览扩展

flb search              # list all extensions
flb search fleet        # search by keyword
flb search --category logistics
flb search --free
flb search --json       # machine-readable output

安装扩展

要在自托管实例上安装扩展：

# 1. Register an account (one-time)
flb register

# 2. Verify your email (one-time)
flb verify -e your-email@example.com -c verification-code

# 3. Generate your registry token
flb generate-token -e your-email@example.com

# 4. Set your authentication token
flb set-auth your-registry-token-here

# 5. Install an extension
flb install <extension>

示例：

flb install fleetbase/pallet
flb install fleetbase/fleetops

开发扩展

您可以开发并发布自己的扩展，以扩展Fleetbase的功能或通过市场实现商业化。更多信息，请参阅扩展开发快速入门。

# 1. Register a developer account (one-time)
flb register

# 2. Verify your email
flb verify -e your-email@example.com -c verification-code

# 3. Scaffold a new extension
flb scaffold

# 4. Authenticate for publishing
flb login -u your-username -p your-password -e your-email@example.com

# 5. Publish to the registry
flb publish

📱 应用程序

Fleetbase 提供可自定义和部署的开源移动应用程序：

应用程序	描述	平台	代码仓库
Storefront App	用于启动自己的商店或市场的电子商务/按需应用程序	iOS & Android	GitHub
Navigator App	用于管理订单并具有实时位置跟踪功能的司机应用程序	iOS & Android	GitHub

🛣️ 路线图

功能	状态	预计发布时间	描述
Pallet (WMS)	🚧 开发中	2026年第二季度	库存与仓库管理扩展
Dynamic Rules	📋 计划中	2027年	用于触发事件、任务和作业的规则构建器

想要影响我们的路线图？参与讨论

🚀 部署选项

选项	最适合	设置时间	维护
Docker (本地)	开发与测试	5分钟	自行管理
本地部署	在自有基础设施上生产	30-60分钟	自行管理
云自托管	生产环境（AWS、GCP、Azure）	30-60分钟	自行管理
Fleetbase Cloud	快速启动，无需DevOps	即时	完全托管

查看云部署指南 →

🐛 错误报告和 💡 功能请求

发现错误或有功能请求？请查看问题跟踪器，搜索现有和已关闭的问题。如果您的问题或想法尚未被提及，请提交新问题。

📄 文档

Fleetbase 提供全面的文档，帮助您快速入门并充分利用平台：

• 入门指南：在本地运行 Fleetbase
• API 参考：API 文档
• 开发者控制台：API 密钥和集成设置
• 扩展开发：扩展快速入门
• 部署：在云端部署 Fleetbase

🤝 贡献指南

我们欢迎社区成员的贡献！您可以通过以下方式提供帮助：

• 报告漏洞：提交 issue
• 建议功能：发起讨论
• 提交 PR：阅读我们的 贡献指南
• 编写文档：帮助改进我们的 文档
• 开发扩展：创建并分享 扩展

开发环境设置：请参阅我们的 开发环境设置指南，获取有关搭建本地开发环境的详细说明。

👥 社区交流

加入我们的 Discord，获取 Fleetbase 的开发动态，并与项目维护者和社区成员交流。

• 关注 X 平台上的 @fleetbase_io。
• 阅读并订阅 Fleetbase 官方博客。
• 在 GitHub Discussions 提问和交流。

有关 Fleetbase 各版本的更新日志，请查看 GitHub 项目的 Releases 部分。

Fleetbase 官方博客 发布公告 包含每个版本中最值得关注的变更摘要。

创始人

Ronald A. Richardson 联合创始人兼首席技术官 GitHub | LinkedIn

Shiv Thakker 联合创始人兼首席执行官 GitHub | LinkedIn

许可与版权

Fleetbase 采用双重许可模式，以满足开源社区用户和商业企业的不同需求：

开源许可（AGPL-3.0）

默认情况下，Fleetbase 根据 GNU Affero 通用公共许可证 v3.0（AGPL-3.0） 进行许可。此许可证允许您自由使用、修改和分发 Fleetbase，但需满足以下条件：

• 任何修改或衍生作品也必须在 AGPL-3.0 许可下提供
• 如果您将修改后的版本作为网络服务运行，则必须向用户提供源代码

AGPL-3.0 非常适合开源项目、学术研究以及致力于与社区分享其改进成果的组织。

商业许可（FCL）

对于需要更大灵活性的组织，Fleetbase 提供Fleetbase 商业许可（FCL），其中包括：

• 摆脱 AGPL 义务——部署和修改 Fleetbase 时无需遵守源代码披露要求
• 专有集成——构建闭源扩展和集成
• 商业保护——提供 AGPL 未涵盖的保证、赔偿和法律保障
• 衍生作品所有权——保留对您的修改和定制的全部所有权
• 灵活的许可选项——可选择年度、月度或永久许可模式

商业许可选项

许可类型	价格	支持与更新	最适合
年度许可	$25,000/年	✅ 包含所有升级和商业支持	需要持续更新和支持的组织
月度许可	$2,500/月	✅ 包含所有升级和商业支持	试点项目和短期部署
主版本许可	$25,000（一次性）	❌ 无持续支持	单一主版本上的稳定部署
次版本许可	$15,000（一次性）	❌ 无持续支持	锁定版本的部署

何时需要商业许可

如果您属于以下情况，应考虑商业许可：

• 希望开发专有扩展或集成，且无需将其开源
• 需要将Fleetbase嵌入商业产品，同时免除AGPL义务
• 要求企业级支持、服务等级协议（SLA）和法律保护
• 计划修改Fleetbase，但不公开分享您的更改

获取商业许可

如需了解商业许可选项的更多信息，请联系我们：

• 邮箱： hello@fleetbase.io
• 网站： fleetbase.io

---

版权所有 © 2026 Fleetbase Pte. Ltd. 保留所有权利。