在数字经济浪潮下，独立开发者和小型团队销售自己的数字产品、源码或提供专业服务变得越来越普遍。然而，搭建一套完整的交易、支付、交付和售后系统往往耗时耗力，技术门槛较高。今天，我们要介绍的“飞鱼小铺”正是为解决这一痛点而生，它是一个面向数字产品、源码仓库与开发者服务的开源交易和自动交付系统，旨在帮助创作者轻松构建和运营自己的数字商品平台。
一、飞鱼小铺是什么？
飞鱼小铺（flyfish-dev/shop）是一个专为独立开发者、小团队及数字产品业务设计的开源交易与自动交付系统。它将商品展示、下单支付、交付履约和售后管理等核心功能整合于一套可私有化部署的解决方案中。无论是销售源码仓库、授权文件、数字资料，还是提供开发者服务，飞鱼小铺都能提供一套完整且高效的自动化流程，让您的数字业务运营更加顺畅。
其核心价值在于提供了一个“完整闭环”的数字商品销售体验，从用户浏览、下单、支付，到系统自动交付产品，再到后期的工单支持，全部在一个可控的私有环境中完成。这对于注重数据安全、希望拥有高度定制性和独立运营权的创作者来说，无疑是一个极具吸引力的选择。
二、功能特征
飞鱼小铺集成了多项强大功能，旨在覆盖数字商品交易的各个环节，并优化用户和运营者的体验：
-
完整交易闭环： 系统支持丰富的商品展示形式，包括商品分组、SKU管理、多语言内容，并允许人民币/美元双币种定价。内置优惠券功能和合同确认机制，支付方面集成了Stripe和H5支付，确保交易流畅。订单管理、工单系统和WebSocket客服功能，则为用户提供了全面的售后支持。
-
自动交付与故障恢复： 这是飞鱼小铺的核心亮点之一。它可以自动化完成多种交付任务，例如为用户开通GitHub、Gitea、Gitee等代码仓库权限，交付数字文件，甚至可以接入用户自有的授权系统。每个交付任务都具备独立的状态跟踪和失败原因记录，当出现问题时，运营者修复后可按任务重试，系统将自动继续剩余流程，大大提高了交付的可靠性和效率。
-
认证与业务解耦： 飞鱼小铺采用微服务架构，将认证（Auth）、商城（Shop）和低代码最小实例拆分为三个独立的Spring Boot应用。它们共享一套JWT登录态和Vue 3前端，确保了系统的模块化和可扩展性。同时，系统支持多种登录方式，包括邮箱Magic Link、GitHub/Gitee/Gitea、Google、Microsoft，甚至微信公众号登录，极大地提升了用户登录的便捷性。
-
Docker Native 一键体验： 对于部署和体验，飞鱼小铺提供了极致的便利。它利用GraalVM Native技术编译后端服务，结合Docker Compose，用户只需一条命令即可构建并启动包括MySQL数据库、三个Native后端服务和Nginx前端在内的完整系统。这种“一键部署”模式非常适合本地开发体验和轻量级服务器的快速部署。
-
面向真实运营场景： 飞鱼小铺不仅仅是一个商品展示页面。它内置了功能完善的管理工作台，方便运营者进行商品与订单管理、仓库配置、交付记录查询、失败任务重试、合同管理和通知发送。此外，系统还对移动端进行了适配，确保在不同设备上都能提供良好的操作体验，满足日常运营的各种需求。
-
明确的开源边界： 飞鱼小铺公开了通用的交易和交付编排逻辑，允许用户自由使用和修改。对于商业授权签发等特定业务，系统提供了灵活的扩展接口，但不包含任何私有的签发算法、根密钥或生产配置，保障了核心业务的独立性和安全性。
三、操作指南
飞鱼小铺的部署流程相对便捷，主要通过Docker Compose实现一键部署。开发者可根据GitHub上的详细文档指引，配置数据库、后端服务和前端界面。完成部署后，即可通过管理后台进行商品上架、订单管理、用户管理等各项操作。对于需要进行GitHub/Gitea仓库权限开通或数字文件交付的集成，则需按照文档配置相应的API接口或自定义授权系统接口，以实现自动化履约。整个过程都旨在降低技术门槛，让更多的创作者能够轻松上手。
四、支持平台
飞鱼小铺作为一个基于Docker部署的后端系统，其运行环境具有高度的灵活性和跨平台性。它可以在任何支持Docker容器技术的操作系统上运行。
| 平台 | 是否支持 | 最低要求/版本 |
|---|---|---|
| Linux | 是 | 支持 Docker 的操作系统 |
| Windows | 是 | Docker Desktop |
| macOS | 是 | Docker Desktop |
| 服务器环境 | 是 | Docker Compose v2+ |
五、产品定价
飞鱼小铺是一款完全开源的系统，这意味着其核心代码是免费提供给所有用户使用的。您可以自由下载、部署、修改和定制，无需支付软件授权费用。主要的成本可能来源于您选择的服务器租赁、域名注册以及根据自身业务需求进行的定制开发或集成其他商业服务（如支付网关手续费）的费用。这种模式为独立开发者和小型团队提供了极大的成本控制能力和灵活性。
六、使用场景
飞鱼小铺的灵活设计使其适用于多种数字商品销售和交付场景：
- 独立开发者： 销售个人开发的软件、插件、主题、电子书、教程、API服务等数字产品。
- 内容创作者： 交付付费的数字资料、模板、设计素材、授权文件等。
- 小型团队/工作室： 提供技术服务、SaaS产品订阅、软件授权或代码仓库访问权限。
- 教育培训机构： 销售在线课程、学习资料的数字版本。
- 需要私有化部署： 对数据安全、系统稳定性有高要求，希望将所有交易数据和业务流程掌握在自己手中的商家。
- 追求自动化效率： 希望通过系统自动完成订单处理、产品交付，减少人工干预，提高运营效率的业务。
七、运作模式
飞鱼小铺的运作模式可以概括为一个高效的“下单-支付-自动交付-售后”闭环。当用户在您的数字商店浏览并选定商品后，通过集成的支付通道（Stripe/H5支付）完成付款。系统在接收到支付成功的通知后，会立即触发预设的自动化交付流程。这可能包括自动为用户创建或授权访问GitHub/Gitea等代码仓库，直接发送数字文件下载链接，或者通过扩展接口与您的自有授权系统进行交互，生成并发送授权密钥。整个交付过程都有详细的任务状态和日志记录，确保可追溯性。若交付过程中发生异常，系统会记录失败原因，并允许运营者在问题解决后进行任务重试，确保每一个订单都能得到妥善的履约。此外，通过内置的工单系统和WebSocket客服，用户可以随时获得支持，而运营者也能高效地管理订单和处理客户咨询。
结语
飞鱼小铺为独立开发者和小型团队提供了一个功能强大、部署便捷且高度可定制的数字商品交易与自动交付解决方案。它不仅简化了数字产品销售的复杂性，更通过自动化流程和完善的售后支持，让创作者能够专注于产品的研发和内容的创作，而无需为繁琐的运营事务分心。如果您正在寻找一个开源、私有化部署的数字商品销售平台，飞鱼小铺无疑是一个值得深入了解和尝试的优秀选择。
网址：https://github.com/flyfish-dev/shop
