How to Deploy GenHuman: One-Click Setup for Uni‑App + Webman Digital Human Platform

Overview

GenHuman is a digital‑human solution that uses uni‑app for the front‑end and Webman for the back‑end. It can be deployed as a web site, native app, WeChat mini‑program, and includes a backend management console.

Platform Compatibility

The front‑end runs on Vue 2, Vue 3, Chrome, Safari, app‑vue, app‑nvue, Android, iOS and HarmonyOS. The same codebase also supports major mini‑program platforms: WeChat, Alipay, Douyin, Baidu, Kuaishou, JD, HarmonyOS services, QQ, Feishu and Huawei/Alliance quick apps.

Quick Start

Verify the server meets Workerman requirements: curl -Ss https://www.workerman.net/check | php If each line outputs ok, the environment is ready.

Deployment with BT (BaoTa) Panel

Create a new site.

Set the appropriate directory permissions.

Configure a static proxy.

Add the following nginx configuration to forward requests to Webman and block unwanted files:

# Forward requests to Webman
location ^~ / {
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    if (!-f $request_filename) {
        proxy_pass http://127.0.0.1:8787;
    }
}
# Deny access to .php files
location ~ \ .php$ {
    return 404;
}
# Allow .well-known directory
location ~ ^/\.well-known/ {
    allow all;
}
# Deny hidden files and directories
location ~ /\. {
    return 404;
}

Import the provided database dump.

Edit the database configuration file to match your MySQL credentials.

Add a daemon process for Webman (e.g., using php start.php start or configuring a systemd service).

Access the admin console at https://YourDomain/admin with the default credentials admin / 123456.