LNMP环境搭建教程：Ubuntu 22.04+Nginx+PHP8.1+MariaDB部署Discuz论坛

开头直接说事吧。LNMP这四个字母差不多是国内站长接触服务器时最早认识的缩写。Nginx处理静态资源和并发连接PHP-FPM负责解析动态脚本MySQL这类关系型数据库把用户、帖子、版块数据稳稳存住三个组件配合起来再装一个论坛程序就能跑起一个具备注册、发帖、回帖、私信、版块管理的完整社区。这篇文章不聊虚的直接以 Ubuntu 22.04 Nginx 1.22 PHP 8.1 MariaDB 10.11 Discuz! X 3.5 为组合从一台空机器开始一直跑到论坛能正常发帖。每一步我都会说清楚为什么这么选、配置项背后是什么意思、出问题该看哪里。想从零搭一套论坛的站长或者刚接触Linux服务器想练手的朋友照着走一遍就能落地。1. 环境规划与版本选型1.1 为什么选LNMP而不是LAMP很多人会问同样是建论坛LNMP和LAMP到底差在哪。最核心的差别是Web服务器LNMP用Nginx处理静态文件和转发动态请求LAMP用Apache。论坛这种场景大多数请求都是看帖子、看列表也就是读多写少Nginx在这种场景下的并发处理能力比Apache更轻量内存占用也低得多。配合PHP-FPM运行PHP脚本整个链路更干净。Apache的特点是配置灵活、模块多、对伪静态规则兼容性好但代价是每个请求都会吃更多内存。你在一台1核2G的云服务器上跑LNMP能比LAMP多扛不少并发访问。LCNMP这种全家桶方案虽然省事但新手往往不清楚底层怎么工作出问题很难排查。所以这里我坚持手动搭建LNMP这样你对每个组件都有掌控感后面加功能、调性能也知道动哪里。1.2 操作系统与软件版本怎么挑操作系统我推荐Ubuntu 22.04 LTS理由很简单软件源更新及时、社区资料多、遇到问题容易搜到解决方案。CentOS停更之后Rocky Linux或AlmaLinux也是备选项但就上手门槛和资料丰富程度来说Ubuntu对新手更友好。软件版本方面建议别盲目追新。Nginx用官网stable版本或系统源里的1.22系列都行Nginx本身很稳定大版本变化基本不影响论坛部署。PHP用8.1或8.2是主流选择Discuz! X 3.5已经能完美支持PHP 8老版本PHP 5.6那种性能和安全问题不用趟。数据库方面MariaDB 10.11是兼容MySQL协议的最佳选择它是MySQL分支API完全兼容社区版里性能调校还更激进很多云数据库产品底层都用它。如果硬要装MySQL官方的8.0也没问题但MariaDB在轻量服务器上表现更均衡。1.3 服务器配置参考与前置准备论坛程序本身对配置要求不高1核1G内存起步就能跑但建议至少2核2G尤其是准备做大量图片附件、或者有实时在线聊天功能的话。硬盘能上SSD就SSD数据库随机读写非常吃IO机械盘在帖子量大了以后会明显卡顿。部署前要准备几件事一个已解析到服务器的域名云服务器安全组或防火墙放行80和443端口还有就是规划好数据库账号密码。这里多说一句不要把数据库密码设置成和服务器SSH密码一样也不要直接拿root账户给论坛连数据库。后面我会单独讲怎么建一个权限刚好够用的数据库账号。2. Nginx安装与站点配置2.1 安装Nginx并确认运行Ubuntu下安装很直接sudo apt update sudo apt install nginx -y sudo systemctl enable nginx sudo systemctl start nginx启动后用curl -I http://localhost如果返回200和Server: nginx字样说明服务已经在跑了。默认站点先不用管后面我会新建一个独立配置文件。这里建议顺手把防火墙配好sudo ufw allow 22/tcp sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw enable22端口是SSH千万别漏放否则重开防火墙后可能把自己锁在外面。80放给HTTP访问等后面配了HTTPS再加443规则。2.2 新建站点server块Nginx的配置文件在 /etc/nginx/ 目录其中 sites-available 存放站点配置sites-enabled 存放软链接。我的习惯是在 sites-available 下新建一个域名命名的文件比如 forum.conf内容这样写server { listen 80; server_name www.example.com example.com; root /var/www/forum; index index.php index.html; access_log /var/log/nginx/forum_access.log; error_log /var/log/nginx/forum_error.log; client_max_body_size 20m; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/run/php/php8.1-fpm.sock; } }server_name 换成你自己的域名root 指向论坛程序所在目录。client_max_body_size 这个参数容易被忽略论坛传附件超过默认1M就会报413错误我习惯先设到20M后面根据实际需求再调。配置写完后运行sudo ln -s /etc/nginx/sites-available/forum.conf /etc/nginx/sites-enabled/forum.conf然后sudo nginx -t检查语法确认没问题再sudo systemctl reload nginx。注意 sites-enabled 里的默认站点如果也在监听80端口最好删掉软链接否则server_name匹配时容易出诡异问题。2.3 伪静态规则的作用论坛不是静态页面它的URL本质上是 index.php?modforumdisplayfid2 这种带参数的动态地址。伪静态就是通过Nginx的rewrite规则把这种地址转换成 /forum-2-1.html 这样更短、更容易被搜索引擎收录的格式。Discuz! X 3.5 官方包里带了一个 nginx 伪静态规则文件位置一般在 Discuz_X3.5_SC_UTF8.zip 解压后的 utility/ 目录里文件名类似 nginx_rewrite.conf。把它里的 rewrite 规则复制到上面那个 location / 块里或者通过 include 引用进来。这里我摘一段典型规则location / { try_files $uri $uri/ /index.php?$query_string; rewrite ^/forum-(\w)-(\d)\.html$ /forum.php?modforumdisplayfid$1page$2 last; rewrite ^/thread-(\w)-(\d)-(\d)\.html$ /forum.php?modviewthreadtid$1extrapage%3D$3page$2 last; }配置伪静态时要注意规则顺序必须放在 try_files 之后否则优先级会出现冲突。伪静态在论坛后台开启后再刷新页面看链接地址从问号参数变成路径格式就说明生效了。3. PHP环境搭建与调优3.1 安装PHP-FPM和扩展PHP在LNMP里不是独立服务而是通过PHP-FPM进程池接收Nginx转发过来的脚本请求。安装命令sudo apt install php8.1-fpm php8.1-mysql php8.1-gd php8.1-xml php8.1-mbstring php8.1-curl php8.1-zip php8.1-redis -y这几个扩展是运行Discuz! X 3.5的基础。php8.1-mysql 是数据库驱动php8.1-gd 处理验证码和图片缩略图php8.1-mbstring 保证中文编码不乱php8.1-curl 用于远程请求和UCenter通信。如果以后要装Redis缓存php8.1-redis 也提前装好。装完执行sudo systemctl enable php8.1-fpm sudo systemctl start php8.1-fpm检查进程是否跑起来ps -ef | grep php-fpm。正常情况下会看到master进程和若干个worker进程。3.2 理解PHP-FPM的进程池与并发PHP-FPM的进程池配置在 /etc/php/8.1/fpm/pool.d/www.conf里面的参数直接决定论坛在高并发下是快还是崩。我用最常见的两种模式解释。pm dynamic 是动态模式PHP-FPM启动时只开辟少量子进程请求多了再增加最省内存适合面向普通访问量不大的论坛。pm.max_children 是空置进程数上限pm.start_servers 是启动时的进程数pm.min_spare_servers 和 pm.max_spare_servers 控制空闲进程范围。pm static 是静态模式固定开 max_children 个进程不随流量变化。这种方式消耗内存稳定响应快但进程数必须根据服务器内存精确计算。假设2G内存每个PHP-FPM进程大约占用40-60M内存设置 max_children20 左右比较安全。我一般给小型论坛用 dynamicmax_children 设20-30start_servers 设5min_spare_servers 设5max_spare_servers 设15。如果你只有1G内存max_children 建议降到10-15优先保障系统整体稳定。这段配置没有绝对标准要结合实际内存和插件数量调。3.3 php.ini参数调整php-fpm的配置在 /etc/php/8.1/fpm/php.ini有几个参数对论坛特别重要memory_limit 256M upload_max_filesize 20M post_max_size 25M date.timezone Asia/Shanghai max_execution_time 60memory_limit 是单个PHP脚本能占用的最大内存论坛后台安装插件、生成缩略图、处理大数据量查询时都会涨内存默认128M往往不够。upload_max_filesize 和 post_max_size 同时要改因为POST请求体可能包含文件和其他表单数据post_max_size 一定要略大于 upload_max_filesize。date.timezone 不设的话论坛时间会跟服务器时区不一致发帖时间差8个小时就是这个原因。改完记得重启sudo systemctl restart php8.1-fpm。有时候改了 php.ini 没生效大概率是改错了路径用php -i | grep loaded查看实际加载的配置文件路径。4. 数据库安装与初始化准备4.1 安装MariaDB并安全初始化数据库我选MariaDB理由前面说过协议兼容、性能好、资源占用可控。安装sudo apt install mariadb-server -y sudo mysql_secure_installationmysql_secure_installation 交互脚本会引导你设置root密码、删除匿名用户、禁止root远程登录、删除测试数据库。这里每一步都选是尤其是禁止root远程登录论坛应用不需要直接远程连数据库开着反而多一个暴露面。设置完root密码后测试登录mysql -uroot -p输入密码能进到 MariaDB monitor 就说明正常。注意用 sudo mysql 可能直接免密登录这是因为默认使用了unix_socket认证插件后面创建论坛专用账号时要选择 mysql_native_password 或默认认证避免权限混乱。4.2 创建论坛数据库和专用账号论坛程序不要直接使用root连数据库这是新手最常见的坑。正确做法是在MariaDB里建一个独立的数据库和一个权限刚好的账号CREATE DATABASE forumdb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER forumuserlocalhost IDENTIFIED BY 这里填强密码; GRANT ALL PRIVILEGES ON forumdb.* TO forumuserlocalhost; FLUSH PRIVILEGES;数据库字符集一定要用 utf8mb4这是编码的最佳实践。很多老教程还在用 utf8结果发emoji表情或者生僻字时直接变成问号就是因为utf8只支持三字节编码utf8mb4才能完整覆盖四字节字符。授权只给 forumdb 一个库账号只能在本地连接这样即使配置或者密码泄露影响面也会被控制在最小。4.3 数据库基本优化参数MariaDB默认配置放在 /etc/mysql/mariadb.conf.d/50-server.cnf对小型论坛来说调几个关键参数就够了[mysqld] innodb_buffer_pool_size 256M character-set-server utf8mb4 collation-server utf8mb4_unicode_ci skip-name-resolveinnodb_buffer_pool_size 是最重要的内存参数它控制InnoDB把多少数据缓存在内存里。2G内存的服务器设256M比较合适太小则频繁磁盘IO太大则可能和PHP-FPM抢内存导致系统OOM。skip-name-resolve 可以跳过域名反查减少连接建立的时间但要注意账号必须写成 localhost 或 IP 的形式不能再写域名。改完重启MariaDBsudo systemctl restart mariadb。检查配置是否生效SHOW VARIABLES LIKE character_set_server; SHOW VARIABLES LIKE innodb_buffer_pool_size;5. 论坛程序部署与安装5.1 下载并解压Discuz! X 3.5以Discuz! X 3.5中文版为例从官方渠道下载zip包后上传到服务器。我习惯直接传到网站根目录对应的路径然后解压cd /var/www/forum sudo unzip Discuz_X3.5_SC_UTF8.zip解压后会出现 upload 目录目录里面的内容才是论坛程序文件需要把 upload 目录下的所有文件移动到 /var/www/forum 的根目录或你配置的root目录。这里特别提醒移动文件时注意不要遗漏隐藏文件用ls -la确认一下。执行sudo mv upload/* . sudo cp -r upload/. .最终 /var/www/forum 下应该能直接看到 index.php、forum.php、install 等文件目录。目录所有权设置稍后统一处理。5.2 运行安装向导浏览器访问http://你的域名/install/index.php进入安装向导。第一步检查环境PHP版本、扩展、目录权限都会列出来有红色叉号的需要先处理。第二步填写数据库信息数据库服务器填 localhost数据库名填 forumdb用户名填 forumuser密码填刚才设置的密码。管理员账号密码这里要填一个强密码不能图省事用简单组合因为管理员权限就是论坛的最高权限。安装过程中出现 redirection 或者提示“无法连接数据库”优先检查数据库账号密码是否写对、论坛程序所在目录的 config 文件是否有写入权限。安装程序会自动生成 config/config_global.php 和 config/config_ucenter.php如果这两个文件生成失败手动创建后填对内容也问题不大。5.3 目录权限的正确设置Discuz! 官方安装文档会建议把某些目录设为777权限很多新手图省事直接chmod -R 777 /var/www/forum这是极度危险的操作。正确做法是sudo chown -R www-data:www-data /var/www/forum sudo chmod -R 755 /var/www/forum sudo chmod -R 777 /var/www/forum/data sudo chmod -R 777 /var/www/forum/config sudo chmod -R 777 /var/www/forum/uc_server/datachown 把网站根目录的属主改成 www-data这样Nginx和PHP-FPM才能读写。仅对 data、config、uc_server/data 这些确实需要动态写入的目录放开权限。如果对目录结构不熟先设置755然后让安装向导跑一遍它会在后台提示哪些目录需要额外权限按提示逐个开放比一把梭给777稳得多。5.4 后台开启伪静态并配对规则安装完成后进入后台“全局 - SEO设置”把“URL静态化”下的选项勾上然后去“全局 - 优化设置”里关闭不需要的缓存先让论坛处于干净状态。这里有个操作顺序问题后台勾选URL静态化之前Nginx需要已经加载好伪静态规则否则前端所有帖子链接都会404。如果你在Nginx配置里已经把规则写进location块那直接刷新前台页面看链接是否变成 .html 结尾即可。如果没有生效先nginx -t校验配置再 reload Nginx别在伪静态规则没加载的时候去论坛后台点保存容易造成误以为功能坏了。6. 常见问题与排查技巧实录6.1 访问页面出现502 Bad Gateway502 是Nginx收到了请求但PHP-FPM没有正常返回响应。最常见原因是PHP-FPM没启动、socket路径不一致、或者PHP-FPM子进程全部耗尽。第一步先看服务状态sudo systemctl status php8.1-fpm ps -ef | grep php-fpm如果PHP-FPM在跑再看Nginx配置里 fastcgi_pass 的路径和PHP-FPM实际监听的路径是否一致。我习惯用 unix socket 方式路径统一写成 /run/php/php8.1-fpm.sock。开了防火墙还要确认套接字文件对Nginx用户可读否则也会报502。用sudo -u www-data curl --unix-socket /run/php/php8.1-fpm.sock http://localhost/能快速测试socket是否可访问。6.2 伪静态404或500伪静态404多半是nginx配置文件里没有正确加载rewrite规则500错误多半是rewrite规则和后台URL静态化规则不匹配比如后台开启了三层目录模式Nginx规则却是默认模式。解决思路是先去后台把URL静态化暂时关闭再逐条对比rewrite规则。还有一个隐藏坑Nginx的location / 块里 try_files $uri $uri/ /index.php?$query_string; 如果放在rewrite之前某些请求会被try_files先截走导致伪静态链接无法到达PHP。正确顺序是先把rewrite规则放好再配置try_files。用 curl 带上-L参数看响应码和跳转地址能直观判断问题出在哪个环节。6.3 数据库连接失败报错安装论坛时最常见的报错是“无法连接数据库请检查数据库配置”。先确认MariaDB服务在运行systemctl status mariadb。然后去命令行尝试用论坛账号连接mysql -uforumuser -p -h localhost forumdb能连上说明程序和账号都没问题问题多半出在Discuz安装过程中填写的数据库主机名上。如果填 127.0.0.1 而账号授权的是 localhost两者在某些版本里是分开的。最稳妥的方法账号授权时用 localhost安装向导里也填 localhost或者统一用 127.0.0.1 并确保账号授权为 forumuser127.0.0.1。6.4 上传附件失败或大小受限上传几张图就提示“文件过大”或者“413 Request Entity Too Large”这是Nginx和PHP两侧限制叠加导致的。Nginx的 client_max_body_size 改到20M只是第一步PHP的 post_max_size 和 upload_max_filesize 也必须同时提高。还有个容易忽略的地方如果用了CDN或反向代理CDN层也可能有上传大小限制到时候要先去CDN控制台调。改完配置文件后重点是用phpinfo();确认生效值不要凭记忆判断。在网站根目录临时建一个 info.php写入?php phpinfo(); ?浏览器访问确认 upload_max_filesize 已变成20M然后立即把它删掉避免暴露服务器信息。6.5 内存不足导致后台页面白屏论坛后台点击某些操作时整个页面白屏没有报错信息第一反应不是程序坏了而是看系统内存和PHP错误日志free -m sudo tail -f /var/log/php8.1-fpm.log sudo tail -f /var/log/nginx/error.log如果日志里出现 Fatal error: Allowed memory size of 134217728 bytes exhausted说明PHP内存到了128M上限把 php.ini 的 memory_limit 调高到256M或512M同时确认PHP-FPM没有开太多max_children。更严重的情况是服务器整体OOM系统日志/var/log/syslog里会看到 oom-killer 记录。这种情况只能加内存或者把进程数参数调小。1G内存的服务器跑Discuz! Xmax_children 超过15基本就是在赌运气。不要开一堆重型插件一个轻量论坛完全可以用好几年。7. 上线前的一些额外建议到这里LNMP环境下的论坛已经能跑了但距离一个稳定对外服务的站点还差了最后几步。第一务必把HTTPS配上。用Certbot申请Lets Encrypt免费证书修改Nginx配置加上SSL证书路径然后把80端口请求301跳转到443。现在搜索引擎和浏览器对非HTTPS站点的信任度都在降低同时HTTP明文传输会让用户密码和Cookie暴露在链路上这是不可接受的安全隐患。第二做备份。论坛的核心资产就是数据库里的帖子和用户数据代码文件丢了重新上传就能恢复数据库丢了才是灾难。我习惯每天凌晨2点用mysqldump导出一份SQL文件保留最近7天然后同步到对象存储或另一台机器。定期从备份里恢复一次测试库确认备份文件真的可用这比备份本身更重要。第三别忘后台安全设置。把默认管理员账号名改掉开启登录验证码限制后台登录IP入口关闭不必要的权限接口。Discuz! X 3.5 后台有安全策略选项可以开启敏感词过滤和注册防灌水机制这些对论坛的日常运营帮助很大。第四注册和发帖要开启基础防刷策略。验证码、注册间隔、新手见习期这些功能都是实打实能减少垃圾帖的工具。不要想着上线后再补论坛一开放就会被扫描脚本盯上前期不做防范第二天可能就全是广告帖。我在实际部署中踩过最大的坑是在1G内存的小机器上装了一堆缓存插件结果PHP-FPM和数据库抢内存整个服务器CPU飙到100%还频繁宕机。后来把所有多余插件卸载只保留最基本的功能论坛反而跑得又快又稳。LNMP搭建本身不复杂真正考验人的是资源管理和配置细节。跟着这篇流程走遇到问题多查日志你的论坛上线只是时间问题。