LNMP一键安装包 - Readme

LNMP 2.4 测试版，尚未完成完整安装和真实升级恢复矩阵验收。
此候选版先维护现代源码组合：MySQL 8.4、PHP 8.2-8.5、Nginx、Apache 2.4。
src/checksums.sha256 中没有可信校验值的组件会停止下载；保留的旧版本、MariaDB、数据库二进制及可选模块需要先补齐经过确认的下载清单，不应以关闭校验绕过。
本轮 full 白名单包含 src/full-packages.txt 声明的 17 个归档，可信目录内另有 21 项按需下载，不包含发行版系统软件包，不代表所有菜单选项均可离线安装。
发行版依赖解析、隔离回归和部分组件烟雾测试不等于完整安装及生产升级认证。

2026-10-18 第二测试批次默认启用安装统计，交互和无人值守安装均不额外询问。
lnmp.conf 中 LNMP_Install_Stats=n 完全关闭；ask 仅在交互模式询问且默认拒绝。
上报仅含随机实例/安装批次标识、版本、系统、架构、组件、耗时和结果；不发送密码、域名、主机名或完整日志。
统计入口为 https://soft.lnmp.com/stats/api/v1/install；单次请求最长 2 秒，失败不影响安装结果。
2026-10-19 测试批次分别上报确认开始及结束结果；首个开始事件失败时最多补报一次，无 curl 时可尝试 wget。
开始和结束采用同一随机批次标识；断网、强制终止等未收到结束的样本不能推断成功或失败。
随机实例标识保存在 /var/lib/lnmp/instance-id，可在镜像克隆前删除以避免多个克隆共用标识；关闭统计时不会创建。
安装成功次数只表示已上报且通过安装器现有检查的样本，不代表全部安装量或完整运行认证。

LNMP一键安装包是什么?

LNMP一键安装包是一个用Linux Shell编写的可以为CentOS/RHEL/Fedora/Debian/Ubuntu/Raspbian/Deepin/Alibaba/Amazon/Mint/Oracle/Rocky/Alma/Kali/UOS/银河麒麟/openEuler/Anolis OS/OpenCloudOS/Huawei Cloud EulerOS Linux VPS或独立主机安装LNMP(Nginx/MySQL/PHP)、LNMPA(Nginx/MySQL/PHP/Apache)、LAMP(Apache/MySQL/PHP)生产环境的Shell程序。

LNMP一键安装包有哪些功能？

支持自定义Nginx、PHP编译参数及网站和数据库目录、支持生成Let's Ecrypt/ZeroSSL/BuyPass免费SSL证书、支持无人值守、LNMP模式支持多PHP版本、支持单独安装Nginx/MySQL/MariaDB/Pureftpd服务器，同时提供一些实用的辅助工具如：虚拟主机管理、FTP用户管理、Nginx、MySQL/MariaDB、PHP的升级、常见PHP模块exif、fileinfo、ldap、bz2、sodium、imap和swoole的一键安装、常用缓存组件Redis/Xcache等的安装、重置MySQL root密码、502自动重启、日志切割、SSH防护DenyHosts/Fail2Ban、备份等许多实用脚本。

LNMP官网：https://lnmp.org
作者: licess admin@lnmp.org
问题反馈&技术支持论坛：https://bbs.lnmp.com/forum-25-1.html
打赏捐赠：https://lnmp.org/donation.html

LNMP安装

安装前确认已经安装wget命令，如提示wget: command not found ，使用 yum install wget  或  apt-get install wget  命令安装。
为防止掉线等情况，建议使用screen，可以先执行：screen -S lnmp 命令后，再执行LNMP安装命令：

候选包通过独立测试环境验收后，再执行安装；不要在已有生产环境上运行 install.sh。
本地候选包示例：tar zxf lnmp2.4.tar.gz && cd lnmp2.4
随后选择 ./install.sh lnmp、./install.sh lnmpa 或 ./install.sh lamp。
正式镜像下载地址应以实际发布后验证的文件为准。

如断线可使用 screen -r lnmp  恢复。详细安装教程参考：https://lnmp.org/install.html

常用功能说明

以下操作需在lnmp安装包目录下执行，如lnmp2.4

