How to Deploy the Zaihangyun BaaS Platform for Independent Developers

Overview

Zaihangyun is a lightweight Backend‑as‑a‑Service (BaaS) platform for independent developers. It provides ready‑made modules—user management, payment, document handling, data collection, and version control—through a unified admin interface, eliminating the need to write backend code.

Core Modules

User module : registration, login, and user management.

Sales module : payment, refund, membership purchase, feature activation, and order management.

Document module : help docs, agreements, and custom documents.

Data collection module : feedback, FAQs, and system notifications.

Version management module : app version control and update strategies.

Technical Architecture

The project consists of two components:

admin : management backend built with laravel-admin.

api : API service built with Webman framework.

Both admin and api share a single Redis instance to ensure API performance while keeping admin configurations instantly effective.

API documentation:

https://www.zaihangyun.com/docs

Installation & Deployment

Environment Requirements

PHP >= 8.0

MySQL >= 5.7

Redis >= 5.0

Composer

Admin Backend Setup

Clone the repository and enter the admin directory:

git clone https://gitee.com/herenet/zaihangyun-CE.git
cd zaihangyun-CE/admin

Install PHP dependencies: composer install Copy the example environment file and generate an application key:

cp .env.example .env
php artisan key:generate

Import the database schema (adjust paths as needed):

mysql -u USERNAME -p DATABASE_NAME < /zaihangyun-admin/zaihangyun-admin.sql

Start the admin service: php artisan serve Access it at http://localhost:8000 (default credentials: admin/admin).

API Service Setup

Enter the API directory: cd zaihangyun-CE/api Install dependencies: composer install Copy the example environment file: cp .env.example .env Create required symbolic links for certificates and public assets:

# Link certificates from admin storage
cd api/storage/app
ln -s ../../admin/storage/app/public/mch ./
# Link public assets
cd ../../public
ln -s ../storage ./

Start the API service: php start.php start Access it at http://localhost:8787.

Nginx Configuration (optional)

Example snippets for serving the admin site over HTTPS and proxying API requests to the Webman server are provided in the source repository.

Usage

User Management : manage registrations, logins, and permissions via the admin UI.

Payment Management : integrated Alipay, WeChat Pay, Apple IAP, order handling, and refunds.

Document Management : maintain help docs, agreements, and custom documentation.

Data Collection : collect user feedback, FAQs, and system notifications.

Version Management : control app version releases and update policies.

Source Code

Repository mirrors:

Gitee (China): https://gitee.com/herenet/zaihangyun-CE GitHub (global):

https://github.com/herenet/zaihangyun-CE