Fenfa

Fenfa (分发, "distribute" in Chinese) is a self-hosted app distribution platform for iOS, Android, macOS, Windows, and Linux. Upload builds, get install pages with QR codes, and manage releases through a clean admin panel -- all from a single Go binary with embedded frontend and SQLite storage.

Fenfa is designed for development teams, QA engineers, and enterprise IT departments who need a private, controllable app distribution channel -- one that handles iOS OTA installation, Android APK distribution, and desktop app delivery without depending on public app stores or third-party services.

Why Fenfa?

Public app stores impose review delays, content restrictions, and privacy concerns. Third-party distribution services charge per-download fees and control your data. Fenfa gives you full control:

• Self-hosted. Your builds, your server, your data. No vendor lock-in, no per-download fees.
• Multi-platform. A single product page serves iOS, Android, macOS, Windows, and Linux builds with automatic platform detection.
• Zero dependencies. A single Go binary with embedded SQLite. No Redis, no PostgreSQL, no message queue.
• iOS OTA distribution. Full support for itms-services:// manifest generation, UDID device binding, and Apple Developer API integration for ad-hoc provisioning.

Key Features

• Smart Upload -- Auto-detect app metadata (bundle ID, version, icon) from IPA and APK packages. Just upload the file and Fenfa handles the rest.

• Product Pages -- Public download pages with QR codes, platform detection, and per-release changelogs. Share a single URL for all platforms.

• iOS UDID Binding -- Device registration flow for ad-hoc distribution. Users bind their device UDID through a guided mobile config profile, and admins can auto-register devices via Apple Developer API.

• S3/R2 Storage -- Optional S3-compatible object storage (Cloudflare R2, AWS S3, MinIO) for scalable file hosting. Local storage works out of the box.

• Admin Panel -- Full-featured Vue 3 admin panel to manage products, variants, releases, devices, and system settings. Supports Chinese and English UI.

• Token Authentication -- Separate upload and admin token scopes. CI/CD pipelines use upload tokens; administrators use admin tokens for full control.

• Event Tracking -- Track page visits, download clicks, and file downloads per release. Export events as CSV for analytics.

Architecture

graph TB
    CLIENT["Browser / CI Pipeline"]

    subgraph Server["Fenfa Server (Go + Gin)"]
        ROUTER["Gin Router"]
        AUTH["Auth Middleware<br/>X-Auth-Token"]
        HANDLERS["Handlers<br/>Upload · Download · Admin · UDID"]
        EMBED["Embedded Frontend<br/>Public Page (Vue 3) · Admin Panel (Vue 3)"]
        GORM["GORM ORM"]
    end

    subgraph Storage["Storage Layer"]
        SQLITE["SQLite Database"]
        FILES["File Storage<br/>Local or S3/R2"]
    end

    CLIENT --> ROUTER
    ROUTER --> AUTH
    AUTH --> HANDLERS
    ROUTER --> EMBED
    HANDLERS --> GORM
    GORM --> SQLITE
    HANDLERS --> FILES

Data Model

graph LR
    PRODUCT["Product<br/>(e.g. MyApp)"]
    VARIANT_IOS["Variant: iOS<br/>com.example.myapp"]
    VARIANT_ANDROID["Variant: Android<br/>com.example.myapp"]
    VARIANT_MAC["Variant: macOS<br/>arm64 · dmg"]
    REL1["Release v1.0.0<br/>build 100"]
    REL2["Release v1.1.0<br/>build 110"]
    REL3["Release v1.0.0<br/>build 100"]

    PRODUCT --> VARIANT_IOS
    PRODUCT --> VARIANT_ANDROID
    PRODUCT --> VARIANT_MAC
    VARIANT_IOS --> REL1
    VARIANT_IOS --> REL2
    VARIANT_ANDROID --> REL3

• Product: A logical app with name, slug, icon, and description. A single product page serves all platforms.
• Variant: A platform-specific build target (iOS, Android, macOS, Windows, Linux) with its own identifier, architecture, and installer type.
• Release: A specific uploaded build with version, build number, changelog, and binary file.

Quick Install

docker run -d --name fenfa -p 8000:8000 fenfa/fenfa:latest

Visit http://localhost:8000/admin and log in with token dev-admin-token.

See the Installation Guide for Docker Compose, source builds, and production configuration.

Documentation Sections

Section	Description
Installation	Install Fenfa with Docker or build from source
Quick Start	Get Fenfa running and upload your first build in 5 minutes
Product Management	Create and manage multi-platform products
Platform Variants	Configure iOS, Android, and desktop variants
Release Management	Upload, version, and manage releases
Distribution Overview	How Fenfa distributes apps to end users
iOS Distribution	iOS OTA install, manifest generation, UDID binding
Android Distribution	Android APK distribution
Desktop Distribution	macOS, Windows, and Linux distribution
API Overview	REST API reference
Upload API	Upload builds via API or CI/CD
Admin API	Full admin API reference
Configuration	All configuration options
Docker Deployment	Docker and Docker Compose deployment
Production Deployment	Reverse proxy, TLS, backups, and monitoring
Troubleshooting	Common issues and solutions

Project Info

• License: MIT
• Language: Go 1.25+ (backend), Vue 3 + Vite (frontend)
• Database: SQLite (via GORM)
• Repository: github.com/openprx/fenfa
• Organization: OpenPRX