Webman在Linux生产环境稳定运行需绕过五大断点：PHP扩展（pcntl/posix/event）必须真启用且未被disable_functions屏蔽；8787端口须空闲并放行防火墙；runtime等目录权限须与systemd用户（如www-data或nginx）严格一致；Nginx反代需透传Connection/Upgrade头并禁用敏感路径；systemd服务必须配置User、Group、WorkingDirectory及Restart策略，且所有环节用户身份统一。
Webman 在 Linux 生产环境能稳定跑起来，前提是绕过五个典型断点：PHP 扩展缺失、端口被占、权限错配、Nginx 反代配置漏项、systemd 服务没落进用户上下文。其他都是锦上添花。
检查 pcntl、posix、event 是否真启用
Webman 启动失败却没报错？十有八九是扩展“看似加载实则被禁”。php -m 显示在列表里不等于能用，还要看 disable_functions 和 php.ini 加载顺序。
- 执行
php --ri pcntl，若输出含Directive => Local Value行，说明扩展已激活；若只显示模块名但无详情，大概率被disable_functions屏蔽 - 检查
php.ini中disable_functions是否包含pcntl_fork、pcntl_waitpid、posix_kill—— Webman 的进程管理全靠这几个函数 -
event扩展不是可选，而是高并发下的性能分水岭；Ubuntu/Debian 需额外装php-event包，CentOS/RHEL 要用pecl install event编译，且必须确认libevent系统库已存在
Nginx 反向代理必须显式透传 Connection 和 Upgrade 头
默认 proxy_pass 配置下 WebSocket 或长连接会静默降级为 HTTP/1.1 短连接，导致心跳断开、推送失效。这不是 Webman 的 bug，是 Nginx 默认行为。
- 在
location /块中必须添加：proxy_http_version 1.1; proxy_set_header Connection "upgrade"; proxy_set_header Upgrade $http_upgrade;
-
proxy_pass http://127.0.0.1:8787后不能加斜杠（即不要写成.../8787/），否则路由前缀会被截断，config/route.php里定义的/api/v1会变成//api/v1 - 务必屏蔽
/runtime、/config、/vendor路径，加一条location ~ ^/(runtime|config|vendor) { return 403; }
用 systemd 管理服务时，User 和 Group 必须与 runtime/ 目录归属一致
很多人把服务跑起来了，但第二天发现日志不写了、session 消失了、缓存失效——根本原因是 systemd 启动的进程用户和 runtime 目录所有者不匹配，Linux 权限机制直接拒绝写入。
立即学习“PHP免费学习笔记（深入）”；
- Ubuntu/Debian 下设
User=www-data，同时运行sudo chown -R www-data:www-data runtime/ - CentOS/RHEL 下设
User=nginx，对应执行sudo chown -R nginx:nginx runtime/ -
WorkingDirectory必须设为项目根目录（如/var/www/webman），否则start.php读不到config/app.php - 别漏掉
Restart=always和RestartSec=3，Webman 进程意外退出后才能自动拉起
composer install --no-dev --optimize-autoloader 必须在目标服务器执行
本地 vendor 目录直接打包上传到服务器？危险。不同系统架构（x86_64 vs ARM64）、PHP 版本、扩展 ABI 兼容性都会导致 opcache 编译失败或 ext-redis 扩展调用崩溃。
- 上传代码时排除
vendor/、.env、node_modules/，只传源码和composer.lock - 在服务器上执行
php -d memory_limit=-1 composer install --no-dev --optimize-autoloader，-d memory_limit=-1防止 Composer 因内存不足中断 -
--optimize-autoloader生成vendor/autoload_classmap.php，类加载速度提升 30%+，生产环境不加等于裸奔 - 完成后立即删掉
composer.lock文件（可选但推荐），避免后续误执行composer update
真正卡住人的从来不是「怎么配」，而是「配完谁在跑」——systemd 里写的 User、Nginx 配置里写的 user、chown 命令里写的用户、PHP-FPM pool 里写的 user，这四个必须指向同一个账号，少一个对不上，Permission denied 就在日志里安静躺着等你翻三遍。
