Typecho这个博客程序说真的是我用过的PHP建站程序里最省心的一个。朋友问我打算搭个人博客选什么好我基本都是直接推荐它——安装包不到2MB1核1G的服务器跑起来都轻松后台界面干净得不像这个时代的产物写文章、发页面、传附件功能刚好够用又不像大厂CMS那样塞一堆你用不上但删不掉的东西。但部署这东西光说简单没用真踩到坑才知道深浅。Linux环境下用宝塔面板来装Typecho算是目前最主流的组合了宝塔把Nginx、MySQL、PHP这些零散的组件全部图形化管理Linux命令不熟的人也能顺利把环境编排好Typecho本身轻量搭在Nginx上响应非常快比Apache更省内存。这篇文章我会把完整的部署路径走一遍从服务器选型、环境初始化到Typecho安装、伪静态配置、SSL证书再到常见问题排查和部署后的安全加固每一步都讲清楚为什么要这么做遇到报错怎么定位。适合想搭独立博客、内容站或者只是想快速体验Typecho的新手也适合已经装过但没整明白伪静态和安全配置的老手来查漏补缺。1. 项目概述与环境准备1.1 为什么选Typecho当个人站Typecho诞生得挺早圈子里的老用户基本都认识它。它是一款开源的PHP博客程序核心卖点就一句话轻、快、省心。对比WordPress那样动辄几十MB安装包、后台一堆菜单项和插件依赖的重型工具Typecho安装包只有几百KB跑起来占用的内存和CPU都要低一大截。对个人博客这种打开就能写写了就能发的场景来说它刚好卡在功能够用和不那么臃肿的平衡点上。我一直认为个人站的核心价值是内容不是平台。Typecho把注意力完全拉回到写作本身——Markdown写作支持得很干净文章管理简洁评论系统够用主题和插件机制也足够灵活。如果你只是想安安稳稳地写点技术笔记或者日常记录不追求网站后台有各种花哨报表和可视化编辑器Typecho就是最合适的那个。另外一个隐藏优势是HTML源码干净Google和百度的收录体验很好SEO底子比很多建站程序都要好。当然它也不是没有缺点。比如主题和插件的生态相比WordPress小很多开发文档也不算丰富遇到问题更多要靠社区博客和GitHub Issue。但对大多数个人博客场景来说这个生态规模完全够用了而且正因为选择少反而少了每天折腾主题这种浪费时间的事。1.2 服务器选型与Linux环境准备Typecho虽然对配置要求很低但服务器选型还是要有基本章法。CPU至少1核内存推荐2GB起步1GB勉强能跑但PHP-FPM、MySQL、Nginx三个进程挤在一起的时候内存会很紧张。带宽看你的访问量日常个人博客1M到3M完全够用但注意国内某些云厂商的带宽计费规则按流量还是按固定带宽要看自己的预算。系统盘建议SSD20GB起步后面要装宝塔、跑日志、存备份得留点余量。操作系统这块我在CentOS 7、CentOS Stream、Ubuntu 20.04/22.04、Debian 11/12之间都部署过Typecho。如果你的服务器是全新的我更推荐Ubuntu 22.04或者Debian 12——软件源新社区活跃遇到问题搜答案命中率高。CentOS 7虽然经典但官方已经停止维护软件源也迁移了新部署不建议再选。买完服务器之后第一步是SSH登录工具可以用Xshell、FinalShell、Termius任选然后做两件事第一更新系统软件包到最新命令很简单# Ubuntu/Debian apt update apt upgrade -y # CentOS/RHEL yum update -y第二检查一下防火墙和云安全组的放行状态。记得先放行SSH端口默认22但建议改成不常见端口和之后宝塔面板要用的端口很多安装卡住的问题其实都是防火墙把端口挡了。1.3 宝塔面板安装与初始配置宝塔面板是一个Linux服务器管理工具把Nginx、MySQL、PHP、FTP、防火墙、计划任务这些运维组件全部做成图形化界面。对刚接触Linux的朋友来说它最大的价值是不用记一大堆命令行就能把网站环境搭起来对我这种老手来说它也省掉了大量重复的手工编译配置工作。安装方式非常简单SSH登录服务器后去宝塔官网复制对应操作系统的安装脚本执行就行。脚本是官方定制的会自动检测系统环境并安装依赖整个安装过程大概需要5到15分钟取决于服务器性能和网络状况。这里顺便回答一个很多人问的问题宝塔面板是收费的吗答案是它分为免费版和付费专业版免费版已经覆盖了日常建站需要的绝大多数功能Typecho部署完全用不到付费功能放心用免费版就好不需要去研究什么免费使用专业版插件的办法那没意义也有安全风险。安装完成后终端会输出面板访问地址、初始用户名和随机密码。这里有几个安全习惯务必从第一天就养成面板默认端口是8888很多云厂商的安全组默认不放行需要你自己去云控制台放行登录面板后立刻修改面板端口和登录入口路径别用默认值开启面板SSL选项避免面板后台用明文HTTP访问进面板后在软件商店里安装Nginx、MySQL 5.7或8.0、PHP 7.4或8.1、PHPMyAdmin这几件套。装的时候版本搭配要注意Typecho官方虽然没强制指定PHP版本但建议至少7.4起太老版本跑起来会有兼容性问题后面我会细讲。2. 核心细节解析与部署前的关键决策2.1 PHP版本选择与扩展项配置PHP版本这个事是Typecho部署里最值得说道的环节。Typecho本身兼容PHP 5.6到8.2但不同版本跑起来体验差距很大。我个人推荐用PHP 7.4原因很实在Typecho生态里大量老主题和插件是几年前开发的有些语法在当时条件下还能兼容到了PHP 8.0以后就会报错甚至白屏而7.4作为过渡版本兼容性最稳妥性能也比5.6、7.0时代快一大截。如果你是全新安装且不太用老主题PHP 8.1其实也可以速度更快但遇到问题时要学会看PHP错误日志。这里有句话送给大家别追求最新稳定够用才是个人站的第一原则。选好PHP版本后在宝塔的软件商店 - PHP - 设置 - 安装扩展里有几个扩展是必装的pdo_mysqlTypecho连接MySQL数据库的底层驱动必备mbstring中文编码和多字节字符串处理不装的话中文标题、文章内容可能乱码curl部分插件和更新检测功能会用到opensslSSL证书访问和HTTPS加密依赖它fileinfo上传附件时检测文件类型避免伪装文件被放行opcachePHP代码缓存执行速度提升非常明显安装扩展后记得重启PHP-FPM进程否则配置不会生效。重启按钮在面板PHP设置页面的右上角点一下就行。2.2 数据库方案选型MySQL还是SQLiteTypecho支持两种存储方式MySQL或MariaDB和SQLite。这个选择看似不起眼实际会影响后期的维护体验。SQLite是一个文件型数据库整个数据都保存在一个文件里不需要单独安装数据库服务。它的好处是部署极简适合在极低配置的服务器上快速试跑或者你只是临时想体验一下Typecho。但缺陷也明显并发写入能力弱文章多了、评论多了之后体验会下降而且数据备份、迁移都不如MySQL方便。MySQL或MariaDB是传统的关系型数据库Typecho从早期版本就默认适配MySQL稳定性和文档完备度都更好。我的建议是正式部署一律用MySQL理由有三个一是备份方便导出.sql文件放到新服务器导入就行二是宝塔面板对MySQL的日常管理都做好了建库、授权、备份都是点几下的事三是网上90%的Typecho教程和插件都基于MySQL遇到问题搜解决方案命中率高很多。在宝塔面板的数据库菜单里新建数据库时记得数据库名、用户名、密码都单独设置密码建议用高强度随机密码不要用生日、手机号这种可猜的。创建好后把这几个信息复制到记事本里后面安装向导要用。2.3 Nginx站点创建与伪静态规则在宝塔面板网站菜单里点击添加站点填入你的域名选择之前装好的PHP版本。这里有一个容易忽略的点创建站点时弹出的同步创建数据库选项建议关掉数据库单独在数据库菜单里建这样生成的库名和权限更可控。添加完成后Nginx配置文件会自动生成位置在 /www/server/panel/vhost/nginx 目录下。Typecho默认的链接是带 index.php 的比如 http://你的域名/index.php/archives/123.html这种链接看起来不专业也不利于SEO。所以我们要给Nginx加上伪静态规则让链接变得简洁友好。Typecho官方文档给出的Nginx规则是这样的location / { index index.html index.php; if (!-e $request_filename) { rewrite ^(.*)$ /index.php$1 last; } }操作位置在对应站点的设置 - 伪静态把这段规则粘贴进去保存即可。配置完成后访问文章链接时Nginx会把不存在的路径重写到 index.php 上去由Typecho的路由解析对应文章。这里有个很多新手会踩的坑伪静态规则贴错了位置或者站点配置文件里已经有一段 location / 规则再贴就冲突了结果整个站点打不开。我的建议是先用最简单的官方规则确认访问正常后再按需调整。别一上来就抄网上的复杂规则简化才是稳定之道。2.4 域名解析与SSL证书域名解析看起来简单却是整个部署流程里最容易被卡住的地方。如果你用的是阿里云、腾讯云、Cloudflare等DNS服务商添加一条A记录记录值填服务器的公网IP等待全球DNS生效即可。生效时间通常在几分钟到一小时国内解析可能更快但有时候你本地的DNS缓存没刷新会误以为没生效可以用在线的DNS检测工具确认。SSL证书强烈建议在宝塔面板里直接申请。宝塔自带Lets Encrypt免费证书申请功能申请前提是域名已正确解析到本服务器并且站点配置的域名和证书申请域名一致。申请成功后在SSL菜单里开启强制HTTPS和HSTS让所有HTTP请求自动跳转到HTTPS。顺便提一个热搜词相关的问题宝塔面板 启用不安全的TLS1.0协议怎么关闭——这个操作其实很简单在Nginx配置文件里的 ssl_protocols 一行改成ssl_protocols TLSv1.2 TLSv1.3;意思是只启用TLS1.2和1.3这两个安全版本把不安全的TLS1.0和1.1彻底关掉。改完保存重载Nginx配置即可。这个优化对提升站点安全评分很有帮助建议配合免费证书一起做。3. Typecho安装全程实操3.1 下载Typecho源码并上传Typecho的安装包可以从官网下载也可以在GitHub的官方仓库下载目前的最新稳定版是1.2.x以官网实际显示为准。下载下来的压缩包解压后会得到一个包含 index.php、install.php 等文件的目录结构。上传到服务器有两种方式大家按习惯选。第一种宝塔面板的文件管理把压缩包上传到站点根目录/www/wwwroot/你的网站目录选中压缩包点击解压然后把解压出来的文件剪切/移动到根目录。这种方式全程鼠标操作对不熟悉命令行的朋友最友好。第二种SSH命令行方式速度快适合有基础的朋友cd /www/wwwroot/你的网站目录 wget https://github.com/typecho/typecho/releases/download/v1.2.1/typecho.zip unzip typecho.zip不管用哪种方式上传完后访问 http://你的域名/install.php应该能看到Typecho安装向导。如果这一步出现404或空白页优先检查Nginx站点配置里的根目录路径是否和文件实际存放目录一致。3.2 目录权限设置权限问题是安装Typecho时最容易碰到的坑。安装过程中Typecho需要往 usr 目录下写入配置文件 config.inc.php还需要在 usr/uploads 目录下保存上传的图片附件。如果权限不够安装向导会在第一步就报无法写入配置文件。宝塔面板创建站点时默认已经把网站目录所有者设置为 www 用户权限是755。为了确保安装顺利我建议在安装阶段给 usr 目录临时设置为777等安装完成后再改回755并单独把 config.inc.php 的权限设置为644。这样既保证了安装过程不卡壳又减少了目录被恶意写入的风险。如果安装过程中遇到权限报错进入面板文件管理右键对应目录点击权限手动设置好所有者和权限值然后刷新安装页面重试。这一步基本可以解决99%的无法写入类报错。还有一个小细节FTP上传文件时某些FTP客户端默认的文件权限是644、目录权限是755如果上传后目录变成了其他权限记得批量调整回来。3.3 浏览器安装向导填表要点访问 http://你的域名/install.php 后Typecho安装向导会分几步走。第一页显示数据库配置,需要填写数据库信息。这里我见过太多人填错重点说几个第一数据库用户名和密码。注意这里填的不是宝塔面板的账号密码而是你在宝塔数据库菜单里创建的那个MySQL数据库的用户名和密码两个是两个系统别混。第二数据库地址。大部分情况填 localhost 或者 127.0.0.1 都可以。宝塔默认配置下填 localhost 通常能成功如果提示连接失败改成 127.0.0.1 再试一次这个修改能解决很多莫名其妙的连接问题。第三数据库名。要填你在宝塔里创建的那个数据库的全名不要自己改拼写或添字。数据库名一般是一长串小写字母加数字复制粘贴最稳妥。第二页是站点配置设置管理员用户名、登录密码、邮箱以及站点时区。时区直接选中国时区Asia/Shanghai就好。填完后点击安装正常几秒就会进入Typecho后台登录页面。如果卡住或报错回看第4章的问题排查。3.4 后台初始设置与基本优化安装完成登录后台后第一件事就是到控制台 - 设置 - 基础设置里检查几个配置项站点名称改成你自己的博客名称站点地址填你的域名带不带 www 要和后面配置的保持一致否则可能出现部分链接生成错误时区确认是 Asia/Shanghai日期时间格式按自己喜好调整比如 Y-m-d H:i:s然后发布一篇测试文章看看链接什么样。如果文章链接还是带着 index.php 的样子说明前面Nginx伪静态规则没生效回到站点设置里重贴一遍规则然后清理浏览器缓存再看。接下来可以配置永久链接结构。Typecho默认的文章链接是 /archives/数字.html其实已经很简洁了一般不用改。但如果你喜欢日期型链接或者分类型链接可以在设置 - 永久链接里调整。需要注意修改永久链接后旧链接可能失效所以第一次就定好结构尽量别在站点上线后频繁改。主题和插件的安装我也顺便说一下下载主题或插件压缩包后在后台外观或插件菜单里上传安装即可也可以手动上传到 usr/themes 或 usr/plugins 目录再到后台启用。Typecho的Markdown写作体验很好后台写文章时默认就支持Markdown语法没有太多需要配置的东西装好主题和插件之后基本就能开写了。4. 常见问题与排查技巧实录4.1 数据库连接失败安装向导报数据库连接失败是最常见的问题。排查顺序按下面来检查MySQL服务是否运行中宝塔面板 - 数据库 - 服务状态如果是停止状态点击启动检查数据库名、用户名、密码是否填错去宝塔数据库菜单里重新看一眼确认没有多打或少打字符检查数据库地址是 localhost 还是 127.0.0.1两个切换试一下检查数据库用户是否有权限访问这个库宝塔创建数据库时默认绑定了权限一般不会错但如果你手动创建过同名库或同名用户可能权限对应混乱这里分享一个我踩过的隐蔽坑如果服务器上安装了多个PHP版本而你创建站点时选择的PHP版本和数据库配置不匹配比如PHP 8.1的pdo_mysql扩展没装那MySQL连接也会报错。解决办法是到软件商店 - PHP - 设置 - 扩展里确认pdo_mysql扩展已安装并重启PHP。4.2 404页面无法访问首页能打开但访问文章链接比如 /archives/1.html出现40490%的原因是Nginx伪静态没配置或者配置了没有生效。处理步骤宝塔面板 - 网站 - 对应站点 - 设置 - 伪静态确认规则内容无误保存规则后再点一次配置文件确认规则确实写入了对应server块如果规则没问题清一下浏览器缓存用无痕窗口重新访问如果以上都做了还是404检查一下站点根目录下是否有 .htaccess 文件这是Apache的重写规则Nginx不识别但有时候会被模板或工具带进来。有的话不影响Nginx但如果同时存在其他location规则冲突就可能导致404可以先把配置文件里多余的location块注释掉再测试。4.3 502 Bad Gateway502通常意味着PHP-FPM进程挂了或者PHP版本与站点配置不匹配。排查路径去宝塔面板软件商店 - PHP - 设置 - 状态里看PHP-FPM是否在运行如果没运行点击启动然后在站点设置里确认选择的PHP版本是正在运行的那个版本查看PHP-FPM日志/www/server/php/你的PHP版本/var/log/php-fpm.log定位具体报错实际部署中502经常出现在安装了opcache等扩展之后忘了重启PHP-FPM的情况。解决办法就是重启面板上有重启按钮点一下几秒就好。还有一种少见情况是PHP-FPM的listen配置的socket路径和Nginx配置里不一致导致Nginx连接不上PHP-FPM这种情况检查Nginx配置文件里的 fastcgi_pass 参数确保和PHP-FPM的listen配置对应。4.4 伪静态不生效伪静态配置完首页正常但文章链接还是带index.php或者点击文章链接404。这有两种可能第一种是规则没生效。在宝塔面板伪静态里粘贴规则后要点右侧保存按钮再回到配置文件确认规则确实写入了。第二种可能是PHP的pathinfo模式问题。Typecho对pathinfo处理得还算好但如果Nginx配置里限制了PATH_INFO传递也可能导致文章页面404。解决方法是在站点的Nginx配置文件的server块中加入location ~ .*\.php { fastcgi_pass unix:/tmp/php-cgi-74.sock; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_index index.php; include fastcgi.conf; }这里的 unix:/tmp/php-cgi-74.sock 要根据你实际PHP版本修改在宝塔PHP - 配置文件里能找到 listen 那一行的实际socket路径。不过很多情况下只要伪静态规则贴对了不会走到pathinfo这一步。4.5 上传文件失败后台写文章时上传图片附件失败基本就是几个原因usr/uploads 目录没有写权限把该目录所有者改为 www权限设置755PHP的upload_max_filesize默认只有2M到PHP - 设置 - 上传限制里改大比如20Mpost_max_size 也要一并改大否则表单提交大数据会被服务器拒绝服务器磁盘满了执行 df -h 看看磁盘使用率备用方案是清理日志和备份还有一个容易忽略的点如果你使用了CDN或对象存储插件上传附件那问题可能出在插件的API配置上跟服务器权限无关需要到插件设置页面重新校验密钥和存储路径。上传失败后记得看PHP-FPM日志和Nginx的error.log里面通常有具体的错误描述比瞎猜定位快得多。5. 部署后的安全加固与性能调优5.1 目录权限与防注入Typecho源码目录本身不大但权限分配要做到最小化。我一般按下面这样分网站根目录目录权限755文件权限644usr/ 目录给 www 用户写权限主题插件的写入和更新需要usr/uploads/ 目录www 用户写权限用户上传的附件都存这里install.php安装完成后直接删除或多加一道访问控制避免被再次执行安装逻辑防注入方面Typecho本身对SQL注入和XSS做了不少防护这篇文章就不展开讲代码层面了但服务器层面至少要做两件事。第一启用宝塔面板的系统防火墙关闭不必要的外网端口。第二在Nginx配置里增加一段规则隐藏掉备份文件、数据库导出文件、日志文件这类可能包含敏感信息的内容location ~* (\.bak|\.old|\.swp|\.sql|\.log)$ { deny all; }这段规则会禁止外部直接访问 .bak、.sql、.log 等后缀的文件。很多人习惯把数据库备份文件放到网站目录下如果不加这个限制被搜索引擎或恶意扫描者抓到后果很严重。顺带提醒一下备份文件尽量放在站外目录比如 /backup 或者单独挂载的云盘。5.2 缓存与CDN配置Typecho已经很轻量但访问量上来了之后缓存优化还是值得做的。我先按优先级排序。第一层是PHP层面的OpCache。在宝塔面板PHP - 设置 - OpCache中开启内存大小建议128M。它的原理是把PHP脚本编译后的字节码存到共享内存里下次请求直接复用省掉了重复解析代码的过程对降低响应时间效果立竿见影。开启后记得重启PHP-FPM。第二层是页面静态化缓存。Typecho有几种静态缓存插件原理是首次访问某页面时把生成的HTML缓存到文件里后续访问直接读取静态文件不再执行PHP代码。但要注意如果你开了评论功能静态页缓存会导致评论无法实时显示需要配置定时更新或评论触发更新。个人博客如果评论量不大建议还是用动态模式避免缓存不一致的麻烦。第三层是CDN加速。国内云厂商的CDN都可以接入海外访问量大的话可以用Cloudflare免费版。接入CDN后静态资源图片、CSS、JS由边缘节点分发源站压力大幅降低。有一个注意事项如果源站开了HTTPSCDN也要配置好证书回源否则页面会出现混合内容警告。另外如果CDN和源站的缓存配置不对可能导致后台更新文章后前台看不到变化这时候需要到CDN控制台刷一下缓存。5.3 定时备份方案数据无价备份必须养成习惯不然哪天手滑删库或被入侵哭都没地方哭。宝塔面板最直接的备份方式是计划任务在计划任务里添加一个备份网站任务和一个备份数据库任务周期设置为每天或每周备份目录选一个独立磁盘最好是另一块云盘或挂载盘。宝塔默认会保留最近几份备份可以设置保留份数比如3份避免无限堆积占满磁盘。如果你想更稳一点可以写一个Shell脚本把数据库dump出来后自动上传到远程对象存储比如COS、OSS、S3。核心命令大概是这样的#!/bin/bash # 数据库备份并同步到远程存储 mysqldump -u用户名 -p密码 数据库名 /backup/typecho_$(date %Y%m%d).sql # 压缩后上传到对象存储的脚本这里按你使用的云厂商SDK来写我自己是把备份任务分成两组网站文件每天凌晨4点备份数据库每天凌晨5点备份各保留最近7天的版本。加上一个上传远程存储的同步任务做到双保险。实测一年多了没出过岔子但备份不是为了今天用而是为了不确定的明天。5.4 日志查看与攻击防护日志是排障的第一手资料中文世界里很多人不太看日志出了问题全靠猜效率极低。宝塔面板的日志在 /www/wwwlogs/ 目录下文件名一般是你的站点域名_access.log 和 域名_error.log。访问异常时看access日志页面报错时看error日志配合PHP-FPM的日志绝大多数问题都能定位到具体原因。安全方面宝塔面板自带的系统防火墙插件提供了一些基础功能比如防CC攻击、禁止恶意解析、IP黑白名单等。如果站点被恶意扫描可以直接把异常IP拉黑。更轻量一点的做法是在Nginx层面加一个限流配置limit_req_zone $binary_remote_addr zoneblog:10m rate10r/s; server { location / { limit_req zoneblog burst20 nodelay; } }意思是每个IP每秒最多10次请求允许突发最多20次。一旦有人疯狂刷页面或尝试爆破Nginx会直接返回503把对PHP进程的影响降到最低。这里提醒一句限流参数要结合自己的实际访问量来调如果设置的rate太低可能把正常的搜索引擎爬虫也拦在门外。最后再提一个经常被忽视的安全点数据库账号不要用root。宝塔创建的站点数据库用户都是独立的专用权限账号Typecho连接数据库时就用这个专用账号别为省事改成root。一旦网站代码被利用拿到的是MySQL全权限那后果就更严重了。我自己部署完Typecho后还习惯手动改一下后台登录路径比如把admin目录名改成一个不常见的字符串虽然不能完全防住攻击但至少能减少被脚本批量扫描命中这个后台的可能性。Typecho部署整个过程总结下来就是轻、稳、简三个字。只要PHP版本选对、伪静态规则贴对、目录权限给对基本一次就能装好。个人博客本身就是重内容轻形式的东西越简单越好Typecho正好卡在这个点上。我在实际操作中的体会是安装只是第一步真正花时间的其实是安装完之后的备份机制和安全配置——很多新人装完就放着不管几个月后遇到问题才发现备份没做、日志没开临时抱佛脚就很被动。这篇里关于权限、备份、日志的几个小节建议认真看完再动手好过事后补课。后面你自己跑熟了会发现Typecho部署这件事真的就是半小时以内能搞定的活。
宝塔面板部署Typecho全攻略：Nginx伪静态与SSL安全加固
Typecho这个博客程序说真的是我用过的PHP建站程序里最省心的一个。朋友问我打算搭个人博客选什么好我基本都是直接推荐它——安装包不到2MB1核1G的服务器跑起来都轻松后台界面干净得不像这个时代的产物写文章、发页面、传附件功能刚好够用又不像大厂CMS那样塞一堆你用不上但删不掉的东西。但部署这东西光说简单没用真踩到坑才知道深浅。Linux环境下用宝塔面板来装Typecho算是目前最主流的组合了宝塔把Nginx、MySQL、PHP这些零散的组件全部图形化管理Linux命令不熟的人也能顺利把环境编排好Typecho本身轻量搭在Nginx上响应非常快比Apache更省内存。这篇文章我会把完整的部署路径走一遍从服务器选型、环境初始化到Typecho安装、伪静态配置、SSL证书再到常见问题排查和部署后的安全加固每一步都讲清楚为什么要这么做遇到报错怎么定位。适合想搭独立博客、内容站或者只是想快速体验Typecho的新手也适合已经装过但没整明白伪静态和安全配置的老手来查漏补缺。1. 项目概述与环境准备1.1 为什么选Typecho当个人站Typecho诞生得挺早圈子里的老用户基本都认识它。它是一款开源的PHP博客程序核心卖点就一句话轻、快、省心。对比WordPress那样动辄几十MB安装包、后台一堆菜单项和插件依赖的重型工具Typecho安装包只有几百KB跑起来占用的内存和CPU都要低一大截。对个人博客这种打开就能写写了就能发的场景来说它刚好卡在功能够用和不那么臃肿的平衡点上。我一直认为个人站的核心价值是内容不是平台。Typecho把注意力完全拉回到写作本身——Markdown写作支持得很干净文章管理简洁评论系统够用主题和插件机制也足够灵活。如果你只是想安安稳稳地写点技术笔记或者日常记录不追求网站后台有各种花哨报表和可视化编辑器Typecho就是最合适的那个。另外一个隐藏优势是HTML源码干净Google和百度的收录体验很好SEO底子比很多建站程序都要好。当然它也不是没有缺点。比如主题和插件的生态相比WordPress小很多开发文档也不算丰富遇到问题更多要靠社区博客和GitHub Issue。但对大多数个人博客场景来说这个生态规模完全够用了而且正因为选择少反而少了每天折腾主题这种浪费时间的事。1.2 服务器选型与Linux环境准备Typecho虽然对配置要求很低但服务器选型还是要有基本章法。CPU至少1核内存推荐2GB起步1GB勉强能跑但PHP-FPM、MySQL、Nginx三个进程挤在一起的时候内存会很紧张。带宽看你的访问量日常个人博客1M到3M完全够用但注意国内某些云厂商的带宽计费规则按流量还是按固定带宽要看自己的预算。系统盘建议SSD20GB起步后面要装宝塔、跑日志、存备份得留点余量。操作系统这块我在CentOS 7、CentOS Stream、Ubuntu 20.04/22.04、Debian 11/12之间都部署过Typecho。如果你的服务器是全新的我更推荐Ubuntu 22.04或者Debian 12——软件源新社区活跃遇到问题搜答案命中率高。CentOS 7虽然经典但官方已经停止维护软件源也迁移了新部署不建议再选。买完服务器之后第一步是SSH登录工具可以用Xshell、FinalShell、Termius任选然后做两件事第一更新系统软件包到最新命令很简单# Ubuntu/Debian apt update apt upgrade -y # CentOS/RHEL yum update -y第二检查一下防火墙和云安全组的放行状态。记得先放行SSH端口默认22但建议改成不常见端口和之后宝塔面板要用的端口很多安装卡住的问题其实都是防火墙把端口挡了。1.3 宝塔面板安装与初始配置宝塔面板是一个Linux服务器管理工具把Nginx、MySQL、PHP、FTP、防火墙、计划任务这些运维组件全部做成图形化界面。对刚接触Linux的朋友来说它最大的价值是不用记一大堆命令行就能把网站环境搭起来对我这种老手来说它也省掉了大量重复的手工编译配置工作。安装方式非常简单SSH登录服务器后去宝塔官网复制对应操作系统的安装脚本执行就行。脚本是官方定制的会自动检测系统环境并安装依赖整个安装过程大概需要5到15分钟取决于服务器性能和网络状况。这里顺便回答一个很多人问的问题宝塔面板是收费的吗答案是它分为免费版和付费专业版免费版已经覆盖了日常建站需要的绝大多数功能Typecho部署完全用不到付费功能放心用免费版就好不需要去研究什么免费使用专业版插件的办法那没意义也有安全风险。安装完成后终端会输出面板访问地址、初始用户名和随机密码。这里有几个安全习惯务必从第一天就养成面板默认端口是8888很多云厂商的安全组默认不放行需要你自己去云控制台放行登录面板后立刻修改面板端口和登录入口路径别用默认值开启面板SSL选项避免面板后台用明文HTTP访问进面板后在软件商店里安装Nginx、MySQL 5.7或8.0、PHP 7.4或8.1、PHPMyAdmin这几件套。装的时候版本搭配要注意Typecho官方虽然没强制指定PHP版本但建议至少7.4起太老版本跑起来会有兼容性问题后面我会细讲。2. 核心细节解析与部署前的关键决策2.1 PHP版本选择与扩展项配置PHP版本这个事是Typecho部署里最值得说道的环节。Typecho本身兼容PHP 5.6到8.2但不同版本跑起来体验差距很大。我个人推荐用PHP 7.4原因很实在Typecho生态里大量老主题和插件是几年前开发的有些语法在当时条件下还能兼容到了PHP 8.0以后就会报错甚至白屏而7.4作为过渡版本兼容性最稳妥性能也比5.6、7.0时代快一大截。如果你是全新安装且不太用老主题PHP 8.1其实也可以速度更快但遇到问题时要学会看PHP错误日志。这里有句话送给大家别追求最新稳定够用才是个人站的第一原则。选好PHP版本后在宝塔的软件商店 - PHP - 设置 - 安装扩展里有几个扩展是必装的pdo_mysqlTypecho连接MySQL数据库的底层驱动必备mbstring中文编码和多字节字符串处理不装的话中文标题、文章内容可能乱码curl部分插件和更新检测功能会用到opensslSSL证书访问和HTTPS加密依赖它fileinfo上传附件时检测文件类型避免伪装文件被放行opcachePHP代码缓存执行速度提升非常明显安装扩展后记得重启PHP-FPM进程否则配置不会生效。重启按钮在面板PHP设置页面的右上角点一下就行。2.2 数据库方案选型MySQL还是SQLiteTypecho支持两种存储方式MySQL或MariaDB和SQLite。这个选择看似不起眼实际会影响后期的维护体验。SQLite是一个文件型数据库整个数据都保存在一个文件里不需要单独安装数据库服务。它的好处是部署极简适合在极低配置的服务器上快速试跑或者你只是临时想体验一下Typecho。但缺陷也明显并发写入能力弱文章多了、评论多了之后体验会下降而且数据备份、迁移都不如MySQL方便。MySQL或MariaDB是传统的关系型数据库Typecho从早期版本就默认适配MySQL稳定性和文档完备度都更好。我的建议是正式部署一律用MySQL理由有三个一是备份方便导出.sql文件放到新服务器导入就行二是宝塔面板对MySQL的日常管理都做好了建库、授权、备份都是点几下的事三是网上90%的Typecho教程和插件都基于MySQL遇到问题搜解决方案命中率高很多。在宝塔面板的数据库菜单里新建数据库时记得数据库名、用户名、密码都单独设置密码建议用高强度随机密码不要用生日、手机号这种可猜的。创建好后把这几个信息复制到记事本里后面安装向导要用。2.3 Nginx站点创建与伪静态规则在宝塔面板网站菜单里点击添加站点填入你的域名选择之前装好的PHP版本。这里有一个容易忽略的点创建站点时弹出的同步创建数据库选项建议关掉数据库单独在数据库菜单里建这样生成的库名和权限更可控。添加完成后Nginx配置文件会自动生成位置在 /www/server/panel/vhost/nginx 目录下。Typecho默认的链接是带 index.php 的比如 http://你的域名/index.php/archives/123.html这种链接看起来不专业也不利于SEO。所以我们要给Nginx加上伪静态规则让链接变得简洁友好。Typecho官方文档给出的Nginx规则是这样的location / { index index.html index.php; if (!-e $request_filename) { rewrite ^(.*)$ /index.php$1 last; } }操作位置在对应站点的设置 - 伪静态把这段规则粘贴进去保存即可。配置完成后访问文章链接时Nginx会把不存在的路径重写到 index.php 上去由Typecho的路由解析对应文章。这里有个很多新手会踩的坑伪静态规则贴错了位置或者站点配置文件里已经有一段 location / 规则再贴就冲突了结果整个站点打不开。我的建议是先用最简单的官方规则确认访问正常后再按需调整。别一上来就抄网上的复杂规则简化才是稳定之道。2.4 域名解析与SSL证书域名解析看起来简单却是整个部署流程里最容易被卡住的地方。如果你用的是阿里云、腾讯云、Cloudflare等DNS服务商添加一条A记录记录值填服务器的公网IP等待全球DNS生效即可。生效时间通常在几分钟到一小时国内解析可能更快但有时候你本地的DNS缓存没刷新会误以为没生效可以用在线的DNS检测工具确认。SSL证书强烈建议在宝塔面板里直接申请。宝塔自带Lets Encrypt免费证书申请功能申请前提是域名已正确解析到本服务器并且站点配置的域名和证书申请域名一致。申请成功后在SSL菜单里开启强制HTTPS和HSTS让所有HTTP请求自动跳转到HTTPS。顺便提一个热搜词相关的问题宝塔面板 启用不安全的TLS1.0协议怎么关闭——这个操作其实很简单在Nginx配置文件里的 ssl_protocols 一行改成ssl_protocols TLSv1.2 TLSv1.3;意思是只启用TLS1.2和1.3这两个安全版本把不安全的TLS1.0和1.1彻底关掉。改完保存重载Nginx配置即可。这个优化对提升站点安全评分很有帮助建议配合免费证书一起做。3. Typecho安装全程实操3.1 下载Typecho源码并上传Typecho的安装包可以从官网下载也可以在GitHub的官方仓库下载目前的最新稳定版是1.2.x以官网实际显示为准。下载下来的压缩包解压后会得到一个包含 index.php、install.php 等文件的目录结构。上传到服务器有两种方式大家按习惯选。第一种宝塔面板的文件管理把压缩包上传到站点根目录/www/wwwroot/你的网站目录选中压缩包点击解压然后把解压出来的文件剪切/移动到根目录。这种方式全程鼠标操作对不熟悉命令行的朋友最友好。第二种SSH命令行方式速度快适合有基础的朋友cd /www/wwwroot/你的网站目录 wget https://github.com/typecho/typecho/releases/download/v1.2.1/typecho.zip unzip typecho.zip不管用哪种方式上传完后访问 http://你的域名/install.php应该能看到Typecho安装向导。如果这一步出现404或空白页优先检查Nginx站点配置里的根目录路径是否和文件实际存放目录一致。3.2 目录权限设置权限问题是安装Typecho时最容易碰到的坑。安装过程中Typecho需要往 usr 目录下写入配置文件 config.inc.php还需要在 usr/uploads 目录下保存上传的图片附件。如果权限不够安装向导会在第一步就报无法写入配置文件。宝塔面板创建站点时默认已经把网站目录所有者设置为 www 用户权限是755。为了确保安装顺利我建议在安装阶段给 usr 目录临时设置为777等安装完成后再改回755并单独把 config.inc.php 的权限设置为644。这样既保证了安装过程不卡壳又减少了目录被恶意写入的风险。如果安装过程中遇到权限报错进入面板文件管理右键对应目录点击权限手动设置好所有者和权限值然后刷新安装页面重试。这一步基本可以解决99%的无法写入类报错。还有一个小细节FTP上传文件时某些FTP客户端默认的文件权限是644、目录权限是755如果上传后目录变成了其他权限记得批量调整回来。3.3 浏览器安装向导填表要点访问 http://你的域名/install.php 后Typecho安装向导会分几步走。第一页显示数据库配置,需要填写数据库信息。这里我见过太多人填错重点说几个第一数据库用户名和密码。注意这里填的不是宝塔面板的账号密码而是你在宝塔数据库菜单里创建的那个MySQL数据库的用户名和密码两个是两个系统别混。第二数据库地址。大部分情况填 localhost 或者 127.0.0.1 都可以。宝塔默认配置下填 localhost 通常能成功如果提示连接失败改成 127.0.0.1 再试一次这个修改能解决很多莫名其妙的连接问题。第三数据库名。要填你在宝塔里创建的那个数据库的全名不要自己改拼写或添字。数据库名一般是一长串小写字母加数字复制粘贴最稳妥。第二页是站点配置设置管理员用户名、登录密码、邮箱以及站点时区。时区直接选中国时区Asia/Shanghai就好。填完后点击安装正常几秒就会进入Typecho后台登录页面。如果卡住或报错回看第4章的问题排查。3.4 后台初始设置与基本优化安装完成登录后台后第一件事就是到控制台 - 设置 - 基础设置里检查几个配置项站点名称改成你自己的博客名称站点地址填你的域名带不带 www 要和后面配置的保持一致否则可能出现部分链接生成错误时区确认是 Asia/Shanghai日期时间格式按自己喜好调整比如 Y-m-d H:i:s然后发布一篇测试文章看看链接什么样。如果文章链接还是带着 index.php 的样子说明前面Nginx伪静态规则没生效回到站点设置里重贴一遍规则然后清理浏览器缓存再看。接下来可以配置永久链接结构。Typecho默认的文章链接是 /archives/数字.html其实已经很简洁了一般不用改。但如果你喜欢日期型链接或者分类型链接可以在设置 - 永久链接里调整。需要注意修改永久链接后旧链接可能失效所以第一次就定好结构尽量别在站点上线后频繁改。主题和插件的安装我也顺便说一下下载主题或插件压缩包后在后台外观或插件菜单里上传安装即可也可以手动上传到 usr/themes 或 usr/plugins 目录再到后台启用。Typecho的Markdown写作体验很好后台写文章时默认就支持Markdown语法没有太多需要配置的东西装好主题和插件之后基本就能开写了。4. 常见问题与排查技巧实录4.1 数据库连接失败安装向导报数据库连接失败是最常见的问题。排查顺序按下面来检查MySQL服务是否运行中宝塔面板 - 数据库 - 服务状态如果是停止状态点击启动检查数据库名、用户名、密码是否填错去宝塔数据库菜单里重新看一眼确认没有多打或少打字符检查数据库地址是 localhost 还是 127.0.0.1两个切换试一下检查数据库用户是否有权限访问这个库宝塔创建数据库时默认绑定了权限一般不会错但如果你手动创建过同名库或同名用户可能权限对应混乱这里分享一个我踩过的隐蔽坑如果服务器上安装了多个PHP版本而你创建站点时选择的PHP版本和数据库配置不匹配比如PHP 8.1的pdo_mysql扩展没装那MySQL连接也会报错。解决办法是到软件商店 - PHP - 设置 - 扩展里确认pdo_mysql扩展已安装并重启PHP。4.2 404页面无法访问首页能打开但访问文章链接比如 /archives/1.html出现40490%的原因是Nginx伪静态没配置或者配置了没有生效。处理步骤宝塔面板 - 网站 - 对应站点 - 设置 - 伪静态确认规则内容无误保存规则后再点一次配置文件确认规则确实写入了对应server块如果规则没问题清一下浏览器缓存用无痕窗口重新访问如果以上都做了还是404检查一下站点根目录下是否有 .htaccess 文件这是Apache的重写规则Nginx不识别但有时候会被模板或工具带进来。有的话不影响Nginx但如果同时存在其他location规则冲突就可能导致404可以先把配置文件里多余的location块注释掉再测试。4.3 502 Bad Gateway502通常意味着PHP-FPM进程挂了或者PHP版本与站点配置不匹配。排查路径去宝塔面板软件商店 - PHP - 设置 - 状态里看PHP-FPM是否在运行如果没运行点击启动然后在站点设置里确认选择的PHP版本是正在运行的那个版本查看PHP-FPM日志/www/server/php/你的PHP版本/var/log/php-fpm.log定位具体报错实际部署中502经常出现在安装了opcache等扩展之后忘了重启PHP-FPM的情况。解决办法就是重启面板上有重启按钮点一下几秒就好。还有一种少见情况是PHP-FPM的listen配置的socket路径和Nginx配置里不一致导致Nginx连接不上PHP-FPM这种情况检查Nginx配置文件里的 fastcgi_pass 参数确保和PHP-FPM的listen配置对应。4.4 伪静态不生效伪静态配置完首页正常但文章链接还是带index.php或者点击文章链接404。这有两种可能第一种是规则没生效。在宝塔面板伪静态里粘贴规则后要点右侧保存按钮再回到配置文件确认规则确实写入了。第二种可能是PHP的pathinfo模式问题。Typecho对pathinfo处理得还算好但如果Nginx配置里限制了PATH_INFO传递也可能导致文章页面404。解决方法是在站点的Nginx配置文件的server块中加入location ~ .*\.php { fastcgi_pass unix:/tmp/php-cgi-74.sock; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_index index.php; include fastcgi.conf; }这里的 unix:/tmp/php-cgi-74.sock 要根据你实际PHP版本修改在宝塔PHP - 配置文件里能找到 listen 那一行的实际socket路径。不过很多情况下只要伪静态规则贴对了不会走到pathinfo这一步。4.5 上传文件失败后台写文章时上传图片附件失败基本就是几个原因usr/uploads 目录没有写权限把该目录所有者改为 www权限设置755PHP的upload_max_filesize默认只有2M到PHP - 设置 - 上传限制里改大比如20Mpost_max_size 也要一并改大否则表单提交大数据会被服务器拒绝服务器磁盘满了执行 df -h 看看磁盘使用率备用方案是清理日志和备份还有一个容易忽略的点如果你使用了CDN或对象存储插件上传附件那问题可能出在插件的API配置上跟服务器权限无关需要到插件设置页面重新校验密钥和存储路径。上传失败后记得看PHP-FPM日志和Nginx的error.log里面通常有具体的错误描述比瞎猜定位快得多。5. 部署后的安全加固与性能调优5.1 目录权限与防注入Typecho源码目录本身不大但权限分配要做到最小化。我一般按下面这样分网站根目录目录权限755文件权限644usr/ 目录给 www 用户写权限主题插件的写入和更新需要usr/uploads/ 目录www 用户写权限用户上传的附件都存这里install.php安装完成后直接删除或多加一道访问控制避免被再次执行安装逻辑防注入方面Typecho本身对SQL注入和XSS做了不少防护这篇文章就不展开讲代码层面了但服务器层面至少要做两件事。第一启用宝塔面板的系统防火墙关闭不必要的外网端口。第二在Nginx配置里增加一段规则隐藏掉备份文件、数据库导出文件、日志文件这类可能包含敏感信息的内容location ~* (\.bak|\.old|\.swp|\.sql|\.log)$ { deny all; }这段规则会禁止外部直接访问 .bak、.sql、.log 等后缀的文件。很多人习惯把数据库备份文件放到网站目录下如果不加这个限制被搜索引擎或恶意扫描者抓到后果很严重。顺带提醒一下备份文件尽量放在站外目录比如 /backup 或者单独挂载的云盘。5.2 缓存与CDN配置Typecho已经很轻量但访问量上来了之后缓存优化还是值得做的。我先按优先级排序。第一层是PHP层面的OpCache。在宝塔面板PHP - 设置 - OpCache中开启内存大小建议128M。它的原理是把PHP脚本编译后的字节码存到共享内存里下次请求直接复用省掉了重复解析代码的过程对降低响应时间效果立竿见影。开启后记得重启PHP-FPM。第二层是页面静态化缓存。Typecho有几种静态缓存插件原理是首次访问某页面时把生成的HTML缓存到文件里后续访问直接读取静态文件不再执行PHP代码。但要注意如果你开了评论功能静态页缓存会导致评论无法实时显示需要配置定时更新或评论触发更新。个人博客如果评论量不大建议还是用动态模式避免缓存不一致的麻烦。第三层是CDN加速。国内云厂商的CDN都可以接入海外访问量大的话可以用Cloudflare免费版。接入CDN后静态资源图片、CSS、JS由边缘节点分发源站压力大幅降低。有一个注意事项如果源站开了HTTPSCDN也要配置好证书回源否则页面会出现混合内容警告。另外如果CDN和源站的缓存配置不对可能导致后台更新文章后前台看不到变化这时候需要到CDN控制台刷一下缓存。5.3 定时备份方案数据无价备份必须养成习惯不然哪天手滑删库或被入侵哭都没地方哭。宝塔面板最直接的备份方式是计划任务在计划任务里添加一个备份网站任务和一个备份数据库任务周期设置为每天或每周备份目录选一个独立磁盘最好是另一块云盘或挂载盘。宝塔默认会保留最近几份备份可以设置保留份数比如3份避免无限堆积占满磁盘。如果你想更稳一点可以写一个Shell脚本把数据库dump出来后自动上传到远程对象存储比如COS、OSS、S3。核心命令大概是这样的#!/bin/bash # 数据库备份并同步到远程存储 mysqldump -u用户名 -p密码 数据库名 /backup/typecho_$(date %Y%m%d).sql # 压缩后上传到对象存储的脚本这里按你使用的云厂商SDK来写我自己是把备份任务分成两组网站文件每天凌晨4点备份数据库每天凌晨5点备份各保留最近7天的版本。加上一个上传远程存储的同步任务做到双保险。实测一年多了没出过岔子但备份不是为了今天用而是为了不确定的明天。5.4 日志查看与攻击防护日志是排障的第一手资料中文世界里很多人不太看日志出了问题全靠猜效率极低。宝塔面板的日志在 /www/wwwlogs/ 目录下文件名一般是你的站点域名_access.log 和 域名_error.log。访问异常时看access日志页面报错时看error日志配合PHP-FPM的日志绝大多数问题都能定位到具体原因。安全方面宝塔面板自带的系统防火墙插件提供了一些基础功能比如防CC攻击、禁止恶意解析、IP黑白名单等。如果站点被恶意扫描可以直接把异常IP拉黑。更轻量一点的做法是在Nginx层面加一个限流配置limit_req_zone $binary_remote_addr zoneblog:10m rate10r/s; server { location / { limit_req zoneblog burst20 nodelay; } }意思是每个IP每秒最多10次请求允许突发最多20次。一旦有人疯狂刷页面或尝试爆破Nginx会直接返回503把对PHP进程的影响降到最低。这里提醒一句限流参数要结合自己的实际访问量来调如果设置的rate太低可能把正常的搜索引擎爬虫也拦在门外。最后再提一个经常被忽视的安全点数据库账号不要用root。宝塔创建的站点数据库用户都是独立的专用权限账号Typecho连接数据库时就用这个专用账号别为省事改成root。一旦网站代码被利用拿到的是MySQL全权限那后果就更严重了。我自己部署完Typecho后还习惯手动改一下后台登录路径比如把admin目录名改成一个不常见的字符串虽然不能完全防住攻击但至少能减少被脚本批量扫描命中这个后台的可能性。Typecho部署整个过程总结下来就是轻、稳、简三个字。只要PHP版本选对、伪静态规则贴对、目录权限给对基本一次就能装好。个人博客本身就是重内容轻形式的东西越简单越好Typecho正好卡在这个点上。我在实际操作中的体会是安装只是第一步真正花时间的其实是安装完之后的备份机制和安全配置——很多新人装完就放着不管几个月后遇到问题才发现备份没做、日志没开临时抱佛脚就很被动。这篇里关于权限、备份、日志的几个小节建议认真看完再动手好过事后补课。后面你自己跑熟了会发现Typecho部署这件事真的就是半小时以内能搞定的活。
