★ FEATURED ARTICLE 1. 为什么要在 Linux 上折腾 Emlog 这套组合把 Emlog 装到 Linux 上再让它能从公网访问这个需求听起来像是老派博客玩家才会干的事但实际动手的人比想象中多。Emlog 是一款轻量级的 PHP 博客系统整个程序包解压出来也就几兆数据库结构简单后台操作直观对服务器配置要求极低——一台 1 核 1G 的入门级云主机就能跑得很顺。相比那些动辄要装一堆扩展、配置一堆缓存的大型建站程序Emlog 的优势就在于轻和快适合个人写作者、技术笔记记录者以及想低成本维护一个独立站点的人。但问题往往卡在最后一步本地搭好了局域网内能访问出门在外却打不开。这时候就需要引入内网穿透的思路把本地服务的端口映射到公网上去。整套流程涉及 Linux 基础操作、Web 运行环境搭建、数据库配置、Emlog 安装、穿透工具选型与配置这几个环节任何一个环节出问题都会导致最终访问失败。我见过不少人卡在 PHP 版本不兼容、伪静态规则没配、数据库连接失败这几个坑上折腾一整天也搞不定。这篇内容面向的是有一定 Linux 命令行基础、想自己动手搭一个可公网访问的个人博客的读者。哪怕你之前没接触过 Emlog只要跟着步骤走也能把整套环境跑起来。我会把每个环节背后的逻辑讲清楚——为什么选这个 PHP 版本、为什么数据库要用这个字符集、穿透工具的参数怎么算——而不是甩一堆命令让你照抄。毕竟照抄的命令换个环境就可能报错理解了原理才能自己排查。2. 整体方案设计与选型考量2.1 环境栈的组成与选择逻辑整套方案的核心是一个经典的 LNMP 变体Linux 做底座Nginx 做 Web 服务器PHP 负责解析 Emlog 的程序逻辑MySQL 或 MariaDB 存数据。这个组合是 PHP 类博客系统最成熟的运行环境资料多、坑也被踩得差不多了出问题容易找到答案。为什么用 Nginx 而不是 ApacheEmlog 本身对两者都支持但 Nginx 在低配机器上的内存占用更小静态资源处理效率更高而且配置伪静态规则时更直观。对于一台可能只有 1G 内存的机器来说省下来的每一兆内存都有意义。PHP 版本方面Emlog 较新的版本对 PHP 7.4 到 8.1 支持较好我一般推荐用 PHP 8.0 或 8.1兼顾性能和兼容性——太老的版本有安全隐患太新的版本部分老插件可能不兼容。数据库选 MariaDB 而不是原版 MySQL主要原因是 MariaDB 在多数 Linux 发行版的软件源里直接可用安装一条命令搞定且与 MySQL 协议完全兼容Emlog 连接时不会有任何差异。字符集统一用utf8mb4这个细节很多人忽略结果文章里插入个特殊符号或者表情就乱码回头改起来很麻烦。2.2 内网穿透的角色定位内网穿透在这里解决的是没有公网 IP 也能被外网访问的问题。家用宽带、公司内网、校园网环境下设备拿到的通常是私有地址外部无法直接连进来。穿透工具的原理是在公网服务器上跑一个中转服务本地客户端与它建立一条长连接外部请求先到中转服务器再通过这条连接转发到本地端口。选型时要关注几个点是否支持 HTTP 协议转发、是否提供固定域名、带宽和并发限制、客户端在 Linux 上的兼容性。对于博客这种以文本为主的站点带宽需求不高但稳定性要求高——谁也不想访客打开页面转半天。配置时核心是把本地的 80 或 8080 端口映射出去拿到一个公网可访问的地址。这里要提醒一句穿透工具的具体品牌和配置方式差异较大下文会讲通用的配置思路和参数含义具体到某个工具时按其官方文档操作即可。2.3 方案的整体数据流理解数据流有助于排查问题。访客在浏览器输入公网地址请求先到达穿透服务的中转节点中转节点根据映射规则把请求转发到本地 Linux 机器的指定端口Nginx 接收到请求后判断是静态文件还是 PHP 脚本静态文件直接返回PHP 脚本交给 PHP-FPM 处理PHP 再向数据库查询数据组装成 HTML 返回原路回传到访客浏览器。这条链路上任何一环断了表现都是打不开。所以排查时要分段验证本地curl能不能通、局域网另一台机器能不能通、穿透客户端是否在线、公网地址是否解析正确。按这个顺序走基本能快速定位问题在哪一段。3. 基础环境搭建的实操细节3.1 系统准备与软件源配置先确认系统版本不同发行版的包管理命令不一样。以常见的 Debian 系为例登录后先更新软件源索引把系统补丁打上。这一步别省老旧的软件源里 PHP 版本可能过低装完发现 Emlog 跑不起来还得重来。sudo apt update sudo apt upgrade -y更新完成后检查一下系统时间和时区时间不对会导致 HTTPS 证书校验失败、日志时间错乱。设置时区的命令是sudo timedatectl set-timezone Asia/Shanghai然后用date确认。这个细节看似无关紧要但我在实际排查中遇到过因为时间偏差导致穿透工具握手失败的情况绕了不少弯路。接着安装基础工具curl、wget、unzip、vim这些后面都会用到。一条命令装齐sudo apt install -y curl wget unzip vim3.2 Nginx 与 PHP 的安装配置安装 Nginx 和 PHP 及其扩展。Emlog 需要的扩展主要是php-fpm、php-mysql、php-gd处理图片、php-mbstring多字节字符、php-curl、php-xml。少装一个后台可能就报某个函数未定义。sudo apt install -y nginx php-fpm php-mysql php-gd php-mbstring php-curl php-xml php-zip装完后确认 PHP-FPM 服务在跑systemctl status php8.1-fpm版本号按实际装的填。Nginx 默认配置里对 PHP 的处理是注释掉的需要新建一个站点配置文件。我习惯在/etc/nginx/sites-available/下建一个emlog.conf然后软链到sites-enabled。配置内容的关键点root指向 Emlog 的解压目录index加上index.phplocation ~ \.php$块里fastcgi_pass要指向正确的 PHP-FPM socket 路径通常是unix:/run/php/php8.1-fpm.sock还要带上fastcgi_param SCRIPT_FILENAME这一行漏了就会返回空白页或者下载 PHP 文件。伪静态规则是 Emlog 正常工作的必要条件。Emlog 的 URL 重写规则大致是location / { index index.php index.html; if (!-e $request_filename) { rewrite ^/(.*)$ /index.php/$1 last; } }这段规则的意思是请求的文件不存在时统一交给index.php处理。配置完用nginx -t测试语法通过后systemctl reload nginx生效。3.3 数据库的初始化安装 MariaDB 服务端启动后执行安全初始化脚本设置 root 密码、删除匿名用户、禁止 root 远程登录。然后登录数据库为 Emlog 单独建一个库和用户不要图省事直接用 root 连博客——权限过大一旦程序有漏洞风险更高。CREATE DATABASE emlog DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER emloguserlocalhost IDENTIFIED BY 你的强密码; GRANT ALL PRIVILEGES ON emlog.* TO emloguserlocalhost; FLUSH PRIVILEGES;字符集这里再强调一次utf8mb4而不是utf8。MySQL 里的utf8其实是残缺的三字节实现存不了四字节字符utf8mb4才是完整的。建库时定好后面省心。4. Emlog 部署与穿透配置全流程4.1 程序上传与安装向导从 Emlog 官方渠道下载最新版程序包解压到 Nginx 配置的站点根目录比如/var/www/emlog。目录权限要设对属主给www-dataNginx 和 PHP-FPM 的运行用户目录权限 755文件权限 644。权限给太宽有安全风险给太窄安装时写配置文件会失败。sudo chown -R www-data:www-data /var/www/emlog sudo find /var/www/emlog -type d -exec chmod 755 {} \; sudo find /var/www/emlog -type f -exec chmod 644 {} \;浏览器访问本地地址进入安装向导。填写数据库地址本地就填localhost、库名、用户名、密码设置管理员账号。安装程序会往数据库写表并在根目录生成配置文件。如果这一步报无法连接数据库先检查数据库用户权限和密码再确认 PHP 的mysqli扩展是否加载php -m | grep mysqli。安装完成后务必删掉安装目录通常是install文件夹否则别人可以重新走安装流程覆盖你的站点。这个安全习惯要养成。4.2 穿透客户端的部署与参数理解穿透客户端在 Linux 上一般以命令行程序或系统服务的形式运行。部署思路是下载对应架构的客户端放到一个固定目录写好配置文件注册成系统服务实现开机自启。配置文件里几个核心参数需要理解参数项含义配置建议服务端地址中转节点的接入地址按服务商提供填写隧道协议转发使用的协议类型博客选 HTTP 类本地端口要暴露的本地服务端口Nginx 监听的 80 或 8080自定义域名外部访问用的地址有固定域名优先用固定域名认证令牌客户端身份凭证妥善保管勿泄露本地端口这里有个细节如果 Nginx 监听的是 80而穿透客户端以普通用户运行可能没有权限绑定低端口。解决办法要么用sudo运行客户端要么把 Nginx 改成监听 8080 之类的非特权端口穿透映射到 8080。我倾向于后者权限管理更清晰。注册成系统服务用 systemd写一个.service文件放到/etc/systemd/system/ExecStart指向客户端可执行文件和配置文件Restartalways保证进程挂了自动拉起。systemctl enable加start之后用systemctl status确认状态是 active。4.3 公网访问验证与链路排查配置完成后从外网环境比如手机切到移动数据访问穿透服务给出的公网地址。能打开首页说明链路通了。如果打不开按前面说的分段排查本地curl -I http://127.0.0.1看 Nginx 是否正常响应局域网另一台设备访问本机 IP确认不是防火墙拦截查看穿透客户端日志确认隧道建立成功、没有认证错误检查公网地址是否拼写正确、是否需要加端口号。我踩过的一个坑是本地一切正常公网访问却返回 502。查了半天发现是穿透客户端转发到了127.0.0.1:80但 Nginx 实际监听的是0.0.0.0:8080端口对不上。所以配置穿透时本地端口一定要和 Nginx 的listen指令完全一致。5. 常见问题排查与经验沉淀5.1 高频故障速查表实际部署中遇到的问题五花八门我把出现频率最高的几类整理成表方便对照排查。现象可能原因排查方向首页空白PHP 未解析或报错被隐藏查 Nginx error log、开 PHP 错误显示502 Bad GatewayPHP-FPM 未运行或 socket 路径错检查 FPM 状态和 fastcgi_pass 配置后台登录后跳回登录页会话目录权限或 Cookie 域问题检查 session 目录属主、站点域名配置文章页 404伪静态规则未生效确认 rewrite 规则、Nginx 是否 reload图片上传失败上传目录无写权限或 GD 扩展缺失查目录权限、php -m看 gd公网访问超时穿透客户端离线或端口不匹配看客户端日志、核对本地端口5.2 几个容易被忽略的实操心得第一个心得关于日志。Nginx 的error.log和 PHP-FPM 的慢日志是排查问题的金矿但默认配置下错误信息可能不够详细。建议在调试阶段把 PHP 的display_errors打开、error_reporting设为E_ALLNginx 的error_log级别调到warn甚至info。等问题解决了再关掉避免把内部路径暴露给访客。第二个心得关于备份。Emlog 的数据全在数据库里程序文件反而是次要的。定期用mysqldump导出数据库配合程序目录打包恢复时先还原文件再导入数据库。我习惯写个简单的 shell 脚本加进 cron每天凌晨跑一次保留最近七天的备份。这个习惯在有一次误操作删表之后救了我。第三个心得关于穿透的稳定性。免费或低配的穿透服务在高峰期可能出现连接抖动表现为页面加载慢或者偶尔超时。如果对稳定性要求高可以考虑在本地加一层缓存或者选择提供固定带宽的方案。另外穿透客户端所在机器的网络质量直接影响访问速度尽量让它跑在网络稳定的环境里。5.3 安全加固的几条底线公网可访问意味着暴露面变大几条底线必须守住。后台登录密码用强密码别用 admin/123456 这种Emlog 后台默认路径可以改掉减少被扫描器盯上的概率数据库只监听本地不对外开放 3306 端口系统定期更新补丁穿透服务的认证令牌不要截图发到公开场合。这些措施单独看都不复杂但组合起来能挡掉绝大多数自动化攻击。还有一点Emlog 的插件和模板尽量从可信来源获取来路不明的代码可能带后门。装之前扫一眼代码里有没有可疑的远程请求或者文件写入操作花几分钟能省掉大麻烦。整套流程走下来从裸机到公网可访问的博客熟练的话半小时到一小时能搞定。真正耗时的往往是踩坑和排查而这些问题大多源于对某个环节原理不清楚。把数据流想明白、把每个配置项的作用搞清楚遇到报错就不会慌顺着链路一段段验证问题总能定位到。这也是我坚持把原理讲透而不是只给命令的原因——命令会过时排查思路不会。
阅读完成 · 觉得有帮助？