LNMP 2.4 当前候选固定 Nginx 1.30.6、PCRE2 10.49、OpenSSL 3.5.9、MySQL 8.4.11、Apache 2.4.69、PHP 8.2.34/8.3.35/8.4.26/8.5.11；默认 PHP 仍为 8.3，MySQL 8.4 默认源码安装。
公开 phpinfo、探针和 Opcache 诊断页默认关闭；仅在受限测试环境中显式设置 Enable_Public_Diagnostics=y 后生成。
Composer 使用固定版本 2.10.3（旧 PHP 兼容分支 2.2.30）和官方 SHA256，不再直接执行在线安装器；已有 Composer 不覆盖。
新安装保留现有系统软件、SELinux 与防火墙，不再自动删除 AMP 软件包或关闭 SELinux；发现冲突先停止。SELinux enforcing 需单独验证策略。
Enable_Firewall_Management 默认 n；管理员应手动放行 HTTP/HTTPS。新建数据库、Redis 和 Memcached 默认仅监听回环地址，远程访问需独立配置和授权。
默认 TLS 证书及 SHA256 校验均启用，缺少条目或校验不一致都会失败；镜像下载失败可回退到 src/fallback-sources.tsv 中登记的 HTTPS 地址，并使用同一固定校验值。
PHP 8.4/8.5 的 IMAP 改用 PECL imap 1.0.3；需要发行版提供 libc-client 和 Kerberos 开发依赖。

自定义参数
lnmp.conf配置文件，可以修改lnmp.conf自定义下载服务器地址、网站/数据库目录及添加nginx模块和php编译参数；不论安装升级都会调用该文件里的设置(如果修改了默认的参数建议备份此文件)；
详细参数说明可以 https://lnmp.org/faq/lnmp-software-list.html#lnmp.conf 查看；

FTP服务器
执行： ./pureftpd.sh  安装，可使用  lnmp ftp {add|list|del}  进行管理。

升级脚本：
执行： ./upgrade.sh  按提示进行选择
也可以直接带参数：./upgrade.sh {nginx|mysql|mariadb|php|phpa|mphp|m2m|phpmyadmin}
* 参数: nginx   只接受已加入可信校验清单的目标版本，编译和配置验证后切换，切换失败尝试恢复旧二进制。
* 参数: mysql   自动升级仅允许 MySQL 8.0 或 8.4 同系列的更新补丁版，不允许跨系列或降级；备份包含存储过程、事件和触发器，备份期间会冻结写入。必须先独立备份并验证恢复，预留维护窗口和旧安装、数据、副本及 SQL 所需磁盘空间。
* 参数: mariadb 同系列补丁升级实现正在验收，当前自动入口保持关闭；不要直接用于生产升级。
* 参数: m2m     自动跨数据库迁移已关闭，必须使用独立备份及经过验证的迁移方案。
* 参数: php     LNMP 的主 PHP 升级先校验下载和目标，再备份旧安装；配置、扩展或服务检查失败尝试恢复旧目录。
* 参数: phpa    LNMPA/LAMP 的主 PHP 升级同时保留 Apache PHP 模块和配置；切换后检查 Apache 配置和服务。
* 参数: mphp    现代多 PHP 同系列补丁升级正在验收，当前自动入口保持关闭；旧 PHP 和跨分支迁移不支持自动升级。
* 参数: phpmyadmin    可升级phpMyadmin。

扩展插件
执行:  ./addons.sh {install|uninstall} {eaccelerator|xcache|memcached|opcache|redis|apcu|imagemagick|ioncube|exif|fileinfo|ldap|bz2|sodium|imap|swoole}
以下为扩展插件安装使用说明
缓存加速：
* 参数: xcache 安装时需选择版本和设置密码，http://yourIP/xcache/ 进行管理，用户名 admin，密码为安装xcache时设置的。
* 参数: redis  安装redis
* 参数: memcached 可选择php-memcache或php-memcached扩展。
* 参数: opcache 可访问 http://yourIP/ocp.php 进行管理。
* 参数: eaccelerator 安装。
* 参数: apcu 安装apcu php扩展，支持php7，可访问 http://yourIP/apc.php 进行管理。 
**请勿安装多个缓存类扩展模块，多个可能导致网站出现问题 ！**
PHP组件/模块：
* 参数：exif   图片exif信息读取模块。
* 参数：fileinfo   文件MIME类型编码读取模块，安装要求至少有1GB以上内存，否则可能会安装失败。
* 参数：ldap    LDAP扩展。
* 参数：bz2     bz2压缩扩展模块。
* 参数：imap    imap模块。
* 参数：swoole  PHP协程框架模块，第三方模块不支持通过lnmp.conf开启安装。

图像处理：
imageMagick安装卸载执行： ./addons.sh {install|uninstall} imageMagick imageMagick路径：/usr/local/imagemagick/bin/ 。

