webman/admin安装需先确认php≥8.1、启用proc_open等函数及fileinfo等扩展，再按webman版本执行对应composer命令，启动后访问http://127.0.0.1:8787/app/admin完成数据库配置与管理员设置，并在生产环境配置nginx反向代理及cookie路径。
如果您已部署 Webman 框架但缺少可视化运维入口，则需安装官方推荐的监控与管理面板 webman/admin。该插件提供数据库配置、任务调度、日志查看、插件管理等核心运维能力。以下是安装与使用步骤：
一、确认基础环境与依赖
webman/admin 要求 Webman 主框架版本 ≥1.4（推荐 ≥2.0），且 PHP 环境需启用关键函数并安装必要扩展。缺失任一条件将导致安装失败或后台无法加载。
1、检查 PHP 版本：执行 php -v，确保为 PHP 8.1 或更高版本。
2、检查禁用函数：执行 php -i | grep disable_functions，确认 proc_open、putenv、pcntl_fork、shell_exec 未被禁用。
3、启用扩展：确保已安装 fileinfo、gd、zip、pdo_mysql 扩展；如使用 Redis 缓存或队列，还需启用 redis 扩展。
二、执行 Composer 安装命令
webman/admin 以 Composer 插件形式集成，必须在 Webman 项目根目录下运行安装指令，否则无法识别上下文环境。
1、进入 Webman 项目根目录：cd /path/to/your/webman。
2、根据 Webman 版本选择对应命令：
若 Webman 为 1.x 版本，运行 composer require -W webman/admin ~1.0；
若 Webman 为 2.x 版本，运行 composer require -W webman/admin ~2.0。
3、等待依赖自动解析并安装完成，控制台输出包含 webman/admin (vX.X.X) 即表示成功。
三、启动服务并访问安装向导
安装完成后需重启 Webman 进程以加载新插件，否则 /app/admin 路径将返回 404。
1、停止当前进程（如正在运行）：php start.php stop。
2、启动服务：php start.php start -d（Linux/macOS 生产模式）或 php start.php start（Windows 调试模式）。
3、浏览器访问：http://127.0.0.1:8787/app/admin/（若修改过端口，请替换为实际监听端口）。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
四、完成数据库初始化与管理员设置
首次访问会触发向导式安装流程，需连接数据库并创建基础表结构，该过程不可跳过。
1、填写数据库配置：主机地址、端口、数据库名、用户名、密码，测试连接按钮显示 连接成功 后继续。
2、点击“下一步”，系统自动执行 migrations 创建 admin_users、admin_permissions、admin_logs 等 6 张核心表。
3、设置超级管理员账号：输入用户名、密码、邮箱，密码需满足 至少 8 位，含大小写字母与数字。
五、配置 Nginx 反向代理（生产环境必需）
直接暴露 :8787 端口存在安全风险且不支持 HTTPS，生产环境必须通过 Nginx 做反向代理并隐藏真实端口。
1、在 Nginx 配置中添加 location 块：location ^~ /app/admin/ { proxy_pass http://127.0.0.1:8787/app/admin/; }。
2、关键头信息不可遗漏：proxy_set_header X-Forwarded-For $remote_addr; 与 proxy_set_header Host $http_host; 必须存在。
3、重载配置：nginx -s reload，随后可通过 https://your-domain.com/app/admin/ 访问。
六、启用验证码与会话安全加固
默认安装后可能出现验证码不生效或登录失败，多因 Cookie 路径或 SameSite 策略配置错误引起。
1、编辑 plugin/admin/config/captcha.php，将 'use_session' => true 设为启用。
2、若使用 Nginx 反向代理，需在 proxy_pass 区块中添加：proxy_cookie_path /app/admin/ /;。
3、重启 Webman 进程与 Nginx：php start.php restart -d && nginx -s reload。