解密：
IonCube安装/卸载执行： ./addons.sh {install|uninstall} ionCube 。
Sodium加密库扩展模块安装/卸载执行：./addons.sh {install|uninstall} sodium  ，一般微信支付之类的需要使用，PHP 7.2以下版本不支持通过lnmp.conf开启安装。

其他常用脚本：
* 可选1，多PHP版本安装执行： ./install.sh mphp  可以安装多个PHP版本 ，只支持LNMP模式，lnmp vhost add时进行选择或使用时需要将nginx虚拟主机配置文件里的include enable-php.conf替换为 include enable-php8.4.conf 即可前面的8.4换成你刚才安装的PHP的大版本号5.*、7.*或8.*之类的。
* 可选2，数据库安装执行： ./install.sh db  可以直接单独安装MySQL或MariaDB数据库。
* 可选3，Nginx安装执行： ./install.sh nginx 可以直接单独安装Nginx。
以下工具在lnmp安装包tools目录下，可拷贝到其他目录下运行
* 可选4，执行： ./reset_mysql_root_password.sh  可重置MySQL/MariaDB的root密码。
* 可选5，执行： ./check502.sh   可检测php-fpm是否挂掉,502报错时重启，配合crontab使用。
* 可选6，执行： ./cut_nginx_logs.sh  日志切割脚本。
* 可选7，执行： ./remove_disable_function.sh  运行此脚本可删掉禁用函数。

无人值守安装
请访问 https://lnmp.org/faq/v1-5-auto-install.html 查看无人值守安装教程

卸载

卸载LNMP、LNMPA或LAMP可执行： ./uninstall.sh  按提示选择即可卸载。

状态管理
* LNMP/LNMPA/LMAP状态管理： lnmp {start|stop|reload|restart|kill|status} 
* Nginx状态管理： lnmp nginx或/etc/init.d/nginx {start|stop|reload|restart} 
* MySQL状态管理： lnmp mysql或/etc/init.d/mysql {start|stop|restart|reload|force-reload|status} 
* MariaDB状态管理： lnmp mariadb或/etc/init.d/mariadb {start|stop|restart|reload|force-reload|status} 
* PHP-FPM状态管理： lnmp php-fpm或/etc/init.d/php-fpm {start|stop|quit|restart|reload|logrotate} 
* PureFTPd状态管理： lnmp pureftpd或/etc/init.d/pureftpd {start|stop|restart|kill|status} 
* Apache状态管理： lnmp httpd或/etc/init.d/httpd {start|stop|restart|graceful|graceful-stop|configtest|status} 

虚拟主机管理
* 添加： lnmp vhost add 
* 删除： lnmp vhost del 
* 列出： lnmp vhost list 
* 数据库管理： lnmp database {add|list|edit|del} 
* FTP用户管理： lnmp ftp {add|list|edit|del|show} 
* SSL添加： lnmp ssl add
* 通配符/泛域名SSL添加：lnmp dnsssl {ali|cf|dp|he|gd|aws|namecheap|namesilo}` 需依赖域名dns api

相关图形界面
* PHPMyAdmin：http://yourIP/phpmyadmin/
* phpinfo / PHP探针：默认不生成，仅供受限测试环境显式开启。
* Xcache管理界面：http://yourIP/xcache/
* Zend Opcache诊断页面：默认不生成。
* APCu：只安装扩展，不公开部署管理页面。

LNMP相关目录文件

#目录位置
* Nginx：/usr/local/nginx/
* MySQL：/usr/local/mysql/
* MariaDB：/usr/local/mariadb/
* PHP：/usr/local/php/
* 多PHP目录：/usr/local/php5.6/ 版本号随安装版本不同而不同
* PHP扩展插件配置文件目录：/usr/local/php/conf.d/
* PHPMyAdmin：/home/wwwroot/default/phpmyadmin/
* 默认虚拟主机网站目录：/home/wwwroot/default/
* Nginx日志目录：/home/wwwlogs/

#配置文件：
* Nginx主配置文件：/usr/local/nginx/conf/nginx.conf
* MySQL/MariaDB配置文件：/etc/my.cnf
* PHP配置文件：/usr/local/php/etc/php.ini
* PHP-FPM配置文件：/usr/local/php/etc/php-fpm.conf
* PureFtpd配置文件：/usr/local/pureftpd/etc/pure-ftpd.conf
* Apache配置文件：/usr/local/apache/conf/httpd.conf

技术支持

技术支持论坛：https://bbs.lnmp.com/forum-25-1.html
